# keshariiii/dentzy-testing architecture

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

- Interactive diagram: https://gitdiagram.com/keshariiii/dentzy-testing
- Repository: https://github.com/keshariiii/dentzy-testing

## Overview

Dentzy is a dental-lab workflow application: dentists register and sign in, track lab cases and payments, while administrators manage dentists, orders, and payments and staff have a separate dashboard. The frontend presents responsive public, dentist, admin, and staff experiences; its API client communicates with a routed backend that handles authentication, dashboard, contact, staff, and administration requests. The backend excerpts show database-backed routes and shared security/email utilities. Some dashboard and admin implementations were not sampled, so their internal interactions are not expanded.

Main entry points: [`backend/src/routes/auth.js`](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/auth.js) (Auth endpoints), [`backend/src/index.js`](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/index.js) (API router), [`backend/src/routes/admin.js`](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/admin.js) (Admin endpoints), [`backend/src/middleware/auth.js`](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/middleware/auth.js) (Role verification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["Next.js app routes"]
  node_responsive["Responsive views"]
  node_userauth["Dentist auth state<br/>[AuthContext.jsx]"]
  node_adminauth["Admin auth state"]
  node_staffauth["Staff auth state"]
  node_api["API fetch client<br/>[client.js]"]
  node_contactui["Contact form<br/>[ContactForm.jsx]"]
  node_proxy["API proxy<br/>[&#91;&#91;path&#93;&#93;.js]"]
end

subgraph group_backend["API backend"]
  node_entry["API router<br/>[index.js]"]
  node_contactroutes["Contact endpoint<br/>[contact.js]"]
  node_email["Email delivery<br/>[email.js]"]
end

subgraph group_security["Security and identity"]
  node_authroutes["Auth endpoints<br/>[auth.js]"]
  node_authmw["Role verification<br/>[auth.js]"]
  node_validation["Request validation<br/>[validate.js]"]
  node_crypto["Crypto helpers<br/>[crypto.js]"]
  node_captcha["CAPTCHA helpers<br/>[captcha.js]"]
  node_ratelimit["Rate limiting<br/>[rateLimit.js]"]
end

subgraph group_operations["Lab operations"]
  node_dentistdash["Dentist dashboard"]
  node_pipeline["Production pipeline"]
  node_pipelinepage["Pipeline details<br/>[page.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_staffui["Staff dashboard<br/>[StaffDashboard.jsx]"]
  node_adminroutes["Admin endpoints<br/>[admin.js]"]
  node_dashroutes["Dashboard endpoints<br/>[dashboard.js]"]
  node_staffroutes["Staff endpoints<br/>[staff.js]"]
end

node_visitor(("Visitor or user"))
node_db[("Application database")]

node_visitor -->|"uses"| node_web
node_web -->|"selects layout"| node_responsive
node_web -->|"uses session"| node_userauth
node_web -->|"uses session"| node_adminauth
node_web -->|"uses session"| node_staffauth
node_responsive -->|"renders"| node_dentistdash
node_userauth -->|"requests"| node_api
node_adminauth -->|"requests"| node_api
node_staffauth -->|"requests"| node_api
node_dentistdash -.->|"shows status"| node_pipeline
node_pipeline -->|"opens details"| node_pipelinepage
node_api -.->|"sends API requests"| node_proxy
node_proxy -.->|"forwards requests"| node_entry
node_api -->|"calls API"| node_entry
node_entry -->|"mounts routes"| node_authroutes
node_entry -->|"mounts routes"| node_adminroutes
node_entry -->|"mounts routes"| node_staffroutes
node_entry -->|"mounts routes"| node_dashroutes
node_entry -->|"mounts routes"| node_contactroutes
node_authroutes -->|"reads and writes"| node_db
node_authroutes -->|"checks credentials"| node_crypto
node_authroutes -->|"generates CAPTCHA"| node_captcha
node_authroutes -->|"checks limits"| node_ratelimit
node_authroutes -->|"sends OTP"| node_email
node_authroutes -->|"validates input"| node_validation
node_authroutes -->|"uses verification"| node_authmw
node_authmw -->|"verifies tokens"| node_crypto
node_authmw -->|"checks accounts"| node_db
node_adminroutes -->|"guards routes"| node_authmw
node_adminroutes -->|"validates input"| node_validation
node_adminroutes -->|"checks limits"| node_ratelimit
node_adminroutes -->|"manages records"| node_db
node_adminroutes -->|"sends reminders"| node_email
node_dashroutes -->|"guards routes"| node_authmw
node_dashroutes -->|"validates input"| node_validation
node_dashroutes -->|"reads dashboard data"| node_db
node_staffroutes -->|"guards routes"| node_authmw
node_staffroutes -->|"validates input"| node_validation
node_staffroutes -->|"manages staff work"| node_db
node_contactroutes -->|"validates input"| node_validation
node_contactroutes -->|"sends messages"| node_email
node_adminui -.->|"requests admin data"| node_adminroutes
node_staffui -.->|"requests staff data"| node_staffroutes
node_contactui -.->|"submits inquiry"| node_contactroutes

click node_web "https://github.com/keshariiii/dentzy-testing/tree/main/frontend/src/app"
click node_responsive "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/layouts/ResponsiveLayout.jsx"
click node_userauth "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/context/AuthContext.jsx"
click node_adminauth "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/admin/AdminAuthContext.jsx"
click node_staffauth "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/staff/StaffAuthContext.jsx"
click node_api "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/api/client.js"
click node_dentistdash "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/views/mobile/MobileDashboard.jsx"
click node_pipeline "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/components/common/ProductionPipeline.jsx"
click node_pipelinepage "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/app/dashboard/pipeline/page.jsx"
click node_adminui "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/admin/AdminDashboard.jsx"
click node_staffui "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/staff/StaffDashboard.jsx"
click node_contactui "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/components/ContactForm.jsx"
click node_proxy "https://github.com/keshariiii/dentzy-testing/blob/main/frontend/functions/api/%5B%5Bpath%5D%5D.js"
click node_entry "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/index.js"
click node_authroutes "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/auth.js"
click node_authmw "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/middleware/auth.js"
click node_adminroutes "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/admin.js"
click node_dashroutes "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/dashboard.js"
click node_staffroutes "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/staff.js"
click node_contactroutes "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/contact.js"
click node_validation "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/middleware/validate.js"
click node_crypto "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/crypto.js"
click node_captcha "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/captcha.js"
click node_ratelimit "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/rateLimit.js"
click node_email "https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/email.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_web,node_responsive,node_userauth,node_adminauth,node_staffauth,node_api,node_contactui,node_proxy,node_visitor toneBlue
class node_entry,node_contactroutes,node_email,node_db toneAmber
class node_authroutes,node_authmw,node_validation,node_crypto,node_captcha,node_ratelimit toneMint
class node_dentistdash,node_pipeline,node_pipelinepage,node_adminui,node_staffui,node_adminroutes,node_dashroutes,node_staffroutes toneRose
```

## Components

### Web application

- [Next.js app routes](https://github.com/keshariiii/dentzy-testing/tree/main/frontend/src/app): `frontend/src/app`
- [Responsive views](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/layouts/ResponsiveLayout.jsx): `frontend/src/layouts/ResponsiveLayout.jsx`
- [Dentist auth state](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Admin auth state](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/admin/AdminAuthContext.jsx): `frontend/src/admin/AdminAuthContext.jsx`
- [Staff auth state](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/staff/StaffAuthContext.jsx): `frontend/src/staff/StaffAuthContext.jsx`
- [API fetch client](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Contact form](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/components/ContactForm.jsx): `frontend/src/components/ContactForm.jsx`
- [API proxy](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/functions/api/%5B%5Bpath%5D%5D.js): `frontend/functions/api/[[path]].js`

### API backend

- [API router](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/index.js): `backend/src/index.js`
- [Contact endpoint](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/contact.js): `backend/src/routes/contact.js`
- [Email delivery](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/email.js): `backend/src/utils/email.js`

### Security and identity

- [Auth endpoints](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Role verification](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Request validation](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/middleware/validate.js): `backend/src/middleware/validate.js`
- [Crypto helpers](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/crypto.js): `backend/src/utils/crypto.js`
- [CAPTCHA helpers](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/captcha.js): `backend/src/utils/captcha.js`
- [Rate limiting](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/utils/rateLimit.js): `backend/src/utils/rateLimit.js`

### Lab operations

- [Dentist dashboard](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/views/mobile/MobileDashboard.jsx): `frontend/src/views/mobile/MobileDashboard.jsx`
- [Production pipeline](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/components/common/ProductionPipeline.jsx): `frontend/src/components/common/ProductionPipeline.jsx`
- [Pipeline details](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/app/dashboard/pipeline/page.jsx): `frontend/src/app/dashboard/pipeline/page.jsx`
- [Admin dashboard](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/admin/AdminDashboard.jsx): `frontend/src/admin/AdminDashboard.jsx`
- [Staff dashboard](https://github.com/keshariiii/dentzy-testing/blob/main/frontend/src/staff/StaffDashboard.jsx): `frontend/src/staff/StaffDashboard.jsx`
- [Admin endpoints](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/admin.js): `backend/src/routes/admin.js`
- [Dashboard endpoints](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/dashboard.js): `backend/src/routes/dashboard.js`
- [Staff endpoints](https://github.com/keshariiii/dentzy-testing/blob/main/backend/src/routes/staff.js): `backend/src/routes/staff.js`

### Other components

- **Visitor or user**
- **Application database**

## Connections

- Visitor or user → Next.js app routes: uses (evidence: `frontend/src/app/page.jsx`)
- Next.js app routes → Responsive views: selects layout (evidence: `frontend/src/app/dashboard/page.jsx`)
- Next.js app routes → Dentist auth state: uses session (evidence: `frontend/src/app/dashboard/page.jsx`)
- Next.js app routes → Admin auth state: uses session (evidence: `frontend/src/app/page.jsx`)
- Next.js app routes → Staff auth state: uses session (evidence: `frontend/src/app/page.jsx`)
- Responsive views → Dentist dashboard: renders (evidence: `frontend/src/app/dashboard/page.jsx`)
- Dentist auth state → API fetch client: requests (evidence: `frontend/src/context/AuthContext.jsx`)
- Admin auth state → API fetch client: requests (evidence: `frontend/src/admin/AdminAuthContext.jsx`)
- Staff auth state → API fetch client: requests (evidence: `frontend/src/staff/StaffAuthContext.jsx`)
- Dentist dashboard → Production pipeline: shows status
- Production pipeline → Pipeline details: opens details (evidence: `frontend/src/components/common/ProductionPipeline.jsx`)
- API fetch client → API proxy: sends API requests
- API proxy → API router: forwards requests
- API fetch client → API router: calls API (evidence: `frontend/src/api/client.js`)
- API router → Auth endpoints: mounts routes (evidence: `backend/src/index.js`)
- API router → Admin endpoints: mounts routes (evidence: `backend/src/index.js`)
- API router → Staff endpoints: mounts routes (evidence: `backend/src/index.js`)
- API router → Dashboard endpoints: mounts routes (evidence: `backend/src/index.js`)
- API router → Contact endpoint: mounts routes (evidence: `backend/src/index.js`)
- Auth endpoints → Application database: reads and writes (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → Crypto helpers: checks credentials (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → CAPTCHA helpers: generates CAPTCHA (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → Rate limiting: checks limits (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → Email delivery: sends OTP (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → Request validation: validates input (evidence: `backend/src/routes/auth.js`)
- Auth endpoints → Role verification: uses verification (evidence: `backend/src/routes/auth.js`)
- Role verification → Crypto helpers: verifies tokens (evidence: `backend/src/middleware/auth.js`)
- Role verification → Application database: checks accounts (evidence: `backend/src/middleware/auth.js`)
- Admin endpoints → Role verification: guards routes (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Request validation: validates input (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Rate limiting: checks limits (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Application database: manages records (evidence: `backend/src/routes/admin.js`)
- Admin endpoints → Email delivery: sends reminders (evidence: `backend/src/routes/admin.js`)
- Dashboard endpoints → Role verification: guards routes (evidence: `backend/src/routes/dashboard.js`)
- Dashboard endpoints → Request validation: validates input (evidence: `backend/src/routes/dashboard.js`)
- Dashboard endpoints → Application database: reads dashboard data (evidence: `backend/src/routes/dashboard.js`)
- Staff endpoints → Role verification: guards routes (evidence: `backend/src/routes/staff.js`)
- Staff endpoints → Request validation: validates input (evidence: `backend/src/routes/staff.js`)
- Staff endpoints → Application database: manages staff work (evidence: `backend/src/routes/staff.js`)
- Contact endpoint → Request validation: validates input (evidence: `backend/src/routes/contact.js`)
- Contact endpoint → Email delivery: sends messages (evidence: `backend/src/routes/contact.js`)
- Admin dashboard → Admin endpoints: requests admin data
- Staff dashboard → Staff endpoints: requests staff data
- Contact form → Contact endpoint: submits inquiry
