How sasankoffice/ombrix-web works
Ombrix is an enterprise construction ERP. Its principal workflow is staff sign-in, role- and page-based authorization, then role-specific work across project progress, junctions, billing/reconciliation, stores, and administration. The API provides these feature areas and persists operational state through Prisma; shared code supplies role and domain rules. The tree also shows web views for the major work areas and support, uploads, and documents. The README is empty and most feature modules and web routes were not sampled, so uncertain cross-app calls and internal feature flows are omitted.
Main entry points: app.module.ts API composition · AppShell.tsx Role workspace · prisma.service.ts Relational database access · auth.controller.ts Authentication
Components 34
Web application
- Sign-in pages
apps/web/app/(auth)/page.tsx - Session client
apps/web/lib/session.tsx - API client
apps/web/lib/api.ts - Role workspace
apps/web/components/shell/AppShell.tsx - DPR review
apps/web/views/DprReviewPage.tsx - Site reporting
apps/web/views/SiteEngineer.tsx - Junction workspace
apps/web/views/JunctionsPage.tsx - Billing reconciliation
apps/web/views/BillingReconPage.tsx - Store operations
apps/web/views/StorePages.tsx - Tech administration
apps/web/views/TechPages.tsx
Identity and access
- Authentication
apps/api/src/auth/auth.controller.ts - OTP delivery
apps/api/src/auth/otp.sender.ts - Session access guard
apps/api/src/common/access.service.ts - Roles and rules
packages/shared/src/roles.ts
Project operations
- Progress reports
apps/api/src/modules/dpr.module.ts - Junction records
apps/api/src/modules/junctions.module.ts - Site management
apps/api/src/modules/sites.module.ts
Commercial and stores
- Billing
apps/api/src/modules/billing.module.ts - Reconciliation
apps/api/src/modules/recon.module.ts - Inventory and stores
apps/api/src/modules/store.module.ts - Vendor management
apps/api/src/modules/vendors.module.ts
API platform
- File uploads
apps/api/src/modules/upload.module.ts - Documents
apps/api/src/modules/documents.module.ts - Support tickets
apps/api/src/modules/support.module.ts - User administration
apps/api/src/modules/users.module.ts - System oversight
apps/api/src/modules/tech.module.ts - Overview metrics
apps/api/src/modules/overview.module.ts - Reference data
apps/api/src/modules/meta.module.ts - API composition
apps/api/src/app.module.ts - Relational database access
apps/api/src/prisma/prisma.service.ts - Application database
- Audit and notifications
apps/api/src/common/common.services.ts - File storage
apps/api/src/common/storage.service.ts
Other components
- ERP users
Connections 37
- ERP users → Sign-in pages: signs in
- Sign-in pages → Session client: starts session
- Session client → API client: requests API
apps/web/lib/session.tsx - API client → API composition: calls API
- API composition → Authentication: registers
apps/api/src/app.module.ts - API composition → Session access guard: registers guard
apps/api/src/app.module.ts - API composition → Relational database access: loads provider
apps/api/src/app.module.ts - API composition → Audit and notifications: loads services
apps/api/src/app.module.ts - API composition → File storage: loads service
apps/api/src/app.module.ts - API composition → Progress reports: registers features
- API composition → Junction records: registers features
- API composition → Site management: registers features
- API composition → Billing: registers features
- API composition → Reconciliation: registers features
- API composition → Inventory and stores: registers features
- API composition → Vendor management: registers features
- API composition → File uploads: registers features
- API composition → Documents: registers features
- API composition → Support tickets: registers features
- API composition → User administration: registers features
- API composition → System oversight: registers features
- API composition → Overview metrics: registers features
- API composition → Reference data: registers features
- Authentication → Relational database access: reads and updates
apps/api/src/auth/auth.controller.ts - Authentication → Audit and notifications: writes audit events
apps/api/src/auth/auth.controller.ts - Session access guard → Relational database access: loads user access
apps/api/src/common/access.service.ts - Junction records → Relational database access: queries records
apps/api/src/modules/junctions.module.ts - Relational database access → Application database: persists data
- ERP users → Role workspace: uses workspace
- Role workspace → DPR review: opens work area
- Role workspace → Site reporting: opens work area
- Role workspace → Junction workspace: opens work area
- Role workspace → Billing reconciliation: opens work area
- Role workspace → Store operations: opens work area
- Role workspace → Tech administration: opens work area
- Roles and rules → Session access guard: provides role rules
apps/api/src/common/access.service.ts - Roles and rules → Authentication: provides role helpers
apps/api/src/auth/auth.controller.ts