# mmdelapuerta-coder/dentasync architecture

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

- Interactive diagram: https://gitdiagram.com/mmdelapuerta-coder/dentasync
- Repository: https://github.com/mmdelapuerta-coder/dentasync

## Overview

DentaSync is a dental-clinic portal with a React frontend and an Express/PostgreSQL API. Users enter through the routed app and role-specific screens; API requests reach the backend, where authentication and domain routes support patient, staff, dentist, and admin workflows. Major capabilities include appointments and clinic schedules, queues and check-in, clinical records and dental charts, AI assistance, document synchronization, notifications, and administration. The excerpts show selected route-to-service calls and database setup; some feature wiring is documented only by the source index, so uncertain links are omitted.

Main entry points: [`backend/routes/patientPortal.js`](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/patientPortal.js) (Patient portal routes), [`backend/server.js`](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/server.js) (Express API), [`backend/services/clinicalPatients.js`](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicalPatients.js) (Clinical records), [`backend/routes/staffPortal.js`](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/staffPortal.js) (Staff operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Role-based app<br/>[App.jsx]"]
  node_authui["Sign-in and registration<br/>[AuthPage.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and security"]
  node_api_server["Express API<br/>[server.js]"]
  node_security["Security configuration<br/>[securityConfig.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_otp["OTP verification<br/>[otpService.js]"]
  node_otp_store[("OTP persistence")]
  node_postgres[("PostgreSQL pool<br/>[db.js]")]
end

subgraph group_care["Clinical operations"]
  node_clinical_routes["Clinical and dentist routes<br/>[dentistPortal.js]"]
  node_clinical["Clinical records"]
  node_dental_chart["Dental chart sync<br/>[dentalChartSync.js]"]
  node_wellness["Dental wellness<br/>[dentalWellness.js]"]
  node_staff_routes["Staff operations<br/>[staffPortal.js]"]
  node_checkin["Staff check-in<br/>[staffCheckIn.js]"]
  node_walkin_qr["Walk-in QR check-in<br/>[staffWalkInQr.js]"]
  node_queue_prediction["Queue wait prediction"]
  node_schedule["Clinic schedule<br/>[clinicSchedule.js]"]
end

subgraph group_patient["Patient services"]
  node_patient_routes["Patient portal routes<br/>[patientPortal.js]"]
  node_patient_data["Patient data<br/>[patientData.js]"]
  node_patient_ids["Patient identifiers<br/>[patientIds.js]"]
  node_patient_notify["Patient notifications"]
end

subgraph group_admin["Administration and intelligence"]
  node_admin_routes["Admin portal routes<br/>[adminPortal.js]"]
  node_admin_command["Admin command center"]
  node_admin_audit["Admin audit<br/>[adminAudit.js]"]
  node_admin_analytics["Admin analytics<br/>[adminAnalytics.js]"]
  node_assistant["Clinic AI assistant<br/>[clinicAssistant.js]"]
  node_ai_usage["AI usage tracking<br/>[aiUsage.js]"]
  node_document_sync["Document synchronization"]
  node_document_extract["Document extraction"]
end

node_visitor(("Portal user"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -.->|"loads"| node_api_client
node_api_client -->|"sends API requests"| node_api_server
node_api_server -->|"queries"| node_postgres
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_patient_routes
node_api_server -->|"configures"| node_security
node_api_server -->|"mounts"| node_clinical_routes
node_api_server -.->|"mounts"| node_staff_routes
node_api_server -.->|"mounts"| node_admin_routes
node_auth_routes -->|"verifies OTP"| node_otp
node_api_server -->|"configures"| node_otp_store
node_patient_routes -->|"uses"| node_patient_data
node_patient_routes -->|"uses"| node_patient_ids
node_patient_routes -->|"uses"| node_patient_notify
node_patient_routes -->|"uses"| node_clinical
node_patient_routes -->|"uses"| node_assistant
node_patient_routes -->|"uses"| node_checkin
node_patient_routes -->|"uses"| node_walkin_qr
node_patient_routes -->|"uses"| node_queue_prediction
node_patient_routes -->|"uses"| node_schedule
node_clinical_routes -->|"uses"| node_clinical
node_clinical_routes -->|"uses"| node_dental_chart
node_clinical_routes -->|"uses"| node_wellness
node_clinical -->|"uses"| node_dental_chart
node_clinical -->|"uses"| node_patient_data
node_staff_routes -->|"uses"| node_clinical
node_staff_routes -->|"uses"| node_checkin
node_staff_routes -->|"uses"| node_walkin_qr
node_staff_routes -->|"uses"| node_queue_prediction
node_admin_routes -->|"attaches routes"| node_admin_command
node_admin_routes -->|"loads analytics"| node_admin_analytics
node_admin_routes -->|"uses"| node_clinical
node_admin_command -->|"uses"| node_admin_audit
node_admin_command -->|"uses"| node_patient_notify
node_assistant -->|"uses"| node_schedule
node_assistant -->|"records usage"| node_ai_usage
node_document_sync -.->|"dispatches extraction"| node_document_extract

click node_app "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/App.jsx"
click node_authui "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/pages/AuthPage.jsx"
click node_api_client "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/api.js"
click node_api_server "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/server.js"
click node_security "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/lib/securityConfig.js"
click node_auth_routes "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/auth.js"
click node_otp "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/otpService.js"
click node_otp_store "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/repositories/postgresOtpStore.js"
click node_postgres "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/db.js"
click node_patient_routes "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/patientPortal.js"
click node_patient_data "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientData.js"
click node_patient_ids "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientIds.js"
click node_patient_notify "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientPortalNotifications.js"
click node_clinical_routes "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/dentistPortal.js"
click node_clinical "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicalPatients.js"
click node_dental_chart "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/dentalChartSync.js"
click node_wellness "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/dentalWellness.js"
click node_staff_routes "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/staffPortal.js"
click node_checkin "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/staffCheckIn.js"
click node_walkin_qr "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/staffWalkInQr.js"
click node_queue_prediction "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/queueWaitPrediction.js"
click node_schedule "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicSchedule.js"
click node_admin_routes "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminPortal.js"
click node_admin_command "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminCommandCenter.js"
click node_admin_audit "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/adminAudit.js"
click node_admin_analytics "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/adminAnalytics.js"
click node_assistant "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicAssistant.js"
click node_ai_usage "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/aiUsage.js"
click node_document_sync "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminDocumentSync.js"
click node_document_extract "https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/documentSyncExtraction.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_app,node_authui,node_api_client,node_visitor toneBlue
class node_api_server,node_security,node_auth_routes,node_otp,node_otp_store,node_postgres toneAmber
class node_clinical_routes,node_clinical,node_dental_chart,node_wellness,node_staff_routes,node_checkin,node_walkin_qr,node_queue_prediction,node_schedule toneMint
class node_patient_routes,node_patient_data,node_patient_ids,node_patient_notify toneRose
class node_admin_routes,node_admin_command,node_admin_audit,node_admin_analytics,node_assistant,node_ai_usage,node_document_sync,node_document_extract toneIndigo
```

## Components

### Web application

- [Role-based app](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in and registration](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/pages/AuthPage.jsx): `frontend/src/pages/AuthPage.jsx`
- [API client](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/frontend/src/api.js): `frontend/src/api.js`

### API and security

- [Express API](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/server.js): `backend/server.js`
- [Security configuration](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/lib/securityConfig.js): `backend/lib/securityConfig.js`
- [Authentication routes](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/auth.js): `backend/routes/auth.js`
- [OTP verification](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/otpService.js): `backend/services/otpService.js`
- [OTP persistence](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/repositories/postgresOtpStore.js): `backend/repositories/postgresOtpStore.js`
- [PostgreSQL pool](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/db.js): `backend/db.js`

### Clinical operations

- [Clinical and dentist routes](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/dentistPortal.js): `backend/routes/dentistPortal.js`
- [Clinical records](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicalPatients.js): `backend/services/clinicalPatients.js`
- [Dental chart sync](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/dentalChartSync.js): `backend/services/dentalChartSync.js`
- [Dental wellness](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/dentalWellness.js): `backend/services/dentalWellness.js`
- [Staff operations](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/staffPortal.js): `backend/routes/staffPortal.js`
- [Staff check-in](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/staffCheckIn.js): `backend/services/staffCheckIn.js`
- [Walk-in QR check-in](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/staffWalkInQr.js): `backend/services/staffWalkInQr.js`
- [Queue wait prediction](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/queueWaitPrediction.js): `backend/services/queueWaitPrediction.js`
- [Clinic schedule](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicSchedule.js): `backend/services/clinicSchedule.js`

### Patient services

- [Patient portal routes](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/patientPortal.js): `backend/routes/patientPortal.js`
- [Patient data](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientData.js): `backend/services/patientData.js`
- [Patient identifiers](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientIds.js): `backend/services/patientIds.js`
- [Patient notifications](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/patientPortalNotifications.js): `backend/services/patientPortalNotifications.js`

### Administration and intelligence

- [Admin portal routes](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminPortal.js): `backend/routes/adminPortal.js`
- [Admin command center](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminCommandCenter.js): `backend/routes/adminCommandCenter.js`
- [Admin audit](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/adminAudit.js): `backend/services/adminAudit.js`
- [Admin analytics](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/adminAnalytics.js): `backend/services/adminAnalytics.js`
- [Clinic AI assistant](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/clinicAssistant.js): `backend/services/clinicAssistant.js`
- [AI usage tracking](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/aiUsage.js): `backend/services/aiUsage.js`
- [Document synchronization](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/routes/adminDocumentSync.js): `backend/routes/adminDocumentSync.js`
- [Document extraction](https://github.com/mmdelapuerta-coder/dentasync/blob/cursor/mobile-logout-booking-5dfe/backend/services/documentSyncExtraction.js): `backend/services/documentSyncExtraction.js`

### Other components

- **Portal user**

## Connections

- Portal user → Role-based app: uses (evidence: `README.md`)
- Role-based app → Sign-in and registration: routes to (evidence: `frontend/src/App.jsx`)
- Role-based app → API client: loads
- API client → Express API: sends API requests (evidence: `README.md`)
- Express API → PostgreSQL pool: queries (evidence: `backend/server.js`)
- Express API → Authentication routes: mounts (evidence: `backend/server.js`)
- Express API → Patient portal routes: mounts (evidence: `backend/server.js`)
- Express API → Security configuration: configures (evidence: `backend/server.js`)
- Express API → Clinical and dentist routes: mounts (evidence: `backend/server.js`)
- Express API → Staff operations: mounts (evidence: `backend/server.js`)
- Express API → Admin portal routes: mounts (evidence: `backend/server.js`)
- Authentication routes → OTP verification: verifies OTP (evidence: `backend/routes/auth.js`)
- Express API → OTP persistence: configures (evidence: `backend/server.js`)
- Patient portal routes → Patient data: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Patient identifiers: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Patient notifications: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Clinical records: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Clinic AI assistant: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Staff check-in: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Walk-in QR check-in: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Queue wait prediction: uses (evidence: `backend/routes/patientPortal.js`)
- Patient portal routes → Clinic schedule: uses (evidence: `backend/routes/patientPortal.js`)
- Clinical and dentist routes → Clinical records: uses (evidence: `backend/routes/dentistPortal.js`)
- Clinical and dentist routes → Dental chart sync: uses (evidence: `backend/routes/dentistPortal.js`)
- Clinical and dentist routes → Dental wellness: uses (evidence: `backend/routes/dentistPortal.js`)
- Clinical records → Dental chart sync: uses (evidence: `backend/services/clinicalPatients.js`)
- Clinical records → Patient data: uses (evidence: `backend/services/clinicalPatients.js`)
- Staff operations → Clinical records: uses (evidence: `backend/routes/staffPortal.js`)
- Staff operations → Staff check-in: uses (evidence: `backend/routes/staffPortal.js`)
- Staff operations → Walk-in QR check-in: uses (evidence: `backend/routes/staffPortal.js`)
- Staff operations → Queue wait prediction: uses (evidence: `backend/routes/staffPortal.js`)
- Admin portal routes → Admin command center: attaches routes (evidence: `backend/routes/adminPortal.js`)
- Admin portal routes → Admin analytics: loads analytics (evidence: `backend/routes/adminPortal.js`)
- Admin portal routes → Clinical records: uses (evidence: `backend/routes/adminPortal.js`)
- Admin command center → Admin audit: uses (evidence: `backend/routes/adminCommandCenter.js`)
- Admin command center → Patient notifications: uses (evidence: `backend/routes/adminCommandCenter.js`)
- Clinic AI assistant → Clinic schedule: uses (evidence: `backend/services/clinicAssistant.js`)
- Clinic AI assistant → AI usage tracking: records usage (evidence: `backend/services/clinicAssistant.js`)
- Document synchronization → Document extraction: dispatches extraction
