How gururagvesh/apex-os works
APEX is an internal business-management platform, with employee and manager workflows spanning authentication, work tracking, attendance, and administration. A common user journey enters through the web app, authenticates against the API, and uses domain screens whose requests are handled by backend modules and persisted through Prisma. The README documents ticket lifecycle/Kanban, projects, leave, RBAC, AI assistance, notifications, and role-based dashboards; attendance and sales CRM are also prominent in the repository tree. Connections are shown only where excerpts or README statements support them; undocumented frontend-to-API wiring is omitted.
Main entry points: prisma.service.ts Prisma data access · tickets.service.ts Ticket lifecycle · auth.service.ts Authentication · access-policy.service.ts Access policy
Components 26
Web experience
- Web application
frontend/app - Punch capture
frontend/components/attendance/useAttendanceCamera.ts
Identity and access
- Authentication
backend/src/modules/core/auth/auth.service.ts - User management
backend/src/modules/core/users/users.service.ts - Access policy
backend/src/common/services/access-policy.service.ts - Role definitions
backend/src/shared/constants/roles.ts
Work management
- Ticket lifecycle
backend/src/modules/operations/tickets/tickets.service.ts - Ticket timing ledger
backend/src/modules/operations/tickets/ticket-ledger.service.ts - Project tracking
backend/src/modules/operations/projects/projects.service.ts - Sales CRM
backend/src/modules/business/sales-crm/leads.service.ts
Attendance and workforce
- Leave approvals
backend/src/modules/operations/leave/leave.service.ts - Attendance operations
backend/src/modules/platform/attendance - Punch photo upload
backend/src/modules/platform/attendance/punch/punch-photo.storage.ts
Platform services
- AI assistance
backend/src/modules/ai/ai.service.ts - Notifications
backend/src/modules/operations/notifications/notifications.service.ts - Realtime gateway
backend/src/modules/platform/gateway/events.gateway.ts - Email service
backend/src/modules/platform/email/email.service.ts - File uploads
backend/src/modules/platform/uploads/uploads.service.ts - Activity events
backend/src/modules/platform/events/events.controller.ts - Event logger
backend/src/common/services/event-logger.service.ts - Prisma data access
backend/src/prisma/prisma.service.ts - PostgreSQL
Other components
- Employee or manager
- Cloudinary
- OpenAI
- SMTP mail
Connections 30
- Employee or manager → Web application: uses
- Web application → Authentication: authenticates
- Authentication → Prisma data access: reads users
backend/src/modules/core/auth/auth.service.ts - Authentication → Event logger: audits login
backend/src/modules/core/auth/auth.service.ts - Authentication → Email service: sends email
backend/src/modules/core/auth/auth.service.ts - User management → Access policy: checks policy
backend/src/modules/core/users/users.service.ts - User management → Email service: uses
backend/src/modules/core/users/users.service.ts - User management → Prisma data access: reads and writes
backend/src/modules/core/users/users.service.ts - Access policy → Prisma data access: reads roles
backend/src/common/services/access-policy.service.ts - Access policy → Role definitions: uses ladder
backend/src/common/services/access-policy.service.ts - Ticket lifecycle → Ticket timing ledger: uses timing
backend/src/modules/operations/tickets/tickets.service.ts - Ticket lifecycle → Event logger: logs actions
backend/src/modules/operations/tickets/tickets.service.ts - Ticket lifecycle → Notifications: dispatches events
backend/src/modules/operations/tickets/tickets.service.ts - Ticket lifecycle → Realtime gateway: emits updates
backend/src/modules/operations/tickets/tickets.service.ts - Ticket lifecycle → Prisma data access: reads and writes
backend/src/modules/operations/tickets/tickets.service.ts - Ticket lifecycle → File uploads: serves attachments
backend/src/modules/operations/tickets/tickets.controller.ts - Project tracking → Prisma data access: persists projects
- Leave approvals → Prisma data access: persists requests
- Attendance operations → Prisma data access: stores attendance
- Punch capture → Punch photo upload: uploads photo
frontend/components/attendance/useAttendanceCamera.ts - Punch photo upload → Cloudinary: stores photos
backend/src/modules/platform/attendance/punch/punch-photo.storage.ts - Sales CRM → Prisma data access: persists leads
- AI assistance → OpenAI: requests assistance
- Notifications → Realtime gateway: broadcasts realtime
- Email service → SMTP mail: sends messages
- Activity events → Access policy: checks visibility
backend/src/modules/platform/events/events.controller.ts - Activity events → Prisma data access: queries events
backend/src/modules/platform/events/events.controller.ts - Activity events → Event logger: uses event history
backend/src/modules/platform/events/events.controller.ts - Event logger → Prisma data access: writes events
backend/src/common/services/event-logger.service.ts - Prisma data access → PostgreSQL: connects