# truckgreen/consultorio_issac architecture

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

- Interactive diagram: https://gitdiagram.com/truckgreen/consultorio_issac
- Repository: https://github.com/truckgreen/consultorio_issac

## Overview

EQUILIBRA is a clinic-services, appointment-booking, and administration platform with a root React web client, a separate React client under `aplicacion/`, and a documented native Android client. The main patient workflow is browsing services, optionally using clinical guidance, booking an appointment, and consulting its code; staff manage appointments and patient records. Supabase and local storage provide web persistence, while the README describes Room and Supabase for Android. Several component relationships are based on the README or SOURCE INDEX; unsampled details are not expanded into speculative flows.

Main entry points: [`src/App.tsx`](https://github.com/truckgreen/consultorio_issac/blob/main/src/App.tsx) (Web app shell), [`src/components/AdminPanelView.tsx`](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/AdminPanelView.tsx) (Admin panel), [`aplicacion/src/App.tsx`](https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/App.tsx) (Android-associated web client), [`src/components/BookingModal.tsx`](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/BookingModal.tsx) (Booking flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patient["Patient experience"]
  node_webapp["Web app shell<br/>[App.tsx]"]
  node_services["Services catalog<br/>[ServicesGrid.tsx]"]
  node_service_data["Service data<br/>[servicesData.ts]"]
  node_clinical_guidance["Clinical guidance"]
  node_booking["Booking flow<br/>[BookingModal.tsx]"]
  node_booking_logic["Booking utilities<br/>[bookingUtils.ts]"]
  node_patient_portal["Appointment portal"]
end

subgraph group_operations["Clinic operations"]
  node_admin_panel["Admin panel<br/>[AdminPanelView.tsx]"]
  node_appointment_admin["Appointment management"]
  node_patient_records["Patient records"]
  node_admin_services["Service pricing"]
end

subgraph group_persistence["Persistence and services"]
  node_supabase_web[("Web persistence<br/>[supabase.ts]")]
  node_security["Staff security<br/>[security.ts]"]
  node_server["Server<br/>[server.ts]"]
  node_email["Email service<br/>[serverEmail.ts]"]
end

subgraph group_android["Android client"]
  node_android_app["Android app"]
  node_android_web["Android-associated web client<br/>[App.tsx]"]
  node_android_booking["Android web booking<br/>[BookingSection.tsx]"]
  node_android_admin["Android web admin"]
  node_supabase_android[("Android web persistence<br/>[supabase.ts]")]
end

node_patient(("Patients"))

node_patient -->|"uses"| node_webapp
node_webapp -->|"renders"| node_services
node_services -->|"reads"| node_service_data
node_webapp -->|"renders"| node_clinical_guidance
node_webapp -->|"opens"| node_booking
node_booking -.->|"uses"| node_booking_logic
node_booking -.->|"persists"| node_supabase_web
node_webapp -->|"opens"| node_patient_portal
node_admin_panel -.->|"renders"| node_appointment_admin
node_admin_panel -->|"opens"| node_patient_records
node_admin_panel -.->|"renders"| node_admin_services
node_admin_panel -->|"reads and writes"| node_supabase_web
node_supabase_web -->|"gets auth headers"| node_security
node_server -->|"uses"| node_email
node_android_app -.->|"includes client"| node_android_web
node_android_web -.->|"renders"| node_android_booking
node_android_web -.->|"renders"| node_android_admin
node_android_web -->|"uses"| node_supabase_android
node_android_app -.->|"syncs appointments"| node_supabase_android

click node_webapp "https://github.com/truckgreen/consultorio_issac/blob/main/src/App.tsx"
click node_services "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/ServicesGrid.tsx"
click node_service_data "https://github.com/truckgreen/consultorio_issac/blob/main/src/data/servicesData.ts"
click node_clinical_guidance "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/InteractiveAssessment.tsx"
click node_booking "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/BookingModal.tsx"
click node_booking_logic "https://github.com/truckgreen/consultorio_issac/blob/main/src/utils/bookingUtils.ts"
click node_patient_portal "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/PatientPortalModal.tsx"
click node_admin_panel "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/AdminPanelView.tsx"
click node_appointment_admin "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/AppointmentsManagerView.tsx"
click node_patient_records "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/PatientDetailModal.tsx"
click node_admin_services "https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/ServicesPricingView.tsx"
click node_supabase_web "https://github.com/truckgreen/consultorio_issac/blob/main/src/lib/supabase.ts"
click node_security "https://github.com/truckgreen/consultorio_issac/blob/main/src/utils/security.ts"
click node_server "https://github.com/truckgreen/consultorio_issac/blob/main/server.ts"
click node_email "https://github.com/truckgreen/consultorio_issac/blob/main/serverEmail.ts"
click node_android_app "https://github.com/truckgreen/consultorio_issac/tree/main/aplicacion/app"
click node_android_web "https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/App.tsx"
click node_android_booking "https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/components/BookingSection.tsx"
click node_android_admin "https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/components/admin/AppointmentsManagerView.tsx"
click node_supabase_android "https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/lib/supabase.ts"

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_webapp,node_services,node_service_data,node_clinical_guidance,node_booking,node_booking_logic,node_patient_portal toneBlue
class node_admin_panel,node_appointment_admin,node_patient_records,node_admin_services toneAmber
class node_supabase_web,node_security,node_server,node_email toneMint
class node_android_app,node_android_web,node_android_booking,node_android_admin,node_supabase_android toneRose
class node_patient toneIndigo
```

## Components

### Patient experience

- [Web app shell](https://github.com/truckgreen/consultorio_issac/blob/main/src/App.tsx): `src/App.tsx`
- [Services catalog](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/ServicesGrid.tsx): `src/components/ServicesGrid.tsx`
- [Service data](https://github.com/truckgreen/consultorio_issac/blob/main/src/data/servicesData.ts): `src/data/servicesData.ts`
- [Clinical guidance](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/InteractiveAssessment.tsx): `src/components/InteractiveAssessment.tsx`
- [Booking flow](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/BookingModal.tsx): `src/components/BookingModal.tsx`
- [Booking utilities](https://github.com/truckgreen/consultorio_issac/blob/main/src/utils/bookingUtils.ts): `src/utils/bookingUtils.ts`
- [Appointment portal](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/PatientPortalModal.tsx): `src/components/PatientPortalModal.tsx`

### Clinic operations

- [Admin panel](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/AdminPanelView.tsx): `src/components/AdminPanelView.tsx`
- [Appointment management](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/AppointmentsManagerView.tsx): `src/components/admin/AppointmentsManagerView.tsx`
- [Patient records](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/PatientDetailModal.tsx): `src/components/admin/PatientDetailModal.tsx`
- [Service pricing](https://github.com/truckgreen/consultorio_issac/blob/main/src/components/admin/ServicesPricingView.tsx): `src/components/admin/ServicesPricingView.tsx`

### Persistence and services

- [Web persistence](https://github.com/truckgreen/consultorio_issac/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Staff security](https://github.com/truckgreen/consultorio_issac/blob/main/src/utils/security.ts): `src/utils/security.ts`
- [Server](https://github.com/truckgreen/consultorio_issac/blob/main/server.ts): `server.ts`
- [Email service](https://github.com/truckgreen/consultorio_issac/blob/main/serverEmail.ts): `serverEmail.ts`

### Android client

- [Android app](https://github.com/truckgreen/consultorio_issac/tree/main/aplicacion/app): `aplicacion/app`
- [Android-associated web client](https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/App.tsx): `aplicacion/src/App.tsx`
- [Android web booking](https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/components/BookingSection.tsx): `aplicacion/src/components/BookingSection.tsx`
- [Android web admin](https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/components/admin/AppointmentsManagerView.tsx): `aplicacion/src/components/admin/AppointmentsManagerView.tsx`
- [Android web persistence](https://github.com/truckgreen/consultorio_issac/blob/main/aplicacion/src/lib/supabase.ts): `aplicacion/src/lib/supabase.ts`

### Other components

- **Patients**

## Connections

- Patients → Web app shell: uses (evidence: `README.md`)
- Web app shell → Services catalog: renders (evidence: `src/App.tsx`)
- Services catalog → Service data: reads (evidence: `src/components/ServicesGrid.tsx`)
- Web app shell → Clinical guidance: renders (evidence: `src/App.tsx`)
- Web app shell → Booking flow: opens (evidence: `src/App.tsx`)
- Booking flow → Booking utilities: uses
- Booking flow → Web persistence: persists
- Web app shell → Appointment portal: opens (evidence: `src/App.tsx`)
- Admin panel → Appointment management: renders
- Admin panel → Patient records: opens (evidence: `src/components/AdminPanelView.tsx`)
- Admin panel → Service pricing: renders
- Admin panel → Web persistence: reads and writes (evidence: `src/components/AdminPanelView.tsx`)
- Web persistence → Staff security: gets auth headers (evidence: `src/lib/supabase.ts`)
- Server → Email service: uses (evidence: `server.ts`)
- Android app → Android-associated web client: includes client (evidence: `README.md`)
- Android-associated web client → Android web booking: renders
- Android-associated web client → Android web admin: renders (evidence: `aplicacion/src/App.tsx`)
- Android-associated web client → Android web persistence: uses (evidence: `aplicacion/src/App.tsx`)
- Android app → Android web persistence: syncs appointments (evidence: `README.md`)
