akyldash/docs/operations/project-status.md

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

Последняя проверка: 2026-08-03 Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов.

• Telegram-бот: 0.2.2
• Backend: не создан
• Frontend: не создан

Краткий итог

Репозиторий переориентирован с отдельного бота на весь проект юридической информационно-аналитической платформы. Telegram-бот выделен в инструмент рабочего окружения: он сохраняет сообщения разрешённых тем в SQLite, экспортирует обсуждения в Markdown и постоянно запущен в Container Manager на Synology.

Ближайшая цель — 2026-08-04 зафиксировать MVP с командой, настроить резервное копирование SQLite и затем проверить полный рабочий цикл на реальном обсуждении.

Уже сделано

Telegram

• Создана супергруппа Акылдаш.
• Создан бот help_clerk_bot.
• Бот добавлен в супергруппу с необходимыми правами.
• Privacy Mode бота отключён.
• Созданы и проверены рабочие темы.
• Проверено подключение к Telegram Bot API.
• Webhook у бота не установлен; доступен режим long polling через getUpdates.

ID тем

Тема	message_thread_id	Состояние
Общее	отсутствует	приветствие закреплено, тема закрыта
MVP	2	подтверждено тестовым сообщением
Решения	4	подтверждено тестовым сообщением
Обсуждение	6	подтверждено тестовым сообщением
Работа с ИИ	8	материалы опубликованы, тема закрыта
Отчеты	37	экспорт проверен, тема закрыта

Документация и правила

• Подготовлен общий план реализации в docs/operations/telegram-workspace-plan.md.
• Зафиксированы границы MVP и правила работы с данными в docs/decisions/001-telegram-workspace-mvp.md.
• Добавлены обзор всей платформы и единый индекс документации.
• В MVP не входит автоматический вызов API языковой модели.
• Анализ экспортов выполняется вручную в обычном ChatGPT.
• Telegram используется как рабочий штаб, Git/Gitea — как источник утверждённых материалов.
• Подготовлены и опубликованы краткие навыки работы с ИИ для начинающих.
• В Общее опубликовано и закреплено приветствие с назначением тем и описанием бота.

Доступы

• Локальные доступы находятся в credentials.json.
• credentials.json добавлен в .gitignore.
• Секреты нельзя добавлять в Git, логи, экспорты или сообщения бота.

Репозиторий и приложение

• Реализован бот-секретарь версии 0.2.2 без внешних Python-зависимостей.
• Код бота выделен из корня репозитория в tools/telegram-bot.
• Сообщения и полные Telegram-метаданные сохраняются в SQLite.
• Добавлены команды /help, /status и /export.
• Экспорт доступен только владельцу, указанному в TELEGRAM_OWNER_ID.
• Первый /export охватывает всю сохранённую тему, последующие начинаются после последней успешно созданной отсечки.
• Отчёты публикуются в закрытой теме Отчеты (message_thread_id=37).
• Исходное обсуждение завершается заметной отсечкой со ссылкой и хэштегом отчёта.
• Локальный Git-репозиторий восстановлен и привязан к Gitea.
• Репозиторий организован как основа всего проекта, а не отдельного бота.
• Бот развёрнут в Container Manager на Synology; автозапуск после перезапуска менеджера проверен.

Развёртывание

• Бот постоянно запущен на Synology в контейнере akyldash-bot.
• Используется официальный образ python:3.11-slim и long polling.
• Контейнер работает без root, с read-only root filesystem и политикой unless-stopped.
• Доступ к Telegram Bot API идёт через отдельный закрытый прокси-контейнер без опубликованных наружу портов.
• Код, закрытый env-файл и SQLite хранятся в /volume1/docker/akyldash.

Пока не сделано

Развёртывание и сопровождение

• Docker-конфигурация развёртывания не хранится в репозитории.
• Не настроен CI/CD.

Хранилище

• PostgreSQL не подключён; первая версия использует SQLite.
• Не утверждена окончательная схема PostgreSQL.
• Не определены сроки хранения сообщений, вложений и экспортов.

Функции бота

• Скачивание файлов вложений; сейчас сохраняются их Telegram-метаданные.
• Ручная пометка отдельных сообщений для экспорта.
• Формирование готовой инструкции для ручной загрузки в ChatGPT.
• Возврат отчёта пользователя в Telegram.

Группа и рабочий процесс

• Не проверены сценарии закрытия темы MVP после фиксации состава первой версии.
• Не настроены уведомления Gitea.
• Не проведён полный пользовательский тест: сообщение → сохранение → экспорт → анализ в ChatGPT → возврат отчёта.

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

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

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

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

Фиксация MVP и проверка полного цикла

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

1. Настроить резервное копирование /volume1/docker/akyldash/data.
2. Зафиксировать состав MVP с командой и закрыть тему MVP.
3. Провести одно реальное обсуждение с ответами, правками и вложением.
4. Экспортировать обсуждение и вручную проанализировать Markdown в ChatGPT.
5. Вернуть подтверждённый итог в тему Решения и зафиксировать его в Git/Gitea.
6. Записать обнаруженные неудобства и только после этого выбирать следующую доработку.

История изменений статуса

2026-08-03

• Репозиторий перестроен под весь проект юридической платформы; Telegram-бот перенесён в tools/telegram-bot.
• Созданы обзор продукта и структурированный индекс документации; будущие каталоги решено создавать по фактическим задачам.
• Закрытые юридические материалы решено хранить отдельно от основного репозитория.
• Версия Telegram-бота обновлена до 0.2.2 из-за изменения структуры запуска.
• Экспорт без параметров переведён с периода в семь дней на диапазон после предыдущей отсечки.
• Бот развёрнут в Container Manager на Synology; автозапуск проверен перезапуском.
• В теме Работа с ИИ опубликована первоначальная библиотека практик и отдельный материал о безопасной работе с Codex.
• В Общее опубликовано и закреплено приветствие; тема закрыта для сообщений.
• Локальный файл доступов переведён из credentials.txt в credentials.json.

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.
• Зафиксировано, что код бота и хранилище ещё не реализованы.

---

Акылдаш · Telegram-бот v0.2.2 · Backend — не создан · Frontend — не создан