Merge pull request 'docs: record Synology deployment' (#3) from feature/synology-deployment into main
Reviewed-on: agent/telegram-ai-infrastructure#3
This commit was merged in pull request #3.
This commit is contained in:
2
.gitignore
vendored
2
.gitignore
vendored
@@ -1,5 +1,5 @@
|
|||||||
# Local credentials and secrets
|
# Local credentials and secrets
|
||||||
credentials.txt
|
credentials.json
|
||||||
|
|
||||||
# Python/runtime artifacts (for the upcoming bot implementation)
|
# Python/runtime artifacts (for the upcoming bot implementation)
|
||||||
__pycache__/
|
__pycache__/
|
||||||
|
|||||||
@@ -33,6 +33,12 @@ Markdown публикуется в теме `TELEGRAM_REPORT_THREAD_ID`, а в
|
|||||||
python3 -m unittest -v
|
python3 -m unittest -v
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Synology
|
||||||
|
|
||||||
|
Контейнер `akyldash-bot` работает на образе `python:3.11-slim` с политикой
|
||||||
|
перезапуска `unless-stopped`. Постоянные данные находятся в
|
||||||
|
`/volume1/docker/akyldash/data`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Акылдаш v0.2.0
|
Акылдаш v0.2.0
|
||||||
|
|||||||
@@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
Telegram-инфраструктура и первая версия бота-секретаря подготовлены. Бот сохраняет сообщения разрешённых тем в SQLite, переживает перезапуск и экспортирует обсуждения в Markdown.
|
Telegram-инфраструктура и первая версия бота-секретаря подготовлены. Бот сохраняет сообщения разрешённых тем в SQLite, переживает перезапуск и экспортирует обсуждения в Markdown.
|
||||||
|
|
||||||
Ближайшая цель — проверить полный цикл на реальном обсуждении и подготовить постоянный запуск бота.
|
Ближайшая цель — проверить экспорт из постоянно работающего контейнера и настроить резервное копирование SQLite.
|
||||||
|
|
||||||
## Уже сделано
|
## Уже сделано
|
||||||
|
|
||||||
@@ -32,6 +32,7 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
| Решения | `4` | подтверждено тестовым сообщением |
|
| Решения | `4` | подтверждено тестовым сообщением |
|
||||||
| Обсуждение | `6` | подтверждено тестовым сообщением |
|
| Обсуждение | `6` | подтверждено тестовым сообщением |
|
||||||
| Работа с ИИ | `8` | подтверждено тестовым сообщением |
|
| Работа с ИИ | `8` | подтверждено тестовым сообщением |
|
||||||
|
| Отчеты | `37` | закрытая тема для Markdown-экспортов |
|
||||||
|
|
||||||
### Документация и правила
|
### Документация и правила
|
||||||
|
|
||||||
@@ -43,8 +44,8 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
|
|
||||||
### Доступы
|
### Доступы
|
||||||
|
|
||||||
- Локальные доступы находятся в `credentials.txt`.
|
- Локальные доступы находятся в `credentials.json`.
|
||||||
- `credentials.txt` добавлен в `.gitignore`.
|
- `credentials.json` добавлен в `.gitignore`.
|
||||||
- Секреты нельзя добавлять в Git, логи, экспорты или сообщения бота.
|
- Секреты нельзя добавлять в Git, логи, экспорты или сообщения бота.
|
||||||
|
|
||||||
### Репозиторий и приложение
|
### Репозиторий и приложение
|
||||||
@@ -57,11 +58,15 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
- Исходное обсуждение завершается заметной отсечкой со ссылкой и хэштегом отчёта.
|
- Исходное обсуждение завершается заметной отсечкой со ссылкой и хэштегом отчёта.
|
||||||
- Локальный Git-репозиторий восстановлен и привязан к Gitea.
|
- Локальный Git-репозиторий восстановлен и привязан к Gitea.
|
||||||
|
|
||||||
## Пока не сделано
|
|
||||||
|
|
||||||
### Развёртывание
|
### Развёртывание
|
||||||
|
|
||||||
- Не настроены Docker-файлы для Synology.
|
- Бот постоянно запущен на Synology в контейнере `akyldash-bot`.
|
||||||
|
- Используется официальный образ `python:3.11-slim` и long polling.
|
||||||
|
- Контейнер работает без root, с read-only root filesystem и политикой `unless-stopped`.
|
||||||
|
- Код, закрытый env-файл и SQLite хранятся в `/volume1/docker/akyldash`.
|
||||||
|
|
||||||
|
## Пока не сделано
|
||||||
|
|
||||||
- Не настроен CI/CD.
|
- Не настроен CI/CD.
|
||||||
|
|
||||||
### Хранилище
|
### Хранилище
|
||||||
@@ -86,7 +91,7 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
|
|
||||||
## Важные неизвестные
|
## Важные неизвестные
|
||||||
|
|
||||||
Перед реализацией постоянного развёртывания нужно получить или принять решения по следующим вопросам:
|
Для следующего этапа нужно получить или принять решения по следующим вопросам:
|
||||||
|
|
||||||
1. Адрес и параметры PostgreSQL для разработки и Synology.
|
1. Адрес и параметры PostgreSQL для разработки и Synology.
|
||||||
2. Правила хранения и удаления сообщений и вложений.
|
2. Правила хранения и удаления сообщений и вложений.
|
||||||
@@ -94,15 +99,13 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
|
|
||||||
## Следующий этап
|
## Следующий этап
|
||||||
|
|
||||||
### Проверка бота-секретаря
|
### Проверка постоянного запуска
|
||||||
|
|
||||||
Рекомендуемый порядок:
|
Рекомендуемый порядок:
|
||||||
|
|
||||||
1. Запустить бота с рабочими переменными окружения.
|
1. Проверить `/status` и `/export 1` из контейнера Synology.
|
||||||
2. Отправить в разрешённую тему текст, ответ, правку сообщения и вложение.
|
2. Перезапустить контейнер и убедиться, что сообщения не дублируются.
|
||||||
3. Проверить `/status`, `/export 1` и `/export все`.
|
3. Настроить резервное копирование `/volume1/docker/akyldash/data`.
|
||||||
4. Перезапустить процесс и убедиться, что сообщения не дублируются.
|
|
||||||
5. После проверки подготовить постоянный запуск на Synology.
|
|
||||||
|
|
||||||
## История изменений статуса
|
## История изменений статуса
|
||||||
|
|
||||||
@@ -112,6 +115,7 @@ Telegram-инфраструктура и первая версия бота-се
|
|||||||
- Технические ответы на корневое сообщение темы исключены из Markdown.
|
- Технические ответы на корневое сообщение темы исключены из Markdown.
|
||||||
- Экспорт перенесён в тему `Отчеты`, добавлены отсечки и навигационные хэштеги.
|
- Экспорт перенесён в тему `Отчеты`, добавлены отсечки и навигационные хэштеги.
|
||||||
- Проверена живая публикация отчёта и отсечки через Telegram Bot API.
|
- Проверена живая публикация отчёта и отсечки через Telegram Bot API.
|
||||||
|
- Бот версии `0.2.0` развёрнут в Container Manager на Synology.
|
||||||
- Версия приложения обновлена до `0.2.0`.
|
- Версия приложения обновлена до `0.2.0`.
|
||||||
|
|
||||||
### 2026-08-01
|
### 2026-08-01
|
||||||
|
|||||||
@@ -65,10 +65,10 @@ Telegram позволяет запретить пользователям отп
|
|||||||
|
|
||||||
## Инфраструктурные предпосылки
|
## Инфраструктурные предпосылки
|
||||||
|
|
||||||
- Доступы для настройки находятся в `credentials.txt`; секреты из этого файла нельзя включать в Git, логи CI/CD, экспорт Telegram или сообщения бота.
|
- Доступы для настройки находятся в `credentials.json`; секреты из этого файла нельзя включать в Git, логи CI/CD, экспорт Telegram или сообщения бота.
|
||||||
- Для проекта можно создать открытый репозиторий в Gitea.
|
- Для проекта можно создать открытый репозиторий в Gitea.
|
||||||
- В Gitea необходимо настроить защиту `main`: прямые push запрещены, изменения проходят через pull request и проверки CI/CD.
|
- В Gitea необходимо настроить защиту `main`: прямые push запрещены, изменения проходят через pull request и проверки CI/CD.
|
||||||
- Развёртывание бота планируется на Docker-инфраструктуре Synology.
|
- Бот развёрнут в Container Manager на Synology с постоянным SQLite-томом и политикой автоперезапуска.
|
||||||
- PostgreSQL будет использоваться как хранилище бота; параметры доступа к базе будут предоставлены отдельно.
|
- PostgreSQL будет использоваться как хранилище бота; параметры доступа к базе будут предоставлены отдельно.
|
||||||
- Почта может использоваться как дополнительный канал доставки файлов и отчётов, но не как основное хранилище.
|
- Почта может использоваться как дополнительный канал доставки файлов и отчётов, но не как основное хранилище.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user