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:
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user