diff --git a/docs/PROJECT_STATUS.md b/docs/PROJECT_STATUS.md new file mode 100755 index 0000000..29ebead --- /dev/null +++ b/docs/PROJECT_STATUS.md @@ -0,0 +1,118 @@ +# Статус проекта + +Последняя проверка: 2026-07-31 +Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов. + +## Краткий итог + +Telegram-инфраструктура подготовлена для начала разработки бота. Супергруппа и бот существуют, бот добавлен в группу, Privacy Mode отключён, темы созданы и проверены через Telegram Bot API. Исходный код бота пока не создан. + +Ближайшая цель — реализовать минимальный архиватор сообщений с сохранением метаданных и Markdown-экспортом обсуждений. + +## Уже сделано + +### Telegram + +- Создана супергруппа `Акылдаш`. +- Создан бот `help_clerk_bot`. +- Бот добавлен в супергруппу с необходимыми правами. +- Privacy Mode бота отключён. +- Созданы и проверены рабочие темы. +- Проверено подключение к Telegram Bot API. +- Webhook у бота не установлен; доступен режим long polling через `getUpdates`. + +### ID тем + +| Тема | `message_thread_id` | Состояние | +|---|---:|---| +| Общее | отсутствует | стандартная тема | +| MVP | `2` | подтверждено тестовым сообщением | +| Решения | `4` | подтверждено тестовым сообщением | +| Обсуждение | `6` | подтверждено тестовым сообщением | +| Работа с ИИ | `8` | подтверждено тестовым сообщением | + +### Документация и правила + +- Подготовлен общий план реализации в `TEAM_AI_TELEGRAM_IMPLEMENTATION_PLAN.md`. +- Зафиксированы границы MVP и правила работы с данными в `docs/decisions/001-mvp-boundaries-and-rules.md`. +- В MVP не входит автоматический вызов API языковой модели. +- Анализ экспортов выполняется вручную в обычном ChatGPT. +- Telegram используется как рабочий штаб, Git/Gitea — как источник утверждённых материалов. + +### Доступы + +- Локальные доступы находятся в `credentials.txt`. +- `credentials.txt` добавлен в `.gitignore`. +- Секреты нельзя добавлять в Git, логи, экспорты или сообщения бота. + +## Пока не сделано + +### Репозиторий и приложение + +- Не создан исходный код бота. +- Не определена и не зафиксирована структура Python-проекта. +- Локальный каталог `.git` пуст; локальный Git-репозиторий ещё нужно корректно инициализировать или привязать к удалённому репозиторию Gitea. +- Не настроены Docker-файлы для Synology. +- Не настроен CI/CD. + +### Хранилище + +- Не подключена база данных. +- Не утверждена окончательная схема PostgreSQL. +- Не определены сроки хранения сообщений, вложений и экспортов. +- Не определён согласованный список пользователей с доступом к архиву. + +### Функции бота + +- Приём и сохранение сообщений. +- Сохранение автора, даты, темы, ID сообщения и reply-связи. +- Сохранение доступных вложений. +- Ручная пометка сообщений для экспорта. +- Экспорт темы или диапазона в Markdown. +- Формирование готовой инструкции для ручной загрузки в ChatGPT. +- Возврат отчёта пользователя в Telegram. +- Команды `/help`, `/status` и команда экспорта. + +### Группа и рабочий процесс + +- Не подготовлены закреплённые сообщения с правилами тем. +- Не проверены сценарии закрытия темы `MVP` после фиксации состава первой версии. +- Не настроены уведомления Gitea. +- Не проведён полный пользовательский тест: сообщение → сохранение → экспорт → анализ в ChatGPT → возврат отчёта. + +## Важные неизвестные + +Перед реализацией постоянного развёртывания нужно получить или принять решения по следующим вопросам: + +1. Адрес и параметры PostgreSQL для разработки и Synology. +2. Имя и URL удалённого репозитория Gitea. +3. Список пользователей Telegram, которым разрешён экспорт и работа с архивом. +4. Правила хранения и удаления сообщений и вложений. +5. Способ запуска бота: long polling на старте или webhook после развёртывания. +6. Нужен ли SQLite для локальной разработки как временное хранилище до подключения PostgreSQL. + +## Следующий этап + +### Stage 2 — бот-архиватор + +Рекомендуемый порядок: + +1. Создать каркас Python-приложения и конфигурацию через переменные окружения. +2. Добавить фильтр группы `-1004242041275` и разрешённых тем `2`, `4`, `6`, `8`. +3. Реализовать приём сообщений и сохранение метаданных. +4. Добавить минимальную схему хранилища. +5. Реализовать ручную отметку сообщений. +6. Реализовать Markdown-экспорт с контекстом, авторами, датами, reply-связями и вложениями. +7. Добавить команды справки и состояния. +8. Проверить работу на реальном обсуждении и зафиксировать результат в этом документе. + +## История изменений статуса + +### 2026-07-31 + +- Создана супергруппа и добавлен бот. +- Отключён Privacy Mode. +- Определены ID тем: `2`, `4`, `6`, `8`. +- Подтверждено отсутствие webhook. +- Зафиксировано, что код бота и хранилище ещё не реализованы. +