# CD9 System
> Sistema web de gerenciamento logístico com backend em PHP Laravel e frontend em React Next.js.

## Core Files & Estrutura
- `cd_back/`: Repositório do Backend. 
  - Desenvolvido em PHP com framework Laravel. 
  - Contém Controllers (ex: CDEstoqueController, CDAnexoController), Models de banco de dados e rotas (/routes).
- `cd_front/`: Repositório do Frontend.
  - Desenvolvido em ReactJS com framework Next.js.
  - Contém a interface do usuário, estado global e integrações com as APIs (ex: `src/` directory).

## Key Concepts
- **CIV (Controle de Identificação de Veículos):** A entidade central para rastreamento de entrada e saída. Ancorado a um lote de operações logísticas.
- **CD Estoque:** O módulo de estoque relaciona a movimentação de produtos e lotes ao respectivo CIV (entrada gera estoque, saída filtra do estoque disponível correspondente).
- **Validação de XML:** Ferramenta crítica na Análise CIV. Ao realizar upload de arquivos `.xml` de NFe, o backend verifica se a tag `<refNFe>` bate com a chave primária salva do CIV, gravando o `status_validacao` no banco e refletindo alertas visuais na tabela no frontend.
- **Gestão de Contratos e Perfis:** O sistema avalia perfis e status de entidade para exibir botões de interação (como "Reabrir" um contrato vigente mediante a uma validação).

## Dev Notes
- O projeto consome JWT para autenticação do lado da API.
- Recomenda-se forte consistência visual no frontend (Tailwind/Material ou custom UI) através de seus componentes criados internamente.
- Antes de subir para ambiente de produção, certifique-se que o `npm run build` na pasta `cd_front` consiga apontar corretamente para a URL do backend de prod no `.env.production`.