domovoy_bot/ДОСТУПЫ.md
Admin 8363c82575 docs: Добавлены доступы к инфраструктуре
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
2026-02-27 10:58:17 +00:00

191 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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