Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
107 lines (86 loc) · 2.22 KB

ARCHITECTURE.md

File metadata and controls

107 lines (86 loc) · 2.22 KB

System Architecture

Microservices Diagram

graph TD
    A[API Gateway] --> B[Authentication Service]
    A --> C[Patient Service]
    A --> D[Doctor Service]
    A --> E[Appointment Service]
    A --> F[Notification Service]
    E --> G[RabbitMQ]
    F --> G
    C --> H[PostgreSQL]
    D --> H
    E --> H
    B --> I[Redis]

classDef service fill:#4CAF50,stroke:#388E3C;
class A,B,C,D,E,F service;
Loading

Component Breakdown

  1. API Gateway (FastAPI)

    • Routes incoming requests
    • Handles rate limiting
    • Manages JWT validation

  2. Authentication Service

    • OAuth2 password flow
    • JWT token generation
    • Redis session storage

  3. Patient Service

    • Patient CRUD operations
    • Insurance data management
    • Medical records storage

  4. Doctor Service

    • Doctor profile management
    • Availability scheduling
    • Specialization tracking

  5. Appointment Service

    • Conflict detection system
    • Calendar integration
    • Status transitions

  6. Notification Service

    • Email/SMS notifications
    • RabbitMQ message processing
    • Template management

Data Flow

  1. Client → API Gateway → Service
  2. Services ↔ PostgreSQL (ACID transactions)
  3. Cross-service communication via RabbitMQ
  4. Redis cache for frequent queries

API_EXAMPLES.http

# API Request Examples

### Authentication
```http
POST http://localhost:8000/api/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "securePassword123!"
}

Patient Management

GET http://localhost:8000/api/patients/me
Authorization: Bearer {{token}}

Doctor Availability

POST http://localhost:8000/api/doctors/availability
Authorization: Bearer {{token}}
Content-Type: application/json

{
  "start_time": "2024-03-01T09:00:00",
  "end_time": "2024-03-01T17:00:00",
  "recurring": true
}

Appointment Booking

POST http://localhost:8000/api/appointments
Authorization: Bearer {{token}}
Content-Type: application/json

{
  "doctor_id": "550e8400-e29b-41d4-a716-446655440000",
  "scheduled_time": "2024-03-05T14:30:00",
  "reason": "Annual Checkup"
}