Governança¶
Autenticação e papéis¶
Usuários autenticam pela aplicação Django. As migrations criam os grupos Leitura, Operador e Administrador e distribuem permissões por app:
| Grupo | Acesso previsto |
|---|---|
| Leitura | Consulta telas e API. |
| Operador | Consulta e executa permissões de criação/alteração necessárias ao trabalho diário, incluindo movimentação e inventário. |
| Administrador | Permissões de operador e ações administrativas, incluindo exclusão conforme a matriz. |
As views usam LoginRequiredMixin/PermissionRequiredMixin ou decorators; a API aplica ModelPermissions, que exige view_<model> também para GET. A auditoria do MVP testou a matriz de permissões nas rotas de domínio.
Auditoria das alterações¶
core.Log armazena usuário opcional, código de ação, descrição e data/hora. LogService persiste auditoria em banco e o sistema registra a operação no logger. Ações seguem 3 alteração, 4 inclusão, 5 exclusão, 6 importação e 7 exportação. Movimentação é preservada como entidade histórica; relacionamentos usam PROTECT quando excluir o ativo, setor ou unidade comprometeria o histórico.
Integração e dados externos¶
CoreFlow Assets mantém banco próprio. O Centro de Custo é consultado em tempo real pela API autenticada do CoreFlow ERP, com cache temporário; os dados do ERP não são replicados como tabelas locais. A API AssetGuard v1 é somente leitura e sua conta consumidora deve receber apenas o grupo Leitura.
Auditoria conhecida¶
A auditoria final de 18/09/2026 registrou 0 achados críticos e altos; corrigiu seis itens de média severidade e quatro de baixa severidade, incluindo respostas 500 a entradas inválidas, consulta N+1, elementos da UI e rolagem vertical. A API AssetGuard foi adicionada como escopo pós-MVP e permanece somente leitura.
Referências¶
- Matriz: migrations
apps/accounts/migrations/0002_seed_grupos.pyeapps/*/migrations/*seed_permissoes.py. - Auditoria:
documentacao/Auditoria de Fidelidade.md. - APIs