Skip to content

docs: restaura o PRD interno e o PRE_STATUS removidos em ca6047d - #19

Open
Garakis wants to merge 2 commits into
mainfrom
docs/restaura-prd-interno
Open

Garakis wants to merge 2 commits into
mainfrom
docs/restaura-prd-interno

Conversation

@Garakis

@Garakis Garakis commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Restaura os dois documentos removidos em ca6047d sob a justificativa de duplicados. Os dois casos são diferentes, e por isso foram tratados de formas diferentes.

O PRD interno não era duplicata

Das 781 linhas, 257 não existem na versão do cliente — um terço do documento.

Seção Linhas Está na versão do cliente?
7. Modelo de domínio 125 não
16. Dependências do cliente 49 não
11. Modelo de dados (esboço) 35 não
15. Perguntas abertas para o cliente 14 parcial
14. Riscos 13 não
17. Pendências internas 12 não
13. Definição de pronto 9 não

São exatamente as partes mantidas fora da versão externa de propósito: risco, licença do n8n, requisito de hardware, nome de modelo e o que ainda depende de resposta da PRO4TECH. A versão do cliente é uma redução deliberada, não um espelho.

Por que sumiu: o documento estava órfão. Nenhum arquivo apontava para ele, e o índice do README listava só o PRD-PRO4TECH.md sob o rótulo genérico "PRD — Product Requirements Document". Quem viu dois arquivos com PRD no nome e só um referenciado tinha motivo para achar que era cópia.

Por isso este PR não só restaura: põe as duas versões no índice, com a diferença escrita. Restaurado em docs/PRD.md, acompanhando o achatamento de docs/PRD/ que o mesmo commit fez; o link do Kick-off foi ajustado e resolve.

O PRE_STATUS era, e por isso voltou diferente

Aqui a justificativa tinha fundamento: o PLANO_DE_TAREFAS ganhou uma coluna Situação Técnica que absorveu a função da página.

A versão removida dizia que PRE-02, PRE-03, PRE-04 e PRE-06 estavam em andamento e que PRE-09 estava bloqueada por Docker. Hoje o plano registra oito das nove como concluídas. Recolocar o arquivo como estava seria devolver informação errada ao repositório.

A página volta com o estado atual, conferido contra as migrations 001004, o contrato OpenAPI, os cinco jobs da CI, o spike de embeddings e os PRs #13 e #14. E diz na primeira linha que a fonte é o plano, com link nos dois sentidos — sem isso as duas divergem de novo em duas semanas.

Uma ressalva que vale a leitura

O PRE-01 é "Registrar as decisões Q1–Q5 com a PRO4TECH" e consta concluído, com a evidência "decisões registradas no backlog v1.1 e quadro".

Só que Q1, Q4 e Q5 continuam na tabela de pendências do backlog, sem resposta do cliente:

  • Q4 — existe um nível "Projeto" acima do Épico? Altera PBI-01.1.1 e a raiz da hierarquia.
  • Q5 — padrão de identificação de itens da PRO4TECH. Altera a convenção de códigos.
  • Q1 — a plataforma é ferramenta principal de especificação ou repositório consultivo?

Registrar a pergunta não é ter a decisão. PRE-02 e PRE-05 dependem do PRE-01 e estão avançando sobre uma premissa. Ficou anotado como ressalva na página, não como reprovação — quem marcou pode ter contexto que eu não tenho.

Fora deste PR

docs/planning/TRELLO_AUTOMACAO.md caiu no mesmo commit e continua removido. Não avaliei se o scripts/trello-sync.mjs o torna redundante; a decisão é do time.

O PRD interno foi removido em ca6047d, junto de PRE_STATUS.md e
TRELLO_AUTOMACAO.md, sob a justificativa de documento duplicado. Não era:
das 781 linhas, 257 não existem na versão do cliente — um terço do
documento.

O que só existe aqui: modelo de domínio (125 linhas), dependências do
cliente (49), modelo de dados (35), perguntas abertas (14), riscos (13),
pendências internas (12) e a definição de pronto (9). São justamente as
partes que foram mantidas fora da versão externa de propósito, porque
discutem risco, licença, hardware e nome de modelo.

Restaurado em docs/PRD.md para acompanhar o achatamento de docs/PRD/ que
o mesmo commit fez, com o link do Kick-off ajustado ao novo caminho.

A causa da remoção foi o documento estar órfão: nenhum arquivo do
repositório apontava para ele, e o índice do README listava só a versão
do cliente sob o rótulo genérico "PRD". As duas agora aparecem no índice,
com a diferença explicada — senão a próxima limpeza o remove de novo.

PRE_STATUS.md e TRELLO_AUTOMACAO.md continuam removidos: decidir se
voltam é do time.
Removido em ca6047d junto do PRD interno. Aqui a justificativa de
duplicado tinha fundamento: o PLANO_DE_TAREFAS ganhou uma coluna
Situação que absorveu a função desta página.

Por isso não foi restaurado como estava. A versão removida dizia que
PRE-02, PRE-03, PRE-04 e PRE-06 estavam em andamento e que PRE-09 estava
bloqueada por Docker — cinco linhas que hoje contradizem o plano, onde
oito das nove PREs constam concluídas. Recolocar aquilo seria devolver
informação errada ao repositório.

A página volta com o estado atual, conferido contra as migrations, o
contrato OpenAPI, os jobs da CI, o spike de embeddings e os PRs #13 e
#14. E diz na primeira linha que a fonte é o plano, com link nos dois
sentidos: sem isso as duas divergem de novo em duas semanas.

Registra também a ressalva do PRE-01. Ele consta concluído sob a
evidência "decisões registradas no backlog e no quadro", mas Q1, Q4 e Q5
seguem na tabela de pendências do backlog sem resposta da PRO4TECH.
Registrar a pergunta não é ter a decisão, e PRE-02 e PRE-05 dependem
dela.
@Garakis Garakis changed the title docs: restaura o PRD interno removido em ca6047d docs: restaura o PRD interno e o PRE_STATUS removidos em ca6047d Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant