Pular para o conteúdo
Veritas
  • Nada com esse termo. Tente o nome de uma lib ou de uma stack.

Títulos, descrições e seções de todas as skills.

Arquivo de apoio da skill clickup · relatorio.md

Relatório de fechamento

Vai como comentário na própria task, quando o trabalho termina. É o que a pessoa lê para decidir se move o status — e ela vai decidir com base nele, não no código.

A regra que vale mais que o formato

Critério não atendido vira ❌ escrito, nunca omissão. Um relatório que só lista o que deu certo é pior que nenhum: ele faz a falha parecer ausência de assunto. Todo critério do card aparece, com o resultado que teve.

Segunda regra: não aumente o escopo em silêncio. Se você mexeu em algo que o card não pedia, isso vai em "Fora do escopo do card", com o motivo.

Terceira, e sem exceção: nenhum dado pessoal real no relatório. O card é lido por muita gente. Cliente é cliente_id=4821, nunca nome, CPF ou telefone; exemplo de teste é fictício (veritas:lgpd).


Formato

## <Título da task>

**O que mudou.** Dois ou três parágrafos em português de gente, não em nome de
função. Quem lê pode não ser quem programa.

**Causa raiz.** O que estava errado de verdade, não o sintoma que o card
descreveu. Se a correção foi no lugar onde todos os chamadores passam, diga —
é a diferença entre consertar uma vez e consertar um caso.

### Critérios de aceite

| # | Critério | Resultado |
|---|---|---|
| 1 | Somente pago entra na conta | ✅ `services.py:782` filtra por `GET_PAIDS_PLOTS_STATUS()` |
| 2 | Recorte anual comprovado | ✅ teste `test_recibo_virada_de_ano` |
| 7 | Permissão e URL direta | ❌ não feito — ver Pendências |

### Arquivos

- `crm/customers/services.py:763-799` — filtro de status no queryset `general`
- `crm/customers/views.py:2424` — PDF recalcula a partir de `(cliente, ano)`

### Como testar

Passo a passo que alguém que não escreveu o código consegue seguir.

```bash
docker compose exec web uv run manage.py test crm.customers

Pendências

O que ficou de fora e por quê. Sem isto o relatório vira promessa.

Fora do escopo do card

O que foi mexido além do pedido, e o motivo.

Observado, fora do escopo

O que você viu e não mexeu: código morto, padrão inconsistente, algo que uma remodelação resolveria. Falha de segurança vai no topo. Em sistema legado (modo conservar da veritas:projeto-existente), é aqui que a melhoria que você faria vira registro, em vez de mudança.

Modo: conservar ou remodelar, e se foi declarado ou assumido.

PR:


---

## Ajustes por tamanho

**Task pequena** (uma correção, um critério): corte a tabela e escreva em prosa.
O que não se corta nunca: causa raiz, como testar, e o ❌ do que não foi feito.

**Task grande, ou que vira referência** (uma migração, uma integração inteira):
o comentário continua sendo obrigatório, e além dele cabe uma página no doc de
registro do projeto — o padrão é `<Projeto> — Registro de correções`, uma
seção por sintoma:

```markdown
## <O sintoma, como a pessoa de negócio descreveria>

**Problema.** ...

**Correção.** ...

## ⚠️ Pendência que bloqueia a estreia

Página em doc só quando a pessoa pedir. O comentário é o padrão.


Depois de postar

Diga em uma linha que o relatório foi postado e que o status espera a pessoa. Não mova o card. Não ofereça mover.

Ver no GitHub →