82 lines
10 KiB
Markdown
82 lines
10 KiB
Markdown
# Решение 001: границы и правила первой версии Telegram-инфраструктуры
|
||
|
||
Статус: рабочий черновик, требует подтверждения команды
|
||
Дата: 2026-07-31
|
||
|
||
## Цель
|
||
|
||
Проверить рабочий цикл «обсуждение в Telegram → экспорт → ручной анализ в ChatGPT → подтверждение → фиксация в Git/Gitea» на небольшом и безопасном объёме.
|
||
|
||
Telegram не является хранилищем проекта, а бот и ChatGPT не принимают окончательных решений и не изменяют репозиторий без подтверждения команды.
|
||
|
||
## Что входит в MVP
|
||
|
||
- Telegram-супергруппа с темами `Общее` (стандартная тема), `MVP`, `Решения`, `Обсуждение`, `Работа с ИИ` и `Отчеты`.
|
||
- Тема `MVP` используется только для обсуждения границ первой версии. После фиксации MVP тема закрывается.
|
||
- Тема `Обсуждение` используется для рабочих гипотез и вопросов, которые ещё не стали подтверждёнными решениями.
|
||
- В теме `Решения` бот публикует итоговые сводки и подтверждённые решения после завершения обсуждения. Сообщения бота являются единственным редактируемым источником итогового текста; пользователи не редактируют сообщения бота.
|
||
- Тема `Работа с ИИ` закрытая: в ней публикуются только сообщения бота о корректных подходах, best practice, типичных ошибках и недопустимых формулировках при работе с ИИ. Отдельный FAQ будет подготовлен позднее как библиотека таких практик.
|
||
- Бот принимает сообщения только из явно разрешённых тем.
|
||
- Для сообщения сохраняются текст, автор, дата и время, тема, идентификатор сообщения и связь с ответом.
|
||
- Экспорт выполняется по ручной отметке участника или по явно заданному диапазону темы.
|
||
- Экспорт формируется в Markdown и включает контекст, сообщения по времени, ссылки и доступные вложения.
|
||
- Markdown публикуется в закрытой для сообщений участников теме `Отчеты`. В исходной теме бот оставляет заметную отсечку, прямую ссылку и общий с отчётом уникальный хэштег.
|
||
- Участник вручную загружает экспорт в ChatGPT и возвращает результат в Telegram.
|
||
- Gitea-уведомления на старте можно публиковать в `Общее` либо в отдельную тему после появления такой потребности. События ограничиваются PR, задачами, дедлайнами и сбоями важных проверок.
|
||
- Подтверждённые решения и изменения документации фиксируются в Git/Gitea обычным review-процессом.
|
||
|
||
## Что не входит в MVP
|
||
|
||
- API-интеграция с языковой моделью и автоматический ИИ-чат.
|
||
- Автоматическое принятие решений, изменение кода или создание PR без подтверждения.
|
||
- Сбор всех сообщений группы по умолчанию.
|
||
- Полнотекстовый поиск, RAG, векторная база и сложная аналитика.
|
||
- Уведомление о каждом push, комментарии или техническом событии.
|
||
|
||
## Правила данных и приватности
|
||
|
||
1. Автоматически собираются только сообщения из согласованных рабочих тем.
|
||
2. Ручной экспорт имеет приоритет над автоматическим сбором.
|
||
3. Вложения экспортируются только если бот имеет к ним доступ и их включение разрешено правилами темы.
|
||
4. Конфиденциальные, персональные и юридически чувствительные данные не отправляются во внешний сервис без отдельного разрешения команды.
|
||
5. Срок хранения сообщений, вложений и экспортов должен быть утверждён до включения автоматического режима.
|
||
6. Доступ к боту, архиву и уведомлениям получают только участники из согласованного списка.
|
||
|
||
## Утверждённые решения
|
||
|
||
- Используются темы `MVP`, `Решения`, `Обсуждение` и `Работа с ИИ`; тема `Общее` остаётся стандартной.
|
||
- `MVP` закрывается после фиксации состава первой версии.
|
||
- Итог обсуждения формирует бот и публикует в `Решения`.
|
||
- Файлы экспортов публикуются в теме `Отчеты`; исходные темы не засоряются файлами.
|
||
- `Работа с ИИ` предназначена только для публикаций бота и будет содержать best practice, а не обычный FAQ.
|
||
- Остальные параметры первой версии из этого документа считаются утверждёнными, если команда не изменит их отдельным решением.
|
||
|
||
## Граница между ботом и ИИ
|
||
|
||
- Бот без обращения к API языковой модели полностью выполняет сбор сообщений, сортировку, добавление метаданных, подготовку вложений и формирование Markdown-экспорта.
|
||
- На следующем этапе бот должен добавлять к экспорту готовую инструкцию для ручной загрузки в обычный ChatGPT.
|
||
- Выделение решений, задач, рисков, противоречий и открытых вопросов выполняется в ChatGPT вручную через подписку участника.
|
||
- На следующем этапе бот должен принимать возвращённый человеком отчёт, публиковать его в Telegram и связывать с исходным обсуждением.
|
||
- Бот не выдаёт эвристический или шаблонный результат за выполненный ИИ-анализ. Поиск ключевых слов и ручные метки допустимы только как вспомогательная навигация.
|
||
|
||
## Техническое замечание о правах тем
|
||
|
||
Telegram позволяет запретить пользователям отправку сообщений в закрытой теме, но не даёт отдельного режима «пользователи обсуждают, а затем только бот публикует» внутри одной и той же открытой темы. Поэтому завершение обсуждения в `Решения` должно оформляться закрытием темы или переключением прав группы. В любом случае пользователи не смогут редактировать сообщения, отправленные ботом.
|
||
|
||
## Инфраструктурные предпосылки
|
||
|
||
- Доступы для настройки находятся в локальном `credentials.json`; секреты из этого файла нельзя включать в Git, логи CI/CD, экспорт Telegram или сообщения бота.
|
||
- Для проекта можно создать открытый репозиторий в Gitea.
|
||
- В Gitea необходимо настроить защиту `main`: прямые push запрещены, изменения проходят через pull request и проверки CI/CD.
|
||
- Бот развёрнут в Container Manager на Synology с постоянным SQLite-томом и политикой автоперезапуска; конфигурацию развёртывания ещё предстоит зафиксировать в репозитории.
|
||
- PostgreSQL будет использоваться как хранилище бота; параметры доступа к базе будут предоставлены отдельно.
|
||
- Почта может использоваться как дополнительный канал доставки файлов и отчётов, но не как основное хранилище.
|
||
|
||
## Критерий завершения Stage 0
|
||
|
||
Критерий выполнен: границы MVP зафиксированы, темы созданы, первая версия бота и экспортов реализована. Полный рабочий цикл будет принят командой после проверки на реальном обсуждении.
|
||
|
||
---
|
||
|
||
Акылдаш · Telegram-бот v0.2.2 · Backend v0.7.1 · Frontend — не создан
|