Sistema de Transferência de Materiais Entre Filiais — Orquestrador de workflow para processos de transferência baseados em NFe, OS e OC.
Desenvolvido por ness.
Repositório: https://github.com/resper1965/nTransfer
O Sistema de Transferência de Materiais Entre Filiais é uma rotina adicional (camada complementar) que orquestra, registra, audita e notifica o processo de transferência de materiais entre filiais de uma organização.
O fluxo de transferência de materiais envolve múltiplas áreas (contratos, fiscal, administrativo de filial, fábrica/inspetor, fabricante, financeiro) e depende de etapas coordenadas com documentos fiscais (NFe/XML/DANFE), vínculos entre Ordem de Serviço (OS), Ordem de Compra (OC) e Nota Fiscal Eletrônica (NFe).
Desafios comuns:
- Erros de vínculo entre OS, OC e NFe
- Falta de rastreabilidade de decisões e aprovações
- Processos travados por divergências não críticas
- Ausência de evidências obrigatórias (anexos)
- Falta de notificações em pontos críticos do fluxo
O sistema não substitui os ERPs existentes (RM, RM nFlow, Qive), mas organiza o trabalho através de:
- Orquestração de workflow — Gerencia estados e transições dos três fluxos principais
- Vínculo inteligente — Conecta OS, OC e NFe com tratamento de divergências
- Auditoria completa — Registra todas as decisões, aprovações e transições
- Painéis operacionais — Fila de trabalho por papel (fiscal, administrativo, gestor)
- Notificações automáticas — E-mails em pontos críticos do processo
- Gates obrigatórios — Garante anexos e validações antes de avançar
O sistema suporta três fluxos operacionais:
- F1: Compra Direta — Fluxo completo de fabricação até entrega
- F2: Entrega Futura (mãe) — Faturamento antecipado sem atualização de estoque
- F3: Entrega Futura (filha) — Remessa efetiva após entrega futura
- ✅ Reduzir erros operacionais de vínculo OS/OC/NFe
- ✅ Aumentar rastreabilidade ponta a ponta (quem fez o quê, quando, por quê)
- ✅ Assegurar gates obrigatórios (ex.: anexo obrigatório na entrada destino)
- ✅ Diminuir retrabalho via painéis de pendência e notificações
- Backend: .NET 8 (Clean Architecture)
- Banco de Dados: PostgreSQL
- API: RESTful (OpenAPI 3.0.3)
- Integração: Qive ↔ RM (stub inicial, integração real via TBD-01)
Estes documentos são fonte única para seus domínios. Qualquer alteração deve começar aqui:
docs/specs/transferencia-materiais/workflow-states.md— Mapeamento por fluxo e regra de consistênciadocs/data-models/data-model.md—WorkflowStatuscanônico (Seção 2.2)docs/contracts/openapi.yaml—components/schemas/WorkflowStatus(deve ser idêntico)
docs/data-models/data-model.md— Entidades, campos, constraints, relacionamentos e índices
docs/contracts/auditoria-eventos.md— Catálogo deeventType+ payload mínimo por eventodocs/contracts/openapi.yaml—AuditoriaEventType+AuditoriaEvento
docs/contracts/email-templates.md— Templates de e-mail (conteúdo/variáveis)docs/OPERATIONS.md— Disparos/destinatários/regras de envio (Seção "2. Notificações por E-mail")
A documentação completa do projeto está em docs/:
- Índice Completo — Todos os artefatos organizados
- Guia de Desenvolvimento — Setup local, comandos, testes (.NET 8)
- Arquitetura — Arquitetura técnica e componentes
- Operação — Painéis, notificações, auditoria
- PROJECT_MAP — Visão geral e objetivos
- SPEC — Requisitos funcionais, regras de negócio, RNF
- PLAN — Plano de implementação
- TASKS — Tarefas acionáveis
- TBD — Pendências e decisões
- OpenAPI — Especificação completa da API
- Data Model — Modelo de dados completo
- Workflow States — Estados canônicos
- Workflow Transitions — Transições documentadas
- Diagramas — Fluxos e estados (Mermaid)
- .NET SDK 8.0 ou superior
- Docker + Docker Compose (para Postgres e Mailpit)
- Make (opcional, mas recomendado)
- Git (>= 2.40)
Para mais detalhes, consulte o Guia de Desenvolvimento.
- Documentação Completa — Índice de toda a documentação do projeto