How veletpro0-lgtm/valet-platform works
VAYLET is a multi-tenant valet operations platform. Its core workflow spans vehicle check-in and parking, task assignment, guest retrieval requests, staff retrieval and handoff, with payment and custody/audit capabilities alongside it. Staff, guests, and managers use the API through separate domain surfaces; management also provides configuration, analytics, and reports. The graph reflects documented capabilities and sampled API code; unsampled subsystem wiring is represented conservatively, without implying unverified internal calls.
Main entry points: postgres.ts PostgreSQL · staff-mfa.controller.ts MFA · start-retrieval.controller.ts Staff retrieval · gps-ingestion.controller.ts Task tracking
Components 23
Identity and access
- Staff authentication
apps/api/src/modules/auth/staff-auth.controller.ts - MFA
apps/api/src/modules/auth/mfa/staff-mfa.controller.ts
Valet operations
- Vehicle check-in
apps/api/src/modules/check-in-api/check-in-api.controller.ts - Plate OCR
apps/api/src/modules/check-in-api/plate-ocr.controller.ts - Parking custody
apps/api/src/modules/parking/start-parking.controller.ts - Key custody
apps/api/src/modules/keys/key-custody.controller.ts - Task dispatch
apps/api/src/modules/dispatch/dispatch.controller.ts - Staff retrieval
apps/api/src/modules/retrieval/start-retrieval.controller.ts - Vehicle handoff
apps/api/src/modules/retrieval/complete-handoff.controller.ts - Task tracking
apps/api/src/modules/tracking/gps-ingestion.controller.ts - Incident reporting
apps/api/src/modules/incidents/incident-reporting.controller.ts
Guest and payment
- Guest access
apps/api/src/modules/guest-access/guest-access.controller.ts - Guest retrieval request
apps/api/src/modules/retrieval/guest-retrieval.controller.ts - Payments and cash
apps/api/src/modules/payments/guest-payment.controller.ts
Management surfaces
- Operations dashboard
apps/api/src/modules/dashboard/overview.controller.ts - Analytics and reports
apps/api/src/modules/dashboard/analytics.controller.ts - Management configuration
apps/api/src/modules/management/management-settings.controller.ts - Staff management
apps/api/src/modules/management/staff-management.controller.ts
Shared platform
- Audit events
apps/api/src/modules/audit/custody-audit-event-writer.ts - PostgreSQL
apps/api/src/common/database/postgres.ts
Other components
- Staff
- Guest
- Manager
Connections 24
- Staff → Staff authentication: authenticates
- Staff → MFA: verifies factor
- Staff → Vehicle check-in: checks in vehicle
- Staff → Plate OCR: assists plate entry
- Staff → Parking custody: records parking
- Staff → Key custody: records custody
- Staff → Task dispatch: handles tasks
- Staff → Staff retrieval: retrieves vehicle
- Staff → Vehicle handoff: completes handoff
- Staff → Task tracking: sends GPS samples
- Guest → Guest access: opens secure link
- Guest → Guest retrieval request: requests retrieval
- Guest → Payments and cash: pays or validates
- Manager → Operations dashboard: views operations
- Manager → Analytics and reports: reviews reports
- Manager → Management configuration: configures location
- Manager → Staff management: manages staff
- Manager → Incident reporting: reports incident
- Guest retrieval request → PostgreSQL: reads and writes
- Staff retrieval → PostgreSQL: reads and writes
- Task tracking → PostgreSQL: ingests samples
- MFA → PostgreSQL: stores factor state
- MFA → Audit events: records activation
- Operations dashboard → PostgreSQL: queries task queues