Blueprint¶
Domínios¶
| Domínio | Responsabilidade |
|---|---|
| Patrimônio | Categoria, identificação, dados de aquisição, estado e QR Code do ativo. |
| Localização | Unidade, setor e histórico de alocação do ativo. |
| Inventário | Rodada, bipagens, escopo, divergências e fechamento. |
| Integração ERP | Consulta somente leitura de Centro de Custo, com cache e fallback. |
| Contas e auditoria | Usuários, grupos, permissões e log duplo. |
Fluxo de cadastro e localização¶
- O operador registra um ativo manualmente ou por importação CSV e o associa a uma categoria.
- A aplicação gera um código patrimonial/QR Code para localizar a ficha do ativo.
- O usuário pode associar Centro de Custo retornado pelo ERP quando a integração estiver disponível.
- Atribuições, transferências, empréstimos e devoluções passam por
MovimentacaoService. - Cada evento guarda setor e responsável de origem/destino, data, motivo e usuário que registrou; o serviço atualiza a localização/responsável corrente do ativo.
Fluxo de inventário¶
- Um usuário autorizado abre uma rodada geral, por unidade ou por setor.
- O operador lê o QR Code do ativo e registra em qual setor foi encontrado.
- A leitura é idempotente por par rodada/ativo e valida o escopo da rodada.
- O fechamento cria itens para ativos esperados e não encontrados, congelando a evidência usada no relatório.
- O relatório separa encontrados no local, encontrados em local diferente e não encontrados; pode ser exportado em PDF ou Excel.
Princípios preservados¶
- O setor e o responsável atuais do ativo só são atualizados pelo serviço de movimentação.
- O inventário usa QR Code como identificador, mas também permite resolução pelo UUID ou código patrimonial no fluxo interno.
- O vínculo de Centro de Custo não deve impedir o salvamento quando o ERP estiver indisponível.
Referências¶
- Estrutura funcional
- Database
- Serviços:
apps/localizacao/services.py,apps/inventario/services.pyeapps/integracao_erp/client.py.