# Public Form Intake

> Implementa ou corrige fluxo de formulario publico com analise inicial e persistencia segura.

- Skill: `deveclipsy007/public-form-intake` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add deveclipsy007/public-form-intake`
- Raw SKILL.md: https://api.skillmd.com/api/skills/deveclipsy007/public-form-intake/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: deveclipsy007 (https://skillmd.com/u/deveclipsy007)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/deveclipsy007/public-form-intake

---


# public-form-intake

Skill para manutencao do fluxo `/diagnostico` e endpoints relacionados.

## Inputs

- `form_fields`: campos esperados no payload
- `validation_rules`: regras obrigatorias
- `analysis_mode`: `ai` ou `fallback`
- `notification_channels`: ex: `telegram`, `email`

## Outputs

- Atualizacao em `config/routes.php` (se necessario)
- Atualizacao em `src/Controllers/Client/PublicFormController.php`
- Atualizacao opcional de migration de suporte

## Fontes do projeto

- `config/routes.php`
- `src/Controllers/Client/PublicFormController.php`
- `database/migrations/008_public_form_responses.sql`

## Passo a passo

1. Validar entradas obrigatorias e termos de uso.
2. Implementar interface de wizard multi-step em `templates/pages/public/diagnostico.php`.
    - **Resiliência**: Utilizar o operador null-safe (`??`) para acessar chaves do JSON estrutural (ex: `$field['type'] ?? 'text'`). Isso evita que um erro PHP interrompa o layout e cause problemas de encoding.
    - **Arquitetura de Tradução (Ideal)**:
        - Criar helper `$t($obj, $key)` que suporte strings e arrays (para `options`).
        - **Display vs Value**: Traduzir apenas o rótulo visual (`display`). O `value` do input deve permanecer na língua original (PT) para garantir consistência dos dados no banco e evitar quebras em relatórios/IA.
        - **Fallback**: Sempre garantir fallback para o array original se a tradução falhar ou tiver tamanho diferente.
3. Adicionar barra de progresso e mensagens motivacionais em `public/js/diagnostico.js`.
4. Persistir submissao com metadados (`ip`, `user_agent`, `submitted_at`).
5. Retornar resposta JSON e disparar redirecionamento para página de agradecimento.

## Troubleshooting: Encoding (Mojibake)

Se a página exibir caracteres como "ç" em vez de "ç":
1. Verifique se há erros PHP ocorrendo durante o rendering do template.
2. Certifique-se de que o layout (que contém `<meta charset="UTF-8">`) está sendo aplicado e não foi interrompido por um crash.
3. Verifique se o banco de dados e os arquivos PHP estão salvos em UTF-8 sem BOM.
4. Use `curl.exe -s URL` para verificar se o HTML bruto contém a declaração de charset antes de qualquer script.

## Criterios de aceite

- Erros de validacao retornam 422 com payload consistente.
- Fluxo nao depende 100% de API externa.
- Registro salvo com status inicial `pending`.

## Nao faz

- Nao aprova/rejeita respostas automaticamente.
- Nao cria conta de usuario sem validacao de email.