ClinicAI — WhatsApp AI Clinic Assistant

Problem

India has 12 lakh+ small clinics running on phone calls and paper diaries. Patients call multiple times to confirm, double bookings happen daily, and revenue leaks through manual invoicing.

Business Impact

500M+ Indians use WhatsApp daily. A clinic bot eliminates phone-tag, prevents double bookings, and automates follow-ups — directly on the platform patients already use. Zero training required.

System Approach

• Spring Boot 3.5 + Java 21 backend with Flyway migrations (9 migration scripts)
• Twilio WhatsApp API for bi-directional messaging with Hindi templates
• Rule-based intent classifier parsing Hinglish queries (booking, cancellation, status)
• PostgreSQL 16 with JSONB for flexible clinic services and working hours
• Redis 7 for session management and conversation state caching
• Docker Compose for local development (PostgreSQL + Redis)

Key Decisions & Trade-offs

• WhatsApp over custom app — zero friction adoption for Tier 2/3 clinics
• Twilio over Gupshup — better developer experience, official WhatsApp Business API
• Rule-based NLP first, LLM later — ship fast, iterate with real user data
• Hinglish support from day one — reflects actual patient communication patterns
• JSONB for services/hours — clinics have wildly different schedules and offerings

Current Status

Sprint 0 complete — backend scaffold, database schema, WhatsApp webhook, appointment slot engine, demo clinic seeded. All APIs verified.

Roadmap

• LLM-powered intent classification replacing rule-based system
• Patient registration and medical history tracking
• GST-compliant invoice generation
• Automated appointment reminders via WhatsApp
• Multi-clinic support with clinic onboarding flow

What I'd Improve Next

• Add voice message transcription for patients who prefer speaking
• Consider regional language support beyond Hindi (Marathi, Tamil, Telugu)

Explore More

• MicroItinerary — AI Travel Planner — Travel apps optimize for proximity and ratings.
• StellarMIND — Chat-to-SQL with RAG — Business users need to query databases without knowing SQL.
• MyFinancial — Personal Financial Advisor — Financial planning in India is fragmented across banks, insurance, and tax documents.
• rohitraj.tech — Engineering work is often invisible.
• Reliability & Production Readiness — Load testing, observability, and API contracts.
• Open Source Repos — Browse the source code behind these projects.