How leonardodavinci2049/erp-api-server-winerp-v1 works
WinERP is an early-stage NestJS API for desktop-facing ERP applications. Its implemented workflows authenticate brand and supplier requests, delegate business operations to services that build SQL, execute queries against MySQL/MariaDB, and shape database results into API responses. The repository also includes a static root page and a taxonomy module, though the README identifies brand management as the current business module. The map follows documented behavior and indexed references; unsampled modules are represented only where the tree or README establishes their role.
Main entry points: brand.service.ts Brand operations · supplier.service.ts Supplier operations · app.module.ts App module · main.ts NestJS HTTP app
Components 19
HTTP API
- NestJS HTTP app
src/main.ts - App module
src/app.main/app.module.ts - Brand routes
src/brand/brand.controller.ts - Supplier routes
src/supplier/supplier.controller.ts - Static root page
pageroot
Business Operations
- Brand operations
src/brand/brand.service.ts - Brand request DTOs
src/brand/dto - Brand SQL builders
src/brand/query - Supplier operations
src/supplier/supplier.service.ts - Supplier request DTOs
src/supplier/dto - Supplier SQL builders
src/supplier/query - Taxonomy endpoint
src/taxonomy/taxonomy.controller.ts
Shared Services
- API key guard
src/core/guards/auth.guard.ts - Result processing
src/core/process-result - Environment config
src/core/config/envs.ts
Database Access
- SQL operations
src/db-operation/db-operation.service.ts - MySQL pool
src/db-connection/db-connection.service.ts
Other components
- Desktop client
- MySQL / MariaDB
Connections 21
- Desktop client → NestJS HTTP app: sends requests
- NestJS HTTP app → App module: starts module
src/main.ts - App module → Brand routes: registers routes
src/app.main/app.module.ts - App module → Supplier routes: registers routes
src/app.main/app.module.ts - Brand routes → API key guard: guards routes
src/brand/brand.controller.ts - Supplier routes → API key guard: guards routes
src/supplier/supplier.controller.ts - Brand routes → Brand operations: dispatches operations
src/brand/brand.controller.ts - Supplier routes → Supplier operations: dispatches operations
src/supplier/supplier.controller.ts - Brand operations → Brand SQL builders: builds SQL
src/brand/brand.service.ts - Brand operations → Brand request DTOs: uses DTOs
src/brand/brand.service.ts - Brand operations → SQL operations: executes SQL
src/brand/brand.service.ts - Brand operations → Result processing: formats results
src/brand/brand.service.ts - Supplier operations → Supplier SQL builders: builds SQL
src/supplier/supplier.service.ts - Supplier operations → Supplier request DTOs: uses DTOs
src/supplier/supplier.service.ts - Supplier operations → SQL operations: executes SQL
src/supplier/supplier.service.ts - Supplier operations → Result processing: formats results
src/supplier/supplier.service.ts - SQL operations → MySQL pool: acquires connections
src/db-operation/db-operation.service.ts - MySQL pool → Environment config: reads settings
src/db-connection/db-connection.service.ts - MySQL pool → MySQL / MariaDB: creates pool
src/db-connection/db-connection.service.ts - NestJS HTTP app → Static root page: serves root
- App module → Taxonomy endpoint: registers endpoint