backend-logistica

---

Visão geral

API REST que expõe os recursos de um sistema de logística (usuários, níveis de acesso, MFA e módulos de domínio). Construída com foco em separação de responsabilidades, validação de entrada e autenticação stateless.

Stack

• Framework: NestJS 9 (Node.js + TypeScript)
• ORM: Prisma 4
• Banco: MySQL
• Auth: JWT + Passport + bcrypt + MFA por código temporário
• Validação: class-validator / class-transformer
• Container: Dockerfile pronto para build

Estrutura

code/
├── prisma/                  # schema.prisma + migrations
└── src/
    ├── database/            # acesso a dados (PrismaService)
    ├── helpers/             # utilitários transversais
    ├── infraestructure/     # camadas de infra (auth, mailer, etc.)
    └── modules/             # módulos de domínio (users, nivel, mfa, ...)

Como rodar

# 1. Instalar dependências
cd code && npm install

# 2. Configurar .env (DATABASE_URL, JWT_SECRET, etc.)
cp .env.example .env

# 3. Rodar migrações
npx prisma migrate dev

# 4. Modo dev
npm run start:dev

API sobe em http://localhost:3000.

Docker

docker build -t backend-logistica .
docker run -p 3000:3000 --env-file .env backend-logistica

Status

Projeto formativo (2023). Mantido público como referência de stack NestJS/Prisma com autenticação completa.