evaldoc 1.0.0

package/docs/PATIENT_GUIDE.md

@@ -0,0 +1,451 @@
+# EvalDoc Patient User Guide
+
+## 👋 Welcome!
+
+EvalDoc helps you get quick, safe health information from your doctor's AI assistant - available 24/7 on any device.
+
+---
+
+## 🤔 What is EvalDoc?
+
+EvalDoc is your doctor's AI assistant that helps answer routine health questions instantly. Your doctor reviews all conversations and steps in when needed.
+
+### What EvalDoc IS:
+✅ A way to get quick health information
+✅ Educational guidance for common questions
+✅ A bridge to your doctor 24/7
+✅ Free to use (no app download needed)
+
+### What EvalDoc is NOT:
+❌ A replacement for seeing your doctor
+❌ A diagnostic tool
+❌ A prescription service
+❌ For medical emergencies
+
+---
+
+## 🚀 Getting Started
+
+### Step 1: Get Your Doctor's Link
+
+Your doctor will share a unique link like:
+```
+evaldoctor.ai/dr-sarah-amina
+```
+
+You might receive it via:
+- WhatsApp message
+- SMS text
+- Email
+- QR code at the clinic
+- Business card
+
+### Step 2: Open the Link
+
+Simply click or tap the link - it works on:
+- 📱 Any smartphone (iPhone, Android)
+- 💻 Computer or laptop
+- 📲 Tablet
+- 🌐 Any web browser
+
+**No app download needed!**
+
+### Step 3: Start Chatting
+
+The page will open with your doctor's welcome message and available topics.
+
+---
+
+## 💬 How to Use the Chat
+
+### Choosing a Topic
+
+Select what your question is about:
+
+**💊 Medication Information & Safety**
+- Questions about medications
+- Drug interactions
+- When to take medicines
+
+**📅 Appointments & Preparation**
+- How to prepare for visits
+- What to bring
+- Scheduling help
+
+**ℹ️ General Health Information**
+- Common health questions
+- Preventive care tips
+- Healthy living advice
+
+**🏥 Clinic Services & Hours**
+- Clinic hours
+- Services offered
+- Location and contact info
+
+**💳 Insurance & Billing**
+- Insurance questions
+- Payment options
+- Billing inquiries
+
+**🩹 Post-Procedure Guidance**
+- Recovery instructions
+- Follow-up care
+- What to expect after treatment
+
+### Asking Your Question
+
+1. Select a topic from the dropdown
+2. Type your question in the message box
+3. Click **"Send"**
+4. AI responds within seconds
+
+### Examples of Good Questions
+
+✅ "What should I do if my child has a fever?"
+✅ "How do I prepare for my blood test tomorrow?"
+✅ "What are your clinic hours?"
+✅ "Is it normal to feel tired after surgery?"
+✅ "Can I take ibuprofen with my blood pressure medication?"
+
+### Questions to Ask Your Doctor Directly
+
+❌ "What disease do I have?"
+❌ "Can you prescribe me antibiotics?"
+❌ "What dose should I take?"
+❌ "Is this rash cancer?"
+
+For these questions, **book an appointment with your doctor**.
+
+---
+
+## 🤖 Understanding AI Responses
+
+### What to Expect
+
+The AI will:
+- Give you educational information
+- Explain things in simple language
+- Suggest when to see your doctor
+- Always include safety disclaimers
+- Flag urgent issues automatically
+
+### Example Conversation
+
+**You**: "My child has a fever of 37.8°C. What should I do?"
+
+**AI**: "For a child with mild fever (37.8°C):
+
+**At Home Care:**
+- Keep them comfortable and rested
+- Offer plenty of fluids (water, juice)
+- Use light clothing and blankets
+- Monitor temperature regularly
+
+**When to See a Doctor:**
+- Fever above 38.5°C (101.3°F)
+- Lasts more than 3 days
+- Child is very sleepy or irritable
+- Has trouble breathing
+- Shows signs of dehydration
+
+**Important**: This is educational information only, not medical advice.
+Your doctor reviews all conversations. For specific medical guidance,
+please contact [Doctor Name] directly.
+
+📞 For emergencies, call your local emergency services immediately."
+
+---
+
+## 🚨 When AI Detects Something Urgent
+
+If you mention serious symptoms like:
+- Severe chest pain
+- Difficulty breathing
+- Heavy bleeding
+- Severe injury
+- Thoughts of self-harm
+
+The AI will:
+1. **Immediately alert you** to seek emergency care
+2. **Notify your doctor** automatically
+3. **Give emergency guidance** on what to do now
+4. **NOT provide treatment advice** - you need immediate medical attention
+
+### Urgent Response Example
+
+**You**: "I have severe chest pain"
+
+**AI**: "🚨 **URGENT: SEEK EMERGENCY CARE NOW**
+
+Severe chest pain requires immediate medical attention.
+
+**What to do RIGHT NOW:**
+1. Call emergency services (911 or local emergency number)
+2. Do NOT drive yourself
+3. Do NOT wait to see if it improves
+4. Tell someone near you
+
+Your doctor has been notified of this urgent message.
+
+**This is a medical emergency. Go to the nearest hospital
+or call emergency services immediately.**"
+
+---
+
+## 🔒 Your Privacy & Safety
+
+### Data Protection
+
+- All conversations are secure and private
+- Your doctor can see all messages
+- No data is sold to third parties
+- Conversations are stored securely
+
+### Anonymous Chatting
+
+You can chat without providing:
+- Your name
+- Email address
+- Phone number
+
+However, providing contact info helps your doctor follow up if needed.
+
+### Optional: Share Your Contact Info
+
+If you'd like your doctor to reach you, you can share:
+- Your name
+- Email address
+- Phone number
+
+**How to share**: Just mention it in your first message
+```
+Example: "Hi, this is Sarah Johnson (sarah@email.com)"
+```
+
+---
+
+## ✅ Best Practices
+
+### DO:
+
+✅ **Use for routine questions**
+- General health information
+- Appointment preparation
+- Medication questions
+- Clinic information
+
+✅ **Be clear and specific**
+- "My 5-year-old has a fever of 38°C" (not just "fever")
+- "I'm preparing for blood work tomorrow" (not just "test")
+
+✅ **Mention all symptoms**
+- The more detail, the better the AI can help
+- Include when symptoms started
+- Describe severity (mild, moderate, severe)
+
+✅ **Follow safety advice**
+- If AI says seek care, do it
+- Don't ignore red flags
+- Call emergency services for emergencies
+
+### DON'T:
+
+❌ **Use for emergencies**
+- Call emergency services instead
+- Don't wait for AI response in emergencies
+
+❌ **Expect diagnoses**
+- AI can't tell you what disease you have
+- Book an appointment for diagnosis
+
+❌ **Request prescriptions**
+- AI can't prescribe medications
+- Your doctor needs to see you for prescriptions
+
+❌ **Share overly personal medical history**
+- Keep to the specific question
+- Share detailed history with your doctor in person
+
+---
+
+## 📱 Tips for Best Experience
+
+### On Mobile Phone
+
+- Use in portrait mode for better layout
+- Type short, clear messages
+- Select topic before each question
+- Works on any mobile browser (Safari, Chrome, etc.)
+
+### If Something Goes Wrong
+
+**Page won't load?**
+- Check your internet connection
+- Try refreshing the page
+- Verify you have the correct link
+
+**Can't send messages?**
+- Check internet connection
+- Try reloading the page
+- Make sure you selected a topic
+
+**AI not responding?**
+- Wait a few seconds
+- Check your internet
+- Try sending again
+
+**Still having issues?**
+- Contact your doctor directly
+- They can help troubleshoot
+
+---
+
+## ❓ Frequently Asked Questions
+
+### Q: Is this free?
+
+A: Your doctor decides pricing. Many doctors offer free basic access. Check with your doctor for details.
+
+### Q: Do I need to create an account?
+
+A: No! You can chat immediately without signing up.
+
+### Q: Can I use this instead of visiting my doctor?
+
+A: No. This is for educational information only. You still need to see your doctor for:
+- Diagnoses
+- Prescriptions
+- Physical examinations
+- Serious health concerns
+
+### Q: How fast will I get a response?
+
+A: The AI responds within seconds. If your doctor replies manually, it may take longer depending on their availability.
+
+### Q: Can my doctor see my messages?
+
+A: Yes! Your doctor reviews all conversations. This is a good thing - they can step in if needed.
+
+### Q: Is my conversation private?
+
+A: Yes. Only you and your doctor can see your messages. They're stored securely and not shared with anyone else.
+
+### Q: What if I need urgent care?
+
+A: The AI will tell you to seek immediate medical attention. Always:
+- Call emergency services for emergencies
+- Go to the nearest hospital
+- Don't wait for online responses
+
+### Q: Can I chat about mental health?
+
+A: Yes, but remember:
+- This is not therapy or counseling
+- If you're in crisis, call a suicide hotline
+- The AI will direct you to emergency resources if needed
+
+### Q: Can I use this for my children?
+
+A: Yes! You can ask questions about your children's health. The AI is designed to help with pediatric questions too.
+
+### Q: What languages are supported?
+
+A: Currently English. More languages coming soon!
+
+### Q: Can I chat from anywhere?
+
+A: Yes! As long as you have internet, you can chat from anywhere in the world.
+
+---
+
+## 🆘 Emergency Resources
+
+**Remember: EvalDoc is NOT for emergencies**
+
+### When to Call Emergency Services:
+
+- Chest pain or pressure
+- Difficulty breathing or shortness of breath
+- Severe bleeding that won't stop
+- Severe burns
+- Possible broken bones
+- Severe allergic reactions
+- Loss of consciousness
+- Seizures
+- Poisoning or overdose
+- Suicidal thoughts or actions
+- Severe injuries from accidents
+
+### In an Emergency
+
+**Always call your local emergency number in serious situations!**
+
+Common emergency numbers: 911 (US/Canada), 999 (UK), 112 (EU/International).
+
+---
+
+## 📞 Getting More Help
+
+### Can't Find What You Need?
+
+1. **Ask in the chat** - The AI might have the answer
+2. **Call your doctor's clinic** - For specific questions about your care
+3. **Book an appointment** - For thorough medical evaluation
+
+### Technical Support
+
+If the website isn't working:
+- Contact your doctor's office
+- They can report technical issues
+- Or email: helpme@evaldoctor.ai
+
+---
+
+## 📝 Quick Tips Summary
+
+🟢 **DO USE** for:
+- Routine health questions
+- Medication information
+- Appointment preparation
+- General health education
+- Clinic information
+
+🔴 **DON'T USE** for:
+- Emergencies (call 911/112)
+- Diagnoses
+- Prescriptions
+- Serious symptoms
+- Detailed treatment plans
+
+✅ **REMEMBER**:
+- AI provides education, not medical advice
+- Your doctor reviews all chats
+- Always follow AI safety recommendations
+- Book appointments for proper medical care
+- Call emergency services for emergencies
+
+---
+
+## 🎉 You're Ready!
+
+You now know how to use EvalDoc to get quick, safe health information from your doctor's AI assistant.
+
+**Remember**:
+- 🤖 AI handles routine questions
+- 👨‍⚕️ Your doctor handles medicine
+- 🚨 Emergency services handle emergencies
+
+Stay healthy! 💚
+
+---
+
+*Your doctor cares about your health. This tool helps them serve you better, faster, and more efficiently.*
+
+---
+
+**Questions? Ask in the chat or contact your doctor's clinic directly.**
+
+---
+
+*Last Updated: January 2026*
+*Version: 1.0*

package/docs/PLATFORM_OVERVIEW.md

@@ -0,0 +1,194 @@
+# EvalDoc Platform Overview
+
+## 🏥 What is EvalDoc?
+
+EvalDoc is an AI-powered medical consultation platform that connects patients with healthcare providers through an intelligent chat interface. The platform helps doctors scale their practice by automating routine questions while maintaining full oversight and control.
+
+## 🎯 Core Purpose
+
+**For Doctors**: Reduce burnout from repetitive questions, serve more patients safely, and focus on complex clinical cases.
+
+**For Patients**: Get instant, safe medical guidance 24/7 without waiting for appointments, while maintaining connection to their trusted doctors.
+
+## 🌟 Key Features
+
+### 1. **Link-First Architecture**
+- Each doctor gets a unique shareable link (e.g., `evaldoc.com/dr-amina`)
+- No app downloads required
+- Works on any device with a web browser
+- Perfect for WhatsApp, SMS, or QR code sharing
+
+### 2. **AI-Powered Chat Assistant**
+- **Two AI Models**:
+  - **DeepSeek** (Primary): Better quality medical responses
+  - **Google Gemini** (Fallback): Backup when DeepSeek is unavailable
+- Provides educational information, not medical diagnosis
+- Automatically detects red flags and escalates to doctor
+- Never prescribes medication or diagnoses conditions
+
+### 3. **Doctor Oversight & Control**
+- **Inbox Dashboard**: View all patient conversations in one place
+- **Full Message History**: See both patient questions and AI responses
+- **Manual Reply Capability**: Doctors can respond directly when needed
+- **Escalation System**: AI flags urgent cases automatically
+- **Analytics Dashboard**: Monitor platform usage and patient volume
+
+### 4. **Safety-First Design**
+- ✅ Educational content only
+- ✅ Red-flag detection (chest pain, breathing issues, etc.)
+- ✅ Automatic escalation for serious symptoms
+- ✅ Clear disclaimers on every interaction
+- ❌ No diagnoses given
+- ❌ No medication prescriptions
+- ❌ No dosing recommendations
+
+### 5. **Topic-Based Conversations**
+Doctors can enable/disable specific topics:
+- 💊 Medication Information & Safety
+- 📅 Appointments & Preparation
+- ℹ️ General Health Information
+- 🏥 Clinic Services & Hours
+- 💳 Insurance & Billing FAQ
+- 🩹 Post-Procedure Guidance
+
+## 🔄 How It Works
+
+### Patient Journey:
+```
+1. Patient receives link from doctor
+   ↓
+2. Opens link in browser (no signup required)
+   ↓
+3. Selects topic of interest
+   ↓
+4. Asks question via chat
+   ↓
+5. AI responds instantly with educational info
+   ↓
+6. If urgent → Doctor gets alert
+   ↓
+7. Doctor reviews and steps in if needed
+```
+
+### Doctor Journey:
+```
+1. Sign up at /app
+   ↓
+2. Complete profile setup
+   ↓
+3. Customize topics and branding
+   ↓
+4. Share unique link with patients
+   ↓
+5. Monitor inbox for conversations
+   ↓
+6. Review AI responses
+   ↓
+7. Reply manually when needed
+```
+
+## 🛠️ Technical Highlights
+
+- **Frontend**: Vanilla JavaScript (no framework overhead)
+- **Backend**: Node.js with Express
+- **Database**: Firebase Firestore
+- **Authentication**: Firebase Auth
+- **AI Integration**: DeepSeek API + Google Gemini API
+- **Hosting**: Firebase Hosting + Cloud Functions
+- **Design**: Clean, mobile-first UI with accessibility focus
+
+## 📊 Data Architecture
+
+### Collections:
+- **providers**: Doctor profiles and settings
+- **conversations**: Chat sessions between patients and doctors
+- **messages**: Individual messages (subcollection of conversations)
+- **safetyEvents**: Tracked escalations and flags
+- **analytics**: Usage metrics and statistics
+
+### Message Flow:
+```
+Patient → Chat API → AI Model → Response → Firestore → Doctor Inbox
+```
+
+## 🌍 Built for Anywhere
+
+- **Mobile-First**: Works on any phone
+- **Low Bandwidth**: Optimized for any network condition
+- **Share Anywhere**: WhatsApp, SMS, email, or QR code
+- **Offline Resilience**: Graceful degradation when connectivity is poor
+- **Global Ready**: Designed for real healthcare conditions worldwide
+
+## 💰 Business Model
+
+- **Doctor Pricing**: Flexible (per session or subscription)
+- **Patient Pricing**: Set by individual doctors
+- **Platform Fee**: 25% commission on transactions
+- **No Ads**: Healthcare trust comes first
+- **No Data Selling**: Patient privacy is paramount
+
+## 🔐 Security & Privacy
+
+- **PII Redaction**: Automatically removes sensitive information
+- **Secure Storage**: All data encrypted in Firebase
+- **Authentication**: Secure token-based auth for doctors
+- **Anonymous Sessions**: Patients can chat without creating accounts
+- **Audit Trails**: All conversations logged for doctor review
+
+## 📈 Current Status
+
+### ✅ Implemented Features:
+- Doctor registration and profile management
+- Unique shareable links per doctor
+- AI chat with DeepSeek and Gemini
+- Safety detection and escalation
+- Doctor inbox with full conversation history
+- Analytics dashboard with doctor metrics
+- Topic customization
+- Manual doctor replies
+- Mobile-responsive design
+
+### 🚧 Future Roadmap:
+- Patient authentication (Google Sign-In)
+- Thread-based conversations (WhatsApp-style)
+- Push notifications
+- Payment integration (Stripe)
+- Multi-language support
+- Voice messages
+- Image sharing
+- Appointment scheduling
+
+## 🎓 Target Users
+
+### Primary: Healthcare Providers
+- Solo practitioners
+- Small clinics
+- Multi-doctor practices
+- Medical specialists
+- Family medicine doctors
+
+### Secondary: Patients
+- Tech-savvy mobile users
+- People seeking quick medical info
+- Patients with routine questions
+- Those preparing for appointments
+- Post-procedure follow-up needs
+
+## 🚀 Competitive Advantages
+
+1. **Link-First**: No app downloads, instant access
+2. **Doctor-Controlled**: Providers maintain full oversight
+3. **Global-Ready**: Built for real conditions everywhere
+4. **Safety-First**: Medical-grade content moderation
+5. **Scalable**: AI handles routine, doctors handle medicine
+6. **Affordable**: Lower cost than traditional telemedicine
+
+## 📞 Support & Contact
+
+- **Email**: helpme@evaldoctor.ai
+- **Website**: evaldoctor.ai
+- **Company**: Feyti Medical Group, Inc.
+- **Location**: Dover, DE, USA
+---
+
+**Built with care for healthcare providers and patients worldwide**