# kiahcare/sathiyaa-platform architecture

> Architecture diagram of the GitHub repository kiahcare/sathiyaa-platform, 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-platform
- Repository: https://github.com/kiahcare/sathiyaa-platform

## Overview

Sathiyaa is an India-focused home-healthcare and senior-care booking platform: families find nearby carers, book visits, and track carers en route, while carers, agencies, administrators, and business partners have distinct workflows. The backend is the shared API and MySQL-backed product core; the React console administers providers and operations and exposes partner referrals and revenue. README documents additional live capabilities and integration seams. Several subsystems are unsampled, so their nodes reflect documented capabilities without speculative call chains.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Admin console"]
  node_console_app["Console routing<br/>[App.tsx]"]
  node_provider_admin["Provider admin"]
  node_console_api["Console API services<br/>[services.ts]"]
end

subgraph group_api["API foundation"]
  node_api_app["HTTP application<br/>[app.js]"]
  node_api_routes["API routes"]
  node_auth["Authentication<br/>[auth.js]"]
  node_database[("MySQL database<br/>[pool.js]")]
end

subgraph group_care["Care booking"]
  node_customer["Customer workflows"]
  node_booking["Booking lifecycle"]
  node_provider_self["Carer workflows"]
  node_matching["Provider matching"]
  node_service_area["Service area checks<br/>[serviceArea.js]"]
  node_provider_accounts["Provider accounts"]
end

subgraph group_operations["Platform operations"]
  node_admin_ops["Admin operations<br/>[adminController.js]"]
  node_config["Platform configuration<br/>[appConfig.js]"]
  node_messaging["Messaging and SOS<br/>[messageService.js]"]
end

subgraph group_integrations["External integrations"]
  node_integrations{{"Integration interfaces"}}
  node_maps{{"Maps providers<br/>[maps.js]"}}
  node_payments{{"Payment providers<br/>[payment.js]"}}
end

node_family(("Family / customer"))
node_carer(("Carer"))
node_agency(("Care agency"))
node_admin(("Administrator"))
node_partner(("Business partner"))

node_family -->|"searches and books"| node_api_app
node_carer -->|"runs care visits"| node_api_app
node_agency -->|"manages carers"| node_api_app
node_admin -->|"administers platform"| node_console_app
node_partner -->|"views referrals"| node_console_app
node_console_app -->|"routes to"| node_provider_admin
node_provider_admin -->|"loads and updates"| node_console_api
node_console_api -->|"calls API"| node_api_app
node_api_app -->|"mounts routes"| node_api_routes
node_api_routes -->|"protects endpoints"| node_auth
node_api_routes -->|"dispatches admin"| node_admin_ops
node_api_routes -->|"dispatches customer"| node_customer
node_api_routes -->|"dispatches provider"| node_provider_self
node_api_routes -->|"dispatches bookings"| node_booking
node_customer -->|"queries"| node_database
node_booking -->|"queries"| node_database
node_provider_self -->|"queries"| node_database
node_booking -->|"finds providers"| node_matching
node_customer -->|"checks signup area"| node_service_area
node_provider_self -->|"checks signup area"| node_service_area
node_provider_self -->|"creates employees"| node_provider_accounts
node_admin_ops -->|"creates providers"| node_provider_accounts
node_admin_ops -->|"reads and updates"| node_config
node_booking -->|"handles booking messages"| node_messaging
node_booking -->|"requests directions"| node_maps
node_booking -->|"processes booking payment"| node_payments
node_matching -->|"queries roster"| node_database
node_service_area -->|"reads area settings"| node_config
node_service_area -->|"stores signup verdict"| node_database
node_provider_accounts -->|"writes accounts"| node_database
node_config -->|"reads and writes"| node_database
node_messaging -->|"stores messages"| node_database
node_maps -->|"selects provider"| node_integrations
node_payments -->|"selects provider"| node_integrations

click node_console_app "https://github.com/kiahcare/sathiyaa-platform/blob/main/admin-portal/src/App.tsx"
click node_provider_admin "https://github.com/kiahcare/sathiyaa-platform/blob/main/admin-portal/src/pages/admin/ServiceProviders.tsx"
click node_console_api "https://github.com/kiahcare/sathiyaa-platform/blob/main/admin-portal/src/api/services.ts"
click node_api_app "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/app.js"
click node_api_routes "https://github.com/kiahcare/sathiyaa-platform/tree/main/backend/src/routes"
click node_auth "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/middleware/auth.js"
click node_database "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/db/pool.js"
click node_customer "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/customerController.js"
click node_booking "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/bookingController.js"
click node_provider_self "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/providerSelfController.js"
click node_matching "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/providerMatching.js"
click node_service_area "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/serviceArea.js"
click node_provider_accounts "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/providerAccounts.js"
click node_admin_ops "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/adminController.js"
click node_config "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/appConfig.js"
click node_messaging "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/messageService.js"
click node_integrations "https://github.com/kiahcare/sathiyaa-platform/tree/main/backend/src/integrations"
click node_maps "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/integrations/maps.js"
click node_payments "https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/integrations/payment.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_console_app,node_provider_admin,node_console_api toneBlue
class node_api_app,node_api_routes,node_auth,node_database toneAmber
class node_customer,node_booking,node_provider_self,node_matching,node_service_area,node_provider_accounts toneMint
class node_admin_ops,node_config,node_messaging toneRose
class node_integrations,node_maps,node_payments,node_family,node_carer,node_agency,node_admin,node_partner toneIndigo
```

## Components

### Admin console

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

### API foundation

- [HTTP application](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/app.js): `backend/src/app.js`
- [API routes](https://github.com/kiahcare/sathiyaa-platform/tree/main/backend/src/routes): `backend/src/routes`
- [Authentication](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [MySQL database](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/db/pool.js): `backend/src/db/pool.js`

### Care booking

- [Customer workflows](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/customerController.js): `backend/src/controllers/customerController.js`
- [Booking lifecycle](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Carer workflows](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/providerSelfController.js): `backend/src/controllers/providerSelfController.js`
- [Provider matching](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/providerMatching.js): `backend/src/services/providerMatching.js`
- [Service area checks](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/serviceArea.js): `backend/src/services/serviceArea.js`
- [Provider accounts](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/providerAccounts.js): `backend/src/services/providerAccounts.js`

### Platform operations

- [Admin operations](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Platform configuration](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/appConfig.js): `backend/src/services/appConfig.js`
- [Messaging and SOS](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/services/messageService.js): `backend/src/services/messageService.js`

### External integrations

- [Integration interfaces](https://github.com/kiahcare/sathiyaa-platform/tree/main/backend/src/integrations): `backend/src/integrations`
- [Maps providers](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/integrations/maps.js): `backend/src/integrations/maps.js`
- [Payment providers](https://github.com/kiahcare/sathiyaa-platform/blob/main/backend/src/integrations/payment.js): `backend/src/integrations/payment.js`

### Other components

- **Family / customer**
- **Carer**
- **Care agency**
- **Administrator**
- **Business partner**

## Connections

- Family / customer → HTTP application: searches and books (evidence: `README.md`)
- Carer → HTTP application: runs care visits (evidence: `README.md`)
- Care agency → HTTP application: manages carers (evidence: `README.md`)
- Administrator → Console routing: administers platform (evidence: `README.md`)
- Business partner → Console routing: views referrals (evidence: `README.md`)
- Console routing → Provider admin: routes to (evidence: `admin-portal/src/App.tsx`)
- Provider admin → Console API services: loads and updates (evidence: `admin-portal/src/pages/admin/ServiceProviders.tsx`)
- Console API services → HTTP application: calls API (evidence: `README.md`)
- HTTP application → API routes: mounts routes (evidence: `backend/src/app.js`)
- API routes → Authentication: protects endpoints (evidence: `backend/src/routes/admin.routes.js`)
- API routes → Admin operations: dispatches admin (evidence: `backend/src/routes/admin.routes.js`)
- API routes → Customer workflows: dispatches customer (evidence: `backend/src/routes/customers.routes.js`)
- API routes → Carer workflows: dispatches provider (evidence: `backend/src/routes/providers.routes.js`)
- API routes → Booking lifecycle: dispatches bookings (evidence: `backend/src/routes/providers.routes.js`)
- Customer workflows → MySQL database: queries (evidence: `backend/src/controllers/customerController.js`)
- Booking lifecycle → MySQL database: queries (evidence: `backend/src/controllers/bookingController.js`)
- Carer workflows → MySQL database: queries (evidence: `backend/src/controllers/providerSelfController.js`)
- Booking lifecycle → Provider matching: finds providers (evidence: `backend/src/controllers/bookingController.js`)
- Customer workflows → Service area checks: checks signup area (evidence: `backend/src/controllers/customerController.js`)
- Carer workflows → Service area checks: checks signup area (evidence: `backend/src/controllers/providerSelfController.js`)
- Carer workflows → Provider accounts: creates employees (evidence: `backend/src/controllers/providerSelfController.js`)
- Admin operations → Provider accounts: creates providers (evidence: `backend/src/controllers/adminController.js`)
- Admin operations → Platform configuration: reads and updates (evidence: `backend/src/controllers/adminController.js`)
- Booking lifecycle → Messaging and SOS: handles booking messages (evidence: `backend/src/controllers/bookingController.js`)
- Booking lifecycle → Maps providers: requests directions (evidence: `backend/src/controllers/bookingController.js`)
- Booking lifecycle → Payment providers: processes booking payment (evidence: `backend/src/controllers/bookingController.js`)
- Provider matching → MySQL database: queries roster (evidence: `backend/src/services/providerMatching.js`)
- Service area checks → Platform configuration: reads area settings (evidence: `backend/src/services/serviceArea.js`)
- Service area checks → MySQL database: stores signup verdict (evidence: `backend/src/services/serviceArea.js`)
- Provider accounts → MySQL database: writes accounts (evidence: `backend/src/services/providerAccounts.js`)
- Platform configuration → MySQL database: reads and writes (evidence: `backend/src/services/appConfig.js`)
- Messaging and SOS → MySQL database: stores messages (evidence: `backend/src/services/messageService.js`)
- Maps providers → Integration interfaces: selects provider (evidence: `backend/src/integrations/maps.js`)
- Payment providers → Integration interfaces: selects provider (evidence: `backend/src/integrations/payment.js`)
