Welcome to the comprehensive API documentation for the Modern Reservation System.

🏗️ Architecture

Our system follows a microservices architecture with:

• Hybrid Technology Stack: Node.js + Java services
• Event-Driven Communication: Apache Kafka
• Service Discovery: Eureka Server
• API Gateway: GraphQL Federation + REST

📋 Service Categories

🏢 Business Services (Java Spring Boot)

Core business logic and domain services:

• Business Services Overview - Complete business services documentation
• Analytics Engine - Real-time analytics and reporting
• Availability Calculator - Room availability computation
• Payment Processor - Secure payment handling
• Rate Management - Dynamic pricing engine
• Reservation Engine - Core booking logic

🌐 API Services (Node.js)

High-performance I/O services:

• GraphQL Gateway - Unified data graph and federation
• WebSocket Service - Real-time communication
• Notification Service - Multi-channel messaging

🏗️ Infrastructure Services

Platform and infrastructure:

• Eureka Server - Service discovery and registration
• Config Server - Centralized configuration management

🚀 Getting Started

Quick Start

# Start all infrastructure
./dev.sh docker-start

# Start business services
./dev.sh start-business-services

# Check service health
./dev.sh status

Service URLs

| Service | URL | Health Check | |———|—–|————–| | Eureka Dashboard | http://localhost:8761 | ✅ Active | | GraphQL Playground | http://localhost:4000/graphql | ✅ Active | | API Gateway | http://localhost:3001 | ✅ Active |

📊 Observability

Monitoring Stack

• Jaeger Tracing: http://localhost:16686
• Prometheus Metrics: http://localhost:9090
• Grafana Dashboards: http://localhost:3000 (admin/admin123)

OpenTelemetry

All services include distributed tracing with automatic instrumentation.

🔐 Authentication

JWT Authentication

# Get JWT token
curl -X POST http://localhost:3001/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "admin123"}'

# Use token in requests
curl -H "Authorization: Bearer <jwt-token>" \
     -H "X-Tenant-ID: <tenant-id>" \
     http://localhost:8080/api/v1/analytics/overview

📡 GraphQL Federation

Unified Schema

Access all services through a single GraphQL endpoint:

query GetReservationWithAnalytics($id: ID!) {
  reservation(id: $id) {
    id
    guestName
    checkIn
    checkOut
    status
    analytics {
      revenue
      nights
      averageRate
    }
  }
}

🔗 Event-Driven Architecture

Kafka Topics

| Topic | Purpose | Schema | |——-|———|——–| | reservation.created | New reservations | Avro Schema | | payment.processed | Payment confirmations | Avro Schema | | availability.updated | Room availability changes | Avro Schema |

📚 Additional Resources

• Architecture Documentation
• Deployment Guide
• Multi-Tenancy Implementation
• Development Guide

---

Generated: $(date -u +”%Y-%m-%d %H:%M:%S UTC”) Version: $(git rev-parse –short HEAD)