Bandhu is a companion-first mental health check-in app for India — solo project, FastAPI + Supabase/pgvector backend, built incrementally and documented as it goes. These are the working design docs, not marketing pages: each one says what to build and why, including the parts still undecided.
The 12-stage flow one check-in goes through — safety gate, classify, retrieval, the orchestrator's one real judgment call, guardrails. Silence is the default outcome, not a fallback.
HTML CoreHow memory works across two horizons, voice in/out, anonymous sessions, rate limiting, cleanup, and telemetry — the layer underneath the pipeline diagram.
HTML · source: backend-architecture.md CoreActual Postgres/pgvector schema, retrieval queries, and the embedding/generation provider choices underneath both docs above.
Markdown — renders best viewed on GitHubThe original vision doc — why this, why now, what it will/won't do, and the tone rules everything else derives from.
Markdown — renders best viewed on GitHub ProductThe screen-by-screen flow this backend serves — Home, check-in, Thinking Trap, Crisis Support, Co-Create, and the rest.
HTML SupersededAn earlier design, predating the single-Supabase pivot — kept for history. Its retrieval-cache proposal has since been corrected in Backend Architecture's open items.
HTML — historical