reservations-servicelisted
Install: claude install-skill mattbutlerengineering/mattbutlerengineering
# Reservations Service Development Skill
This skill provides patterns and workflows for developing the Reservations Service, a Fastify-based REST API at `services/reservations/` that handles restaurant table reservations with Auth0 authentication and Prisma ORM.
## Service Overview
**Location**: `services/reservations/`
**Framework**: Fastify v5 with TypeScript
**Database**: PostgreSQL via Prisma
**Auth**: Auth0 JWT verification with jose
**Port**: 3004 (API docs at http://localhost:3004/docs)
### Key Files
| File | Purpose |
| ---------------------------------- | ------------------------------------------------- |
| `src/app.ts` | Fastify app setup, plugin registration |
| `src/routes/tables.ts` | Table CRUD endpoints (create/update require auth) |
| `src/routes/reservations.ts` | Reservation CRUD endpoints |
| `src/routes/venues.ts` | Venue CRUD endpoints |
| `src/routes/floor-plans.ts` | Floor plan CRUD endpoints |
| `src/routes/guests.ts` | Guest management endpoints |
| `src/routes/availability.ts` | Availability check endpoints |
| `src/routes/holds.ts` | Reservation hold endpoints |
| `src/routes/cancel-reservation.ts` | Self-service cancellation endpoin