domovoy_bot/ДОСТУПЫ.md

# 🔐 Доступы к инфраструктуре Домового Бота

**Дата настройки:** 27 февраля 2026 г.
**Статус:** ✅ ВСЁ РАБОТАЕТ!

---

## 📊 Сводная таблица доступов

| Сервис | URL / Путь | Порт | Логин | Пароль | Статус |
|--------|-----------|------|-------|--------|--------|
| **Gitea (Веб)** | http://localhost:3000 | 3000 | `matrixhasyou` | `5nMVkjd5nMVkjd` | ✅ Работает |
| **Gitea (Git HTTP)** | http://localhost:3000/matrixhasyou/domovoy_bot.git | 3000 | `matrixhasyou` | `5nMVkjd5nMVkjd` | ✅ Работает |
| **Gitea (Git SSH)** | ssh://localhost:2222/matrixhasyou/domovoy_bot.git | 2222 | `git` | SSH ключ | ⚠️ Требуется настройка |
| **Репозиторий** | http://localhost:3000/matrixhasyou/domovoy_bot | — | — | — | ✅ Создан |
| **Веб-интерфейс бота** | http://localhost:8000 | 8000 | `admin` | `ADMIN_USER_ID` | ✅ Работает |
| **Домовой Бот (код)** | `/home/matrixhasyou/domovoy_bot/` | — | — | — | ✅ Работает |

---

## 🗂️ Git Репозитории

### Основной репозиторий проекта в Gitea
```
URL:     http://localhost:3000/matrixhasyou/domovoy_bot
Remote:  origin
Branch:  main
Clone:   git clone http://localhost:3000/matrixhasyou/domovoy_bot.git
Теги:    15 версий (v1.0_mvp ... v1.14_events_calendar)
```

### Команды для работы с Git
```bash
# Клонирование
git clone http://localhost:3000/matrixhasyou/domovoy_bot.git

# Просмотр тегов
git tag -l

# Переход на версию
git checkout v1.14_events_calendar

# Создание новой версии
git tag -a v1.15_newfeature -m "Описание"
git push origin --tags
```

---

## 🏷️ Список версий (тегов)

| Тег | Версия | Дата | Описание |
|-----|--------|------|----------|
| `v1.0_mvp` | 1.0 MVP | 26.02.2026 | Базовый функционал |
| `v1.1_polls` | 1.1 | 26.02.2026 | Опросы и голосования |
| `v1.2_antispam` | 1.2 | 26.02.2026 | Чёрный список ссылок |
| `v1.3_rate_limits` | 1.3 | 26.02.2026 | Анти-спам лимиты |
| `v1.4_schedule` | 1.4 | 26.02.2026 | Расписание отключений |
| `v1.5_ads` | 1.5 | 26.02.2026 | Доска объявлений |
| `v1.6_payments` | 1.6 | 26.02.2026 | Напоминания о платежах |
| `v1.7_multicount` | 1.7 | 26.02.2026 | Детект мультиаккаунтов |
| `v1.8_topics` | 1.8 | 26.02.2026 | Облако тегов тем |
| `v1.9_toxicity` | 1.9 | 26.02.2026 | Рейтинг токсичности |
| `v1.10_profile_history` | 1.10 | 26.02.2026 | История версий профиля |
| `v1.11_web_interface` | 1.11 | 27.02.2026 | Веб-интерфейс админа |
| `v1.12_achievements` | 1.12 | 27.02.2026 | Достижения жильцов |
| `v1.13_thanks` | 1.13 | 27.02.2026 | Система благодарностей |
| `v1.14_events_calendar` | 1.14 | 27.02.2026 | Календарь событий дома |

---

## 🐘 Docker контейнеры

| Контейнер | Образ | Порт(ы) | Статус |
|-----------|-------|---------|--------|
| `gitea` | gitea/gitea:latest | 3000 (веб), 2222 (SSH) | ✅ Работает |

### Управление контейнерами
```bash
# Статус
docker ps | grep gitea

# Перезапуск
docker restart gitea

# Остановка
docker stop gitea

# Запуск
docker start gitea

# Логи
docker logs gitea
```

### Доступ к репозиторию
```bash
# Через веб-интерфейс
http://localhost:3000/matrixhasyou/domovoy_bot

# Clone
git clone http://localhost:3000/matrixhasyou/domovoy_bot.git

# Через SSH (требуется настройка SSH ключа)
git clone ssh://git@localhost:2222/matrixhasyou/domovoy_bot.git
```

---

## 📁 Структура проекта

```
/home/matrixhasyou/
├── domovoy_bot/              # Исходный код бота
│   ├── .git/                 # Git репозиторий
│   ├── backups/versions/     # Бекапы версий
│   ├── database/             # БД и миграции
│   ├── handlers/             # Хендлеры бота
│   ├── services/             # Сервисы
│   └── ...
│
├── gitea/                    # Данные Gitea
│   ├── data/                 # БД и репозитории Gitea
│   ├── config/               # Конфигурация Gitea
│   └── repos/                # Bare репозитории
│       └── domovoy_bot.git/
│
└── gitea-compose.yml         # Docker Compose для Gitea
```

---

## 🔑 Настройка Gitea

✅ **Gitea настроена!**

**Админ:** `matrixhasyou`
**Пароль:** `5nMVkjd5nMVkjd`

**Репозиторий создан:**
- URL: http://localhost:3000/matrixhasyou/domovoy_bot
- Ветка: main
- Тегов: 15 (все версии v1.x)

---

## 📝 Команды для работы

### Push новой версии
```bash
cd /home/matrixhasyou/domovoy_bot

# Внеси изменения
git add .
git commit -m "v1.15 - Описание изменений"

# Создай тег
git tag -a v1.15_description -m "Подробное описание релиза"

# Push
git push origin main
git push origin --tags
```

### Просмотр истории версий
```bash
cd /home/matrixhasyou/domovoy_bot
git log --oneline --decorate --all
```

### Переход на версию
```bash
cd /home/matrixhasyou/domovoy_bot
git checkout v1.10_profile_history
```

---

## 🌐 Доступ к Gitea из сети

Для доступа с других устройств:
```
URL: http://<твой-IP>:3000
Git HTTP: http://<твой-IP>:3000/matrixhasyou/domovoy_bot.git
Git SSH: ssh://git@<твой-IP>:2222/matrixhasyou/domovoy_bot.git

Логин: matrixhasyou
Пароль: 5nMVkjd5nMVkjd
```

**Для открытия доступа:**
1. Открой порты в фаерволе:
   ```bash
   sudo ufw allow 3000/tcp
   sudo ufw allow 2222/tcp
   ```

2. В конфиге Gitea (`gitea/config/app.ini`):
   ```ini
   [server]
   DOMAIN = твой-IP
   ROOT_URL = http://твой-IP:3000/
   ```

---

## 🎉 ИТОГ

✅ **Gitea установлена и работает**
✅ **Админ создан: matrixhasyou**
✅ **Репозиторий создан: domovoy_bot**
✅ **Проект загружен в Git**
✅ **Все 15 версий оформлены как теги**
✅ **Каждый тег имеет подробное описание**
✅ **Бекапы версий сохранены**

**ВСЁ ГОТОВО К РАБОТЕ!** 🚀

### 📋 Быстрый доступ:

1. **Gitea (веб):** http://localhost:3000
2. **Репозиторий:** http://localhost:3000/matrixhasyou/domovoy_bot
3. **Веб-интерфейс бота:** http://localhost:8000