How rabblo06/rab-recurit works
Crewflow is a workforce-operations product for staffing agencies and hospitality operators. Managers and venue managers plan shifts and staffing; staff receive and accept offers, work shifts, and record attendance in the mobile app; reviewed attendance feeds payroll and timesheets. The README documents this lifecycle and workspace isolation. The graph preserves the main domain stages and the web, mobile, server, and worker layers. Some subsystem links are documented behavior rather than inspected implementation; edges use the README where source excerpts do not establish the connection.
Main entry points: src/main.ts Application server · venue-offer-pipeline.service.ts Offer lifecycle · src/main.ts Scheduled job queues · Dashboard.tsx Manager web app
Components 21
User applications
- Manager web app
packages/rab-front/src/features/dashboard/Dashboard.tsx - Staff and venue app
packages/rab-iphone/Crewflow/Features/Staff/Views/StaffRootView.swift - Web API client
packages/rab-front/src/shared/api.ts
Workforce workflow
- Staff and manager records
packages/rab-server/src/modules/staff/entities/staff-profile.entity.ts - Shift planning
packages/rab-front/src/features/scheduling/Shifts.tsx - Offer lifecycle
packages/rab-server/src/modules/offer/services/venue-offer-pipeline.service.ts - Mobile attendance
packages/rab-iphone/Crewflow/Features/Staff/Attendance/StaffClockFlow.swift - Attendance review
packages/rab-server/src/modules/attendance/controllers/staff-reviews.controller.ts - Payroll and timesheets
packages/rab-front/src/features/payroll/Payroll.tsx
Server platform
- Offer pipeline routes
packages/rab-server/src/modules/offer/controllers/venue-offer-pipeline.controller.ts - Application server
packages/rab-server/src/main.ts - Session authentication
packages/rab-server/src/engine/core-modules/auth/guards/jwt-auth.guard.ts - Workspace context
packages/rab-server/src/engine/core-modules/tenant/tenant-context.service.ts - Authorization
packages/rab-server/src/engine/core-modules/permissions/permissions.service.ts - Tenant data store
packages/rab-server/src/database/typeorm/core/core.datasource.ts
Background operations
- Background worker
packages/rab-worker/src/main.ts - Scheduled job queues
packages/rab-worker/src/main.ts - Generated shift reports
packages/rab-worker/src/main.ts
Other components
- Managers
- Venue managers
- Staff
Connections 24
- Managers → Manager web app: manage workforce
README.md - Venue managers → Manager web app: request cover
README.md - Staff → Staff and venue app: use mobile app
README.md - Manager web app → Web API client: request data
packages/rab-front/src/shared/api.ts - Web API client → Application server: send requests
- Staff and venue app → Application server: record attendance
README.md - Application server → Session authentication: authenticate requests
- Application server → Staff and manager records: manage records
- Application server → Shift planning: serve scheduling
- Shift planning → Offer pipeline routes: send shift offers
README.md - Offer pipeline routes → Offer lifecycle: dispatches
packages/rab-server/src/modules/offer/controllers/venue-offer-pipeline.controller.ts - Offer lifecycle → Staff and manager records: select eligible staff
packages/rab-server/src/modules/offer/services/venue-offer-pipeline.service.ts - Staff → Offer lifecycle: accept or decline
README.md - Managers → Offer lifecycle: confirm placements
README.md - Mobile attendance → Attendance review: submit worked time
README.md - Attendance review → Payroll and timesheets: provide reviewed hours
README.md - Application server → Workspace context: scope workspace data
- Workspace context → Tenant data store: bind tenant context
packages/rab-server/src/engine/core-modules/tenant/tenant-context.service.ts - Application server → Authorization: authorize actions
- Background worker → Scheduled job queues: run background jobs
packages/rab-worker/src/main.ts - Scheduled job queues → Offer lifecycle: confirm on timeout
README.md - Scheduled job queues → Attendance review: detect attendance issues
README.md - Scheduled job queues → Generated shift reports: generate timesheets
README.md - Generated shift reports → Payroll and timesheets: produce timesheets
README.md