How kiahcare/sathiyaa works
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: bookingController.js Booking lifecycle · pool.js MySQL database · adminController.js Administration · app.js HTTP API
Components 25
User applications
- Customer app
apps/customer_app - Provider app
apps/provider_app
Admin and partner console
- Role-based portals
admin-portal/src/App.tsx - Provider administration
admin-portal/src/pages/admin/ServiceProviders.tsx - Console API services
admin-portal/src/api/services.ts
Backend API
- HTTP API
backend/src/app.js - Provider routes
backend/src/routes/providers.routes.js - Admin routes
backend/src/routes/admin.routes.js - Audit logging
backend/src/middleware/audit.js
Care operations
- Booking lifecycle
backend/src/controllers/bookingController.js - Provider operations
backend/src/controllers/providerSelfController.js - Customer records and SOS
backend/src/controllers/customerController.js - Administration
backend/src/controllers/adminController.js - Provider matching
backend/src/services/providerMatching.js - Service-area eligibility
backend/src/services/serviceArea.js - Application configuration
backend/src/services/appConfig.js - In-app messaging
backend/src/services/messageService.js - Broadcast targeting
backend/src/services/broadcastTargeting.js
Persistence and integrations
- MySQL database
backend/src/db/pool.js - Payment integration
backend/src/integrations/payment.js - Maps integration
backend/src/integrations/maps.js - Push notifications
backend/src/integrations/push.js
Other components
- Family
- Carer or agency
- Administrator or partner
Connections 31
- Family → Customer app: uses
README.md - Carer or agency → Provider app: uses
README.md - Administrator or partner → Role-based portals: uses
admin-portal/src/App.tsx - Customer app → HTTP API: calls API
README.md - Provider app → HTTP API: calls API
README.md - Role-based portals → Provider administration: routes to
admin-portal/src/App.tsx - Provider administration → Console API services: requests provider data
admin-portal/src/pages/admin/ServiceProviders.tsx - Console API services → HTTP API: calls API
README.md - HTTP API → Provider routes: mounts routes
backend/src/app.js - Provider routes → Provider operations: dispatches to
backend/src/routes/providers.routes.js - Provider routes → Booking lifecycle: dispatches to
backend/src/routes/providers.routes.js - Admin routes → Administration: dispatches to
backend/src/routes/admin.routes.js - Booking lifecycle → MySQL database: reads and writes
backend/src/controllers/bookingController.js - Booking lifecycle → Provider matching: finds providers
backend/src/controllers/bookingController.js - Booking lifecycle → Payment integration: requests payment
backend/src/controllers/bookingController.js - Booking lifecycle → Maps integration: uses location services
backend/src/controllers/bookingController.js - Provider operations → MySQL database: reads and writes
backend/src/controllers/providerSelfController.js - Provider operations → Service-area eligibility: checks signup place
backend/src/controllers/providerSelfController.js - Customer records and SOS → MySQL database: reads and writes
backend/src/controllers/customerController.js - Customer records and SOS → Service-area eligibility: checks signup place
backend/src/controllers/customerController.js - Customer records and SOS → Payment integration: requests payment
backend/src/controllers/customerController.js - Administration → MySQL database: reads and writes
backend/src/controllers/adminController.js - Administration → Application configuration: updates configuration
backend/src/controllers/adminController.js - Service-area eligibility → Application configuration: reads settings
backend/src/services/serviceArea.js - Service-area eligibility → MySQL database: records eligibility
backend/src/services/serviceArea.js - Application configuration → MySQL database: reads and writes
backend/src/services/appConfig.js - Provider operations → In-app messaging: loads unread counts
backend/src/controllers/providerSelfController.js - HTTP API → Audit logging: attaches audit context
backend/src/app.js - Administration → Push notifications: sends notifications
backend/src/controllers/adminController.js - Booking lifecycle → In-app messaging: uses messaging
backend/src/controllers/bookingController.js - Administration → Broadcast targeting: targets broadcasts
backend/src/controllers/adminController.js