# kiahcare/sathiyaa-apps architecture

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

## Overview

Sathiyaa is a pair of Flutter apps for home-healthcare and senior-care booking: families find and book carers, while carers and agencies manage visits and teams. The customer journey covers discovery, booking and payment, then visit tracking and follow-up; the provider app supports day-to-day work and agency operations. Both apps can use the separately hosted platform API or an in-memory demo backend, and provide English, Hindi and Gujarati. The README documents capabilities and the API boundary, but the Dart implementation was not sampled, so subsystem connections below reflect documented relationships rather than inspected call sites.

Main entry points: [`apps/provider_app/lib/main.dart`](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/main.dart) (Provider app), [`apps/customer_app/lib/main.dart`](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/main.dart) (Customer app), [`apps/customer_app/lib/backend.dart`](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/backend.dart) (Backend selection), [`apps/customer_app/lib/screens/search_screen.dart`](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/search_screen.dart) (Carer search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Family app"]
  node_customer_app["Customer app<br/>[main.dart]"]
  node_discovery["Carer search<br/>[search_screen.dart]"]
  node_provider_detail["Carer details"]
  node_booking["Visit booking<br/>[booking_flow.dart]"]
  node_payment["Payment"]
  node_appointments["Appointments"]
  node_tracking["Visit tracking<br/>[home_screen.dart]"]
  node_customer_comms["Messages and SOS"]
end

subgraph group_provider["Carer and agency app"]
  node_provider_app["Provider app<br/>[main.dart]"]
  node_carer_day["Carer workday"]
  node_provider_bookings["Booking management"]
  node_agency_team["Team management"]
  node_agency_schedule["Team scheduling"]
end

subgraph group_shared["App foundations"]
  node_language["Language support<br/>[l10n.dart]"]
  node_service_area["Service-area gate<br/>[service_area.dart]"]
end

subgraph group_integration["Backend integration"]
  node_api_backend["API backend<br/>[api_backend.dart]"]
  node_api_client["API client<br/>[api_client.dart]"]
  node_backend_choice["Backend selection<br/>[backend.dart]"]
  node_mock_backend["Demo backend<br/>[mock_data.dart]"]
end

node_family(("Family"))
node_carer(("Carer"))
node_agency(("Agency"))
node_platform_api["Platform API"]

node_family -->|"uses"| node_customer_app
node_customer_app -->|"searches"| node_discovery
node_discovery -.->|"views"| node_provider_detail
node_provider_detail -->|"books"| node_booking
node_booking -->|"pays"| node_payment
node_family -->|"reviews visits"| node_appointments
node_family -->|"tracks carer"| node_tracking
node_family -->|"messages or SOS"| node_customer_comms
node_carer -->|"uses"| node_provider_app
node_agency -->|"uses"| node_provider_app
node_provider_app -->|"manages day"| node_carer_day
node_provider_app -->|"manages visits"| node_provider_bookings
node_agency -->|"manages carers"| node_agency_team
node_agency -.->|"manages schedule"| node_agency_schedule
node_customer_app -->|"selects backend"| node_backend_choice
node_provider_app -.->|"selects backend"| node_backend_choice
node_backend_choice -.->|"uses API"| node_api_backend
node_backend_choice -->|"uses demo"| node_mock_backend
node_api_backend -.->|"uses"| node_api_client
node_api_client -->|"calls"| node_platform_api
node_customer_app -->|"supports languages"| node_language
node_provider_app -->|"supports languages"| node_language
node_customer_app -->|"gates service"| node_service_area
node_provider_app -->|"shares gate"| node_service_area

click node_customer_app "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/main.dart"
click node_discovery "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/search_screen.dart"
click node_provider_detail "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/provider_detail_screen.dart"
click node_booking "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/booking_flow.dart"
click node_payment "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/payment_screen.dart"
click node_appointments "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/appointments_screen.dart"
click node_tracking "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/home_screen.dart"
click node_customer_comms "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/messages_screen.dart"
click node_provider_app "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/main.dart"
click node_carer_day "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/dashboard_screen.dart"
click node_provider_bookings "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/bookings_screen.dart"
click node_agency_team "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/organization/employees_screen.dart"
click node_agency_schedule "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/organization/schedule_overview_screen.dart"
click node_api_backend "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/api/api_backend.dart"
click node_api_client "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/api/api_client.dart"
click node_backend_choice "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/backend.dart"
click node_mock_backend "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/mock_data.dart"
click node_language "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/i18n/l10n.dart"
click node_service_area "https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/service_area.dart"

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_discovery,node_provider_detail,node_booking,node_payment,node_appointments,node_tracking,node_customer_comms toneBlue
class node_provider_app,node_carer_day,node_provider_bookings,node_agency_team,node_agency_schedule toneAmber
class node_language,node_service_area,node_platform_api toneMint
class node_api_backend,node_api_client,node_backend_choice,node_mock_backend toneRose
class node_family,node_carer,node_agency toneIndigo
```

## Components

### Family app

- [Customer app](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/main.dart): `apps/customer_app/lib/main.dart`
- [Carer search](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/search_screen.dart): `apps/customer_app/lib/screens/search_screen.dart`
- [Carer details](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/provider_detail_screen.dart): `apps/customer_app/lib/screens/provider_detail_screen.dart`
- [Visit booking](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/booking_flow.dart): `apps/customer_app/lib/screens/booking_flow.dart`
- [Payment](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/payment_screen.dart): `apps/customer_app/lib/screens/payment_screen.dart`
- [Appointments](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/appointments_screen.dart): `apps/customer_app/lib/screens/appointments_screen.dart`
- [Visit tracking](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/home_screen.dart): `apps/customer_app/lib/screens/home_screen.dart`
- [Messages and SOS](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/screens/messages_screen.dart): `apps/customer_app/lib/screens/messages_screen.dart`

### Carer and agency app

- [Provider app](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/main.dart): `apps/provider_app/lib/main.dart`
- [Carer workday](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/dashboard_screen.dart): `apps/provider_app/lib/screens/dashboard_screen.dart`
- [Booking management](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/bookings_screen.dart): `apps/provider_app/lib/screens/bookings_screen.dart`
- [Team management](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/organization/employees_screen.dart): `apps/provider_app/lib/screens/organization/employees_screen.dart`
- [Team scheduling](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/provider_app/lib/screens/organization/schedule_overview_screen.dart): `apps/provider_app/lib/screens/organization/schedule_overview_screen.dart`

### App foundations

- [Language support](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/i18n/l10n.dart): `apps/customer_app/lib/i18n/l10n.dart`
- [Service-area gate](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/service_area.dart): `apps/customer_app/lib/service_area.dart`

### Backend integration

- [API backend](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/api/api_backend.dart): `apps/customer_app/lib/api/api_backend.dart`
- [API client](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/api/api_client.dart): `apps/customer_app/lib/api/api_client.dart`
- [Backend selection](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/backend.dart): `apps/customer_app/lib/backend.dart`
- [Demo backend](https://github.com/kiahcare/sathiyaa-apps/blob/main/apps/customer_app/lib/mock_data.dart): `apps/customer_app/lib/mock_data.dart`

### Other components

- **Family**
- **Carer**
- **Agency**
- **Platform API**

## Connections

- Family → Customer app: uses (evidence: `README.md`)
- Customer app → Carer search: searches (evidence: `README.md`)
- Carer search → Carer details: views
- Carer details → Visit booking: books (evidence: `README.md`)
- Visit booking → Payment: pays (evidence: `README.md`)
- Family → Appointments: reviews visits (evidence: `README.md`)
- Family → Visit tracking: tracks carer (evidence: `README.md`)
- Family → Messages and SOS: messages or SOS (evidence: `README.md`)
- Carer → Provider app: uses (evidence: `README.md`)
- Agency → Provider app: uses (evidence: `README.md`)
- Provider app → Carer workday: manages day (evidence: `README.md`)
- Provider app → Booking management: manages visits (evidence: `README.md`)
- Agency → Team management: manages carers (evidence: `README.md`)
- Agency → Team scheduling: manages schedule
- Customer app → Backend selection: selects backend (evidence: `README.md`)
- Provider app → Backend selection: selects backend
- Backend selection → API backend: uses API
- Backend selection → Demo backend: uses demo (evidence: `README.md`)
- API backend → API client: uses
- API client → Platform API: calls (evidence: `README.md`)
- Customer app → Language support: supports languages (evidence: `README.md`)
- Provider app → Language support: supports languages (evidence: `README.md`)
- Customer app → Service-area gate: gates service (evidence: `README.md`)
- Provider app → Service-area gate: shares gate (evidence: `README.md`)
