Files
akyldash/docs/PROJECT_STATUS.md
T

7.7 KiB
Executable File
Raw Blame History

Статус проекта

Последняя проверка: 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 → возврат отчёта.

Важные неизвестные

Для следующего этапа нужно получить или принять решения по следующим вопросам:

  1. Адрес и параметры PostgreSQL для разработки и Synology.
  2. Правила хранения и удаления сообщений и вложений.
  3. Нужен ли webhook после постоянного развёртывания; первая версия работает через long polling.

Следующий этап

Проверка постоянного запуска

Рекомендуемый порядок:

  1. Проверить /status и /export 1 из контейнера Synology.
  2. Перезапустить контейнер и убедиться, что сообщения не дублируются.
  3. Настроить резервное копирование /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.
  • Зафиксировано, что код бота и хранилище ещё не реализованы.