docs: Добавлены доступы к инфраструктуре

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
Admin 2026-02-27 10:58:17 +00:00
parent ba4676b0af
commit 8363c82575

191
ДОСТУПЫ.md Normal file
View file

@ -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 версий оформлены как теги**
✅ **Каждый тег имеет подробное описание**
✅ **Бекапы версий сохранены**
**ВСЁ ГОТОВО К РАБОТЕ!** 🚀