Licita+
Gera minutas de Termo de Referência (e, depois, de ETP) no modelo AGU, para compras de saúde. A entrada é o checklist técnico da área requisitante e as decisões da equipe administrativa no wizard. A minuta é revisada por pessoas e colada no Compras.gov.br.
Estado: Marcos 0 e 1 concluídos. O motor monta a minuta do TR a partir das matrizes (Fase 14), e npm run simular -- C1 mostra o resultado em texto corrido. O Marco 2 (telas, banco e login) está em andamento no ramo marco-2; ainda não há IA.
Como começar
- Clone o repositório (https://github.com/Utgas/licita-). Ele está público por enquanto; ver
docs/decisoes/0005-dados-reais-fora-do-repositorio.md.
- Abra o Claude Code nesta pasta e peça: "Leia o CLAUDE.md e execute a tarefa docs/tarefas/marco-0.md."
- No fim do Marco 0, confira o critério de saída da tarefa e o relatório do compilador.
Vercel e Supabase só entram de verdade no Marco 2 (telas e banco). Até lá basta o GitHub.
Como rodar
Precisa do Node 22.18 ou mais novo.
npm ci # instala as dependências nas versões fixadas
npm run compilar # confere as matrizes e gera o pacote de regras
npm test # testes automáticos
npm run lint # padrões de código e isolamento do motor
npm run typecheck # tipos do TypeScript
npm run dev # página inicial em http://localhost:3000
O npm run compilar imprime um relatório: linhas por matriz, contagem de status (EXTRAIDO, INFERIDO, A_VERIFICAR), situação da validação no M03 e no M04 e a lista de erros. Sem erro, ele grava regras/agu-tr-compras-2025-12/pacote.json e o hash em pacote.sha256; compilar de novo dá o mesmo hash. npm run compilar:piloto falha enquanto houver regra CONDICAO do M03 ou pergunta do M04 sem validacao = OK.
O GitHub Actions roda lint, typecheck, testes e compilação em todo push e pull request, e falha se o pacote em regras/ não corresponder às matrizes.
Estrutura
| Pasta | O que tem |
|---|
docs/ | escopo, arquitetura, decisões e tarefas por marco |
matrizes/v1/ | as matrizes M00 a M12 (CSV), os cenários de ouro, a planilha de revisão e os registros do agente das matrizes |
referencias/ | modelo AGU de TR (DEZ/2025) e checklists técnicos em branco |
regras/ | pacote compilado (npm run compilar; nunca editar à mão) |
scripts/ | compilador e simulador |
src/ | motor, telas, banco, login, auditoria, exportação e IA |
supabase/ | configuração e migrações do banco |
testes/ | testes do motor, cenários de ouro e testes de tela |
Plano
| Marco | Entrega | Depende de |
|---|
| 0. Esqueleto | Repositório, testes e compilador lendo as matrizes | nada |
| 1. Motor do TR | Wizard, regras por item, montagem e validação, sem telas | matrizes da Fase 10 (feitas) |
| 2. Telas e banco | Login, checklist, wizard, itens, revisão, PDF, copiar por campo, auditoria | nada (checklist, formato e expurgo decididos) |
| 3. ETP | ETP montado a partir do checklist e derivação para o TR | Fases 4 a 9 das matrizes (feitas) |
| 4. Piloto | 3 processos reais em paralelo com o método atual | regras do M03 e do M04 validadas, aprovação da hospedagem, conta e patrocinador |
| 5. IA | Melhora a redação do ETP, citando a pergunta de origem | provedor de IA aprovado |
Detalhes em docs/arquitetura.md.
Como validar as matrizes
-
Abra matrizes/v1/matrizes_v1.xlsx.
-
Nas abas M03 e M04, preencha as colunas amarelas validacao (OK, CORRIGIR ou DUVIDA) e comentario_validacao. Comece pelas regras do M03 com natureza CONDICAO: são elas que decidem o que entra no TR.
-
Leve a planilha de volta para os CSV com o comando abaixo (precisa de Python 3 com openpyxl; o Claude Code pode rodar para você):
python3 -I matrizes/v1/scripts/importar_validacao.py matrizes/v1/matrizes_v1.xlsx matrizes/v1 matrizes/v1/logs/validacao.txt
O registro lista as linhas marcadas CORRIGIR e DUVIDA, que voltam para o agente das matrizes.
-
Rode npm run compilar e confira, no relatório, a tabela "Validação do Gabriel (M03 e M04)". Quando tudo estiver OK, npm run compilar:piloto passa.
O que não entra aqui
ETPs, TRs e DFDs reais ficam fora do repositório: alguns têm nomes, assinaturas e CPFs. O .gitignore bloqueia PDFs e a pasta Documentos/. Antes do primeiro commit, confira que nenhum arquivo real entrou.
