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