# ✅ Чек-лист розгортання на Hugging Face Spaces

## 📋 Перед розгортанням

- [ ] Переконайтеся, що у вас є доступ до https://huggingface.co/spaces/DocSA/LP_2-test
- [ ] Підготуйте API ключі (хоча б Anthropic)
- [ ] Перевірте, що всі файли актуальні

## 🔧 Крок 1: Підготовка файлів

```bash
# Запустіть скрипт підготовки
./prepare_hf_deploy.sh
```

- [ ] Скрипт виконався без помилок
- [ ] Створена папка `hf_deploy/`
- [ ] Файл `FILES_LIST.txt` містить всі необхідні файли

## 📤 Крок 2: Завантаження на HF Spaces

### Варіант A: Через веб-інтерфейс

1. [ ] Відкрийте https://huggingface.co/spaces/DocSA/LP_2-test
2. [ ] Files > Add file > Upload files
3. [ ] Виберіть всі файли з папки `hf_deploy/`
4. [ ] Commit changes

### Варіант B: Через Git

```bash
# Клонуйте репозиторій
git clone https://huggingface.co/spaces/DocSA/LP_2-test
cd LP_2-test

# Очистіть старі файли (якщо потрібно)
rm -rf *

# Скопіюйте нові файли
cp -r ../hf_deploy/* ./

# Закомітьте
git add .
git commit -m "Deploy: version X.X.X"
git push
```

- [ ] Файли завантажені
- [ ] Git push пройшов успішно

## 🔐 Крок 3: Налаштування секретів

1. [ ] Перейдіть Settings > Variables and secrets
2. [ ] Додайте змінні:

```
ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx (опціонально)
GEMINI_API_KEY=xxxxx (опціонально)
```

3. [ ] Збережіть зміни

## 📊 Крок 4: Налаштування індексів

### Варіант A: Локальні індекси

- [ ] Запакуйте `Save_Index_Ivan/` в tar.gz
- [ ] Завантажте на HF Space
- [ ] Розпакуйте через terminal або скрипт

### Варіант B: AWS S3

- [ ] Налаштуйте AWS credentials в Secrets:
  ```
  AWS_ACCESS_KEY_ID=xxxxx
  AWS_SECRET_ACCESS_KEY=xxxxx
  ```
- [ ] Індекси завантажаться автоматично при старті

## 🚀 Крок 5: Запуск та тестування

1. [ ] Space автоматично перезапустився
2. [ ] Немає помилок в логах (Logs tab)
3. [ ] Інтерфейс відкривається
4. [ ] Протестуйте функції:
   - [ ] Генерація правової позиції
   - [ ] Пошук прецедентів
   - [ ] Аналіз релевантності

## 🔍 Крок 6: Перевірка налаштувань

- [ ] Default provider: Anthropic
- [ ] Default model: Claude Sonnet 4.5
- [ ] Max tokens: 512
- [ ] Temperature: 0.5

## 📝 Крок 7: Документація

- [ ] README.md відображається правильно
- [ ] Вкладка "Допомога" працює
- [ ] API instructions зрозумілі

## ⚠️ Усунення проблем

### Якщо Space не запускається:

1. [ ] Перевірте Logs на помилки
2. [ ] Переконайтеся, що всі файли завантажені
3. [ ] Перевірте, що API ключі правильно налаштовані
4. [ ] Factory reboot Space

### Якщо є помилки імпорту:

1. [ ] Перевірте `requirements.txt`
2. [ ] Переконайтеся, що папка `config/` повна
3. [ ] Перевірте структуру директорій

## ✅ Фінальна перевірка

- [ ] Space статус: Running (зелений)
- [ ] Інтерфейс відповідає за < 5 секунд
- [ ] Генерація працює з вашим API ключем
- [ ] Пошук повертає результати
- [ ] Аналіз виконується коректно
- [ ] Немає критичних помилок в логах

## 🎉 Готово!

Space розгорнуто та працює: https://huggingface.co/spaces/DocSA/LP_2-test

---

**Версія:** 1.0.0  
**Дата:** 10 лютого 2026 р.