docs: revisa a documentação com base no que a aplicação faz hoje

- README: o que a aplicação faz, migrations, BP_WEB_PORT e testes com
  go.sum/package-lock.json (sem go mod tidy)
- ARQUITETURA: esquema real (00001 a 00003), rotas que faltavam, Compose
  e imagens atuais, cadeia de proxies, retenção, situação dos testes,
  decisões 30 a 33 e estado da implementação
- DEPLOY: cópia por tar, BP_WEB_PORT em todas as etapas e atualização
  para a versão com exclusão de contas
- MANUAL: papéis do owner e navegação por ano nos feriados
- openapi.yaml: DELETE /accounts/{id} e regras da conta restrita
- Dockerfiles: comentários sobre go.sum e package-lock.json

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-29 22:20:25 -03:00
parent b35e1a7d69
commit 61fde19133
7 changed files with 266 additions and 195 deletions

View File

@@ -10,6 +10,9 @@ info:
`bp_csrf` e um `Origin` igual a BP_PUBLIC_URL.
`x-min-role` indica o papel mínimo: viewer < admin < owner.
Conta restrita (viewer com user_id): só vê e altera o próprio usuário em
/users/{id}*, recebe só os próprios dados em /users, /notifications e
/dashboard, e não acessa /audit, /settings nem /accounts (ARQUITETURA.md, 9.6).
Erros seguem application/problem+json (RFC 9457).
servers:
- url: /api/v1
@@ -558,6 +561,14 @@ paths:
responses:
"200": { description: OK }
"409": { $ref: "#/components/responses/Problem" }
delete:
summary: Exclui a conta e as sessões dela; a auditoria mantém o nome (actor_account_name)
description: Recusa excluir a própria conta (INVALID_STATE) e o último owner ativo (LAST_OWNER).
x-min-role: owner
responses:
"204": { description: Excluída }
"404": { $ref: "#/components/responses/Problem" }
"409": { $ref: "#/components/responses/Problem" }
/accounts/{id}/reset-password:
parameters: [{ $ref: "#/components/parameters/id" }]
post: