TESTING_GUIDE.md

🧪 Інструкція з тестування інтегрованих JSON профілів

📁 Структура файлів

Переконайтесь що у вас є ці файли у тій же директорії з app.py:

Lifestyle/
├── app.py
├── clinical_background.json      # ← НОВИЙ
├── lifestyle_profile.json        # ← НОВИЙ  
├── requirements.txt
├── .env (з вашим GEMINI_API_KEY)
└── .env.example

🚀 Запуск

python app.py

При запуску ви повинні побачити:

🔄 Завантаження даних пацієнта...
✅ Завантажено профіль пацієнта: Mark
📋 Активних проблем: 8
🎯 Lifestyle ціль: Improve exercise tolerance safely...

🔧 Debug режим (логування промптів)

Для детального аналізу промптів та відповідей LLM:

1. Активуйте логування в .env:

   LOG_PROMPTS=true
   

2. Запустіть застосунок:

   python app.py
   

3. Перевірте індикатори:

   • В заголовку з'явиться 📝 та повідомлення про DEBUG MODE
   • В статус панелі: Логування: 📝 АКТИВНЕ
   • Лічильник API викликів

4. Аналізуйте логи:

   tail -f lifestyle_journey.log
   

Що логується:

• [SESSION_CONTROLLER] - рішення про режим
• [MEDICAL_ASSISTANT] - медичні консультації
• [LIFESTYLE_ASSISTANT] - lifestyle коучинг
• Повні промпти та відповіді з timestamp'ами

🎯 Що змінилося

1. Реальні дані пацієнта Mark

• 52 роки, ЦД2, АГ, ампутація правої ноги
• 16+ поточних медикаментів
• Складний медичний анамез з недавніми госпіталізаціями

2. Детальний medical context

• Активні проблеми: нудота, гіпокаліємія, біль у грудях
• Критичні попередження про компліансність
• Недавні події: ER візити через блювоту та біль у грудях

3. Персоналізований lifestyle профіль

• Адаптовані вправи для людини з ампутацією
• Діабетична дієта + обмеження GERD
• Реалістичні цілі з урахуванням фізичних обмежень

🧪 Сценарії тестування

🚨 Medical режим (Red flags):

"У мене знову болить груди як тиждень тому"
"Нудота повернулася, не можу їсти"
"Рівень калію знизився - що робити?"
"Відчуваю слабкість в ногах"

Очікуваний результат: Controller направить в medical режим, асистент врахує недавні госпіталізації та поточні медикаменти.

💚 Lifestyle режим:

"Хочу почати займатися спортом з моєю ампутацією"
"Як правильно харчуватися при діабеті та GERD?"
"Які вправи можна робити сидячи?"  
"Допоможіть скласти план тренувань для інвалідного візка"

Очікуваний результат: Controller активує lifestyle режим, коуч врахує ампутацію, діабет та особисті переваги.

🔄 Mixed/складні запити:

"Чи можу я займатися плаванням з моїм цукровим діабетом?"
"Болить спина після сидіння в візку - які вправи допоможуть?"
"Як контролювати цукор під час тренувань?"

📊 Що перевіряти в Status панелі:

✅ Корректне завантаження:

• Пацієнт: Mark
• Вік: 52
• Активні проблеми: повинні показуватись реальні діагнози
• Lifestyle ціль: повинна містити текст про ампутацію

✅ Controller рішення:

• Медичні симптоми → action: start_medical
• Lifestyle питання → action: start_lifestyle
• Обґрунтування українською мовою

✅ Персоналізація відповідей:

• Medical асистент повинен згадувати недавні госпіталізації
• Lifestyle коуч повинен враховувати ампутацію в рекомендаціях
• Обидва режими мають враховувати діабет та гіпертонію

🐛 Можливі проблеми:

Якщо файли не знаходить:

⚠️ Файл clinical_background.json не знайдено. Використовуємо тестові дані.

→ Переконайтесь що JSON файли в тій же папці що й app.py

Якщо JSON некоректний:

⚠️ Помилка завантаження lifestyle_profile.json: ...

→ Перевірте синтаксис JSON (коми, лапки)

Якщо API не працює:

Помилка API: ...

→ Перевірте GEMINI_API_KEY в .env файлі

🎉 Успішний тест:

Якщо все працює правильно, ви побачите:

• Mark's профіль коректно завантажений
• Медичні запити враховують його складний анамнез
• Lifestyle поради адаптовані під ампутацію та діабет
• Controller коректно розрізняє типи запитів
• Profile оновлюється після lifestyle сесій

---

Готово до продакшену! 🚀