# kiahcare/sathiyaa architecture

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

- Interactive diagram: https://gitdiagram.com/kiahcare/sathiyaa
- Repository: https://github.com/kiahcare/sathiyaa

## Overview

Sathiyaa is a home- and senior-care booking platform: families find and book nearby carers, track visits, and use messaging or SOS; carers and agencies manage requests and service delivery; administrators operate provider onboarding, configuration, reporting, and partner revenue. The graph combines that documented product workflow with the sampled API, console, and database layers. Flutter implementation files were not included in the excerpts, so app-to-API and several backend domain links are documented or marked unverified rather than inferred from unseen code.

Main entry points: [`backend/src/controllers/bookingController.js`](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/bookingController.js) (Booking lifecycle), [`backend/src/db/pool.js`](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/db/pool.js) (MySQL database), [`backend/src/controllers/adminController.js`](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/adminController.js) (Administration), [`backend/src/app.js`](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/app.js) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User applications"]
  node_customer_app["Customer app"]
  node_provider_app["Provider app"]
end

subgraph group_console["Admin and partner console"]
  node_admin_ui["Role-based portals<br/>[App.tsx]"]
  node_provider_page["Provider administration"]
  node_console_services["Console API services<br/>[services.ts]"]
end

subgraph group_api["Backend API"]
  node_api_app["HTTP API<br/>[app.js]"]
  node_provider_routes["Provider routes"]
  node_admin_routes["Admin routes<br/>[admin.routes.js]"]
  node_audit["Audit logging<br/>[audit.js]"]
end

subgraph group_domain["Care operations"]
  node_booking["Booking lifecycle"]
  node_provider_self["Provider operations"]
  node_customer_ops["Customer records and SOS"]
  node_admin_ops["Administration<br/>[adminController.js]"]
  node_matching["Provider matching"]
  node_service_area["Service-area eligibility<br/>[serviceArea.js]"]
  node_app_config["Application configuration<br/>[appConfig.js]"]
  node_messages["In-app messaging<br/>[messageService.js]"]
  node_broadcasts["Broadcast targeting"]
end

subgraph group_platform["Persistence and integrations"]
  node_database[("MySQL database<br/>[pool.js]")]
  node_payment["Payment integration<br/>[payment.js]"]
  node_maps["Maps integration<br/>[maps.js]"]
  node_push["Push notifications<br/>[push.js]"]
end

node_family(("Family"))
node_caregiver(("Carer or agency"))
node_administrator(("Administrator or partner"))

node_family -->|"uses"| node_customer_app
node_caregiver -->|"uses"| node_provider_app
node_administrator -->|"uses"| node_admin_ui
node_customer_app -.->|"calls API"| node_api_app
node_provider_app -.->|"calls API"| node_api_app
node_admin_ui -->|"routes to"| node_provider_page
node_provider_page -->|"requests provider data"| node_console_services
node_console_services -.->|"calls API"| node_api_app
node_api_app -->|"mounts routes"| node_provider_routes
node_provider_routes -->|"dispatches to"| node_provider_self
node_provider_routes -->|"dispatches to"| node_booking
node_admin_routes -->|"dispatches to"| node_admin_ops
node_booking -->|"reads and writes"| node_database
node_booking -->|"finds providers"| node_matching
node_booking -->|"requests payment"| node_payment
node_booking -->|"uses location services"| node_maps
node_provider_self -->|"reads and writes"| node_database
node_provider_self -->|"checks signup place"| node_service_area
node_customer_ops -->|"reads and writes"| node_database
node_customer_ops -->|"checks signup place"| node_service_area
node_customer_ops -->|"requests payment"| node_payment
node_admin_ops -->|"reads and writes"| node_database
node_admin_ops -->|"updates configuration"| node_app_config
node_service_area -->|"reads settings"| node_app_config
node_service_area -->|"records eligibility"| node_database
node_app_config -->|"reads and writes"| node_database
node_provider_self -->|"loads unread counts"| node_messages
node_api_app -->|"attaches audit context"| node_audit
node_admin_ops -->|"sends notifications"| node_push
node_booking -->|"uses messaging"| node_messages
node_admin_ops -->|"targets broadcasts"| node_broadcasts

click node_customer_app "https://github.com/kiahcare/sathiyaa/tree/main/apps/customer_app"
click node_provider_app "https://github.com/kiahcare/sathiyaa/tree/main/apps/provider_app"
click node_admin_ui "https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/App.tsx"
click node_provider_page "https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/pages/admin/ServiceProviders.tsx"
click node_console_services "https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/api/services.ts"
click node_api_app "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/app.js"
click node_provider_routes "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/routes/providers.routes.js"
click node_admin_routes "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/routes/admin.routes.js"
click node_booking "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/bookingController.js"
click node_provider_self "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/providerSelfController.js"
click node_customer_ops "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/customerController.js"
click node_admin_ops "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/adminController.js"
click node_matching "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/providerMatching.js"
click node_service_area "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/serviceArea.js"
click node_app_config "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/appConfig.js"
click node_database "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/db/pool.js"
click node_payment "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/payment.js"
click node_maps "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/maps.js"
click node_push "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/push.js"
click node_messages "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/messageService.js"
click node_broadcasts "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/broadcastTargeting.js"
click node_audit "https://github.com/kiahcare/sathiyaa/blob/main/backend/src/middleware/audit.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_customer_app,node_provider_app toneBlue
class node_admin_ui,node_provider_page,node_console_services toneAmber
class node_api_app,node_provider_routes,node_admin_routes,node_audit toneMint
class node_booking,node_provider_self,node_customer_ops,node_admin_ops,node_matching,node_service_area,node_app_config,node_messages,node_broadcasts toneRose
class node_database,node_payment,node_maps,node_push,node_family,node_caregiver,node_administrator toneIndigo
```

## Components

### User applications

- [Customer app](https://github.com/kiahcare/sathiyaa/tree/main/apps/customer_app): `apps/customer_app`
- [Provider app](https://github.com/kiahcare/sathiyaa/tree/main/apps/provider_app): `apps/provider_app`

### Admin and partner console

- [Role-based portals](https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/App.tsx): `admin-portal/src/App.tsx`
- [Provider administration](https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/pages/admin/ServiceProviders.tsx): `admin-portal/src/pages/admin/ServiceProviders.tsx`
- [Console API services](https://github.com/kiahcare/sathiyaa/blob/main/admin-portal/src/api/services.ts): `admin-portal/src/api/services.ts`

### Backend API

- [HTTP API](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/app.js): `backend/src/app.js`
- [Provider routes](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/routes/providers.routes.js): `backend/src/routes/providers.routes.js`
- [Admin routes](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/routes/admin.routes.js): `backend/src/routes/admin.routes.js`
- [Audit logging](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/middleware/audit.js): `backend/src/middleware/audit.js`

### Care operations

- [Booking lifecycle](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Provider operations](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/providerSelfController.js): `backend/src/controllers/providerSelfController.js`
- [Customer records and SOS](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/customerController.js): `backend/src/controllers/customerController.js`
- [Administration](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Provider matching](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/providerMatching.js): `backend/src/services/providerMatching.js`
- [Service-area eligibility](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/serviceArea.js): `backend/src/services/serviceArea.js`
- [Application configuration](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/appConfig.js): `backend/src/services/appConfig.js`
- [In-app messaging](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/messageService.js): `backend/src/services/messageService.js`
- [Broadcast targeting](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/services/broadcastTargeting.js): `backend/src/services/broadcastTargeting.js`

### Persistence and integrations

- [MySQL database](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/db/pool.js): `backend/src/db/pool.js`
- [Payment integration](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/payment.js): `backend/src/integrations/payment.js`
- [Maps integration](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/maps.js): `backend/src/integrations/maps.js`
- [Push notifications](https://github.com/kiahcare/sathiyaa/blob/main/backend/src/integrations/push.js): `backend/src/integrations/push.js`

### Other components

- **Family**
- **Carer or agency**
- **Administrator or partner**

## Connections

- Family → Customer app: uses (evidence: `README.md`)
- Carer or agency → Provider app: uses (evidence: `README.md`)
- Administrator or partner → Role-based portals: uses (evidence: `admin-portal/src/App.tsx`)
- Customer app → HTTP API: calls API (evidence: `README.md`)
- Provider app → HTTP API: calls API (evidence: `README.md`)
- Role-based portals → Provider administration: routes to (evidence: `admin-portal/src/App.tsx`)
- Provider administration → Console API services: requests provider data (evidence: `admin-portal/src/pages/admin/ServiceProviders.tsx`)
- Console API services → HTTP API: calls API (evidence: `README.md`)
- HTTP API → Provider routes: mounts routes (evidence: `backend/src/app.js`)
- Provider routes → Provider operations: dispatches to (evidence: `backend/src/routes/providers.routes.js`)
- Provider routes → Booking lifecycle: dispatches to (evidence: `backend/src/routes/providers.routes.js`)
- Admin routes → Administration: dispatches to (evidence: `backend/src/routes/admin.routes.js`)
- Booking lifecycle → MySQL database: reads and writes (evidence: `backend/src/controllers/bookingController.js`)
- Booking lifecycle → Provider matching: finds providers (evidence: `backend/src/controllers/bookingController.js`)
- Booking lifecycle → Payment integration: requests payment (evidence: `backend/src/controllers/bookingController.js`)
- Booking lifecycle → Maps integration: uses location services (evidence: `backend/src/controllers/bookingController.js`)
- Provider operations → MySQL database: reads and writes (evidence: `backend/src/controllers/providerSelfController.js`)
- Provider operations → Service-area eligibility: checks signup place (evidence: `backend/src/controllers/providerSelfController.js`)
- Customer records and SOS → MySQL database: reads and writes (evidence: `backend/src/controllers/customerController.js`)
- Customer records and SOS → Service-area eligibility: checks signup place (evidence: `backend/src/controllers/customerController.js`)
- Customer records and SOS → Payment integration: requests payment (evidence: `backend/src/controllers/customerController.js`)
- Administration → MySQL database: reads and writes (evidence: `backend/src/controllers/adminController.js`)
- Administration → Application configuration: updates configuration (evidence: `backend/src/controllers/adminController.js`)
- Service-area eligibility → Application configuration: reads settings (evidence: `backend/src/services/serviceArea.js`)
- Service-area eligibility → MySQL database: records eligibility (evidence: `backend/src/services/serviceArea.js`)
- Application configuration → MySQL database: reads and writes (evidence: `backend/src/services/appConfig.js`)
- Provider operations → In-app messaging: loads unread counts (evidence: `backend/src/controllers/providerSelfController.js`)
- HTTP API → Audit logging: attaches audit context (evidence: `backend/src/app.js`)
- Administration → Push notifications: sends notifications (evidence: `backend/src/controllers/adminController.js`)
- Booking lifecycle → In-app messaging: uses messaging (evidence: `backend/src/controllers/bookingController.js`)
- Administration → Broadcast targeting: targets broadcasts (evidence: `backend/src/controllers/adminController.js`)
