How gourav-s-m/sakhicare works
SakhiCare is a Bengaluru menstrual-health platform for finding resources, accessing educational guidance, and privately tracking periods. The user workflow enters through the React app, then branches into resource discovery, coverage, AI guidance, emergency/healthcare listings, learning, and an on-device calendar. Backend API handlers own database-backed operations; the calendar remains local. The README documents mapping and AI integrations, but unsampled implementation details are not inferred, so some external links are omitted or marked unverified.
Main entry points: App.tsx Web Router · database.py PostgreSQL Store · main.py FastAPI Application · resources.py Resource Endpoints
Components 28
Web Experience
- Web Router
frontend/src/App.tsx
Resource Discovery
- Resource Explorer
frontend/src/pages/ExplorePage.tsx - Resource Map
frontend/src/components/map/ResourceMap.tsx - Resource API Client
frontend/src/services/resourceApi.ts - Coverage API Client
frontend/src/services/coverageApi.ts - Coverage Types
frontend/src/types/coverage.ts - Resource Types
frontend/src/types/resource.ts - OSM Ingestion
backend/app/services/osm_ingestion.py
Health Guidance
- AI Chat
frontend/src/pages/AiChatPage.tsx - RAG Guidance
backend/app/services/rag.py - Learning Content
frontend/src/pages/LearnPage.tsx - Emergency Finder
frontend/src/pages/EmergencyPage.tsx - Healthcare Finder
frontend/src/pages/HealthcarePage.tsx
API Platform
- Resource Endpoints
backend/app/api/v1/resources.py - Coverage Grid
backend/app/api/v1/coverage.py - Bengaluru Localities
backend/app/core/localities.py - Resource Scoring
backend/app/services/scoring.py - PostgreSQL Store
backend/app/core/database.py - AI Endpoint
backend/app/api/v1/ai.py - Finder Endpoints
backend/app/api/v1/finders/services.py - Resource Reports
backend/app/api/v1/reports.py - Report Processing
backend/app/services/reports.py - FastAPI Application
backend/app/main.py
Private Tracking
- Cycle Calendar
frontend/src/pages/CalendarPage.tsx - Local Cycle Store
frontend/src/services/calendar/cycleStorage.ts - Cycle Estimates
frontend/src/services/calendar/cycleEstimator.ts
Other components
- Visitor
- Google Gemini
Connections 37
- Visitor → Web Router: opens
- Web Router → Resource Explorer: routes to
frontend/src/App.tsx - Web Router → AI Chat: routes to
frontend/src/App.tsx - Web Router → Cycle Calendar: routes to
frontend/src/App.tsx - Web Router → Learning Content: routes to
frontend/src/App.tsx - Web Router → Emergency Finder: routes to
frontend/src/App.tsx - Web Router → Healthcare Finder: routes to
frontend/src/App.tsx - Resource Explorer → Resource API Client: loads resources
frontend/src/pages/ExplorePage.tsx - Resource Explorer → Coverage API Client: loads coverage
frontend/src/pages/ExplorePage.tsx - Resource Explorer → Resource Map: renders map
frontend/src/pages/ExplorePage.tsx - Resource Map → Resource Types: uses types
frontend/src/components/map/ResourceMap.tsx - Resource Map → Coverage Types: uses types
frontend/src/components/map/ResourceMap.tsx - Coverage API Client → Coverage Types: returns data
frontend/src/services/coverageApi.ts - Resource API Client → Resource Endpoints: requests resources
- Coverage API Client → Coverage Grid: requests grid
- FastAPI Application → Resource Endpoints: registers
backend/app/main.py - FastAPI Application → Coverage Grid: registers
backend/app/main.py - FastAPI Application → AI Endpoint: registers
backend/app/main.py - FastAPI Application → Finder Endpoints: registers
backend/app/main.py - FastAPI Application → Resource Reports: registers
backend/app/main.py - Resource Endpoints → PostgreSQL Store: queries
backend/app/api/v1/resources.py - Resource Endpoints → Resource Scoring: scores results
backend/app/api/v1/resources.py - Resource Endpoints → Bengaluru Localities: uses locality data
backend/app/api/v1/resources.py - Coverage Grid → PostgreSQL Store: counts resources
backend/app/api/v1/coverage.py - Coverage Grid → Bengaluru Localities: uses locality data
backend/app/api/v1/coverage.py - OSM Ingestion → PostgreSQL Store: ingests records
- AI Chat → AI Endpoint: sends queries
- AI Endpoint → RAG Guidance: requests answers
backend/app/api/v1/ai.py - AI Endpoint → PostgreSQL Store: loads context
backend/app/api/v1/ai.py - RAG Guidance → Google Gemini: generates guidance
- Emergency Finder → Finder Endpoints: requests listings
- Healthcare Finder → Finder Endpoints: requests listings
- Finder Endpoints → PostgreSQL Store: queries listings
backend/app/api/v1/finders/services.py - Cycle Calendar → Local Cycle Store: reads and writes
frontend/src/pages/CalendarPage.tsx - Cycle Calendar → Cycle Estimates: estimates cycles
frontend/src/pages/CalendarPage.tsx - Resource Reports → PostgreSQL Store: stores reports
backend/app/api/v1/reports.py - Resource Reports → Report Processing: processes reports
backend/app/api/v1/reports.py