# talasigla-a11y/sigla-tala architecture

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

- Interactive diagram: https://gitdiagram.com/talasigla-a11y/sigla-tala
- Repository: https://github.com/talasigla-a11y/sigla-tala

## Overview

Sigla Tala is a clinic-management application with a browser frontend and an Express/MySQL backend. Patients can register and sign in, book and track appointments, and access medical reports; staff handle appointments and reports, while lead administrators manage workers, schedules, attendance, and activity. The backend also supports announcements and email receipts. The graph preserves these documented-by-module capabilities, but frontend-to-API connections are omitted because the supplied excerpts do not show those calls; unsampled modules are represented by their exact paths.

Main entry points: [`backend/server.js`](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/server.js) (Express server), [`backend/controllers/medicalReportController.js`](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/medicalReportController.js) (Medical reports), [`backend/models/leadAdminModel.js`](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/leadAdminModel.js) (Schedules and activity), [`backend/database/db.js`](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/database/db.js) (MySQL connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser application"]
  node_patient["Patient dashboard"]
  node_staff["Staff dashboard<br/>[admin-dashboard.js]"]
  node_lead_ui["Lead-admin dashboard"]
  node_auth_ui["Authentication UI<br/>[auth.js]"]
  node_receipt_ui["Receipt page"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_appointment_routes["Appointment routes"]
  node_announcement_routes["Announcement routes"]
  node_report_routes["Medical-report routes"]
  node_lead_routes["Lead-admin routes<br/>[leadAdminRoutes.js]"]
  node_auth_guard["Token verification<br/>[authMiddleware.js]"]
  node_role_guard["Worker/admin guard<br/>[adminMiddleware.js]"]
  node_lead_guard["Lead-admin guard"]
end

subgraph group_care["Patient care"]
  node_auth["Authentication<br/>[authController.js]"]
  node_users["User accounts<br/>[userModel.js]"]
  node_appointments["Appointment management"]
  node_appointment_store["Appointment records"]
  node_receipt["Appointment receipts"]
  node_reports["Medical reports"]
  node_report_store["Report records"]
end

subgraph group_operations["Clinic operations"]
  node_announcements["Announcements"]
  node_announcement_store["Announcement records"]
  node_lead_admin["Lead-admin operations"]
  node_lead_store["Schedules and activity<br/>[leadAdminModel.js]"]
  node_db[("MySQL connection<br/>[db.js]")]
  node_email["Email delivery<br/>[gmailSender.js]"]
  node_otp_email["OTP email helper<br/>[sendEmail.js]"]
  node_report_email["Report email helper"]
end

node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_appointment_routes
node_server -->|"mounts"| node_announcement_routes
node_server -->|"mounts"| node_report_routes
node_server -->|"mounts"| node_lead_routes
node_server -->|"initializes"| node_db
node_server -->|"ensures schema"| node_users
node_server -->|"ensures schema"| node_appointment_store
node_server -->|"creates table"| node_report_store
node_server -->|"creates table"| node_announcement_store
node_server -->|"creates tables"| node_lead_store
node_auth_routes -->|"routes to"| node_auth
node_appointment_routes -->|"routes to"| node_appointments
node_announcement_routes -->|"routes to"| node_announcements
node_report_routes -->|"routes to"| node_reports
node_lead_routes -->|"routes to"| node_lead_admin
node_appointment_routes -->|"verifies token"| node_auth_guard
node_appointment_routes -->|"checks role"| node_role_guard
node_announcement_routes -->|"verifies token"| node_auth_guard
node_announcement_routes -->|"checks role"| node_role_guard
node_lead_routes -->|"verifies token"| node_auth_guard
node_lead_routes -->|"checks role"| node_lead_guard
node_auth -->|"uses account data"| node_users
node_auth -->|"uses appointment data"| node_appointment_store
node_auth -->|"logs activity"| node_lead_store
node_auth -->|"sends OTP"| node_otp_email
node_appointments -->|"manages records"| node_appointment_store
node_appointments -->|"logs activity"| node_lead_store
node_appointments -->|"sends receipt"| node_receipt
node_reports -->|"manages reports"| node_report_store
node_reports -->|"loads profile"| node_users
node_reports -->|"handles follow-up"| node_appointment_store
node_reports -->|"logs activity"| node_lead_store
node_reports -->|"sends receipt"| node_receipt
node_reports -->|"sends report"| node_report_email
node_announcements -->|"manages announcements"| node_announcement_store
node_announcements -->|"uses admin data"| node_lead_store
node_lead_admin -->|"manages operations"| node_lead_store
node_users -->|"queries"| node_db
node_appointment_store -->|"queries"| node_db
node_report_store -->|"queries"| node_db
node_announcement_store -->|"queries"| node_db
node_lead_store -->|"queries"| node_db
node_receipt -->|"delivers email"| node_email
node_otp_email -->|"delegates delivery"| node_email
node_report_email -->|"delegates delivery"| node_email

click node_patient "https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/patient-dashboard.js"
click node_staff "https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/admin-dashboard.js"
click node_lead_ui "https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/lead-admin-dashboard.js"
click node_auth_ui "https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/auth.js"
click node_receipt_ui "https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/appointment-receipt.js"
click node_server "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/server.js"
click node_auth_routes "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/authRoutes.js"
click node_appointment_routes "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/appointmentRoutes.js"
click node_announcement_routes "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/announcementRoutes.js"
click node_report_routes "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/medicalReportRoutes.js"
click node_lead_routes "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/leadAdminRoutes.js"
click node_auth_guard "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/authMiddleware.js"
click node_role_guard "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/adminMiddleware.js"
click node_lead_guard "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/leadAdminMiddleware.js"
click node_auth "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/authController.js"
click node_users "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/userModel.js"
click node_appointments "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/appointmentController.js"
click node_appointment_store "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/appointmentModel.js"
click node_receipt "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/appointmentReceipt.js"
click node_reports "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/medicalReportController.js"
click node_report_store "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/medicalReportModel.js"
click node_announcements "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/announcementController.js"
click node_announcement_store "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/announcementModel.js"
click node_lead_admin "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/leadAdminController.js"
click node_lead_store "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/leadAdminModel.js"
click node_db "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/database/db.js"
click node_email "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/gmailSender.js"
click node_otp_email "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/sendEmail.js"
click node_report_email "https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/sendMedicalReport.js"

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_patient,node_staff,node_lead_ui,node_auth_ui,node_receipt_ui toneBlue
class node_server,node_auth_routes,node_appointment_routes,node_announcement_routes,node_report_routes,node_lead_routes,node_auth_guard,node_role_guard,node_lead_guard toneAmber
class node_auth,node_users,node_appointments,node_appointment_store,node_receipt,node_reports,node_report_store toneMint
class node_announcements,node_announcement_store,node_lead_admin,node_lead_store,node_db,node_email,node_otp_email,node_report_email toneRose
```

## Components

### Browser application

- [Patient dashboard](https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/patient-dashboard.js): `frontend/js/patient-dashboard.js`
- [Staff dashboard](https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/admin-dashboard.js): `frontend/js/admin-dashboard.js`
- [Lead-admin dashboard](https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/lead-admin-dashboard.js): `frontend/js/lead-admin-dashboard.js`
- [Authentication UI](https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/auth.js): `frontend/js/auth.js`
- [Receipt page](https://github.com/talasigla-a11y/sigla-tala/blob/main/frontend/js/appointment-receipt.js): `frontend/js/appointment-receipt.js`

### API and access

- [Express server](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Appointment routes](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/appointmentRoutes.js): `backend/routes/appointmentRoutes.js`
- [Announcement routes](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/announcementRoutes.js): `backend/routes/announcementRoutes.js`
- [Medical-report routes](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/medicalReportRoutes.js): `backend/routes/medicalReportRoutes.js`
- [Lead-admin routes](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/routes/leadAdminRoutes.js): `backend/routes/leadAdminRoutes.js`
- [Token verification](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Worker/admin guard](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/adminMiddleware.js): `backend/middleware/adminMiddleware.js`
- [Lead-admin guard](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/middleware/leadAdminMiddleware.js): `backend/middleware/leadAdminMiddleware.js`

### Patient care

- [Authentication](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [User accounts](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/userModel.js): `backend/models/userModel.js`
- [Appointment management](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/appointmentController.js): `backend/controllers/appointmentController.js`
- [Appointment records](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/appointmentModel.js): `backend/models/appointmentModel.js`
- [Appointment receipts](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/appointmentReceipt.js): `backend/utils/appointmentReceipt.js`
- [Medical reports](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/medicalReportController.js): `backend/controllers/medicalReportController.js`
- [Report records](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/medicalReportModel.js): `backend/models/medicalReportModel.js`

### Clinic operations

- [Announcements](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/announcementController.js): `backend/controllers/announcementController.js`
- [Announcement records](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/announcementModel.js): `backend/models/announcementModel.js`
- [Lead-admin operations](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/controllers/leadAdminController.js): `backend/controllers/leadAdminController.js`
- [Schedules and activity](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/models/leadAdminModel.js): `backend/models/leadAdminModel.js`
- [MySQL connection](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/database/db.js): `backend/database/db.js`
- [Email delivery](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/gmailSender.js): `backend/utils/gmailSender.js`
- [OTP email helper](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/sendEmail.js): `backend/utils/sendEmail.js`
- [Report email helper](https://github.com/talasigla-a11y/sigla-tala/blob/main/backend/utils/sendMedicalReport.js): `backend/utils/sendMedicalReport.js`

## Connections

- Express server → Authentication routes: mounts (evidence: `backend/server.js`)
- Express server → Appointment routes: mounts (evidence: `backend/server.js`)
- Express server → Announcement routes: mounts (evidence: `backend/server.js`)
- Express server → Medical-report routes: mounts (evidence: `backend/server.js`)
- Express server → Lead-admin routes: mounts (evidence: `backend/server.js`)
- Express server → MySQL connection: initializes (evidence: `backend/server.js`)
- Express server → User accounts: ensures schema (evidence: `backend/server.js`)
- Express server → Appointment records: ensures schema (evidence: `backend/server.js`)
- Express server → Report records: creates table (evidence: `backend/server.js`)
- Express server → Announcement records: creates table (evidence: `backend/server.js`)
- Express server → Schedules and activity: creates tables (evidence: `backend/server.js`)
- Authentication routes → Authentication: routes to (evidence: `backend/routes/authRoutes.js`)
- Appointment routes → Appointment management: routes to (evidence: `backend/routes/appointmentRoutes.js`)
- Announcement routes → Announcements: routes to (evidence: `backend/routes/announcementRoutes.js`)
- Medical-report routes → Medical reports: routes to (evidence: `backend/routes/medicalReportRoutes.js`)
- Lead-admin routes → Lead-admin operations: routes to (evidence: `backend/routes/leadAdminRoutes.js`)
- Appointment routes → Token verification: verifies token (evidence: `backend/routes/appointmentRoutes.js`)
- Appointment routes → Worker/admin guard: checks role (evidence: `backend/routes/appointmentRoutes.js`)
- Announcement routes → Token verification: verifies token (evidence: `backend/routes/announcementRoutes.js`)
- Announcement routes → Worker/admin guard: checks role (evidence: `backend/routes/announcementRoutes.js`)
- Lead-admin routes → Token verification: verifies token (evidence: `backend/routes/leadAdminRoutes.js`)
- Lead-admin routes → Lead-admin guard: checks role (evidence: `backend/routes/leadAdminRoutes.js`)
- Authentication → User accounts: uses account data (evidence: `backend/controllers/authController.js`)
- Authentication → Appointment records: uses appointment data (evidence: `backend/controllers/authController.js`)
- Authentication → Schedules and activity: logs activity (evidence: `backend/controllers/authController.js`)
- Authentication → OTP email helper: sends OTP (evidence: `backend/controllers/authController.js`)
- Appointment management → Appointment records: manages records (evidence: `backend/controllers/appointmentController.js`)
- Appointment management → Schedules and activity: logs activity (evidence: `backend/controllers/appointmentController.js`)
- Appointment management → Appointment receipts: sends receipt (evidence: `backend/controllers/appointmentController.js`)
- Medical reports → Report records: manages reports (evidence: `backend/controllers/medicalReportController.js`)
- Medical reports → User accounts: loads profile (evidence: `backend/controllers/medicalReportController.js`)
- Medical reports → Appointment records: handles follow-up (evidence: `backend/controllers/medicalReportController.js`)
- Medical reports → Schedules and activity: logs activity (evidence: `backend/controllers/medicalReportController.js`)
- Medical reports → Appointment receipts: sends receipt (evidence: `backend/controllers/medicalReportController.js`)
- Medical reports → Report email helper: sends report (evidence: `backend/controllers/medicalReportController.js`)
- Announcements → Announcement records: manages announcements (evidence: `backend/controllers/announcementController.js`)
- Announcements → Schedules and activity: uses admin data (evidence: `backend/controllers/announcementController.js`)
- Lead-admin operations → Schedules and activity: manages operations (evidence: `backend/controllers/leadAdminController.js`)
- User accounts → MySQL connection: queries (evidence: `backend/models/userModel.js`)
- Appointment records → MySQL connection: queries (evidence: `backend/models/appointmentModel.js`)
- Report records → MySQL connection: queries (evidence: `backend/models/medicalReportModel.js`)
- Announcement records → MySQL connection: queries (evidence: `backend/models/announcementModel.js`)
- Schedules and activity → MySQL connection: queries (evidence: `backend/models/leadAdminModel.js`)
- Appointment receipts → Email delivery: delivers email (evidence: `backend/utils/appointmentReceipt.js`)
- OTP email helper → Email delivery: delegates delivery (evidence: `backend/utils/sendEmail.js`)
- Report email helper → Email delivery: delegates delivery (evidence: `backend/utils/sendMedicalReport.js`)
