akyldash/docs/operations/telegram-workspace-plan.md

# План реализации командной инфраструктуры Telegram + ИИ

## 1. Назначение проекта

Создать удобную рабочую среду для небольшой команды юристов и разработчиков, в которой:

- Telegram используется как место ежедневного общения, обсуждений, задач и уведомлений;
- ИИ помогает переводить обычные формулировки участников в документы, задачи и технические действия;
- Git/Gitea остаётся источником истины для документации проекта, MVP, планов, требований, архитектуры и принятых решений;
- бот собирает информацию из Telegram вручную, автоматически или по запросу и подготавливает её для последующего анализа через обычную подписку ChatGPT;
- результаты анализа возвращаются в Telegram в виде отчёта, проекта решения или уточняющих вопросов.

Проект не должен превращать Telegram в репозиторий или заменять Git. Telegram — рабочий штаб, Git — память и источник актуальных материалов, ИИ — помощник и переводчик между человеком и сложными инструментами.

---

## 2. Целевая модель работы

```text
Команда
   ↓
Telegram-супергруппа с темами
   ↓
Бот: уведомления, сбор материалов, экспорт, запросы на анализ
   ↓
ChatGPT через ручную загрузку подготовленных файлов
   ↓
Отчёт, проект решения или вопросы для уточнения
   ↓
Подтверждённый результат переносится в Git/Gitea
```

ИИ не принимает окончательные решения самостоятельно. Он выделяет позиции, аргументы, противоречия и варианты действий. Решение подтверждает команда, после чего оно фиксируется в Git или в соответствующей задаче.

---

## 3. Роли основных компонентов

### Telegram

- ежедневные обсуждения;
- оперативные вопросы;
- работа со спринтами и задачами;
- обсуждение требований и идей;
- подтверждение решений;
- получение уведомлений от бота;
- доступ к готовым сценариям работы с ИИ.

### Бот

- принимает сообщения и команды;
- учитывает темы, авторов, даты и ответы;
- сохраняет выбранные сообщения и вложения;
- экспортирует обсуждения в Markdown или другой удобный формат;
- формирует материалы для загрузки в ChatGPT;
- возвращает в группу отчёты и вопросы;
- отправляет уведомления о PR, задачах, дедлайнах и других событиях;
- по возможности помогает оформить решение или задачу.

### Git/Gitea

- документация проекта;
- описание MVP;
- пошаговые планы по направлениям;
- требования и пользовательские сценарии;
- архитектура и структура данных;
- принятые решения;
- история изменений;
- задачи, pull request и результаты разработки.

### ChatGPT

- анализирует экспортированные обсуждения;
- выделяет факты, мнения, аргументы и спорные вопросы;
- готовит краткие и подробные сводки;
- предлагает проект решения;
- выделяет задачи, риски и зависимости;
- помогает подготовить изменения в документации и проверить PR;
- работает с юридическими и проектными материалами в рамках обычной подписки.

---

## 4. Предлагаемая структура Telegram-группы

Количество тем на старте следует держать небольшим. Темы можно добавлять по мере появления устойчивой потребности.

### Общее

Организационные сообщения и вопросы, которые пока не относятся к другой теме.

### Задачи и спринты

Текущие задачи, сроки, блокеры, распределение ответственности и статус спринта.

### Обсуждение MVP

Идеи, требования, пользовательские сценарии и обсуждение границ первой версии продукта.

### Юридические вопросы

Рабочие обсуждения правовой модели, источников, классификации документов и судебной практики.

### Решения

Только проекты и подтверждённые решения команды. Подробный результат после утверждения переносится в Git.

### Работа с ИИ и командные сценарии

Живая библиотека готовых промптов и сценариев. Здесь не объясняются технологии ради технологий; здесь показывается, что написать ИИ для получения нужного результата.

### Уведомления бота

Автоматические сообщения о новых PR, изменениях статуса задач, дедлайнах, сборках и отчётах.

### Техническое обсуждение

Архитектура, реализация, инфраструктура и вопросы, которые в первую очередь нужны разработчикам.

---

## 5. FAQ как библиотека рабочих сценариев

FAQ должен отвечать не на вопрос «что такое Git», а на вопрос «что написать ИИ, чтобы выполнить нужную работу».

Каждая запись желательно оформляется по шаблону:

```text
Название сценария

Когда использовать:
...

Готовый промпт:
...

Что проверить в результате:
...

Связанные документы или сценарии:
...
```

### Минимальный набор сценариев

1. Обновить документацию проекта на основе нового решения.
2. Найти связанные документы и проверить противоречия.
3. Подготовить изменение в формате diff.
4. Сформировать задачу из обычного описания проблемы.
5. Подготовить техническое требование из юридического описания.
6. Проанализировать идею и определить, относится ли она к MVP.
7. Провести проверку pull request.
8. Исправить замечания по pull request после согласования плана.
9. Разобрать ошибку или непонятное поведение системы.
10. Проанализировать конфликт Git и предложить безопасный вариант объединения.
11. Сформировать проект решения команды по итогам обсуждения.
12. Проанализировать обсуждение Telegram.
13. Выделить из обсуждения задачи, сроки, риски и открытые вопросы.
14. Проанализировать юридический документ или сравнить две его редакции.

Правило для сценариев, которые меняют файлы или код: сначала анализ и план, затем подтверждение, затем изменение, после чего — diff и краткое объяснение результата.

---

## 6. Объём минимальной версии

### Telegram и бот

- создать и настроить бота;
- добавить его в супергруппу;
- определить права и список разрешённых тем;
- принимать сообщения из выбранных тем;
- сохранять текст, автора, дату, тему и связи ответов;
- сохранять доступные вложения;
- поддержать ручную пометку сообщений для экспорта;
- экспортировать обсуждение в Markdown;
- отправлять готовый файл или ссылку на него;
- предоставить базовые команды справки и состояния.

### Экспорт для ChatGPT

Экспорт должен быть понятен человеку и удобен для загрузки в ChatGPT. Рекомендуемая структура:

```markdown
# Обсуждение

Тема:
Период:
Участники:

## Сообщения по времени

Автор — дата и время:
Текст сообщения

## Контекст для анализа

Связанные ссылки, файлы и примечания
```

Дополнительно можно формировать готовый файл-запрос с задачей для ChatGPT: «выдели решения, открытые вопросы, задачи, риски и спорные позиции».

### Уведомления

На первом этапе достаточно уведомлений о:

- создании и обновлении pull request;
- запросе на проверку PR;
- объединении или закрытии PR;
- создании и закрытии задачи;
- приближении и наступлении дедлайна;
- сбое сборки или другой важной автоматической проверки.

Не следует включать все push и все комментарии без фильтрации: это создаст шум и снизит полезность группы.

### Git/Gitea

Подготовить базовую структуру документации, например:

```text
docs/
├── mvp/
├── roadmap/
├── requirements/
├── architecture/
├── decisions/
└── team/
    ├── ai-workflow.md
    ├── prompts-library.md
    └── team-rules.md
```

Содержимое этих файлов должно редактироваться и проходить обычную проверку через Git/Gitea.

---

## 7. Режимы сбора информации

### Ручной сбор

Участник явно отмечает сообщения, тему или диапазон для последующего экспорта. Это основной и самый безопасный режим на старте.

### Автоматический сбор

Бот сохраняет сообщения из заранее определённых рабочих тем. Для каждой темы можно задать срок хранения и правила исключения технического шума.

### Сбор по запросу

Команды или кнопки позволяют запросить:

- краткий итог текущего обсуждения;
- экспорт темы за период;
- список нерешённых вопросов;
- проект решения;
- список задач;
- подборку сообщений по ключевому слову.

---

## 8. Обмен с ChatGPT без API

На первом этапе не требуется подключать API языковой модели. Бот готовит структурированные файлы, а участник загружает их в ChatGPT вручную.

Рабочий цикл:

1. Бот собирает или получает выбранные сообщения.
2. Бот формирует Markdown-файл и задачу для анализа.
3. Участник загружает файл в ChatGPT Project.
4. ChatGPT подготавливает сводку, решение, вопросы или список задач.
5. Участник возвращает результат в Telegram.
6. Команда обсуждает и подтверждает результат.
7. Подтверждённые материалы переносятся в Git/Gitea.

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

---

## 9. Этапы реализации

Обозначения: `[x]` — выполнено, `[ ]` — ещё не выполнено.

### Этап 0. Границы и правила

- [x] утвердить назначение Telegram, Git, бота и ChatGPT;
- [x] выбрать темы, которые бот слушает;
- [x] определить, что можно собирать автоматически;
- [x] определить правила обработки персональных и конфиденциальных данных;
- [x] определить формат решений, задач и экспортов.

### Этап 1. Рабочая Telegram-группа

- [x] создать супергруппу и темы;
- [x] подготовить и закрепить приветствие с навигацией;
- [x] создать первоначальную библиотеку практик работы с ИИ;
- [x] согласовать правила обсуждений и фиксации решений.

### Этап 2. Бот-архиватор

- [x] реализовать приём сообщений;
- [x] сохранять сообщения и метаданные вложений;
- [ ] добавить ручную отметку отдельных сообщений для экспорта;
- [x] сформировать Markdown-экспорт;
- [x] проверить работу с темами и ответами.

### Этап 3. Уведомления

- [ ] подключить события Gitea;
- [ ] настроить фильтрацию;
- [ ] направлять уведомления в отдельную тему;
- [ ] добавить напоминания о задачах и сроках.

### Этап 4. ИИ-подготовка без API

- [ ] добавить шаблоны запросов для анализа;
- [x] создавать готовые файлы для загрузки в ChatGPT;
- [ ] добавить возврат отчёта в Telegram;
- [ ] проверить несколько реальных обсуждений.

### Этап 5. Связка с Git/Gitea

- [x] подготовить структуру документации;
- [ ] настроить ссылки на задачи, PR и документы;
- [x] определить процесс переноса подтверждённых решений в Git;
- [ ] добавить сценарии обновления документации через ИИ.

### Этап 6. Улучшение по фактическому использованию

- [ ] удалить невостребованные функции;
- [ ] расширить библиотеку практик реальными сценариями команды;
- [ ] улучшить формат отчётов;
- [ ] добавить новые уведомления только при наличии потребности;
- [ ] оценить необходимость API и автоматического ИИ-анализа.

---

## 10. Критерии готовности первой версии

Первая версия считается пригодной к работе, если:

- команда может общаться по темам без технических препятствий;
- участник может найти нужный рабочий сценарий для ИИ;
- бот сохраняет сообщения из согласованных тем;
- выбранное обсуждение экспортируется в читаемый Markdown;
- экспорт можно загрузить в ChatGPT и получить структурированный результат;
- отчёт можно вернуть в Telegram;
- уведомления о PR и задачах приходят в отдельную тему без лишнего шума;
- подтверждённые решения и изменения документации фиксируются в Git;
- участникам не нужно изучать внутреннюю реализацию бота.

---

## 11. Что сознательно не входит в первую версию

- автоматическое принятие решений ИИ;
- полноценный ИИ-чат с API;
- сложная векторная база и RAG;
- автоматическое изменение кода без подтверждения;
- попытка хранить всю базу проекта в Telegram;
- обязательное обучение юристов Git-командам;
- чрезмерное количество тем, команд и уведомлений;
- автоматическая обработка всех сообщений без правил приватности и фильтрации.

---

## 12. Возможности следующего этапа

После того как команда накопит опыт работы, можно добавить:

- автоматические ежедневные и недельные сводки;
- кнопку «проанализировать обсуждение»;
- интерактивное подтверждение проекта решения;
- автоматическое выделение задач и дедлайнов;
- поиск по архиву обсуждений;
- проверку согласованности документов проекта;
- автоматическую подготовку pull request для документации;
- интеграцию с API языковой модели;
- поиск по проектной документации и истории решений;
- аналитику нерешённых вопросов и повторяющихся проблем.

Переход к API имеет смысл только тогда, когда ручной процесс станет понятным и появится регулярная потребность в автоматических отчётах или поиске.

---

## 13. Главный принцип проекта

Команда должна формулировать рабочую задачу обычным языком. Telegram и готовые сценарии снижают порог входа, ИИ помогает перевести намерение в структурированный результат, а Git сохраняет утверждённую версию проекта.

```text
Человек формулирует намерение
        ↓
Telegram и ИИ помогают его оформить
        ↓
Команда проверяет и принимает результат
        ↓
Git сохраняет актуальную версию
```

Цель инфраструктуры — не заставить специалистов изучать больше технологий, а сделать технологии удобным продолжением их профессиональной работы.

---

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