O Guia do Desenvolvedor SINAL

Este manual foi elaborado para orientar uma entrada técnica gradual no SINAL Web, especialmente dirigida a desenvolvedores em formação, estagiários, juniores ou novos colaboradores que estejam iniciando sua participação no projeto. Parte-se do princípio de que alguém em processo de aprendizagem não deve ser imediatamente tratado como responsável autônomo por uma plataforma sensível, embora possa, mediante supervisão, prática orientada e exposição progressiva às rotinas reais do repositório, desenvolver as competências necessárias para compreender, manter e proteger partes relevantes do sistema. A premissa que sustenta este documento é objetiva: um software que lida com dados sensíveis, registros profissionais, fluxos de avaliação e inferências funcionais não pode ser aprendido apenas por tentativa e erro. O aprendizado técnico, nesse contexto, precisa ser acompanhado por disciplina de versionamento, atenção ao escopo, prudência diante de dados, respeito às decisões arquiteturais já estabelecidas e compreensão dos limites metodológicos do próprio produto. O SINAL Web deve ser compreendido como a camada digital do Sistema Integrado de Avaliação Funcional e Neurocognitiva da Aprendizagem. Sua função é substituir progressivamente a planilha integrada por uma plataforma capaz de organizar casos, matriz inicial, sessões, episódios funcionais, cálculos heurísticos, sínteses, dashboards e exportações. Essa descrição operacional, contudo, ainda não basta. Para trabalhar adequadamente no sistema, o desenvolvedor precisa entender a regra conceitual que protege o projeto: o aplicativo não diagnostica, não classifica normativamente, não emite percentis, não calcula QI e não substitui o julgamento técnico do profissional. Por essa razão, a formação técnica proposta neste manual caminha junto com uma formação de governança. Aprender Git, TypeScript, React, Next.js, Prisma, Playwright, banco de dados e segurança básica não significa apenas dominar ferramentas ou decorar comandos. Significa aprender a intervir em um sistema real sem comprometer sua rastreabilidade, sem expor dados, sem criar funcionalidades fora do escopo, sem alterar regras clínicas indevidamente e sem enfraquecer os limites que impedem o SINAL de ser interpretado como instrumento diagnóstico automático. A estrutura do manual acompanha uma progressão deliberada. Primeiro, apresenta o projeto e sua lógica geral; depois, descreve o fluxo funcional do aplicativo; em seguida, orienta a configuração do ambiente local e a rotina de trabalho com Git; posteriormente, introduz as principais tecnologias que compõem o software; por fim, organiza práticas de segurança, testes, manutenção, documentação e evolução gradual da responsabilidade técnica. O objetivo é que cada novo conhecimento seja aprendido em relação a uma prática concreta do repositório, evitando tanto o treinamento abstrato, desconectado da plataforma, quanto a intervenção improvisada em partes críticas do sistema. Desse modo, este manual não deve ser lido apenas como uma documentação de apoio, mas como um percurso inicial de formação técnica dentro do SINAL Web. Ele estabelece como estudar o projeto, como modificar o código com segurança, como registrar mudanças, como testar entregas, como pedir revisão e como reconhecer os próprios limites durante o desenvolvimento. A expectativa é que o novo desenvolvedor aprenda a crescer dentro da plataforma sem confundir velocidade com maturidade, autonomia com ausência de supervisão ou curiosidade técnica com permissão para alterar qualquer parte do sistema.