# Assistente de preenchimento de evidências externas

Versão: v0-pre-proposta
Gerado em: 2026-06-09T15:03:56.955Z
Pasta-base: docs/proposal/external-evidence
writeReady=false
incrementalWriteReady=false
writeMode=all_ready

## Resumo

| Arquivos | Prontos | Obrigatórios prontos | Issues | Elegíveis write | Modo | Write solicitado | Overwrite |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 9 | 0 | 0/4 | 4 | 0 | all_ready | não | não |

## Arquivos planejados

| Arquivo | Obrigatório | Status | Issues | Próxima ação |
| --- | --- | --- | --- | --- |
| docs/proposal/external-evidence/submission-entity-decision.md | sim | needs_input | submissionEntityDecision:missing_field | Preencher dados reais da pessoa/empresa responsável pela submissão. |
| docs/proposal/external-evidence/operation-dates.csv | sim | needs_input | operationDates:no_rows | Adicionar pelo menos uma data real com evidência verificável. |
| docs/proposal/external-evidence/habilitation-index.md | sim | needs_input | habilitationIndexItems:no_rows | Listar documentos, arquivos e validades antes da habilitação. |
| docs/proposal/external-evidence/solv-final-snapshot.md | sim | needs_input | solvSnapshot:missing_field | Salvar dados do formulário final antes de clicar SUBMETER. |
| docs/proposal/external-evidence/cta-auth-provider-response.md | não | needs_input | n/a | Opcional: salvar resposta oficial quando a CTA responder. |
| docs/proposal/external-evidence/cta-fapes-api-response.md | não | needs_input | n/a | Opcional: salvar resposta oficial quando a CTA responder. |
| docs/proposal/external-evidence/cta-pf-eligibility-response.md | não | needs_input | n/a | Opcional: salvar resposta oficial quando a CTA responder. |
| docs/proposal/external-evidence/cta-remuneration-response.md | não | needs_input | n/a | Opcional: salvar resposta oficial quando a CTA responder. |
| docs/proposal/external-evidence/cta-consortium-response.md | não | needs_input | n/a | Opcional: salvar resposta oficial quando a CTA responder. |

## Campos

### Decisão PF/PJ

| Campo | Obrigatório | Exemplo |
| --- | --- | --- |
| profile | sim | PF |
| cpfCnpj | sim | [CPF-ou-CNPJ-real] |
| nameOrCorporateName | sim | Raphael Lages |
| responsibleName | sim | Raphael Lages |
| email | sim | contato@example.com |
| phone | não | +55 00 00000-0000 |
| address | sim | Rua Nome Real, 100, Cidade, UF |
| decisionDate | sim | 2026-05-27 |
| justification | sim | Compatibilidade documental com a submissão no Solv. |

### Datas de operação

| Campo | Obrigatório | Exemplo |
| --- | --- | --- |
| product | sim | Chamei |
| operationStartDate | sim | 2025-01-15 |
| currentStatus | sim | em_operacao |
| evidenceUrlOrPrint | sim | docs/proposal/external-evidence/produto-print.png |
| allowedMetric | sim | usuários ativos sem dado pessoal |
| secrecyRestriction | sim | não incluir dados pessoais |

### Índice de habilitação

| Campo | Obrigatório | Exemplo |
| --- | --- | --- |
| document | sim | Certidão federal |
| file | sim | certidao-federal.pdf |
| issuedAt | sim | 2026-05-27 |
| validUntil | sim | 2026-11-23 |
| portal | não | Receita Federal |
| note | não | Sem pendências |

### Snapshot final Solv

| Campo | Obrigatório | Exemplo |
| --- | --- | --- |
| snapshotAt | sim | 2026-06-11T23:50:00-03:00 |
| solvUser | sim | contato@example.com |
| status | sim | revisado antes do SUBMETER |
| attachments | sim | proposta.pdf, plano-teste.pdf |
| protocolOrReceipt | não | protocolo recebido após envio |

## Política de gravação

- Preview é o padrão: `POST` sem `write: true` não grava arquivo.
- `write: true` com `writeMode: "all_ready"` só grava quando o pacote inteiro está `writeReady=true`.
- `write: true` com `writeMode: "ready_only"` grava apenas arquivos já validados, mantendo pendências abertas sem liberar Solv.
- Arquivo existente não é sobrescrito sem `overwrite: true`.
- O endpoint não gera PDFs assinados; cartas/atestados continuam dependendo dos documentos reais.
- Após gravação, rodar `/api/proposal/external-evidence/kit` e `/api/proposal/solv-dry-run`.

## Runbook

- Preencher dados reais no payload estruturado; não usar exemplos como evidência final.
- Enviar `POST /api/proposal/external-evidence/intake` para preview e corrigir issues.
- Enviar novamente com `write: true` e `writeMode: "ready_only"` para gravar evidências prontas, ou `writeMode: "all_ready"` para exigir pacote completo.
- Anexar PDFs externos de cartas/atestados separadamente como `capability-letter-1.pdf` a `capability-letter-3.pdf`.
- Salvar snapshot final do Solv depois de preencher o formulário real.