How abhinks151/veltrex_backend works
Veltrex is a multi-tenant MES API for CNC shop operations. Its user-facing workflow covers authentication and role checks, production resources and shifts, machine-job monitoring, and maintenance-ticket handling; administrators also manage versioned NC programs and subscriptions. NestJS controllers dispatch to application use cases, with Prisma-backed persistence and optional S3 file storage. The graph keeps documented capabilities even where implementation was not sampled; edges without direct excerpt evidence are omitted. The tree lists no fixture source despite the README mentioning fixture management.
Main entry points: prisma.service.ts PostgreSQL database · app.module.ts NestJS application · maintenance.controller.ts Maintenance tickets · nc-program.controller.ts NC programs
Components 22
API and access
- NestJS application
src/app.module.ts - Authentication
src/modules/auth/presentation - Role authorization
src/modules/auth/presentation/guards/roles.guard.ts
Shop operations
- Machine management
src/modules/machine - Jobs and parts
src/modules/job - Production shifts
src/modules/shift - Maintenance tickets
src/modules/maintenance/presentation/maintenance.controller.ts - Raw materials
src/modules/raw-material - Notifications
src/modules/notification
Programs and files
- NC programs
src/modules/ncProgram/presentation/nc-program.controller.ts - File storage
src/shared/infrastructure/storage/services/s3-storage.service.ts
Accounts and billing
- Tenant management
src/modules/tenant - User profiles
src/modules/profile - Subscriptions
src/modules/subscription - Razorpay payments
src/modules/payment/infrastructure/services/razorpay-gateway.service.ts - System administration
src/modules/super-admin
Shared infrastructure
- PostgreSQL database
src/shared/infrastructure/prisma/prisma.service.ts - Lookup settings
src/modules/lookup - Redis service
src/shared/infrastructure/redis/redis.service.ts
Other components
- API users
- Razorpay
- AWS S3
Connections 25
- API users → NestJS application: sends requests
README.md - NestJS application → Authentication: registers module
src/app.module.ts - NestJS application → Tenant management: registers module
src/app.module.ts - NestJS application → Maintenance tickets: registers module
src/app.module.ts - NestJS application → NC programs: registers module
src/app.module.ts - NestJS application → Notifications: registers module
src/app.module.ts - NestJS application → Role authorization: enforces roles
- Maintenance tickets → API users: returns ticket results
src/modules/maintenance/presentation/maintenance.controller.ts - Maintenance tickets → Role authorization: checks roles
src/modules/maintenance/presentation/maintenance.controller.ts - Maintenance tickets → PostgreSQL database: records ticket data
- NC programs → File storage: uploads and reads
src/modules/ncProgram/presentation/nc-program.controller.ts - File storage → AWS S3: stores files
src/shared/infrastructure/storage/services/s3-storage.service.ts - NC programs → PostgreSQL database: stores program records
- Machine management → PostgreSQL database: persists machine data
- Jobs and parts → PostgreSQL database: persists job data
- Production shifts → PostgreSQL database: persists shift data
- Raw materials → PostgreSQL database: tracks stock
- Tenant management → PostgreSQL database: stores tenant data
- User profiles → PostgreSQL database: stores profiles
- Subscriptions → PostgreSQL database: stores plans
- Razorpay payments → Razorpay: processes payments
- System administration → PostgreSQL database: manages system data
- Lookup settings → PostgreSQL database: stores lookup data
- Notifications → API users: delivers notifications
- NestJS application → Redis service: uses cache