7.7 KiB
Executable File
7.7 KiB
Executable File
Статус проекта
Последняя проверка: 2026-08-02 Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов.
Версия приложения: 0.2.0
Краткий итог
Telegram-инфраструктура и первая версия бота-секретаря подготовлены. Бот сохраняет сообщения разрешённых тем в SQLite, переживает перезапуск и экспортирует обсуждения в Markdown.
Ближайшая цель — проверить экспорт из постоянно работающего контейнера и настроить резервное копирование SQLite.
Уже сделано
Telegram
- Создана супергруппа
Акылдаш. - Создан бот
help_clerk_bot. - Бот добавлен в супергруппу с необходимыми правами.
- Privacy Mode бота отключён.
- Созданы и проверены рабочие темы.
- Проверено подключение к Telegram Bot API.
- Webhook у бота не установлен; доступен режим long polling через
getUpdates.
ID тем
| Тема | message_thread_id |
Состояние |
|---|---|---|
| Общее | отсутствует | стандартная тема |
| MVP | 2 |
подтверждено тестовым сообщением |
| Решения | 4 |
подтверждено тестовым сообщением |
| Обсуждение | 6 |
подтверждено тестовым сообщением |
| Работа с ИИ | 8 |
подтверждено тестовым сообщением |
| Отчеты | 37 |
закрытая тема для Markdown-экспортов |
Документация и правила
- Подготовлен общий план реализации в
TEAM_AI_TELEGRAM_IMPLEMENTATION_PLAN.md. - Зафиксированы границы MVP и правила работы с данными в
docs/decisions/001-mvp-boundaries-and-rules.md. - В MVP не входит автоматический вызов API языковой модели.
- Анализ экспортов выполняется вручную в обычном ChatGPT.
- Telegram используется как рабочий штаб, Git/Gitea — как источник утверждённых материалов.
Доступы
- Локальные доступы находятся в
credentials.json. credentials.jsonдобавлен в.gitignore.- Секреты нельзя добавлять в Git, логи, экспорты или сообщения бота.
Репозиторий и приложение
- Реализован бот-секретарь версии
0.2.0без внешних Python-зависимостей. - Сообщения и полные Telegram-метаданные сохраняются в SQLite.
- Добавлены команды
/help,/status,/export [дней]и/export все. - Экспорт доступен только владельцу, указанному в
TELEGRAM_OWNER_ID. - Отчёты публикуются в закрытой теме
Отчеты(message_thread_id=37). - Исходное обсуждение завершается заметной отсечкой со ссылкой и хэштегом отчёта.
- Локальный Git-репозиторий восстановлен и привязан к Gitea.
Развёртывание
- Бот постоянно запущен на Synology в контейнере
akyldash-bot. - Используется официальный образ
python:3.11-slimи long polling. - Контейнер работает без root, с read-only root filesystem и политикой
unless-stopped. - Код, закрытый env-файл и SQLite хранятся в
/volume1/docker/akyldash.
Пока не сделано
- Не настроен CI/CD.
Хранилище
- PostgreSQL не подключён; первая версия использует SQLite.
- Не утверждена окончательная схема PostgreSQL.
- Не определены сроки хранения сообщений, вложений и экспортов.
Функции бота
- Скачивание файлов вложений; сейчас сохраняются их Telegram-метаданные.
- Ручная пометка отдельных сообщений для экспорта.
- Формирование готовой инструкции для ручной загрузки в ChatGPT.
- Возврат отчёта пользователя в Telegram.
Группа и рабочий процесс
- Не подготовлены закреплённые сообщения с правилами тем.
- Не проверены сценарии закрытия темы
MVPпосле фиксации состава первой версии. - Не настроены уведомления Gitea.
- Не проведён полный пользовательский тест: сообщение → сохранение → экспорт → анализ в ChatGPT → возврат отчёта.
Важные неизвестные
Для следующего этапа нужно получить или принять решения по следующим вопросам:
- Адрес и параметры PostgreSQL для разработки и Synology.
- Правила хранения и удаления сообщений и вложений.
- Нужен ли webhook после постоянного развёртывания; первая версия работает через long polling.
Следующий этап
Проверка постоянного запуска
Рекомендуемый порядок:
- Проверить
/statusи/export 1из контейнера Synology. - Перезапустить контейнер и убедиться, что сообщения не дублируются.
- Настроить резервное копирование
/volume1/docker/akyldash/data.
История изменений статуса
2026-08-02
- Экспорт ограничен Telegram ID владельца бота.
- Технические ответы на корневое сообщение темы исключены из Markdown.
- Экспорт перенесён в тему
Отчеты, добавлены отсечки и навигационные хэштеги. - Проверена живая публикация отчёта и отсечки через Telegram Bot API.
- Бот версии
0.2.0развёрнут в Container Manager на Synology. - Версия приложения обновлена до
0.2.0.
2026-08-01
- Восстановлена связь локального каталога с репозиторием Gitea.
- Реализован бот-секретарь версии
0.1.0с SQLite и Markdown-экспортом. - Проверены токен
help_clerk_botи доступ к супергруппеАкылдаш.
2026-07-31
- Создана супергруппа и добавлен бот.
- Отключён Privacy Mode.
- Определены ID тем:
2,4,6,8. - Подтверждено отсутствие webhook.
- Зафиксировано, что код бота и хранилище ещё не реализованы.