Monetizando Invest — Dev Docs

Aparência

Template PAV ​

O PAV (Plano de Ação Vigiado) é o documento obrigatório antes de qualquer alteração de código ou infra.

→ Ver template completo no GitHub

Estrutura mínima ​

markdown
# Plano de Ação Vigiado (PAV)

**Data/Hora:** YYYY-MM-DD HH:MM:SS
**Ação:** [Descrição curta]
**Status:** PENDENTE_APROVACAO
**GitHub Issue:** #N — https://github.com/FlorencaDigital/.../issues/N

## 1. Diagnóstico
[Evidências reais: código, log, output de comando]

## 2. Impacto
[Quais componentes são afetados]

## 3. Cross-Repository Impact Analysis
[Tabela com todos os repos — obrigatório]

## 4. Solução
[Menor conjunto de mudanças]

## 5. Scope Fence
[O que NÃO será feito — obrigatório]

## 6. Implantação End-to-End
[Arquivos, testes, validação]

Ciclo de vida ​

mermaid
stateDiagram-v2
    [*] --> PENDENTE_APROVACAO : PAV escrito
    PENDENTE_APROVACAO --> EM_EXECUCAO : usuário digita APROVADO
    PENDENTE_APROVACAO --> PENDENTE_APROVACAO : revisão solicitada
    EM_EXECUCAO --> EXECUTADO_COM_SUCESSO : seções 8-10 preenchidas
    EM_EXECUCAO --> FALHA : obstáculo não previsto
    FALHA --> PENDENTE_APROVACAO : PAV Adendo
    EXECUTADO_COM_SUCESSO --> [*]

Onde salvar ​

monetizando-governanca/docs/pav/<timestamp>-<ID>.md

Exemplo: docs/pav/20260424-110000-onboarding-portal.md

Documentação obrigatória ao encerrar ​

Antes de considerar concluído:

  1. PAV com seções 8-10 preenchidas (auditoria, evidências, resultado)
  2. Wiki Status atualizada
  3. GitHub Issue fechada
  4. Tudo commitado e pushed — o que não está no Git não existe

Monetizando Invest