Revise README for clarity and consistency, updating interface descriptions and enhancing user guidance

README.md

@@ -11,7 +11,9 @@ pinned: false
 
 # Medical Brain - Simplified Medical Assistant with Spiritual Monitoring
 
-Спрощена система для медичної підтримки пацієнтів з **автоматичним фоновим моніторингом духовного дистресу**.
+Simplified medical chat experience with **automatic background monitoring for spiritual distress**.
+
+This repository also includes **verification workflows** for chaplains/testers to review classifications and export results for analysis.
 
 ## ⚡ Швидкий Старт
 
@@ -33,14 +35,17 @@ PYTHONPATH=. ./venv/bin/python run_simplified_app.py
 # http://localhost:7860
 ```
 
-**Що включає інтерфейс:**
-- 💬 **Chat** - Медичні питання та консультації
-- ⚙️ **Model Settings** - Вибір AI моделей для різних завдань
-- � ***Patient Profiles** - 15 профілів для тестування (включаючи Spiritual scenarios)
-- � ***Edit Prompts** - Редагування системних промптів
-- 📖 **Help** - Повна документація та приклади
+**Що включає інтерфейс (основні вкладки):**
+- 💬 **Chat** — your main medical conversation (spiritual monitoring runs automatically in the background)
+- 🧾 **Conversation Verification** — generate a verification session from chat, review exchanges, and export results
+- 🔍 **Enhanced Verification** — Manual Input + File Upload workflows for structured testing and exports
+- ⚙️ **Model Settings** — choose which model is used per task (applies to the current browser session)
+- 🔧 **Edit Prompts** — session-scoped prompt overrides for testing (does not change defaults globally)
+- 📖 **Help** — end-user guide embedded in the app
 
-Детальніше: [QUICK_START.md](QUICK_START.md)
+For the customer specification, see:
+- `docs/Spiritual Distress Testing Tool.md`
+- `docs/Spiritual Distress Definition, Defining Characteristics, and Descriptions.md`
 
 ---
 
@@ -63,19 +68,19 @@ PYTHONPATH=. ./venv/bin/python run_simplified_app.py
 
 ### Три Стани Духовного Здоров'я
 
-**🟢 GREEN - Без Дистресу**
+**🟢 GREEN (Not Relevant) — No spiritual distress detected**
 - Медичні симптоми тільки
 - Рутинні питання
 - Стандартні теми здоров'я
 
-**🟡 YELLOW - Потенційний Дистрес**
+**🟡 YELLOW — Potential spiritual distress**
 - Стрес, тривога, проблеми зі сном
 - Горе та втрата
 - Екзистенціальні питання
 - Духовна відчуженість
 - Почуття самотності
 
-**🔴 RED - Важкий Дистрес (Негайна Направлення)**
+**🔴 RED — Severe spiritual distress (needs immediate attention)**
 - Суїцидальні думки
 - Важка безнадійність
 - Духовна криза
@@ -102,7 +107,7 @@ PYTHONPATH=. ./venv/bin/python run_simplified_app.py
 **Файл:** `src/core/soft_triage_manager.py`
 
 ### 4. 🎨 Gradio Interface
-Веб-інтерфейс з 5 закладками.
+Web interface (Gradio) with Chat + Verification tabs.
 
 **Файл:** `src/interface/simplified_gradio_app.py`
 
@@ -137,18 +142,17 @@ http://localhost:7860
 
 ## 📚 Документація
 
-### Основна Документація
-- 📖 [QUICK_START.md](QUICK_START.md) - Швидкий старт
-- 📁 [STRUCTURE.md](STRUCTURE.md) - Структура проекту
-- 📑 [FILE_INDEX.md](FILE_INDEX.md) - Індекс файлів
-- 🤖 [MODEL_SELECTION_GUIDE.md](MODEL_SELECTION_GUIDE.md) - Вибір моделей
-- 📊 [TRIAGE_ANALYSIS.md](TRIAGE_ANALYSIS.md) - Аналіз тріажу
+### Основні документи
+- `docs/Spiritual Distress Testing Tool.md` — customer-facing specification
+- `docs/Spiritual Distress Definition, Defining Characteristics, and Descriptions.md` — distress indicators reference
+- `docs/TROUBLESHOOTING_GUIDE.md` — common issues
 
 ### Інтерфейс
 - **Help Tab** - Вбудована документація в додатку
 - **Model Settings** - Налаштування AI моделей
-- **Patient Profiles** - 15 профілів для тестування
 - **Edit Prompts** - Редагування системних промптів
+- **Conversation Verification** - Перевірка та експорт з поточного чату
+- **Enhanced Verification** - Manual Input / File Upload + CSV/JSON exports
 
 ## 🧪 Тестування
 
@@ -157,7 +161,7 @@ http://localhost:7860
 PYTHONPATH=. ./venv/bin/python -m pytest tests/ -v
 ```
 
-**Результат:** 130/130 тестів пройдено ✅
+**Status:** ✅ test suite is green (most recent run: `pytest -q` → 380 passed)
 
 ### Тестування Spiritual Функціоналу
 ```bash
@@ -172,11 +176,8 @@ PYTHONPATH=. ./venv/bin/python -m pytest tests/test_referral_language_properties
 ```
 
 ### Тестування з Профілями
-1. Відкрийте додаток
-2. Перейдіть на закладку "👥 Patient Profiles"
-3. Виберіть один з 8 Spiritual Testing Profiles
-4. Завантажте профіль
-5. Перейдіть на "💬 Chat" та тестуйте
+This interface no longer relies on "Patient Profiles" as a primary workflow.
+Use **Chat** for free-form testing, or **Enhanced Verification** for structured Manual Input / File Upload workflows.
 
 ## 📁 Структура Проекту
 
@@ -189,6 +190,7 @@ PYTHONPATH=. ./venv/bin/python -m pytest tests/test_referral_language_properties
 │   │   ├── soft_triage_manager.py         # М'яке питання для тріажу
 │   │   ├── spiritual_state.py             # State machine
 │   │   └── ai_client.py                   # AI клієнт
+│   │   └── content_generator.py           # Explanations / follow-ups / referrals
 │   ├── config/
 │   │   ├── prompts.py                     # Системні промпти
 │   │   └── ai_providers_config.py         # Конфігурація моделей
@@ -222,20 +224,18 @@ PYTHONPATH=. ./venv/bin/python -m pytest tests/test_referral_language_properties
 - 🤖 Вибір між Claude та Gemini
 - ⚙️ Налаштування для кожного завдання
 - 🔄 Динамічна зміна моделей
-- 💾 Збереження налаштувань в сесії
-
-#### Профілі Пацієнтів
-- �️ 15 предефінованих профілів
-- 🟢 GREEN - Здоровий пацієнт
-- 🟡 YELLOW - 4 типи легкого дистресу
-- � RED - 3 тnипи важкого дистресу
-- 📝 Редагування та збереження налаштувань
+- 💾 Збереження налаштувань в межах поточної сесії браузера
 
 #### Редагування Промптів
 - 🔧 Редагування 5 системних промптів
 - � HTML зформатування для читаності
 - � Скидтання до стандартних
-- � Збережцення в сесії
+- � Збереження в сесії (не змінює дефолти глобально)
+
+#### Verification & Exports
+- 🧾 Conversation Verification: review chat-derived exchanges and export CSV/JSON
+- 🔍 Enhanced Verification: Manual Input and File Upload for batch testing
+- 📤 Exports: CSV + JSON (CSV “Notes” contains reasoning only)
 
 ### 🧪 Тестування
 
@@ -247,7 +247,7 @@ PYTHONPATH=. ./venv/bin/python -m pytest tests/test_referral_language_properties
 
 ## 🛠️ Технології
 
-- **Backend:** Python 3.14
+- **Backend:** Python 3
 - **LLM:** Google Gemini + Anthropic Claude
 - **UI:** Gradio 6.0.2
 - **Testing:** Pytest + Hypothesis