INSTRUCTION.md

# 🏥 User Guide - Lifestyle Journey MVP

## 🎯 What is this application?

**Lifestyle Journey** is an intelligent medical assistant that helps you:
- 🩺 **Get medical consultations** for symptoms and health concerns
- 💚 **Develop personalized programs** for physical activity and nutrition
- 📊 **Track progress** of your healthy lifestyle journey
- 🔧 **Customize AI behavior** with personalized prompts for coaching style
- 🔒 **Maintain privacy** - your data remains confidential and isolated

---

## 🚀 Getting Started

### 1. **Launch the Application**
- Open the application in your browser
- You'll see a message about private session initialization
- Your data will be isolated from other users

### 2. **Your First Conversation**
Simply type your question in the text field and click "📤 Send"

**Example starter messages:**
- "Hello, I have a headache"
- "I want to start exercising"
- "How should I eat with diabetes?"
- "What exercises are good for elderly people?"

---

## 💬 Main Operating Modes

### 🩺 **Medical Mode**
**When activated:** For medical complaints, symptoms, health questions

**What it does:**
- Analyzes your symptoms
- Provides first aid recommendations
- Advises when to see a doctor
- Explains medical terms in simple language

**Example questions:**
- "I have chest pain"
- "Blood pressure 160/100, what should I do?"
- "Can I take aspirin for headaches?"

⚠️ **IMPORTANT:** For serious symptoms, the app will immediately advise you to see a doctor!

### 💚 **Lifestyle Coaching**
**When activated:** For questions about sports, nutrition, healthy lifestyle

**What it does:**
- Creates personalized workout programs
- Provides nutrition advice
- Considers your medical limitations
- Motivates and supports you
- **Can be customized** with your preferred coaching style

**Example questions:**
- "I want to lose 10 kg"
- "What exercises can I do with arthritis?"
- "How should I eat with hypertension?"
- "How much water should I drink daily?"

### 🔄 **Mixed Mode**
**When activated:** When you have both medical complaints and lifestyle questions

**Example:** "I want to exercise but my back hurts"

The app will first address the medical issue, then help with physical activity.

---

## 🔧 Customize Your AI Coach

### **What is Edit Prompts?**
**Edit Prompts** allows you to customize how the AI lifestyle coach behaves and responds to your questions. You can make it more motivating, conservative, or specialized for your needs.

### **How to access:**
1. Click the **"🔧 Edit Prompts"** tab at the top
2. You'll see the current system prompt that controls AI behavior
3. Edit the text to match your preferences
4. Apply changes and test them in chat

### **Customization examples:**
- **Motivational Coach:** "Be energetic, use emojis, say 'You can do it!'"
- **Medical Conservative:** "Prioritize safety, give very gradual recommendations"
- **Senior-Friendly:** "Focus on fall prevention and low-intensity activities"

### **Important notes:**
- ⚠️ Changes apply **only to your current session**
- ⚠️ Changes are **lost when you close the browser**
- ⚠️ Always maintain **medical safety guidelines**
- ✅ Easy to **reset to default** if needed

### **How to use Edit Prompts:**

#### **Step 1: Open Edit Prompts**
- Click the **"🔧 Edit Prompts"** tab
- View the current system prompt in the large text box

#### **Step 2: Customize**
- Modify the prompt text according to your needs
- Use the guidelines in the right panel as reference
- Focus on tone, style, and approach preferences

#### **Step 3: Apply and Test**
- Click **"✅ Apply Changes"** to activate
- Click **"🧪 Test"** for testing instructions
- Go to **"💬 Patient Chat"** tab to try it out
- Test with: "I want to start exercising"

#### **Step 4: Control Buttons**
- **✅ Apply Changes** - Activate your custom prompt
- **🔄 Reset to Default** - Return to original behavior
- **👁️ Preview** - Check your changes before applying
- **🧪 Test** - Get instructions for testing

### **Requirements for custom prompts:**
- Must return **valid JSON format** with message/action/reasoning
- Must include **medical safety** guidelines
- Must handle three actions: `gather_info`, `lifestyle_dialog`, `close`
- Should respond in the **same language** as the patient

---

## 🧪 Testing with Different Patients

### **What is this?**
In the "🧪 Testing Lab" tab, you can load profiles of different patients to test functionality and your custom prompts.

### **Ready-made test patients:**
- **👵 Elderly Mary** - 76 years old, complex chronic conditions
- **🏃 Athletic John** - 24 years old, recovering from injury
- **🤰 Pregnant Sarah** - 28 years old, pregnancy with complications

### **How to use:**
1. Go to the "🧪 Testing Lab" tab
2. Click on one of the buttons (e.g., "👵 Elderly Mary")
3. Chat will restart with the new patient
4. Now you can test different scenarios for this patient
5. **Perfect for testing custom prompts** with different patient types

### **Loading custom data:**
1. Prepare JSON files with medical data and lifestyle profile
2. Upload them via "📁 Load Test Patient"
3. The app will validate files and create a new test patient

---

## ✅ Helpful Tips

### **💡 How to get better responses:**
- **Be specific:** "Morning headache" is better than "feeling bad"
- **Provide context:** "I have diabetes and want to exercise"
- **Ask direct questions:** "How many times per week should I train?"
- **Customize AI style:** Use Edit Prompts to match your preferences

### **🔒 Safety and Privacy:**
- Your data is not stored on servers
- Each session is isolated from other users
- **Custom prompts are private** to your session only
- All data is deleted when you close the browser

### **⚠️ Medical Safety:**
- The app does NOT replace doctor consultation
- For serious symptoms, always contact medical professionals
- Don't make important medical decisions without a doctor
- **Custom prompts cannot override medical safety** protocols

### **🎯 Lifestyle Tips:**
- Start with small steps
- Follow recommendations regarding your limitations
- Regularly update your progress
- **Experiment with different coaching styles** to find what motivates you

### **🔧 Edit Prompts Best Practices:**
- **Start small:** Make minor changes to the default prompt first
- **Test thoroughly:** Always test changes with different questions
- **Keep safety:** Never remove medical safety instructions
- **Use Reset:** If something goes wrong, use "🔄 Reset to Default"
- **Be specific:** Clear instructions give better results

---

## 🔧 Session Management

### **Main buttons:**
- **📤 Send** - Send message
- **🗑️ Clear Chat** - Clear conversation history
- **🏁 End Conversation** - End conversation and save progress
- **🔄 Refresh Status** - Update system status information

### **Edit Prompts buttons:**
- **✅ Apply Changes** - Activate your custom prompt
- **🔄 Reset to Default** - Return to original AI behavior
- **👁️ Preview** - Review changes before applying
- **🧪 Test** - Get testing instructions

### **Ending your session:**
1. Click "🏁 End Conversation" to save progress
2. Or simply close the browser - session will end automatically
3. **Note:** Custom prompts are lost when closing browser

---

## 🆘 Frequently Asked Questions (FAQ)

### **❓ Why does the app switch between modes?**
The app automatically determines your question type and chooses the best response method.

### **❓ How does the app determine my medical limitations?**
You can tell the app about your conditions during conversation, and it will consider them in recommendations.

### **❓ What to do if the response is inaccurate?**
Clarify your question or provide more details. Try customizing the AI coaching style with Edit Prompts.

### **❓ Is it safe to share medical information?**
Yes, your data is processed locally and not shared with third parties.

### **❓ How to get help in an urgent situation?**
For serious symptoms, the app will advise you to immediately contact emergency services or a doctor.

### **❓ What if my custom prompt breaks the AI?**
Use the "🔄 Reset to Default" button to immediately return to safe, working settings.

### **❓ Can other users see my custom prompts?**
No, your custom prompts are completely private to your session only.

### **❓ Why do my prompt changes disappear?**
Custom prompts are session-only for security. They reset when you close the browser.

### **❓ How do I make the AI more motivating?**
Use Edit Prompts to add instructions like "Be energetic, use positive emojis, motivate with phrases like 'You can do it!'"

---

## 📞 Support

If you have questions or problems:
1. Try restarting the session with the "🗑️ Clear Chat" button
2. **If Edit Prompts cause issues:** Use "🔄 Reset to Default"
3. Check that you're using a supported browser
4. Rephrase your question more specifically

---

## 🌟 Advanced Features

### **🔧 Edit Prompts Examples**

#### **Motivational Coach:**
```
You are a super-energetic lifestyle coach who:
- Always uses positive emojis 🌟💪🚀
- Says "You can do it!" and "Fantastic!"
- Celebrates even small achievements
- Keeps patients motivated and excited
```

#### **Medical Conservative:**
```
You are a careful medical coach who:
- Prioritizes safety above all
- Explains medical principles clearly
- Gives very gradual recommendations
- Always mentions when to consult doctors
```

#### **Senior-Specialized:**
```
You are a coach for elderly patients who:
- Focuses on fall prevention
- Suggests low-impact activities
- Considers age-related limitations
- Emphasizes safety and gradual progress
```

### **🧪 Testing Your Custom Prompts**

**Recommended test questions:**
- "I want to start exercising"
- "Give me nutrition advice"
- "I have [condition] but want to be active"
- "Help me lose weight safely"

**What to check:**
- Does the tone match your expectations?
- Are responses safe and appropriate?
- Does it handle medical limitations correctly?
- Is the JSON format working properly?

---

## 🌟 Successful Usage!

**Lifestyle Journey** is created to make health care simpler and more accessible. With the new **Edit Prompts** feature, you can now personalize your AI coach to match your preferred communication style and motivational needs.

**Remember:** This app is your assistant, but not a replacement for professional medical help. Always consult with a doctor for serious health problems.

🎯 **We wish you strong health and an active lifestyle!**

---

## 🔗 Quick Navigation

- **💬 Patient Chat** - Main conversation interface
- **🔧 Edit Prompts** - Customize AI coaching style
- **🧪 Testing Lab** - Test with different patient profiles
- **📊 Test Results** - View testing analytics
- **📖 Instructions** - This guide

**Happy coaching!** 🏥💚