# juan-var-camp/consultafacil architecture

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

- Interactive diagram: https://gitdiagram.com/juan-var-camp/consultafacil
- Repository: https://github.com/juan-var-camp/consultafacil

## Overview

This is a Spanish-language clinic appointment web app: visitors find clinics, inspect availability and book appointments; signed-in users manage their appointments, while administrators manage clinics, schedules, users and appointments. The React pages call API modules, which share an HTTP client that attaches stored authentication tokens. The source index documents page-to-module imports and routes; sampled source confirms session restoration and request behavior. Backend endpoints and page implementations not shown in excerpts are represented only where the index supports the relationship.

Main entry points: [`src/App.jsx`](https://github.com/juan-var-camp/consultafacil/blob/main/src/App.jsx) (Route shell), [`src/api/consultorios.js`](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/consultorios.js) (Clinic API), [`src/pages/Consultorio.jsx`](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Consultorio.jsx) (Clinic details), [`src/context/AuthContext.jsx`](https://github.com/juan-var-camp/consultafacil/blob/main/src/context/AuthContext.jsx) (Session context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["Application entry<br/>[main.jsx]"]
  node_router["Route shell<br/>[App.jsx]"]
  node_header["Navigation header<br/>[Header.jsx]"]
  node_guard["Protected routes<br/>[RutaProtegida.jsx]"]
  node_ui["Shared UI components"]
  node_toasts["Toast provider<br/>[Toast.jsx]"]
end

subgraph group_booking["Clinic discovery and booking"]
  node_home["Clinic home<br/>[Home.jsx]"]
  node_search["Clinic search<br/>[Buscar.jsx]"]
  node_clinic["Clinic details<br/>[Consultorio.jsx]"]
  node_selector["Time selection"]
end

subgraph group_accounts["Identity and appointments"]
  node_login["Sign in<br/>[Login.jsx]"]
  node_registration["Registration<br/>[Registro.jsx]"]
  node_auth["Session context<br/>[AuthContext.jsx]"]
  node_myappointments["My appointments<br/>[MisCitas.jsx]"]
  node_agenda["Appointment agenda<br/>[Agenda.jsx]"]
end

subgraph group_admin["Administration"]
  node_adminappointments["Appointment admin<br/>[AdminCitas.jsx]"]
  node_clinicsadmin["Clinic admin"]
  node_schedules["Schedule management<br/>[Horarios.jsx]"]
  node_usersadmin["User admin<br/>[AdminUsuarios.jsx]"]
end

subgraph group_services["API and shared services"]
  node_clinicapi["Clinic API<br/>[consultorios.js]"]
  node_appointmentapi["Appointment API<br/>[citas.js]"]
  node_userapi["User API<br/>[usuarios.js]"]
  node_authapi["Authentication API<br/>[auth.js]"]
  node_http["HTTP client<br/>[cliente.js]"]
  node_dates["Date utilities<br/>[fechas.js]"]
  node_carehours["Clinic hours logic<br/>[atencion.js]"]
end

node_visitor(("Visitor"))
node_signedin(("Signed-in user"))
node_adminuser(("Administrator"))
node_backend{{"Application backend"}}

node_entry -->|"provides session"| node_auth
node_entry -->|"provides notices"| node_toasts
node_entry -->|"renders"| node_router
node_router -->|"renders"| node_header
node_router -->|"routes through"| node_guard
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_search
node_router -->|"routes to"| node_clinic
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_registration
node_router -->|"routes to"| node_myappointments
node_router -->|"routes to"| node_agenda
node_router -->|"routes to"| node_schedules
node_router -->|"routes to"| node_clinicsadmin
node_router -->|"routes to"| node_usersadmin
node_router -->|"routes to"| node_adminappointments
node_visitor -.->|"opens"| node_home
node_visitor -.->|"searches"| node_search
node_home -->|"loads clinics"| node_clinicapi
node_search -->|"searches clinics"| node_clinicapi
node_clinic -->|"loads clinic"| node_clinicapi
node_clinic -->|"books appointment"| node_appointmentapi
node_clinic -->|"renders"| node_selector
node_clinic -->|"uses hours logic"| node_carehours
node_selector -->|"formats times"| node_dates
node_signedin -.->|"signs in"| node_login
node_signedin -.->|"registers"| node_registration
node_login -->|"authenticates"| node_auth
node_registration -->|"registers account"| node_auth
node_auth -->|"calls"| node_authapi
node_auth -->|"reads token key"| node_http
node_signedin -.->|"reviews bookings"| node_myappointments
node_myappointments -->|"manages bookings"| node_appointmentapi
node_agenda -->|"manages agenda"| node_appointmentapi
node_adminuser -.->|"manages clinics"| node_clinicsadmin
node_adminuser -.->|"sets schedules"| node_schedules
node_adminuser -.->|"manages users"| node_usersadmin
node_adminuser -.->|"manages appointments"| node_adminappointments
node_clinicsadmin -->|"manages clinics"| node_clinicapi
node_schedules -->|"updates hours"| node_clinicapi
node_usersadmin -->|"manages users"| node_userapi
node_usersadmin -->|"loads clinics"| node_clinicapi
node_adminappointments -->|"manages bookings"| node_appointmentapi
node_adminappointments -->|"loads clinics"| node_clinicapi
node_clinicapi -->|"sends requests"| node_http
node_appointmentapi -->|"sends requests"| node_http
node_userapi -->|"sends requests"| node_http
node_authapi -->|"sends requests"| node_http

click node_entry "https://github.com/juan-var-camp/consultafacil/blob/main/src/main.jsx"
click node_router "https://github.com/juan-var-camp/consultafacil/blob/main/src/App.jsx"
click node_header "https://github.com/juan-var-camp/consultafacil/blob/main/src/components/Header.jsx"
click node_guard "https://github.com/juan-var-camp/consultafacil/blob/main/src/components/RutaProtegida.jsx"
click node_home "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Home.jsx"
click node_search "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Buscar.jsx"
click node_clinic "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Consultorio.jsx"
click node_selector "https://github.com/juan-var-camp/consultafacil/blob/main/src/components/SelectorHorarios.jsx"
click node_login "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Login.jsx"
click node_registration "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Registro.jsx"
click node_auth "https://github.com/juan-var-camp/consultafacil/blob/main/src/context/AuthContext.jsx"
click node_myappointments "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/MisCitas.jsx"
click node_agenda "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Agenda.jsx"
click node_adminappointments "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminCitas.jsx"
click node_clinicsadmin "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminConsultorios.jsx"
click node_schedules "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Horarios.jsx"
click node_usersadmin "https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminUsuarios.jsx"
click node_clinicapi "https://github.com/juan-var-camp/consultafacil/blob/main/src/api/consultorios.js"
click node_appointmentapi "https://github.com/juan-var-camp/consultafacil/blob/main/src/api/citas.js"
click node_userapi "https://github.com/juan-var-camp/consultafacil/blob/main/src/api/usuarios.js"
click node_authapi "https://github.com/juan-var-camp/consultafacil/blob/main/src/api/auth.js"
click node_http "https://github.com/juan-var-camp/consultafacil/blob/main/src/api/cliente.js"
click node_dates "https://github.com/juan-var-camp/consultafacil/blob/main/src/lib/fechas.js"
click node_carehours "https://github.com/juan-var-camp/consultafacil/blob/main/src/lib/atencion.js"
click node_ui "https://github.com/juan-var-camp/consultafacil/tree/main/src/components/ui"
click node_toasts "https://github.com/juan-var-camp/consultafacil/blob/main/src/components/ui/Toast.jsx"

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_entry,node_router,node_header,node_guard,node_ui,node_toasts,node_signedin toneBlue
class node_home,node_search,node_clinic,node_selector toneAmber
class node_login,node_registration,node_auth,node_myappointments,node_agenda toneMint
class node_adminappointments,node_clinicsadmin,node_schedules,node_usersadmin toneRose
class node_clinicapi,node_appointmentapi,node_userapi,node_authapi,node_http,node_dates,node_carehours,node_visitor,node_adminuser,node_backend toneIndigo
```

## Components

### Application shell

- [Application entry](https://github.com/juan-var-camp/consultafacil/blob/main/src/main.jsx): `src/main.jsx`
- [Route shell](https://github.com/juan-var-camp/consultafacil/blob/main/src/App.jsx): `src/App.jsx`
- [Navigation header](https://github.com/juan-var-camp/consultafacil/blob/main/src/components/Header.jsx): `src/components/Header.jsx`
- [Protected routes](https://github.com/juan-var-camp/consultafacil/blob/main/src/components/RutaProtegida.jsx): `src/components/RutaProtegida.jsx`
- [Shared UI components](https://github.com/juan-var-camp/consultafacil/tree/main/src/components/ui): `src/components/ui`
- [Toast provider](https://github.com/juan-var-camp/consultafacil/blob/main/src/components/ui/Toast.jsx): `src/components/ui/Toast.jsx`

### Clinic discovery and booking

- [Clinic home](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [Clinic search](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Buscar.jsx): `src/pages/Buscar.jsx`
- [Clinic details](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Consultorio.jsx): `src/pages/Consultorio.jsx`
- [Time selection](https://github.com/juan-var-camp/consultafacil/blob/main/src/components/SelectorHorarios.jsx): `src/components/SelectorHorarios.jsx`

### Identity and appointments

- [Sign in](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`
- [Registration](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Registro.jsx): `src/pages/Registro.jsx`
- [Session context](https://github.com/juan-var-camp/consultafacil/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [My appointments](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/MisCitas.jsx): `src/pages/MisCitas.jsx`
- [Appointment agenda](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Agenda.jsx): `src/pages/Agenda.jsx`

### Administration

- [Appointment admin](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminCitas.jsx): `src/pages/AdminCitas.jsx`
- [Clinic admin](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminConsultorios.jsx): `src/pages/AdminConsultorios.jsx`
- [Schedule management](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/Horarios.jsx): `src/pages/Horarios.jsx`
- [User admin](https://github.com/juan-var-camp/consultafacil/blob/main/src/pages/AdminUsuarios.jsx): `src/pages/AdminUsuarios.jsx`

### API and shared services

- [Clinic API](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/consultorios.js): `src/api/consultorios.js`
- [Appointment API](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/citas.js): `src/api/citas.js`
- [User API](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/usuarios.js): `src/api/usuarios.js`
- [Authentication API](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/auth.js): `src/api/auth.js`
- [HTTP client](https://github.com/juan-var-camp/consultafacil/blob/main/src/api/cliente.js): `src/api/cliente.js`
- [Date utilities](https://github.com/juan-var-camp/consultafacil/blob/main/src/lib/fechas.js): `src/lib/fechas.js`
- [Clinic hours logic](https://github.com/juan-var-camp/consultafacil/blob/main/src/lib/atencion.js): `src/lib/atencion.js`

### Other components

- **Visitor**
- **Signed-in user**
- **Administrator**
- **Application backend**

## Connections

- Application entry → Session context: provides session (evidence: `src/main.jsx`)
- Application entry → Toast provider: provides notices (evidence: `src/main.jsx`)
- Application entry → Route shell: renders (evidence: `src/main.jsx`)
- Route shell → Navigation header: renders (evidence: `src/App.jsx`)
- Route shell → Protected routes: routes through (evidence: `src/App.jsx`)
- Route shell → Clinic home: routes to (evidence: `src/App.jsx`)
- Route shell → Clinic search: routes to (evidence: `src/App.jsx`)
- Route shell → Clinic details: routes to (evidence: `src/App.jsx`)
- Route shell → Sign in: routes to (evidence: `src/App.jsx`)
- Route shell → Registration: routes to (evidence: `src/App.jsx`)
- Route shell → My appointments: routes to (evidence: `src/App.jsx`)
- Route shell → Appointment agenda: routes to (evidence: `src/App.jsx`)
- Route shell → Schedule management: routes to (evidence: `src/App.jsx`)
- Route shell → Clinic admin: routes to (evidence: `src/App.jsx`)
- Route shell → User admin: routes to (evidence: `src/App.jsx`)
- Route shell → Appointment admin: routes to (evidence: `src/App.jsx`)
- Visitor → Clinic home: opens
- Visitor → Clinic search: searches
- Clinic home → Clinic API: loads clinics (evidence: `src/pages/Home.jsx`)
- Clinic search → Clinic API: searches clinics (evidence: `src/pages/Buscar.jsx`)
- Clinic details → Clinic API: loads clinic (evidence: `src/pages/Consultorio.jsx`)
- Clinic details → Appointment API: books appointment (evidence: `src/pages/Consultorio.jsx`)
- Clinic details → Time selection: renders (evidence: `src/pages/Consultorio.jsx`)
- Clinic details → Clinic hours logic: uses hours logic (evidence: `src/pages/Consultorio.jsx`)
- Time selection → Date utilities: formats times (evidence: `src/components/SelectorHorarios.jsx`)
- Signed-in user → Sign in: signs in
- Signed-in user → Registration: registers
- Sign in → Session context: authenticates (evidence: `src/pages/Login.jsx`)
- Registration → Session context: registers account (evidence: `src/pages/Registro.jsx`)
- Session context → Authentication API: calls (evidence: `src/context/AuthContext.jsx`)
- Session context → HTTP client: reads token key (evidence: `src/context/AuthContext.jsx`)
- Signed-in user → My appointments: reviews bookings
- My appointments → Appointment API: manages bookings (evidence: `src/pages/MisCitas.jsx`)
- Appointment agenda → Appointment API: manages agenda (evidence: `src/pages/Agenda.jsx`)
- Administrator → Clinic admin: manages clinics
- Administrator → Schedule management: sets schedules
- Administrator → User admin: manages users
- Administrator → Appointment admin: manages appointments
- Clinic admin → Clinic API: manages clinics (evidence: `src/pages/AdminConsultorios.jsx`)
- Schedule management → Clinic API: updates hours (evidence: `src/pages/Horarios.jsx`)
- User admin → User API: manages users (evidence: `src/pages/AdminUsuarios.jsx`)
- User admin → Clinic API: loads clinics (evidence: `src/pages/AdminUsuarios.jsx`)
- Appointment admin → Appointment API: manages bookings (evidence: `src/pages/AdminCitas.jsx`)
- Appointment admin → Clinic API: loads clinics (evidence: `src/pages/AdminCitas.jsx`)
- Clinic API → HTTP client: sends requests (evidence: `src/api/consultorios.js`)
- Appointment API → HTTP client: sends requests (evidence: `src/api/citas.js`)
- User API → HTTP client: sends requests (evidence: `src/api/usuarios.js`)
- Authentication API → HTTP client: sends requests (evidence: `src/api/auth.js`)
