bigtux/duorigin-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add technical manual, sales manual, and architecture diagram

Browse Source
This commit is contained in:
bigtux
2026-02-09 11:56:08 -03:00
parent 4122dc6f3b
commit 1056c215df
6 changed files with 322 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
docs/ARQUITETURA.md Normal file
View File

@@ -0,0 +1,78 @@
# Arquitetura - DuOrigin v2
## Visão Geral
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ CLIENTE (Browser) │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Next.js Frontend (React) │ │
│ │ Port: 3000 │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Dashboard │ │ Producers │ │Declarations │ │ Maps │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────┬────────────────────────────────────────┘
│ REST API
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ NestJS Backend │
│ Port: 3001 │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ MODULES │ │
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ │ Auth │ │ Producers │ │Declarations│ │ Geo │ │ │
│ │ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ │
│ │ ┌───────────┐ ┌───────────┐ │ │
│ │ │ EUDR │ │ Reports │ │ │
│ │ │ API │ │ │ │ │
│ │ └───────────┘ └───────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
└──────────────────────────────┼──────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ PostgreSQL │ │ API EUDR UE │ │ Map Services │
│ (Prisma) │ │ (SOAP/WSDL) │ │ (Leaflet) │
│ │ │ │ │ │
│ • Users │ │ • Submit DDS │ │ • Tile layers │
│ • Producers │ │ • Check status │ │ • Geo validate │
│ • Declarations │ │ • Get feedback │ │ │
│ • Parcels │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
```
## Fluxo EUDR
```
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Cadastro │────▶│ Georrefe- │────▶│ Gerar │────▶│ Submeter │
│ Produtor │ │ renciamento │ │ Declaração │ │ à UE │
└─────────────┘ └─────────────┘ └─────────────┘ └──────┬──────┘
│
▼
┌─────────────┐
│ Compliance │
│ ✓ │
└─────────────┘
```
## Stack
```
┌─────────────────────────────────────────────────────────────────┐
│ STACK TECNOLÓGICO │
├─────────────────────────────────────────────────────────────────┤
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Next.js │ │ NestJS │ │ Prisma │ │PostgreSQL │ │
│ │ (Frontend)│ │ (Backend) │ │ (ORM) │ │ (DB) │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Leaflet │ │ JWT │ │ Tailwind │ │TypeScript │ │
│ │ (Maps) │ │ (Auth) │ │ (CSS) │ │ │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
*Diagrama gerado em 2026-02-09*