Toutsu/GmRelayBot
1
1
Fork 0
Code Issues 18 Pull Requests 1 Actions 1 Packages Projects Releases 85 Wiki Activity

epic: VK Bot MVP — полный цикл от подключения до продуктового сценария #64

New Issue
Open
opened 2026-05-13 20:57:05 +03:00 by Toutsu · 0 comments
Toutsu commented 2026-05-13 20:57:05 +03:00
Owner
Copy Link
Copy Source

Контекст

После завершения платформенной развязки (IPlatformMessenger, PlatformKind, PlatformUser) в версии 2.0–3.0 добавление VK-бота не требует архитектурных переделок. VK API предоставляет Bots Long Poll API, Callback-кнопки, inline-клавиатуры и работу в беседах — всё необходимое для реализации сценария GM-Relay.

Цель

Создать отдельный сервис GmRelay.VkBot (аналог GmRelay.Bot для Telegram и GmRelay.DiscordBot для Discord), который через Long Poll API получает события VK и рендерит сессии через callback-кнопки и карточки.

Задачи (эпик разбит на подзадачи ниже)

Этап 1 — Подготовка платформы

  • Добавить VK в PlatformKind
  • Миграция БД: поддержка vk_user_id в platform_identities и vk_message_id в platform_messages
  • Настройка GmRelay.VkBot как отдельного .NET-проекта

Этап 2 — Инфраструктура и Long Poll

  • Сервис VkBotLongPoll — подключение к Bots Long Poll API
  • Обработка событий: message_new, message_edit, message_reply
  • Callback-кнопки: мгновенное редактирование сообщений и клавиатур

Этап 3 — Рендеринг и команды

  • VkSessionBatchRenderer — карточки сессий с inline-клавиатурой (аналог Discord Embed)
  • Команды: /newsession, /listsessions, /session (аналоги Telegram-команд)
  • Поддержка бесед (групповых чатов) и упоминаний

Этап 4 — Продуктовый сценарий

  • Join/Leave с лимитами и waitlist
  • Перенос голосованием
  • RSVP и напоминания
  • Синхронизация с Web Dashboard

Этап 5 — Тестирование и деплой

  • Регрессионные тесты platform rendering
  • Docker Compose wiring
  • Документация по настройке VK-сообщества

Оценка трудозатрат

  • Оптимистичная: 3 недели (если platform-контракты идеально ложатся)
  • Реалистичная: 5-6 недель (типичные неожиданности с VK API, особенности форматирования)
  • Пессимистичная: 8 недель (серьёзные отличия в VK API от Telegram/Discord)

Приоритет

После завершения Discord MVP и стабилизации v2.0–v3.0. Не блокирует текущий roadmap, расширяет TAM на молодёжные и региональные НРИ-сообщества VK.

Ресурсы

  • milestone: Версия 4.0 — VK Bot MVP
## Контекст После завершения платформенной развязки (IPlatformMessenger, PlatformKind, PlatformUser) в версии 2.0–3.0 добавление VK-бота не требует архитектурных переделок. VK API предоставляет Bots Long Poll API, Callback-кнопки, inline-клавиатуры и работу в беседах — всё необходимое для реализации сценария GM-Relay. ## Цель Создать отдельный сервис `GmRelay.VkBot` (аналог `GmRelay.Bot` для Telegram и `GmRelay.DiscordBot` для Discord), который через Long Poll API получает события VK и рендерит сессии через callback-кнопки и карточки. ## Задачи (эпик разбит на подзадачи ниже) ### Этап 1 — Подготовка платформы - Добавить `VK` в `PlatformKind` - Миграция БД: поддержка `vk_user_id` в `platform_identities` и `vk_message_id` в `platform_messages` - Настройка `GmRelay.VkBot` как отдельного .NET-проекта ### Этап 2 — Инфраструктура и Long Poll - Сервис `VkBotLongPoll` — подключение к Bots Long Poll API - Обработка событий: `message_new`, `message_edit`, `message_reply` - Callback-кнопки: мгновенное редактирование сообщений и клавиатур ### Этап 3 — Рендеринг и команды - `VkSessionBatchRenderer` — карточки сессий с inline-клавиатурой (аналог Discord Embed) - Команды: `/newsession`, `/listsessions`, `/session` (аналоги Telegram-команд) - Поддержка бесед (групповых чатов) и упоминаний ### Этап 4 — Продуктовый сценарий - Join/Leave с лимитами и waitlist - Перенос голосованием - RSVP и напоминания - Синхронизация с Web Dashboard ### Этап 5 — Тестирование и деплой - Регрессионные тесты platform rendering - Docker Compose wiring - Документация по настройке VK-сообщества ## Оценка трудозатрат - **Оптимистичная**: 3 недели (если platform-контракты идеально ложатся) - **Реалистичная**: 5-6 недель (типичные неожиданности с VK API, особенности форматирования) - **Пессимистичная**: 8 недель (серьёзные отличия в VK API от Telegram/Discord) ## Приоритет После завершения Discord MVP и стабилизации v2.0–v3.0. Не блокирует текущий roadmap, расширяет TAM на молодёжные и региональные НРИ-сообщества VK. ## Ресурсы - [VK Bots Long Poll API](https://dev.vk.com/api/bots-long-poll) - [VK Callback Buttons](https://vk.com/wall-1_395166) - [VK Keyboard API](https://vk.com/faq15854) --- * milestone: Версия 4.0 — VK Bot MVP
Toutsu added this to the Версия 4.0 — VK Bot MVP milestone 2026-05-13 20:57:05 +03:00
Toutsu added the type:featureplatform:multi labels 2026-05-13 20:57:05 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:bot
Telegram bot and worker logic
 area:data
Database schema, migrations and persistence model
 area:discord
Discord bot service and Discord adapter
 area:infra
Infrastructure, runtime and deployment
 area:miniapp
Telegram Mini App dashboard
 area:platform
Platform-neutral abstractions and adapter boundaries
 area:shared
Shared domain and rendering contracts
 area:web
Blazor web dashboard
 in-progress
В работе (issue взят агентом)
 next-up
Recommended immediate backlog
 pending-approval
Ждёт согласования плана решения
 platform:discord
Discord-specific behavior or adapter work
 platform:multi
Cross-platform or platform-neutral work
 platform:telegram
Telegram-specific behavior or adapter work
 priority:p0
Critical priority
 priority:p0
Блокирующий приоритет: задача должна быть выполнена до признания решения production-ready
 priority:p1
High priority
 priority:p2
Medium priority
 priority:p3
Lower priority
 security
Security-sensitive work
 type:bug
Bug fix or corrective work
 type:chore
Maintenance and supporting work
 type:feature
New product functionality
 type:refactor
Structural change without direct feature growth
 type:test
Testing and coverage work
No Label platform:multi type:feature
Milestone
No items
No Milestone Версия 4.0 — VK Bot MVP
Projects
Clear projects
No project
Assignees
Clear assignees
Toutsu
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Toutsu/GmRelayBot#64
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?