Build Checklist — Ghar Saathi

SINGLE SOURCE OF TRUTH. Process: tick [x] + one-line note the moment a task is done; an orchestrator works top-to-bottom; rebuild the HTML site after doc edits (python3 /var/www/gharsaathi/tools/build_docs_site.py); pause before irreversible/credential decisions; never touch unrelated services; back up before destructive edits.

Last updated: 2026-11-18 (backend done + verified; Flutter app starting)

Phase 0 — Docs & site ✅ / in progress

  • [x] PRD
  • [x] Revenue model
  • [x] Architecture
  • [x] Database schema
  • [x] API spec
  • [x] UI/UX spec
  • [x] Admin spec
  • [x] Dev plan + this checklist
  • [x] Docs HTML site generator + landing (/) + /docs live — gharsaathi.itsmehere.com
  • [x] nginx vhost gharsaathi.itsmehere.com + SSL (certbot) — / landing, /docs, /admin (placeholder)

Phase 1 — Backend (Node/Express + PG, :8043) ✅

  • [x] Project init + config + .env.example (loads shared /root/.config/wa-hub.env)
  • [x] Migrations: all tables (+ notification_log, billing_events, admin_audit); wa_templates seeded
  • [x] JWT + OTP auth via wa-hub (hashed, rate-limit, 5-attempt lockout); user + free sub + 7-day trial
  • [x] GET/PATCH /api/me (effective plan + limits)
  • [x] Reminders CRUD + /log (idempotent, streaks) + free-limit + Pro gates (race-safe)
  • [x] Grocery lists/items + WhatsApp share (Pro send / Free wa.me text)
  • [x] Family links (Pro, capped 5, dedupe, welcome msg)
  • [x] Billing: Razorpay subscribe + signature-verified webhook (gated → 503 unconfigured); manual Pro grant
  • [x] Sync endpoint (idempotent atomic-claim, @op_id refs, limits apply)
  • [x] Admin API (login, metrics, users+search, plan grant/revoke, templates, audit, billing events)
  • [x] Scheduler script: family miss-alerts + expiry WA + Pro WA reminders (idempotent; timer installed, DISABLED)
  • [x] wa_templates seed (otp, reminder, family_alert, expiry_nudge, welcome, list_share)
  • [x] README + run — verified end-to-end locally (OTP→me→reminders→log→lists→free-limits→admin→sync→scheduler→razorpay mock); tenant isolation OK

Phase 2 — Flutter app

  • [ ] Init, M3 theme/tokens (teal, per-type accents), Devanagari font, dark mode
  • [ ] Models + API client (Dio) + secure JWT + offline (sqflite) + outbox sync
  • [ ] Auth (phone → OTP)
  • [ ] Today/Reminders (cards, done tap, streaks, expiry surfacing, FAB + type chooser + forms)
  • [ ] Local notifications scheduling (habit/medicine/expiry)
  • [ ] Ghar ki list (checklist, add, share to WhatsApp, Pro multi-list)
  • [ ] Settings (name, family (Pro), Pro status + upgrade screen, logout)
  • [ ] Pro upsell sheets + entitlement-aware UI
  • [ ] Empty/loading/error states, a11y
  • [ ] flutter analyze clean + unit tests

Phase 3 — Admin + Landing

  • [ ] Admin SPA (/admin): login, dashboard metrics, users, templates, billing
  • [ ] Landing page (/) — product + Pro + download CTA (impeccable standards)

Phase 4 — Review

  • [ ] Correctness + security review (entitlement gates, tenant scoping, SQL, OTP, webhook sig)
  • [ ] Ponytail review → fix blockers

Phase 5 — Deploy + Release

  • [ ] systemd gharsaathi-backend + scheduler.timer; nginx api.gharsaathi + SSL
  • [ ] App icon + signed AAB + APK; Play assets + privacy policy
  • [ ] Host on gharsaathi.itsmehere.com; smoke test end-to-end