Merge pull request 'docs: record project status and Telegram setup' (#1) from codex/project-status-20260731 into main

Reviewed-on: agent/telegram-ai-infrastructure#1

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