Documentação Consolidada do Sistema NexAgroCore
Gerado em: 2026-09-24T15:14:14-03:00 Commit de referência: 30084ba
Esta pasta consolida a documentação técnica do backend NexAgroCore a partir do código fonte real. O objetivo é servir como ponto único para consulta de módulos, API, contratos e glossário de dados.
Arquivos
| Arquivo | Conteúdo |
|---|---|
| GLOSSARIO_DADOS_COMPLETO.html | Glossário completo das entidades expostas no AppDbContext, com DbSet, campos, chaves candidatas e navegações. |
| API_REFERENCIA_COMPLETA.html | Referência de rotas por controller, incluindo CRUD herdado, parâmetros, body, retorno e autorização inferida. |
| CONTRATOS_DTO.html | Inventário dos DTOs usados nos contratos de entrada e saída. |
Convenções Gerais da API
- Base URL lógica:
/api/..., com endpoints públicos mínimos/healthe/api/health. - Autenticação principal: JWT Bearer (
Authorization: Bearer {token}). Em ambiente de desenvolvimento também há suporte a DeveloperToken quando configurado. - Controllers CRUD herdam de
CrudControllerBase<TCreateDto,TUpdateDto,TResponseDto>e expõemGET,GET {id},POST,PUT {id}eDELETE {id}. - Respostas de sucesso usam
ApiResponse<T>comsuccess,message,code,dataeerrors. - Erros tratados pelo middleware usam envelope
{ error: { code, message, details, current } }. - Em
Development, Swagger é publicado porUseSwagger()eUseSwaggerUI(); fora de desenvolvimento, a documentação estática pode ser consultada em/documentacao/.
Multiempresa e Tenant
BaseEntitydefineId,OrganizacaoId,EmpresaId,CreatedAt,UpdatedAteIsActive.- A maioria das consultas recebe ou infere
organizacaoIdeempresaIdpor query/header/claims, dependendo do serviço. - Tabelas de catálogo global podem não depender de empresa; tabelas operacionais tendem a carregar
OrganizacaoIde/ouEmpresaId.
Módulos Mapeados
| Módulo | Entidades | Endpoints |
|---|---|---|
| Acesso e organização | 16 | 62 |
| CRM e relacionamento | 19 | 89 |
| Compras e suprimentos | 12 | 57 |
| Financeiro | 27 | 71 |
| Fiscal e contabilidade | 50 | 165 |
| Florestal | 37 | 136 |
| IA | 15 | 46 |
| Ordem de serviço | 8 | 34 |
| Outros | 21 | 82 |
| Produtos e estoque | 27 | 155 |
| RH | 13 | 13 |
| Vendas e comercial | 28 | 114 |
Escopo desta geração
- Entidades DbSet:
273. - Classes de modelo lidas:
333. - DTOs lidos de
DTOs/:707. - Controllers lidos:
148. - Endpoints mapeados:
1024.
Observação: nomes físicos finais de tabela podem receber convenções e ajustes de migrations. No glossário, o campo DbSet/tabela lógica usa o nome exposto no AppDbContext.