Features

Introdução ao documento

Este índice lista as features centrais comprovadas no repositório e aponta para a documentação detalhada de cada jornada em docs/features/<slug>.md.

Fato observado

• As jornadas centrais do produto estão distribuídas entre rotas em app/, componentes em src/features/components e handlers em pages/api/.
• O fluxo principal do produto parte do detalhe do curso, passa por autenticação/inscrição, confirmação de cadastro, OTP e finalização via WhatsApp ou grupo.

Evidências:

• ../../app/[slug]/page.tsx#L16-L47
• ../../app/[slug]/inscricao/page.tsx#L12-L27
• ../../app/[slug]/inscricao/confirmacao/page.tsx#L8-L16
• ../../app/[slug]/inscricao/codigo/page.tsx#L8-L16
• ../../app/[slug]/inscricao/turma/page.tsx#L8-L13
• ../../app/grupo/[uid]/page.tsx#L12-L41
• ../../app/maintenance/page.tsx#L17-L47

Versionamento

Atualizar este índice sempre que:

• uma rota central for adicionada, removida ou fundida com outra;
• uma jornada mudar de responsabilidade entre app/, src/features/components e pages/api/;
• surgirem novas features com impacto direto na conversão do onboarding.

Evidências:

• ../../app/
• ../../src/features/components/
• ../../pages/api/

Referencial teórico

O inventário abaixo foi derivado por leitura combinada de:

• rotas Next.js;
• componentes de feature;
• validações Formik/Yup;
• handlers HTTP internos e guards client-side.

Evidências:

• ../../src/features/components/CourseRegistration/CourseRegistration.schema.ts#L4-L10
• ../../src/features/components/SignupConfirmation/components/ProfileForm/ProfileForm.schema.ts#L5-L47
• ../../src/common/components/AuthProtected/AuthProtected.component.tsx#L8-L23
• ../../pages/api/v1/otp/confirm.ts#L12-L57

Cobertura priorizada

Feature	Documento	Cobertura
Detalhe do curso	course-details.md	Completa para jornada pública e CTA
Inscrição e login	course-registration.md	Completa para CPF, AMEI e regras de elegibilidade
Confirmação de cadastro	signup-confirmation.md	Completa para pré-preenchimento, upsert, OTP e tracking
Confirmação por OTP	otp-confirmation.md	Completa para validação, reenvio e avanço
Finalização via WhatsApp	class-registration.md	Completa para countdown, reenvio e suporte
Redirecionamento para grupo	group-redirect.md	Completa para resolução de link e falha
Modo manutenção	maintenance-mode.md	Completa para middleware e tela dedicada

Evidências:

• ../../app/[slug]/page.tsx#L16-L47
• ../../app/[slug]/inscricao/page.tsx#L12-L27
• ../../app/[slug]/inscricao/confirmacao/page.tsx#L8-L16
• ../../app/[slug]/inscricao/codigo/page.tsx#L8-L16
• ../../app/[slug]/inscricao/turma/page.tsx#L8-L13
• ../../app/grupo/[uid]/page.tsx#L12-L41
• ../../middleware.ts#L4-L40

Observações de cobertura

• As features acima cobrem todas as rotas centrais de negócio expostas em app/.
• Não foram abertas como features separadas as rotas puramente técnicas app/api/envs, app/api/meta-conversion, health, readiness e liveness, porque elas funcionam como suporte operacional e não como jornada de produto.
• Há lacunas de OpenAPI para jornadas cuja orquestração principal usa adapters server-side diretos ao WordPress ou o catch-all do NextAuth.

Evidências:

• ../../app/api/envs/route.ts#L4-L20
• ../../app/api/meta-conversion/route.ts#L7-L47
• ../../pages/api/health.ts#L20-L108
• ../../pages/api/auth/[...nextauth].ts#L25-L155

Pendências

• Confirmar se a etapa /{slug}/inscricao/turma é o último passo oficial do onboarding em todos os ambientes.
• Confirmar se o redirecionamento de grupo deveria ter um endpoint interno próprio documentado no OpenAPI.
• Confirmar se o catch-all de NextAuth deve ganhar documentação complementar fora do OpenAPI atual.

Evidências:

• ../../app/[slug]/inscricao/turma/page.tsx#L8-L13
• ../../app/grupo/[uid]/page.tsx#L12-L41
• ../api/openapi.yaml