How tritrackit/api works
Tri-TrackIT is a NestJS warehouse-tracking API for monitoring complete built units (CBUs) through RFID, with user and role management, reporting, and live updates. The principal workflow is a client or RFID device submitting tracking activity to the API, which supports unit operations and emits real-time updates; users can also request dashboards and reports. The README documents the product’s broader capabilities, while the excerpts directly confirm only selected controller calls and integrations, so unverified service wiring is left dashed or omitted.
Main entry points: auth.service.ts Authentication logic · employee-user.service.ts User management · entities Warehouse and user entities · units.service.ts Unit tracking operations
Components 28
API surface
- Authentication API
src/controller/auth/auth.controller.ts - Employee user API
src/controller/employee-user/employee-user.controller.ts - Roles API
src/controller/role/role.controller.ts - Units API
src/controller/unit/units.controller.ts - Locations API
src/controller/locations/locations.controller.ts - Models API
src/controller/model/model.controller.ts - Scanners API
src/controller/scanner/scanner.controller.ts - Statistics API
src/controller/statistics/statistics.controller.ts - Metadata API
src/controller/meta-data/metadata.controller.ts - System configuration API
src/controller/system-config/system-config.controller.ts
Warehouse tracking
- Unit tracking operations
src/services/units.service.ts - Location management
src/services/locations.service.ts - Model management
src/services/model.service.ts - Scanner management
src/services/scanner.service.ts - Reports and dashboards
src/services/statistics.service.ts
Identity and access
- Authentication logic
src/services/auth.service.ts - User management
src/services/employee-user.service.ts - Role management
src/services/roles.service.ts
Persistence
- PostgreSQL
- TypeORM configuration
src/db/typeorm/typeorm.service.ts - Warehouse and user entities
src/db/entities - Application cache
src/services/cache.service.ts
Notifications and integrations
- Email service
src/services/email.service.ts - Live update service
src/services/pusher.service.ts - RFID WebSocket gateway
src/gateways/rfid.gateway.ts
Other components
- API client
- RFID device
- Pusher
Connections 32
- API client → Authentication API: requests
README.md - API client → Employee user API: requests
README.md - API client → Roles API: requests
README.md - API client → Units API: requests
README.md - API client → Locations API: requests
README.md - API client → Models API: requests
README.md - API client → Scanners API: requests
README.md - API client → Statistics API: requests
README.md - API client → Metadata API: requests
- API client → System configuration API: requests
- RFID device → Units API: scans units
- Authentication API → Authentication logic: invokes
src/controller/auth/auth.controller.ts - Employee user API → User management: invokes
src/controller/employee-user/employee-user.controller.ts - Statistics API → Reports and dashboards: requests reports
src/controller/statistics/statistics.controller.ts - Units API → Unit tracking operations: invokes
- Roles API → Role management: invokes
- Locations API → Location management: invokes
- Models API → Model management: invokes
- Scanners API → Scanner management: invokes
- Metadata API → Warehouse and user entities: queries
src/controller/meta-data/metadata.controller.ts - Authentication logic → Warehouse and user entities: reads and writes
src/services/auth.service.ts - TypeORM configuration → Warehouse and user entities: registers
src/db/typeorm/typeorm.service.ts - TypeORM configuration → PostgreSQL: configures connection
src/db/typeorm/typeorm.service.ts - Authentication logic → Application cache: uses
src/services/auth.service.ts - Authentication logic → Email service: uses
src/services/auth.service.ts - User management → Email service: uses
src/services/employee-user.service.ts - User management → Application cache: uses
src/services/employee-user.service.ts - User management → Warehouse and user entities: persists users
- Unit tracking operations → Application cache: uses
src/services/units.service.ts - Unit tracking operations → Live update service: publishes updates
src/services/units.service.ts - Live update service → RFID WebSocket gateway: references
src/services/pusher.service.ts - Live update service → Pusher: sends live updates