Skip to main content

Cart Operations & Validation

Testing​

  • Unit suite (covers cart CRUD, assignments, incidents, maintenance, analytics/zones):
    • NX_CLI_SET_DAEMON=false NX_DAEMON=false NODE_OPTIONS=--max_old_space_size=6144 pnpm nx run facilities-service:test:unit --runInBand --skip-nx-cache --output-style=stream
  • Integration smoke (module wiring with mocked repos): libs/facilities/facilities-service/src/lib/__tests__/integration/facilities-service.module.spec.ts

Monitoring Suggestions​

  • Availability: new endpoints (/golf-carts/available, /analytics/utilization, /zones/summary) are good SLO probes.
  • Predictive maintenance: alert on non-empty results to drive service bay actions.
  • GPS staleness: alert if lastLocationAt is stale for in-use carts.

API Smoke Checklist​

  • Utilization: expect 200 and fields utilizationRate, avgDailyAssignments.
  • Zones: GET /golf-carts/zones?tenantId=...&zone=... returns array; zone required.
  • Predictive: horizonDays > 0 enforced; defaults applied when omitted.

Dependencies​

  • Prisma schema: GolfCartDetails includes GPS + service fields; CartAssignment and CartIncident underpin usage and incident analytics.
  • Service code: libs/facilities/facilities-service/src/lib/golf-cart.* for controllers/resolvers/DTOs.