Scan prescriptions, manage medicines, share with family — all from one phone.

# Quick smoke tests
curl -sS "https://dawaisathi-api.onrender.com/healthz"
curl -sS "https://dawaisathi-api.onrender.com/api/notifications/trigger-check?cron_secret=YOUR_CRON_SECRET"

• AI Prescription Scanner — Point your camera at a prescription; Gemini Vision AI extracts medicine names, dosages, schedules, and instructions
• Medicine Cabinet — Daily schedule organized by time slots (Morning, Afternoon, Evening, Night)
• Family Mode — Multiple family members with individual cabinets, join via invite
• Push Notifications — Web Push + Telegram reminders at each time slot
• Offline-First PWA — Works offline with cached cabinet data; IndexedDB queue for offline sync
• Google OAuth — Sign in with Google, JWT session management
• Ops health — Public GET /healthz includes notification system flags and last cron run
• Real-Time Quality Feedback — Image brightness/contrast analysis before scan submission
• Camera Error Guidance — Step-by-step instructions when camera permissions are denied

• Python 3.10+
• Node.js 18+
• Google Cloud project with OAuth 2.0 credentials
• Google Gemini API key
• Cloudinary account (required for production image uploads)
• Supabase (or other Postgres) for production — see DEPLOY.md

git clone https://github.com/Project-eigen/version_3.git
cd version_3

cd backend
pip install -r requirements.txt
cp .env.example .env

Edit backend/.env (see .env.example for the full list):

python app.py

Backend runs on http://localhost:5000

cd frontend
npm install
npm run dev

Frontend runs on http://localhost:5173

In Google Cloud Console → APIs & Services → Credentials → your OAuth 2.0 Client:

Authorized JavaScript origins:

http://localhost:5173
http://localhost:5000

Authorized redirect URIs:

http://localhost:5000/api/auth/callback

For production, also add your Render origins/redirects (see DEPLOY.md).

+-----------------------------+
|     React PWA Frontend      |
|  (Vite + TypeScript + CSS)  |
|                             |
|  Scanner, Cabinet, Family,  |
|  Settings, Scan Approval    |
+----------|------------------+
           |  REST API (Bearer JWT)
           v
+-----------------------------+
|      Flask Backend          |
|                             |
|  /api/medicine/*            |
|  /api/auth/*                |
|  /api/family/*              |
|  /api/notifications/*       |
|  Global error handler       |
|  safe_commit() helper       |
+------|----------------------+
       |
   ----+----
   |       |
   v       v
 SQLite / Supabase    Gemini + Cloudinary
 (dev / prod pooler)  Flash + CDN images

Full curl examples: DEPLOY.md.

Production reliability (see DEPLOY.md):

• Cloudinary-only uploads in production (no /uploads disk fallback on Render)
• Supabase IPv4 pooler required (direct host is IPv6-only and breaks Render)
• CRON_SECRET for /api/notifications/trigger-check (403 without secret in production)
• /healthz database check + public notification system flags (no Settings ops UI)
• Family page skeleton loading (parity with Cabinet)

Earlier product work — see summary.md:

• Global JSON error handler for unhandled exceptions
• safe_commit() helper replacing bare commit() calls
• Structured Gemini error responses with retry logic
• Image quality analysis (brightness/contrast) before scan
• Enhanced scanner UI, camera permission guidance
• Dynamic IANA timezone picker
• Service worker: clientsClaim, SKIP_WAITING, reduced cache TTLs