Architecture

Architecture

Smart ERP Next is a pnpm/Turbo monorepo.

Packages

Path	Responsibility
apps/api	NestJS REST API, business logic, database migrations
apps/web	Next.js PWA dashboard and storefront
packages/database	Drizzle schema, migrations, shared DB client
packages/shared	Shared constants, types, utilities
packages/types	Common TypeScript definitions
packages/utils	Helpers (currency, date, string, sanitize)
packages/validation	Zod schemas for domain models

API design

• API versioning via X-API-Version header and URL path (/api/v1/...).
• Global response format via ResponseFormatInterceptor.
• JWT access + refresh tokens; API keys for service integrations.
• Swagger/OpenAPI available at /api/docs when running locally.

See docs/adr/ for architecture decision records.