Arquitetura

Visão geral do sistema

O "IPA Activity Generator" em PT-BR será uma aplicação web construída em Next.js (App Router) com TypeScript, Tailwind e componentes shadcn/ui. O back-end usará o Node OpenAI SDK com a Responses API para gerar atividades em IPA para professores de Educação Especial. A captura de áudio do estudante será opcional e tratada de forma temporária, sem armazenar PII.

Principais módulos

Interface Web (Next.js/App Router): páginas e componentes React para criação e gestão de atividades, fluxo de captura de áudio e visualização de resultados.
Serviço de Geração (OpenAI Responses API): camada que prepara prompts em PT-BR, aplica regras pedagógicas e recebe as respostas geradas.
Gestão de Sessão/Autenticação: middleware e endpoints para login e controle de acesso (futuro), incluindo RBAC para perfis de professores/administradores.
Camada de Dados: abstração de persistência para atividades, planos, estudantes e registros de áudio/metadados (quando habilitado), com validação de privacidade.
Observabilidade: logs estruturados e métricas mínimas sem dados sensíveis, com possibilidade de toggle para diagnósticos.

Fluxo de dados (alto nível)

Usuário autenticado acessa o painel e solicita a geração de uma atividade IPA em PT-BR.
A UI coleta parâmetros pedagógicos e contexto da turma; dados transitam apenas em sessão autenticada.
O serviço de geração monta o prompt e chama a Responses API da OpenAI.
A resposta é normalizada e entregue à UI; atividade pode ser associada a um plano ou estudante (sem PII obrigatória).
(Opcional) A captura de áudio envia streams/trechos para processamento temporário; somente metadados mínimos são persistidos, se configurado.
Registros de atividades e permissões são salvos via camada de dados, respeitando RBAC e políticas de retenção.