# ayoubdammaq/saas-clinic architecture

> Architecture diagram of the GitHub repository ayoubdammaq/saas-clinic, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayoubdammaq/saas-clinic
- Repository: https://github.com/ayoubdammaq/saas-clinic

## Overview

This is a multi-service healthcare management system with a React frontend and .NET services for identity, clinics, doctors and availability, appointments, patients and medical records, consultations, billing, notifications, and reporting. The apparent user workflow is to manage care records and schedules, then record consultations and handle invoices; the tree supports these as product capabilities, but no README or frontend/API excerpts document their end-to-end routing. The availability handler explicitly loads doctor schedules and checks appointments through an HTTP client. Other links are limited to relationships named in the source index; unsampled wiring is not asserted.

Main entry points: [`API_Gateway/Program.cs`](https://github.com/ayoubdammaq/saas-clinic/blob/main/API_Gateway/Program.cs) (API gateway), [`Services/ConsultationManagementService/ConsultationManagementService.Domain/Entities/Consultation.cs`](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ConsultationManagementService/ConsultationManagementService.Domain/Entities/Consultation.cs) (Consultations and documents), [`Services/ClinicManagementService/Clinic.Domain/Entities/Clinique.cs`](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Domain/Entities/Clinique.cs) (Clinic management), [`Services/RDVManagementService`](https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/RDVManagementService) (Appointment management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_frontend["Web application"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
end

subgraph group_care["Care operations"]
  node_clinic["Clinic management<br/>[Clinique.cs]"]
  node_clinicrepo["Clinic repository contract"]
  node_doctor["Doctor and availability<br/>[Medecin.cs]"]
  node_availability["Availability search"]
  node_slots["Doctor schedules<br/>[Disponibilite.cs]"]
  node_appointments["Appointment management"]
  node_patient["Patient management<br/>[Patient.cs]"]
  node_records["Medical records<br/>[DossierMedical.cs]"]
  node_consultations["Consultations and documents<br/>[Consultation.cs]"]
  node_consultationrepo["Consultation repository contract"]
  node_clinicdb[("Clinic persistence")]
end

subgraph group_finance["Billing and reporting"]
  node_invoices["Invoices and payments<br/>[Facture.cs]"]
  node_reporting["Reporting"]
end

subgraph group_platform["Messaging and gateway"]
  node_gateway["API gateway<br/>[Program.cs]"]
  node_notifications["Notifications"]
end

node_user(("Staff or patient"))

node_user -.->|"uses"| node_frontend
node_frontend -.->|"requests APIs"| node_gateway
node_gateway -.->|"routes requests"| node_auth
node_gateway -.->|"routes requests"| node_clinic
node_gateway -.->|"routes requests"| node_doctor
node_gateway -.->|"routes requests"| node_appointments
node_gateway -.->|"routes requests"| node_patient
node_gateway -.->|"routes requests"| node_consultations
node_gateway -.->|"routes requests"| node_invoices
node_availability -->|"reads schedules"| node_slots
node_availability -->|"checks bookings"| node_appointments
node_clinic -->|"uses contract"| node_clinicrepo
node_consultations -->|"uses contract"| node_consultationrepo
node_clinic -.->|"persists data"| node_clinicdb
node_consultations -.->|"may reference"| node_records
node_consultations -.->|"may trigger billing"| node_invoices
node_notifications -.->|"delivers updates"| node_user
node_reporting -.->|"aggregates metrics"| node_clinic
node_reporting -.->|"aggregates metrics"| node_appointments

click node_frontend "https://github.com/ayoubdammaq/saas-clinic/tree/main/Frontend/src"
click node_gateway "https://github.com/ayoubdammaq/saas-clinic/blob/main/API_Gateway/Program.cs"
click node_auth "https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/AuthService"
click node_clinic "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Domain/Entities/Clinique.cs"
click node_clinicrepo "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Domain/Interfaces/ICliniqueRepository.cs"
click node_doctor "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Domain/Entities/Medecin.cs"
click node_availability "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Application/AvailibilityServices/Queries/GetMedecinsDisponibles/GetMedecinsDisponiblesQueryHandler.cs"
click node_slots "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Domain/Entities/Disponibilite.cs"
click node_appointments "https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/RDVManagementService"
click node_patient "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/PatientManagementService/PatientManagementService.Domain/Entities/Patient.cs"
click node_records "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/PatientManagementService/PatientManagementService.Domain/Entities/DossierMedical.cs"
click node_consultations "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ConsultationManagementService/ConsultationManagementService.Domain/Entities/Consultation.cs"
click node_consultationrepo "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ConsultationManagementService/ConsultationManagementService.Domain/Interfaces/IConsultationRepository.cs"
click node_invoices "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/FacturationService/Facturation.Domain/Entities/Facture.cs"
click node_notifications "https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/NotificationService"
click node_reporting "https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/ReportingService"
click node_clinicdb "https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Infrastructure/Data/CliniqueDbContext.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend toneBlue
class node_auth toneAmber
class node_clinic,node_clinicrepo,node_doctor,node_availability,node_slots,node_appointments,node_patient,node_records,node_consultations,node_consultationrepo,node_clinicdb toneMint
class node_invoices,node_reporting toneRose
class node_gateway,node_notifications,node_user toneIndigo
```

## Components

### Client application

- [Web application](https://github.com/ayoubdammaq/saas-clinic/tree/main/Frontend/src): `Frontend/src`

### Identity and access

- [Authentication](https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/AuthService): `Services/AuthService`

### Care operations

- [Clinic management](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Domain/Entities/Clinique.cs): `Services/ClinicManagementService/Clinic.Domain/Entities/Clinique.cs`
- [Clinic repository contract](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Domain/Interfaces/ICliniqueRepository.cs): `Services/ClinicManagementService/Clinic.Domain/Interfaces/ICliniqueRepository.cs`
- [Doctor and availability](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Domain/Entities/Medecin.cs): `Services/DoctorManagementService/Doctor.Domain/Entities/Medecin.cs`
- [Availability search](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Application/AvailibilityServices/Queries/GetMedecinsDisponibles/GetMedecinsDisponiblesQueryHandler.cs): `Services/DoctorManagementService/Doctor.Application/AvailibilityServices/Queries/GetMedecinsDisponibles/GetMedecinsDisponiblesQueryHandler.cs`
- [Doctor schedules](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/DoctorManagementService/Doctor.Domain/Entities/Disponibilite.cs): `Services/DoctorManagementService/Doctor.Domain/Entities/Disponibilite.cs`
- [Appointment management](https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/RDVManagementService): `Services/RDVManagementService`
- [Patient management](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/PatientManagementService/PatientManagementService.Domain/Entities/Patient.cs): `Services/PatientManagementService/PatientManagementService.Domain/Entities/Patient.cs`
- [Medical records](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/PatientManagementService/PatientManagementService.Domain/Entities/DossierMedical.cs): `Services/PatientManagementService/PatientManagementService.Domain/Entities/DossierMedical.cs`
- [Consultations and documents](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ConsultationManagementService/ConsultationManagementService.Domain/Entities/Consultation.cs): `Services/ConsultationManagementService/ConsultationManagementService.Domain/Entities/Consultation.cs`
- [Consultation repository contract](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ConsultationManagementService/ConsultationManagementService.Domain/Interfaces/IConsultationRepository.cs): `Services/ConsultationManagementService/ConsultationManagementService.Domain/Interfaces/IConsultationRepository.cs`
- [Clinic persistence](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/ClinicManagementService/Clinic.Infrastructure/Data/CliniqueDbContext.cs): `Services/ClinicManagementService/Clinic.Infrastructure/Data/CliniqueDbContext.cs`

### Billing and reporting

- [Invoices and payments](https://github.com/ayoubdammaq/saas-clinic/blob/main/Services/FacturationService/Facturation.Domain/Entities/Facture.cs): `Services/FacturationService/Facturation.Domain/Entities/Facture.cs`
- [Reporting](https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/ReportingService): `Services/ReportingService`

### Messaging and gateway

- [API gateway](https://github.com/ayoubdammaq/saas-clinic/blob/main/API_Gateway/Program.cs): `API_Gateway/Program.cs`
- [Notifications](https://github.com/ayoubdammaq/saas-clinic/tree/main/Services/NotificationService): `Services/NotificationService`

### Other components

- **Staff or patient**

## Connections

- Staff or patient → Web application: uses
- Web application → API gateway: requests APIs
- API gateway → Authentication: routes requests
- API gateway → Clinic management: routes requests
- API gateway → Doctor and availability: routes requests
- API gateway → Appointment management: routes requests
- API gateway → Patient management: routes requests
- API gateway → Consultations and documents: routes requests
- API gateway → Invoices and payments: routes requests
- Availability search → Doctor schedules: reads schedules (evidence: `Services/DoctorManagementService/Doctor.Application/AvailibilityServices/Queries/GetMedecinsDisponibles/GetMedecinsDisponiblesQueryHandler.cs`)
- Availability search → Appointment management: checks bookings (evidence: `Services/DoctorManagementService/Doctor.Application/AvailibilityServices/Queries/GetMedecinsDisponibles/GetMedecinsDisponiblesQueryHandler.cs`)
- Clinic management → Clinic repository contract: uses contract (evidence: `Services/ClinicManagementService/Clinic.Domain/Interfaces/ICliniqueRepository.cs`)
- Consultations and documents → Consultation repository contract: uses contract (evidence: `Services/ConsultationManagementService/ConsultationManagementService.Domain/Interfaces/IConsultationRepository.cs`)
- Clinic management → Clinic persistence: persists data
- Consultations and documents → Medical records: may reference
- Consultations and documents → Invoices and payments: may trigger billing
- Notifications → Staff or patient: delivers updates
- Reporting → Clinic management: aggregates metrics
- Reporting → Appointment management: aggregates metrics
