gohorsejobs/frontend/CONVENTIONS.md

Frontend – Convenções Anti-Erro

1) Chamadas de API (padrão obrigatório)

Use src/lib/api.ts como única porta de entrada para HTTP.

Padrão atual:

• Use apiRequest<T>(endpoint, options) para qualquer fetch.
• Token vem do localStorage (auth_token ou token) e é enviado no header Authorization: Bearer.
• Content-Type é JSON sempre que houver body.
• credentials: "include" está ativado (cookies compartilhados).
• Erros retornam Error com message do backend, quando disponível.

Não chame fetch direto em páginas/componentes.
Sempre centralize novas rotas em src/lib/api.ts (ex.: usersApi, jobsApi, etc.).

Referência: frontend/src/lib/api.ts.

2) Traduções (i18n sem quebra de build)

UI do frontend (Next.js)

• As strings usadas por useTranslation estão em frontend/src/i18n (en.json, es.json, pt-BR.json).
• Regra: qualquer nova chave deve existir em todos os arquivos de idioma para evitar fallback inconsistente.

Catálogo geral

• Existe um catálogo amplo em frontend/messages (ex.: pt-BR.json, en-US.json, es-ES.json, ja-JP.json).
• Se você adicionar uma nova chave nesse catálogo, replique nas outras línguas no mesmo caminho de objeto.

Referências: frontend/src/lib/i18n.tsx, frontend/src/i18n/*.json, frontend/messages/*.json.

3) Componentes de formulário (padrão JobFormBuilder)

Todos os formulários com perguntas dinâmicas devem seguir o padrão de JobFormBuilder:

• Tipo Question com id, type, label, required e options (quando aplicável).
• type permitido: text, long_text, yes_no, multiple_choice, select.
• options existe apenas para multiple_choice e select.
• Respeite o limite maxQuestions (default 7).
• UI deve usar componentes de components/ui e manter o campo fixo de currículo (CV) como referência visual.

Referência: frontend/src/components/job-form-builder.tsx.