Booking / Appointment Scheduler

Backend:

• RESTful API for services, time slots, and bookings management
• Health check endpoint
• Rate limiting (200 requests per 15 minutes per IP)
• Security headers via Helmet
• CORS enabled for all origins
• JSON flat-file persistence
• UUID v4 for unique identifiers

Tech Stack

Setup & Usage

Backend

cd backend
npm install
npm run build
npm start

Server runs on port 9103 by default.

Development mode:

npm run dev

Environment Variables:

PORT=9103  # Optional, defaults to 9103

Frontend

cd frontend
npm install
npm run dev

Starts dev server (typically on http://localhost:5173).

Build for production:

npm run build

Run tests:

npm test          # Single run
npm run test:watch # Watch mode

API Endpoints

Base URL: http://localhost:9103

All responses use envelope format: { "data": ... } or { "error": "<message>" }

Health

GET /api/health

Returns server health status and timestamp.

curl http://localhost:9103/api/health

Response:

{
  "status": "ok",
  "timestamp": "2025-06-15T10:00:00.000Z"
}

Services

GET /api/services

List all available services.

curl http://localhost:9103/api/services

Response:

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Tree Trimming",
      "description": "Professional tree trimming and shaping",
      "duration": 60,
      "price": 150,
      "icon": "scissors"
    }
  ]
}

GET /api/services/:id

Get a single service by UUID.

curl http://localhost:9103/api/services/550e8400-e29b-41d4-a716-446655440000

Time Slots

GET /api/time-slots?serviceId=<id>&date=<YYYY-MM-DD>

Get available time slots for a service on a specific date.

Bookings

POST /api/bookings

Create a new booking.

GET /api/bookings

List all bookings.

GET /api/bookings/:id

Get a specific booking by ID.

Stats

GET /api/stats

Get booking statistics.

License

Tetrees License