mirror of
https://github.com/melgarafael/DeskcommCRM.git
synced 2026-10-02 01:28:34 +08:00
docs(extensoes): nenhum link aponta para a pasta interna de decisões
`Decisão Implementações/` não é versionada no repositório público, e doze links markdown apontavam para ela — em `triagem/TRIAGEM.md`, `docs/research/extensoes/` e `evidence/extensoes/README.md`. Na branch de trabalho eles resolviam, porque a pasta existe no disco; no PR #1016 viraram 404 para qualquer leitor, e o do `TRIAGEM.md` reprovou o `verify` (`documentacao-aponta-para-o-que-existe`, que vigia só os documentos de autoridade — os outros onze estavam igualmente mortos, sem gate que os visse). Cada link vira citação pelo nome, como a `main` já faz com essa pasta. Na triagem, a citação aponta a régua pública que vale para PR: `docs/doctrine/extensoes.md`. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -6,9 +6,9 @@
|
||||
|
||||
## Contratos aprovados que delimitam o reaproveitamento
|
||||
|
||||
O [PROG-017](../../../Decisão%20Implementações/PROG-017%20—%20Extensões%20—%20arquitetura%20e%20contratos.md), §§4–6 e 12, separa catálogo central, artefato local admitido, ativação/configuração da organização e ação autorizada do ator. Catálogo tem aplicação/banco próprios; não recebe contatos/conversas nem executa na VPS. Pacote tem identidade incluindo origem/publicador, versão/digest exatos e contrato do host. Metadado obrigatório desconhecido impede ativação.
|
||||
O PROG-017 *(documento interno de decisão)*, §§4–6 e 12, separa catálogo central, artefato local admitido, ativação/configuração da organização e ação autorizada do ator. Catálogo tem aplicação/banco próprios; não recebe contatos/conversas nem executa na VPS. Pacote tem identidade incluindo origem/publicador, versão/digest exatos e contrato do host. Metadado obrigatório desconhecido impede ativação.
|
||||
|
||||
O [PROG-018](../../../Decisão%20Implementações/PROG-018%20—%20Extensões%20—%20provas%20e%20sequência%20de%20entrega.md), marco 2, exige serviço separado, pacote realmente baixado, instalação/configuração pela tela, uso em A sem efeito em B e desativação/recuperação. O primeiro host pode exigir uma release para introduzir esses contratos; o pacote de prova deve ser publicado depois dessa imagem e instalado sem recompilá-la.
|
||||
O PROG-018 *(documento interno de decisão)*, marco 2, exige serviço separado, pacote realmente baixado, instalação/configuração pela tela, uso em A sem efeito em B e desativação/recuperação. O primeiro host pode exigir uma release para introduzir esses contratos; o pacote de prova deve ser publicado depois dessa imagem e instalado sem recompilá-la.
|
||||
|
||||
## Mapa de reutilização
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
Escopo: marco 2; pesquisa documental, sem implementação, serviços, testes ou SQL executados.
|
||||
|
||||
Autoridade: [PROG-017](<../../../Decisão Implementações/PROG-017 — Extensões — arquitetura e contratos.md>) §§5–6, 9–11 e [PROG-018](<../../../Decisão Implementações/PROG-018 — Extensões — provas e sequência de entrega.md>) marco 2/P0-03, 04, 07, 12, 13/P1-22. AGENTS/CLAUDE lidos; números experimentais anteriores não são prova desta integração.
|
||||
Autoridade: PROG-017 *(documento interno de decisão)* §§5–6, 9–11 e PROG-018 *(documento interno de decisão)* marco 2/P0-03, 04, 07, 12, 13/P1-22. AGENTS/CLAUDE lidos; números experimentais anteriores não são prova desta integração.
|
||||
|
||||
## O que já existe e o que sua evidência permite afirmar
|
||||
|
||||
|
||||
@@ -8,10 +8,10 @@ Referência de código: `25edc35b05c8d522e2bfe313863e6003f47b8f56`, obtida de `o
|
||||
|
||||
| Documento | Conteúdo |
|
||||
|---|---|
|
||||
| [PROG-016 — Plano e andamento](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-016%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20plano%20e%20andamento.md) | Contexto, achados, estado da entrega e próximos passos |
|
||||
| [PROG-017 — Arquitetura e contratos](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-017%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20arquitetura%20e%20contratos.md) | Síntese das alternativas e desenho recomendado |
|
||||
| [PROG-018 — Provas e sequência de entrega](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-018%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20provas%20e%20sequ%C3%AAncia%20de%20entrega.md) | Experimentos de viabilidade e jornadas planejadas em tela |
|
||||
| [DEC-004 — Publicação, incidentes e métricas](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/DEC-004%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20publica%C3%A7%C3%A3o%2C%20incidentes%20e%20m%C3%A9tricas.md) | Escolhas de produto com alternativas, recomendação e espaço de resposta |
|
||||
| PROG-016 — Plano e andamento *(documento interno de decisão)* | Contexto, achados, estado da entrega e próximos passos |
|
||||
| PROG-017 — Arquitetura e contratos *(documento interno de decisão)* | Síntese das alternativas e desenho recomendado |
|
||||
| PROG-018 — Provas e sequência de entrega *(documento interno de decisão)* | Experimentos de viabilidade e jornadas planejadas em tela |
|
||||
| DEC-004 — Publicação, incidentes e métricas *(documento interno de decisão)* | Escolhas de produto com alternativas, recomendação e espaço de resposta |
|
||||
|
||||
## Três investigações distintas e paralelas
|
||||
|
||||
@@ -38,11 +38,11 @@ O diagrama da proposta descreve responsabilidades futuras. Ele não foi publicad
|
||||
| [06 — Estado e dados](06-bancada-estado-e-dados.md) | Compatibilidade real de tarefa antiga, RLS da fixture, desativação e anonimização |
|
||||
| [07 — Perfil de contêiner](07-perfil-comparacao-executor.md) | Imagem fixa, rodada Docker real, limites exercitados e comparação delimitada |
|
||||
|
||||
O [runbook da bancada](../../../experiments/extensoes/README.md) permite repetir os experimentos em ambiente próprio. O [PROG-020](../../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-020%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20resultados%20da%20bancada.md) é a síntese para acompanhar a execução sem ler o código.
|
||||
O [runbook da bancada](../../../experiments/extensoes/README.md) permite repetir os experimentos em ambiente próprio. O PROG-020 *(documento interno de decisão)* é a síntese para acompanhar a execução sem ler o código.
|
||||
|
||||
## Primeira integração ao CRM
|
||||
|
||||
A branch `feat/extensoes-declarativas-20260914` preserva a bancada e incorpora `origin/main` em `60079eb5`. O [PROG-021](<../../../Decisão Implementações/PROG-021 — Extensões — primeira integração.md>) acompanha implementação e provas do marco 2. O [contrato v1](../../specs/extensoes-declarativas-v1.md) define o pacote declarativo, admissão e jornada.
|
||||
A branch `feat/extensoes-declarativas-20260914` preserva a bancada e incorpora `origin/main` em `60079eb5`. O PROG-021 *(documento interno de decisão)* acompanha implementação e provas do marco 2. O [contrato v1](../../specs/extensoes-declarativas-v1.md) define o pacote declarativo, admissão e jornada.
|
||||
|
||||
| Investigação | Foco desta integração |
|
||||
|---|---|
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Capturas de 14/set/2026, somente dados sintéticos. Extraídas da rodada final de cinco jornadas Playwright em Chromium e inspecionadas pelo agente principal. São provas da interface experimental; não mostram um marketplace ou a jornada de extensões integrada ao CRM.
|
||||
|
||||
O navegador iniciou as três provas reais, comparou o resultado exibido com o backend e o arquivo persistido, recarregou a tela e percorreu ambiente ausente, perda de conexão e resposta perdida depois do aceite. A revisão adicional conferiu os controles do processo e a reconciliação da solicitação. Resultados, limites e próximos passos no [PROG-020](../../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-020%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20resultados%20da%20bancada.md).
|
||||
O navegador iniciou as três provas reais, comparou o resultado exibido com o backend e o arquivo persistido, recarregou a tela e percorreu ambiente ausente, perda de conexão e resposta perdida depois do aceite. A revisão adicional conferiu os controles do processo e a reconciliação da solicitação. Resultados, limites e próximos passos no PROG-020 *(documento interno de decisão)*.
|
||||
|
||||
## Três resultados reais na tela
|
||||
|
||||
|
||||
+1
-1
@@ -137,7 +137,7 @@ latência que ela existe para matar.
|
||||
|
||||
Para uma mudança de comportamento, registre o destino e a razão antes da reconciliação. A lei
|
||||
é a [doutrina de extensões](../docs/doctrine/extensoes.md) (item 18 do DoD); o critério foi
|
||||
aprovado no [PROG-017, seção 2](../Decis%C3%A3o%20Implementa%C3%A7%C3%B5es/PROG-017%20%E2%80%94%20Extens%C3%B5es%20%E2%80%94%20arquitetura%20e%20contratos.md).
|
||||
aprovado no PROG-017, seção 2 (documento interno de decisão, fora do repositório público; a régua que vale para PR está em [`docs/doctrine/extensoes.md`](../docs/doctrine/extensoes.md)).
|
||||
O núcleo precisa continuar útil com zero extensões; nichos podem acrescentar capacidades sem
|
||||
determinar a operação de todas as instalações.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user