exabyteso/CareFlow

Kenya hospital pretriage: find the right facility by wait time and distance # CareFlow Kenya hospital pretriage: map symptoms to the right KEPH level, recommend the nearest facility with the shortest hospital-reported wait, and book — with SMS and voice reminders. This monorepo holds the locked product spec, research, agent scaffolding, and the FastAPI + Next.js PWA trees. **Local development** uses Docker Compose (the default). This is **not** a production service. **Staging** is live on Render from the `dev` branch (ONBOARDING.md). **GitHub:** github.com ## Documentation map | Directory | README | Topics | |-----------|--------|--------| | `backend/` | backend/README.md | FastAPI (Python 3.12), Alembic, `/health` `/me` `/facilities/recommend` | | `frontend/` | frontend/README.md | Next.js 15 PWA: role picker, care-seeker, hospital desk | | `prototype/` | prototype/README.md | Hospital ticketing UI prototype (Vite) | | `docs/` | docs/README.md | Agent SOPs, API reference, testing, pre-design notes | | `docs/product-map/` | docs/product-map/README.md | Domain map: two sides, queue vs booking | | `plans/` | plans/README.md | Committed specs, wave plan template | | `research/` | research/README.md | Market (`big-picture/`) and ops research | | `scripts/` | scripts/README.md | PDF generation and other root scripts | | `assets/` | assets/README.md | Brand source art and logo crops | **Local development:** ONBOARDING.md **Agents and coding tools:** AGENTS.md **System architecture:** ARCHITECTURE.md (PlantUML) — target topology vs what is running now. ## Conventions One repo, two app trees (`backend/`, `frontend/`) plus research and docs. **Primary database is locked:** PostgreSQL 16 + pgvector (D-001). Application stack is Next.js 15 PWA + FastAPI per plans/kenya-pretriage.md. Product language: care-seeker, hospital staff/desk, pretriage (not diagnosis); `wait_count` is a desk-typed ranking input, not HMIS. See docs/directory-readme-practice.md for README conventions. Add a row to the table above when you introduce a …