Facilities Service
The Facilities Service manages physical assets and resources at golf clubs, including courses, driving ranges, simulators, carts, and courts.
Last updated: 2026-01-26 Where to find it: Facilities API Who can use it: Developers, integrators Prerequisites: API credentials, tenant access Help link: /intro
Purpose
Provides a centralized facility management system that can be shared across multiple modules:
- Tee Time - booking facilities for tee times
- Sport Club Ledger (SCL) - facility inventory management
- Member Club Admin (MCA) - administrative oversight
Key Features
| Feature | Description |
|---|---|
| Multi-tenant | All queries scoped by tenantId, optional clubId |
| Resource Types | Golf courses, driving ranges, simulators, carts, courts |
| Maintenance Logs | Track scheduled and completed maintenance |
| Resource Usage | Track booking assignments to resources |
| Reservations | Book facility time slots with series + waitlist support |
| Availability Check | Query available resources for a time window |
| Soft Delete | Resources are deactivated, not permanently deleted |
| Dual API | REST endpoints + GraphQL resolvers |
Quick Links
- API Surface - REST and GraphQL endpoints
- Facility Resources - Core resource management
- Maintenance Logs - Maintenance tracking
- Availability - Availability checking
- Facility Reservations - Booking and series workflows
- Booking Rules - Advance windows, guest limits, durations
- Facility Hours - Operating hours and blackout periods
- Waitlist - Queue for unavailable slots with auto-offer
- Golf Cart Management - Cart lifecycle, analytics, GPS
- Golf Cart Notifications - Messaging integration, templates, schedulers
Related Projects
| Project | Path | Description |
|---|---|---|
facilities-api | apps/facilities/facilities-api | NestJS gateway application |
facilities-service | libs/facilities/facilities-service | Core service module |
facilities-data | libs/prisma/facilities-data | Prisma data layer |
Getting Started
# Serve the API locally
pnpm nx serve facilities-api
# Run unit tests
pnpm nx run facilities-service:test:unit --runInBand
# Build the service
pnpm nx build facilities-service
Swagger Documentation
Interactive API documentation is available at:
Expected outcome
- Understand the Facilities Service capabilities.
- Know the available resource types and features.
- Ready to integrate with the REST and GraphQL APIs.
Related
- API Surface — REST and GraphQL endpoints
- Facility Resources — Core resource management
- Golf Cart Management — Cart lifecycle