# ymidortega/clinica architecture

> Architecture diagram of the GitHub repository ymidortega/clinica, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ymidortega/clinica
- Repository: https://github.com/ymidortega/clinica

## Overview

##### Project type and purpose
- This is a full-stack, microservices-based clinic management system (“Sistema de Gestión de Clínica Médica”).
- Backend: Nine Spring Boot microservices (Eureka service discovery, API gateway, authentication, patient, billing, admissions, AI assistant, suppliers, clients).
- Frontend: Astro (modern web UI).
- Datastores: multiple MySQL and PostgreSQL databases plus Redis for cache/sessions.

##### File structure
- Top‐level “BackEnd-Clinica” folder holds one directory per microservice. Each follows a standard Maven/Spring Boot layout (src/main/java, resources, Dockerfile, HELP.md, pom.xml).
- eureka-service
- api-gateway
- auth-service
- patient-service
- billing-service
- admissions-service
- ai-assistant-service
- suppliers-service
- clients-service
- Root “docker-compose.yml” orchestrates all services plus databases (MySQL, PostgreSQL) and Redis.
- “FrontEnd-Clinica” holds Astro config, pages, components, public assets.

##### README for additional insights
- Confirms microservice roles, ports, DB connection details, environment variables, Swagger/OpenAPI per service, Actuator endpoints, and Docker Compose usage.
- Highlights technology stack: Java 21, Spring Boot 3.5, Spring Cloud 2025.0, Maven, Lombok, MapStruct, Docker, Astro, pnpm.

##### Detail
- Nine microservices plus Eureka and API Gateway
- Database instance explicitly
- Docker Compose as the deployment orchestration layer
- Environment variables or config store block if needed
- Swagger/OpenAPI aggregation via the API Gateway

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "FrontEnd-Clinica" 
        direction TB
        Browser["Web Browser"]:::external
        Pages["src/pages"]:::frontend
        Components["src/components"]:::frontend
        Layouts["src/layouts"]:::frontend
        AstroConfig["astro.config.mjs"]:::frontend
        Package["package.json"]:::frontend
        Browser -->|"HTTP"| Pages
        Pages --> Components
        Pages --> Layouts
        Pages --> AstroConfig
        Pages --> Package
    end

    %% Edge Layer
    subgraph "BackEnd-Clinica" 
        direction TB
        APIGateway["API Gateway"]:::gateway
        Eureka["Eureka Service Discovery"]:::discovery
        Browser -->|HTTP| APIGateway
        APIGateway -->|Discovery lookup| Eureka
    end

    %% Microservice Layer
    subgraph "Microservices" 
        direction TB
        AuthApp["Auth Service"]:::auth
        PatientApp["Patient Service"]:::service
        BillingApp["Billing Service"]:::service
        AdmissionsApp["Admissions Service"]:::service
        AIAssistApp["AI Assistant Service"]:::service
        SuppliersApp["Suppliers Service"]:::service
        ClientsApp["Clients Service"]:::service

        APIGateway -->|routes to| AuthApp
        APIGateway -->|routes to| PatientApp
        APIGateway -->|routes to| BillingApp
        APIGateway -->|routes to| AdmissionsApp
        APIGateway -->|routes to| AIAssistApp
        APIGateway -->|routes to| SuppliersApp
        APIGateway -->|routes to| ClientsApp

        AuthApp -->|uses| PatientApp
        AIAssistApp -->|Feign HTTP| PatientApp
    end

    %% Data Layer
    subgraph "Datastores" 
        direction TB
        Redis["Redis Cache/Session"]:::cache
        MyAuthDB["MySQL auth-db"]:::db
        MyPatientDB["MySQL patient-db"]:::db
        MyBillingDB["MySQL billing-db"]:::db
        MySuppliersDB["MySQL suppliers-db"]:::db
        MyClientsDB["MySQL clients-db"]:::db
        PgAdmissionsDB["PostgreSQL admissions-db"]:::db
        PgAIDB["PostgreSQL ai-assistant-db"]:::db

        AuthApp -->|JDBC| MyAuthDB
        PatientApp -->|JDBC| MyPatientDB
        BillingApp -->|JDBC| MyBillingDB
        SuppliersApp -->|JDBC| MySuppliersDB
        ClientsApp -->|JDBC| MyClientsDB
        AdmissionsApp -->|JDBC| PgAdmissionsDB
        AIAssistApp -->|JDBC| PgAIDB

        AuthApp -->|cache| Redis
        PatientApp -->|cache| Redis
        AdmissionsApp -->|cache| Redis
        SuppliersApp -->|cache| Redis
    end

    %% External
    subgraph "External Services"
        direction TB
        ExternalAI["External AI API"]:::external
        AIAssistApp -->|API calls| ExternalAI
    end

    %% Orchestration
    DockerComp["Docker Compose"]:::orchestrator
    DockerComp --> APIGateway
    DockerComp --> Eureka
    DockerComp --> AuthApp
    DockerComp --> PatientApp
    DockerComp --> BillingApp
    DockerComp --> AdmissionsApp
    DockerComp --> AIAssistApp
    DockerComp --> SuppliersApp
    DockerComp --> ClientsApp
    DockerComp --> Redis
    DockerComp --> MyAuthDB
    DockerComp --> MyPatientDB
    DockerComp --> MyBillingDB
    DockerComp --> MySuppliersDB
    DockerComp --> MyClientsDB
    DockerComp --> PgAdmissionsDB
    DockerComp --> PgAIDB

    %% Click Events - Frontend
    click Pages "https://github.com/ymidortega/clinica/tree/main/FrontEnd-Clinica/src/pages"
    click Components "https://github.com/ymidortega/clinica/tree/main/FrontEnd-Clinica/src/components"
    click Layouts "https://github.com/ymidortega/clinica/tree/main/FrontEnd-Clinica/src/layouts"
    click AstroConfig "https://github.com/ymidortega/clinica/blob/main/FrontEnd-Clinica/astro.config.mjs"
    click Package "https://github.com/ymidortega/clinica/blob/main/FrontEnd-Clinica/package.json"

    %% Click Events - Gateway & Discovery
    click APIGateway "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/api-gateway/src/main/java/com/ClinicaDeYmid/api_gateway/ApiGatewayApplication.java"
    click Eureka "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/eureka-service/src/main/java/com/ClinicaDeYmid/eureka_service/EurekaServiceApplication.java"

    %% Click Events - Microservices
    click AuthApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/auth-service/src/main/java/com/ClinicaDeYmid/auth_service/AuthServiceApplication.java"
    click PatientApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/patient-service/src/main/java/com/ClinicaDeYmid/patient_service/PatientServiceApplication.java"
    click BillingApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/billing-service/src/main/java/com/ClinicaDeYmid/billing_service/BillingServiceApplication.java"
    click AdmissionsApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/admissions-service/src/main/java/com/ClinicaDeYmid/admissions_service/AdmissionsServiceApplication.java"
    click AIAssistApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/ai-assistant-service/src/main/java/com/ClinicaDeYmid/ai_assistant_service/AiAssistantServiceApplication.java"
    click SuppliersApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/suppliers-service/src/main/java/com/ClinicaDeYmid/suppliers_service/SuppliersServiceApplication.java"
    click ClientsApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/clients-service/src/main/java/com/ClinicaDeYmid/clients_service/ClientsServiceApplication.java"

    %% Click Events - Orchestrator
    click DockerComp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/docker-compose.yml"

    %% Click Events - Redis Configurations
    click PatientApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/patient-service/src/main/java/com/ClinicaDeYmid/patient_service/module/config/RedisCacheConfig.java"
    click AdmissionsApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/admissions-service/src/main/java/com/ClinicaDeYmid/admissions_service/module/config/RedisCacheConfig.java"
    click SuppliersApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/suppliers-service/src/main/java/com/ClinicaDeYmid/suppliers_service/module/config/RedisCacheConfig.java"
    click AuthApp "https://github.com/ymidortega/clinica/blob/main/BackEnd-Clinica/auth-service/src/main/java/com/ClinicaDeYmid/auth_service/module/auth/config/RedisConfig.java"

    classDef frontend fill:#e8f1fb,stroke:#333,stroke-width:1px
    classDef gateway fill:#dda0dd,stroke:#333,stroke-width:1px
    classDef discovery fill:#d8bfd8,stroke:#333,stroke-width:1px
    classDef service fill:#98fb98,stroke:#333,stroke-width:1px
    classDef auth fill:#ffb6c1,stroke:#333,stroke-width:1px
    classDef db fill:#ffd700,stroke:#333,stroke-width:1px
    classDef cache fill:#f5deb3,stroke:#333,stroke-width:1px
    classDef external fill:#add8e6,stroke:#333,stroke-width:1px
    classDef orchestrator fill:#d3d3d3,stroke:#333,stroke-width:1px
```
