# josephceverino/clinica-vida-sana architecture

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

- Interactive diagram: https://gitdiagram.com/josephceverino/clinica-vida-sana
- Repository: https://github.com/josephceverino/clinica-vida-sana

## Overview

Clínica Vida Sana es un portal web de clínica simulada. El recorrido principal va del registro y verificación de la cuenta del paciente a la consulta de horarios, reserva o solicitud de cita y, finalmente, atención médica reflejada en la historia clínica. El panel cubre además agenda, gestión de pacientes y cuentas, perfiles y auditoría; la zona pública ofrece información y contacto. Las relaciones se basan en el README y las referencias del índice de fuentes; no se inspeccionó el código de todos los módulos.

Main entry points: [`app/core/auth.php`](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/auth.php) (Autenticación y roles), [`app/modelos/citas.php`](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/citas.php) (Citas), [`app/modelos/horarios.php`](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/horarios.php) (Horarios y disponibilidad), [`app/core/db.php`](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/db.php) (Conexión PDO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Web pública"]
  node_public_pages["Información y contacto<br/>[index.php]"]
  node_registration["Registro de cuenta<br/>[registro.php]"]
  node_login["Inicio de sesión<br/>[login.php]"]
end

subgraph group_access["Acceso y soporte"]
  node_auth["Autenticación y roles<br/>[auth.php]"]
  node_db[("Conexión PDO<br/>[db.php]")]
  node_limits["Límites de acceso<br/>[limites.php]"]
  node_errors["Errores seguros<br/>[errores.php]"]
  node_layouts["Plantillas por zona"]
  node_audit["Auditoría clínica<br/>[auditoria.php]"]
end

subgraph group_patient["Portal paciente"]
  node_patient_home["Inicio e historia<br/>[index.php]"]
  node_booking["Reserva de cita<br/>[pedir-cita.php]"]
  node_my_appointments["Mis citas<br/>[citas.php]"]
  node_patient_profile["Perfil del paciente<br/>[perfil.php]"]
end

subgraph group_staff["Operación clínica"]
  node_staff_dashboard["Panel y Mi día<br/>[index.php]"]
  node_staff_appointments["Gestión de citas<br/>[gestionar-cita.php]"]
  node_staff_schedule["Agenda y horarios<br/>[agenda.php]"]
  node_care["Registrar atención<br/>[atender-cita.php]"]
  node_staff_admin["Administración<br/>[usuarios.php]"]
end

subgraph group_data["Modelos clínicos"]
  node_scheduling["Horarios y disponibilidad<br/>[horarios.php]"]
  node_appointments["Citas<br/>[citas.php]"]
  node_requests["Solicitudes de cita<br/>[solicitudes.php]"]
  node_encounters["Atenciones clínicas<br/>[atenciones.php]"]
  node_patients_model["Pacientes<br/>[pacientes.php]"]
  node_accounts["Cuentas y verificación<br/>[cuentas.php]"]
end

node_visitor(("Visitante"))
node_patient_actor(("Paciente"))
node_staff_actor(("Personal clínico"))

node_visitor -->|"consulta"| node_public_pages
node_visitor -->|"se registra"| node_registration
node_patient_actor -->|"inicia sesión"| node_login
node_staff_actor -->|"inicia sesión"| node_login
node_registration -->|"crea cuenta"| node_accounts
node_login -->|"verifica acceso"| node_auth
node_auth -->|"consulta cuentas"| node_db
node_auth -->|"aplica límites"| node_limits
node_auth -->|"usa errores"| node_errors
node_public_pages -->|"renderiza"| node_layouts
node_patient_actor -->|"consulta portal"| node_patient_home
node_patient_actor -->|"elige horario"| node_booking
node_booking -->|"consulta huecos"| node_scheduling
node_booking -->|"envía solicitud"| node_requests
node_booking -->|"reserva cita"| node_appointments
node_patient_home -->|"muestra próxima cita"| node_appointments
node_patient_home -->|"muestra solicitudes"| node_requests
node_patient_home -->|"muestra atención"| node_encounters
node_my_appointments -->|"consulta y cancela"| node_appointments
node_patient_profile -->|"requiere paciente"| node_auth
node_staff_actor -->|"accede al panel"| node_staff_dashboard
node_staff_dashboard -->|"consulta cuentas"| node_accounts
node_staff_dashboard -->|"consulta citas"| node_appointments
node_staff_dashboard -->|"consulta agenda"| node_scheduling
node_staff_appointments -->|"gestiona estados"| node_appointments
node_staff_schedule -->|"administra horarios"| node_scheduling
node_care -->|"registra atención"| node_encounters
node_care -->|"registra acceso"| node_audit
node_appointments -->|"usa duración"| node_scheduling
node_requests -->|"comprueba ocupación"| node_scheduling
node_appointments -->|"lee y escribe"| node_db
node_scheduling -->|"lee y escribe"| node_db
node_requests -->|"lee y escribe"| node_db
node_encounters -->|"lee y escribe"| node_db
node_staff_admin -->|"protege con roles"| node_auth
node_staff_admin -->|"consulta auditoría"| node_audit
node_audit -->|"obtiene usuario"| node_auth

click node_public_pages "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/index.php"
click node_registration "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/registro.php"
click node_login "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/login.php"
click node_auth "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/auth.php"
click node_db "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/db.php"
click node_limits "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/limites.php"
click node_errors "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/errores.php"
click node_layouts "https://github.com/josephceverino/clinica-vida-sana/tree/main/app/layout"
click node_patient_home "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/index.php"
click node_booking "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/pedir-cita.php"
click node_my_appointments "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/citas.php"
click node_patient_profile "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/perfil.php"
click node_scheduling "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/horarios.php"
click node_appointments "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/citas.php"
click node_requests "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/solicitudes.php"
click node_encounters "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/atenciones.php"
click node_patients_model "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/pacientes.php"
click node_accounts "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/cuentas.php"
click node_staff_dashboard "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/index.php"
click node_staff_appointments "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/gestionar-cita.php"
click node_staff_schedule "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/agenda.php"
click node_care "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/atender-cita.php"
click node_staff_admin "https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/usuarios.php"
click node_audit "https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/auditoria.php"

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_public_pages,node_registration,node_login toneBlue
class node_auth,node_db,node_limits,node_errors,node_layouts,node_audit toneAmber
class node_patient_home,node_booking,node_my_appointments,node_patient_profile toneMint
class node_staff_dashboard,node_staff_appointments,node_staff_schedule,node_care,node_staff_admin toneRose
class node_scheduling,node_appointments,node_requests,node_encounters,node_patients_model,node_accounts,node_visitor,node_patient_actor,node_staff_actor toneIndigo
```

## Components

### Web pública

- [Información y contacto](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/index.php): `public/index.php`
- [Registro de cuenta](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/registro.php): `public/registro.php`
- [Inicio de sesión](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/login.php): `public/login.php`

### Acceso y soporte

- [Autenticación y roles](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/auth.php): `app/core/auth.php`
- [Conexión PDO](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/db.php): `app/core/db.php`
- [Límites de acceso](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/limites.php): `app/core/limites.php`
- [Errores seguros](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/errores.php): `app/core/errores.php`
- [Plantillas por zona](https://github.com/josephceverino/clinica-vida-sana/tree/main/app/layout): `app/layout`
- [Auditoría clínica](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/core/auditoria.php): `app/core/auditoria.php`

### Portal paciente

- [Inicio e historia](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/index.php): `public/paciente/index.php`
- [Reserva de cita](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/pedir-cita.php): `public/paciente/pedir-cita.php`
- [Mis citas](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/citas.php): `public/paciente/citas.php`
- [Perfil del paciente](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/paciente/perfil.php): `public/paciente/perfil.php`

### Operación clínica

- [Panel y Mi día](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/index.php): `public/panel/index.php`
- [Gestión de citas](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/gestionar-cita.php): `public/panel/gestionar-cita.php`
- [Agenda y horarios](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/agenda.php): `public/panel/agenda.php`
- [Registrar atención](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/atender-cita.php): `public/panel/atender-cita.php`
- [Administración](https://github.com/josephceverino/clinica-vida-sana/blob/main/public/panel/usuarios.php): `public/panel/usuarios.php`

### Modelos clínicos

- [Horarios y disponibilidad](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/horarios.php): `app/modelos/horarios.php`
- [Citas](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/citas.php): `app/modelos/citas.php`
- [Solicitudes de cita](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/solicitudes.php): `app/modelos/solicitudes.php`
- [Atenciones clínicas](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/atenciones.php): `app/modelos/atenciones.php`
- [Pacientes](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/pacientes.php): `app/modelos/pacientes.php`
- [Cuentas y verificación](https://github.com/josephceverino/clinica-vida-sana/blob/main/app/modelos/cuentas.php): `app/modelos/cuentas.php`

### Other components

- **Visitante**
- **Paciente**
- **Personal clínico**

## Connections

- Visitante → Información y contacto: consulta
- Visitante → Registro de cuenta: se registra
- Paciente → Inicio de sesión: inicia sesión
- Personal clínico → Inicio de sesión: inicia sesión
- Registro de cuenta → Cuentas y verificación: crea cuenta (evidence: `public/registro.php`)
- Inicio de sesión → Autenticación y roles: verifica acceso (evidence: `public/login.php`)
- Autenticación y roles → Conexión PDO: consulta cuentas (evidence: `app/core/auth.php`)
- Autenticación y roles → Límites de acceso: aplica límites (evidence: `app/core/auth.php`)
- Autenticación y roles → Errores seguros: usa errores (evidence: `app/core/auth.php`)
- Información y contacto → Plantillas por zona: renderiza (evidence: `public/index.php`)
- Paciente → Inicio e historia: consulta portal
- Paciente → Reserva de cita: elige horario
- Reserva de cita → Horarios y disponibilidad: consulta huecos (evidence: `public/paciente/pedir-cita.php`)
- Reserva de cita → Solicitudes de cita: envía solicitud (evidence: `public/paciente/pedir-cita.php`)
- Reserva de cita → Citas: reserva cita
- Inicio e historia → Citas: muestra próxima cita (evidence: `public/paciente/index.php`)
- Inicio e historia → Solicitudes de cita: muestra solicitudes (evidence: `public/paciente/index.php`)
- Inicio e historia → Atenciones clínicas: muestra atención (evidence: `public/paciente/index.php`)
- Mis citas → Citas: consulta y cancela (evidence: `public/paciente/citas.php`)
- Perfil del paciente → Autenticación y roles: requiere paciente (evidence: `public/paciente/perfil.php`)
- Personal clínico → Panel y Mi día: accede al panel
- Panel y Mi día → Cuentas y verificación: consulta cuentas (evidence: `public/panel/index.php`)
- Panel y Mi día → Citas: consulta citas
- Panel y Mi día → Horarios y disponibilidad: consulta agenda
- Gestión de citas → Citas: gestiona estados (evidence: `public/panel/gestionar-cita.php`)
- Agenda y horarios → Horarios y disponibilidad: administra horarios
- Registrar atención → Atenciones clínicas: registra atención (evidence: `public/panel/atender-cita.php`)
- Registrar atención → Auditoría clínica: registra acceso (evidence: `public/panel/atender-cita.php`)
- Citas → Horarios y disponibilidad: usa duración (evidence: `app/modelos/citas.php`)
- Solicitudes de cita → Horarios y disponibilidad: comprueba ocupación (evidence: `app/modelos/solicitudes.php`)
- Citas → Conexión PDO: lee y escribe (evidence: `app/modelos/citas.php`)
- Horarios y disponibilidad → Conexión PDO: lee y escribe (evidence: `app/modelos/horarios.php`)
- Solicitudes de cita → Conexión PDO: lee y escribe (evidence: `app/modelos/solicitudes.php`)
- Atenciones clínicas → Conexión PDO: lee y escribe (evidence: `app/modelos/atenciones.php`)
- Administración → Autenticación y roles: protege con roles (evidence: `public/panel/usuarios.php`)
- Administración → Auditoría clínica: consulta auditoría
- Auditoría clínica → Autenticación y roles: obtiene usuario (evidence: `app/core/auditoria.php`)
