O ai-validation é o serviço de validação automatizada por IA da plataforma: uma API FastAPI que expõe dois fluxos independentes de análise. O primeiro valida certificados de treinamento NR-10 e NR-35 (segurança em instalações elétricas e trabalho em altura) enviados como imagem, usando uma pipeline multi-agente orquestrada por LangGraph com LLM Vision (Gemini) para extrair dados, checar prazo de validade, carga horária e cruzar o nome do aluno entre os dois documentos via fuzzy matching. O segundo valida se o CNPJ de uma empresa parceira (integradora/vendedora) está ativo na Receita Federal e se o ramo de atividade (CNAE) é compatível com o setor de energia solar e elétrica, usando um agente de IA para a análise semântica. Ambos os fluxos combinam consultas externas, LLM e regras de negócio determinísticas para reduzir falso positivo, sendo o sistema fail-safe por padrão.
- ARCHITECTURE.md, estrutura de pastas, camadas e padrões arquiteturais do serviço.
- RUNNING.md, como rodar o projeto localmente, incluindo impedimentos e variáveis de ambiente.
- Deployment, pipeline de deploy padronizado da organização (CI, release, ArgoCD).
- docs/API.md, contrato completo dos endpoints, payloads e códigos de erro.
- docs/AGENT_WORKFLOW.md, detalhamento da pipeline multi-agente de validação de certificados.
- docs/CNPJ_WORKFLOW.md, detalhamento do fluxo de validação de CNPJ.
- CONTRIBUTING.md, convenções de commit, branch e Pull Request.
- CODE_OF_CONDUCT.md, código de conduta do projeto.
- SECURITY.md, como reportar vulnerabilidades de segurança.