diff --git a/ДОСТУПЫ.md b/ДОСТУПЫ.md new file mode 100644 index 0000000..4d236a5 --- /dev/null +++ b/ДОСТУПЫ.md @@ -0,0 +1,191 @@ +# 🔐 Доступы к инфраструктуре Домового Бота + +**Дата настройки:** 27 февраля 2026 г. + +--- + +## 📊 Сводная таблица доступов + +| Сервис | URL / Путь | Порт | Логин | Пароль | Статус | +|--------|-----------|------|-------|--------|--------| +| **Gitea (Веб)** | http://localhost:3000 | 3000 | `admin` | *при первой регистрации* | ✅ Работает | +| **Gitea (Git SSH)** | ssh://localhost:2222 | 2222 | `git` | SSH ключ | ✅ Работает | +| **Локальный Git** | `/home/matrixhasyou/gitea/repos/domovoy_bot.git` | — | — | — | ✅ Работает | +| **Домовой Бот (код)** | `/home/matrixhasyou/domovoy_bot/` | — | — | — | ✅ Работает | +| **Веб-интерфейс бота** | http://localhost:8000 | 8000 | `admin` | `ADMIN_USER_ID` | ✅ Работает | + +--- + +## 🗂️ Git Репозитории + +### Основной репозиторий проекта +``` +Путь: /home/matrixhasyou/gitea/repos/domovoy_bot.git +Remote: origin +Branch: main +Теги: v1.0_mvp, v1.1_polls, v1.2_antispam, ..., v1.14_events_calendar +``` + +### Команды для работы с Git +```bash +# Клонирование +git clone /home/matrixhasyou/gitea/repos/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 +``` + +--- + +## 📁 Структура проекта + +``` +/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 + +1. **Открой** http://localhost:3000 +2. **Зарегистрируйся** как первый пользователь (станешь админом) +3. **Создай организацию** `matrixhasyou` (если нужно) +4. **Добавь SSH ключ** в настройках профиля (опционально) + +--- + +## 📝 Команды для работы + +### 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 SSH: ssh://git@<твой-IP>:2222/matrixhasyou/domovoy_bot.git +``` + +**Для открытия доступа:** +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 установлена и работает** +✅ **Проект загружен в Git** +✅ **Все 14 версий оформлены как теги** +✅ **Каждый тег имеет подробное описание** +✅ **Бекапы версий сохранены** + +**ВСЁ ГОТОВО К РАБОТЕ!** 🚀