# franca26/hospital-app architecture

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

- Interactive diagram: https://gitdiagram.com/franca26/hospital-app
- Repository: https://github.com/franca26/hospital-app

## Overview

##### Project Type & Purpose
- Full-stack Hospital Management System
- Frontend: React SPA (Vite, Tailwind)
- Backend: Node.js + Express + Sequelize (MariaDB)
- Core features: appointment scheduling, medical record management, doctor availability, user management, in-app & email notifications

##### Top-Level Components
a. Client / Browser
b. Frontend SPA (“hospital-frontend”)
- Pages, Layouts, UI Components
- Context Providers (Auth, Toast)
- API service (Axios wrapper)
c. API Gateway / Express Server (“hospital-backend/server.js”)
- Route Layer (routes/*.js)
- Controller Layer (controllers/*.js)
- Utils/Services (auth, email, notification, turnoUtils, sync)
- File Upload Handler (Multer → upload/historiales)
- PDF Generator (PDFKit)
d. ORM Layer (Sequelize models/index.js → models/*.js)
e. Relational Database (MariaDB)
f. External Services
- SMTP Mail Server (Nodemailer)
- (Optional) Push / WebSocket notifications

##### Relationships & Data Flows
- Frontend → HTTP(S) → Express Routes
- Routes → Controllers → Services/Utils
- Controllers → Sequelize ORM → MariaDB
- Controllers → Utils → Nodemailer (SMTP)
- File uploads: Frontend → Express/Multer → /upload/historiales → Stored on disk
- PDF Generation: Controller invokes PDFKit → streams PDF back to client
- Auth Flow: Frontend sends credentials → authController issues JWT → Stored in HTTP-only cookie or localStorage → Subsequent requests carry JWT → auth middleware validates → user context returned
- Notification Flow: Server writes notification record → Frontend polls GET /api/notificaciones or subscribes via WebSocket (if implemented) → user sees Toast

##### Architectural Patterns & Principles
- Layered (Presentation → API Layer → Business Logic → Data Access)
- MVC-inspired separation (Routes = View, Controllers = Controller, Models = Model)
- Modularization by feature (each entity: Turno, Usuario, Servicio, etc.)
- Single-Page Application for smooth UX
- Stateless API with JWT for easy scaling
- Use of environment variables (.env) to decouple config

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (React SPA)" 
        direction TB
        Browser["Client / Browser"]:::frontend
        SPA["hospital-frontend"]:::frontend
        subgraph "Source Files"
            direction TB
            Entry["main.jsx"]:::frontend
            HTML["index.html"]:::frontend
            UI["UI Components"]:::frontend
            Layouts["Layouts"]:::frontend
            LayoutComps["Layout Sub-components"]:::frontend
            Pages["Pages"]:::frontend
            AuthCtx["AuthContext"]:::frontend
            ToastCtx["ToastContext"]:::frontend
            APIService["API Service (Axios)"]:::frontend
            ViteConf["vite.config.js"]:::frontend
            TailwindConf["tailwind.config.js"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "Backend (Express API)" 
        direction TB
        Server["server.js"]:::backend

        subgraph "Route Layer"
            direction TB
            Routes["routes/"]:::backend
            RouteIndex["index.js"]:::backend
        end

        subgraph "Controller Layer"
            direction TB
            Controllers["controllers/"]:::backend
            HistorialCtrl["historialMedicoController"]:::backend
        end

        subgraph "Utils / Services"
            direction TB
            AuthUtil["auth.js"]:::backend
            EmailUtil["email.js"]:::backend
            NotifUtil["notificaciones.js"]:::backend
            TurnoUtil["turnoUtils.js"]:::backend
            SyncUtil["sync.js"]:::backend
        end

        FileUpload["Multer File Upload"]:::backend
        PDFService["PDF Generation (PDFKit)"]:::backend
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DBConfig["db.js"]:::data
        ModelsIndex["models/index.js"]:::data
        ModelsDir["models/"]:::data
        SQLScript["hospital_turnos.sql"]:::data
        MariaDB["MariaDB"]:::data
        FileStorage["File Storage (upload/historiales)"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        SMTP["SMTP Mail Server"]:::external
        PushWS["Push/WebSocket (optional)"]:::external
    end

    %% Connections
    Browser -->|"renders SPA"| SPA
    SPA -->|"HTTPS/JSON"| Server
    SPA -->|"uploads multipart/form-data"| FileUpload
    FileUpload -->|"stores files"| FileStorage

    Server -->|"uses routes"| Routes
    Routes -->|"index routes"| RouteIndex
    Routes -->|"calls controllers"| Controllers
    Controllers -->|"invokes historial PDF"| PDFService
    Controllers -->|"uses utils"| AuthUtil
    Controllers -->|"uses utils"| EmailUtil
    Controllers -->|"uses utils"| NotifUtil
    Controllers -->|"uses utils"| TurnoUtil
    Controllers -->|"uses utils"| SyncUtil
    Controllers -->|"ORM calls"| ModelsIndex
    ModelsIndex -->|"loads models"| ModelsDir
    ModelsIndex -->|"DB sync via SQL"| SQLScript
    ModelsIndex -->|"SQL"| MariaDB

    EmailUtil -->|"SMTP"| SMTP
    NotifUtil -->|"WebSocket"| PushWS
    NotifUtil -->|"poll GET /api/notificaciones"| SPA

    PDFService -->|"streams PDF"| SPA

    %% Click Events - Frontend
    click SPA "https://github.com/franca26/hospital-app/tree/master/hospital-frontend/"
    click Entry "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/src/main.jsx"
    click HTML "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/index.html"
    click UI "https://github.com/franca26/hospital-app/tree/master/hospital-frontend/src/components/ui/"
    click Layouts "https://github.com/franca26/hospital-app/tree/master/hospital-frontend/src/layouts/"
    click LayoutComps "https://github.com/franca26/hospital-app/tree/master/hospital-frontend/src/layouts/components/"
    click Pages "https://github.com/franca26/hospital-app/tree/master/hospital-frontend/src/pages/"
    click AuthCtx "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/src/contexts/AuthContext.jsx"
    click ToastCtx "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/src/contexts/ToastContext.jsx"
    click APIService "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/src/services/api.js"
    click ViteConf "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/vite.config.js"
    click TailwindConf "https://github.com/franca26/hospital-app/blob/master/hospital-frontend/tailwind.config.js"

    %% Click Events - Backend
    click Server "https://github.com/franca26/hospital-app/blob/master/hospital-backend/server.js"
    click DBConfig "https://github.com/franca26/hospital-app/blob/master/hospital-backend/config/db.js"
    click ModelsIndex "https://github.com/franca26/hospital-app/blob/master/hospital-backend/models/index.js"
    click ModelsDir "https://github.com/franca26/hospital-app/tree/master/hospital-backend/models/"
    click Routes "https://github.com/franca26/hospital-app/tree/master/hospital-backend/routes/"
    click RouteIndex "https://github.com/franca26/hospital-app/blob/master/hospital-backend/routes/index.js"
    click Controllers "https://github.com/franca26/hospital-app/tree/master/hospital-backend/controllers/"
    click HistorialCtrl "https://github.com/franca26/hospital-app/blob/master/hospital-backend/controllers/historialMedicoController.js"
    click AuthUtil "https://github.com/franca26/hospital-app/blob/master/hospital-backend/utils/auth.js"
    click EmailUtil "https://github.com/franca26/hospital-app/blob/master/hospital-backend/utils/email.js"
    click NotifUtil "https://github.com/franca26/hospital-app/blob/master/hospital-backend/utils/notificaciones.js"
    click TurnoUtil "https://github.com/franca26/hospital-app/blob/master/hospital-backend/utils/turnoUtils.js"
    click SyncUtil "https://github.com/franca26/hospital-app/blob/master/hospital-backend/utils/sync.js"
    click SQLScript "https://github.com/franca26/hospital-app/blob/master/hospital-backend/database/hospital_turnos.sql"
    click FileStorage "https://github.com/franca26/hospital-app/tree/master/hospital-backend/upload/historiales"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef backend fill:#D0FFD6,stroke:#333,stroke-width:1px
    classDef data fill:#FFE4B5,stroke:#333,stroke-width:1px
    classDef external fill:#E5CCFF,stroke:#333,stroke-width:1px
```
