docs: reorganize markdown files into docs/; add docs index

HELP.md

@@ -536,5 +536,5 @@ A: Поки що ні - дочекайтеся завершення або он
 
 Для додаткової інформації дивіться:
 - [README.md](README.md) - технічна документація
-- [BATCH_TESTING_README.md](BATCH_TESTING_README.md) - детально про пакетне тестування
+- [docs/batch/BATCH_TESTING_README.md](docs/batch/BATCH_TESTING_README.md) - детально про пакетне тестування
 - [PROMPT_EDITING.md](docs/PROMPT_EDITING.md) - глибоке занурення у промпти

README.md

@@ -79,7 +79,7 @@ python_version: "3.11"
 - Налаштування деталізації відповідей
 - Конфіденційність: опція не зберігати запити
 
-📖 [Детальна документація GPT-5.2](GPT5_2_INTEGRATION.md) | [Швидкий старт](GPT5_2_QUICKSTART.md)
+📖 [Детальна документація GPT-5.2](docs/models/openai/GPT5_2_INTEGRATION.md) | [Швидкий старт](docs/models/openai/GPT5_2_QUICKSTART.md)
 
 ## 📋 Структура проекту
 
@@ -111,9 +111,8 @@ Legal_Position_2/
 │
 ├── test_results/                # Результати пакетного тестування
 │
-├── BATCH_TESTING_README.md      # Документація пакетного тестування
-├── HELP.md                      # Загальна допомога для користувачів
-└── CHANGES.md                   # Детальний changelog
+├── HELP.md                      # Загальна допомога для користувачів (використовується інтерфейсом)
+└── docs/                        # Документація (див. docs/README.md)
 ```
 
 ## 🛠️ Встановлення
@@ -208,7 +207,7 @@ python main.py
 
 **Формат результатів:** Повний JSON об'єкт з полями `title`, `text`, `proceeding`, `category`
 
-Детальна інструкція: [BATCH_TESTING_README.md](BATCH_TESTING_README.md)
+Детальна інструкція: [docs/batch/BATCH_TESTING_README.md](docs/batch/BATCH_TESTING_README.md)
 
 ### 📖 Допомога
 
@@ -370,10 +369,10 @@ gunicorn main:app --workers 4 --bind 0.0.0.0:7860
 ## 📚 Документація
 
 - **[HELP.md](HELP.md)** - Загальна допомога для користувачів (доступна в додатку)
-- **[BATCH_TESTING_README.md](BATCH_TESTING_README.md)** - Документація пакетного тестування
+- **[docs/batch/BATCH_TESTING_README.md](docs/batch/BATCH_TESTING_README.md)** - Документація пакетного тестування
 - **[PROMPT_EDITING.md](docs/PROMPT_EDITING.md)** - Повна технічна документація з редагування промптів
 - **[QUICK_START_PROMPTS.md](docs/QUICK_START_PROMPTS.md)** - Швидкий старт для користувачів
-- **[CHANGES.md](CHANGES.md)** - Детальний changelog версії 2.0
+- **[docs/changelog/CHANGES.md](docs/changelog/CHANGES.md)** - Детальний changelog
 
 ## 🔧 Troubleshooting
 

docs/README.md

@@ -0,0 +1,39 @@
+# Документація проєкту Legal Position AI Analyzer
+
+## Швидкі посилання
+
+### MVP / Scope
+- **Scope + актуальність даних (важливо для замовника):** `SCOPE_AND_DATA_FRESHNESS.md`
+
+### Генерація (основний фокус)
+- **Prompt editing:** `PROMPT_EDITING.md`
+- **Quick start prompts:** `QUICK_START_PROMPTS.md`
+
+### Моделі
+- OpenAI GPT‑5.2: `models/openai/GPT5_2_INTEGRATION.md` · `models/openai/GPT5_2_QUICKSTART.md` · `models/openai/GPT5_2_SUMMARY.md` · `models/openai/CHANGELOG_GPT5_2.md`
+- Gemini embeddings: `models/gemini/GEMINI_EMBEDDINGS.md`
+
+### Деплой / HF
+- `deployment/hf/DEPLOYMENT_HF.md`
+- `deployment/hf/HF_SPACE_SETUP.md`
+- `deployment/hf/HF_DEPLOYMENT_CHECKLIST.md`
+- `deployment/hf/HF_DEPLOYMENT_SUMMARY.md`
+- `deployment/hf/README_HF.md`
+
+### Дані / індекси (опціонально, якщо search увімкнений)
+- `HF_DATASET_SETUP.md`
+- `INDEX_STORAGE_OPTIONS.md`
+- `data/dataset_README.md`
+
+### Ops
+- `ops/API_KEYS_OPTIONAL.md`
+- `ops/CONFIGURATION_CLEANUP.md`
+- `ops/TODO.md`
+
+### Batch
+- `batch/BATCH_TESTING_README.md`
+
+### Історія змін / технічні нотатки
+- `changelog/CHANGES.md`
+- `legacy/IMPLEMENTATION_SUMMARY.md`
+

IMPLEMENTATION_SUMMARY.md → docs/legacy/IMPLEMENTATION_SUMMARY.md

@@ -148,7 +148,7 @@ async def process_input(..., session_id: str) -> Tuple[str, Dict, str]:
    - Життєвий цикл сесії
    - Порівняння до/після
 
-4. **[CHANGES.md](CHANGES.md)** (500+ рядків)
+4. **[CHANGES.md](../changelog/CHANGES.md)** (500+ рядків)
    - Детальний changelog
    - Список всіх змінених файлів
    - Технічні деталі
@@ -453,7 +453,7 @@ python main.py
 
 1. **[docs/PROMPT_EDITING.md](docs/PROMPT_EDITING.md)** - Технічна документація
 2. **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - Архітектурні схеми
-3. **[CHANGES.md](CHANGES.md)** - Детальний changelog
+3. **[CHANGES.md](../changelog/CHANGES.md)** - Детальний changelog
 
 ### Для DevOps
 

API_KEYS_OPTIONAL.md → docs/ops/API_KEYS_OPTIONAL.md

@@ -277,7 +277,7 @@ else:
     print("Warning: No embedding API key found (OpenAI or Gemini). Search functionality will be disabled.")
 ```
 
-Детальна документація: [GEMINI_EMBEDDINGS.md](GEMINI_EMBEDDINGS.md)
+Детальна документація: [GEMINI_EMBEDDINGS.md](../models/gemini/GEMINI_EMBEDDINGS.md)
 
 ---
 

TODO.md → docs/ops/TODO.md

@@ -24,7 +24,7 @@
 - [x] Написано швидкий старт (QUICK_START_PROMPTS.md)
 - [x] Створено архітектурну схему (ARCHITECTURE.md)
 - [x] Оновлено README.md з детальною інформацією
-- [x] Створено CHANGES.md з повним changelog
+- [x] Створено docs/changelog/CHANGES.md з повним changelog
 
 ### Можливі покращення в майбутньому: