TableTime — документация платформы
Добро пожаловать в проектную документацию платформы TableTime — микросервисной системы для игр из шоу «Тейбл Тайм» с одновременным участием через веб-сайт и Telegram-бот.
Disclaimer
Неофициальный фан-проект. Не аффилирован с правообладателями шоу «Тейбл Тайм».
Быстрые ссылки
| Раздел | Описание |
|---|---|
| Видение и scope | Цели, границы, допущения |
| Функциональные требования | FR-001…FR-050 |
| Архитектура | C4, микросервисы, API |
| Диаграммы | 17 диаграмм (C4, UML, ERD, DFD) |
| Каталог игр | 46 плагинов — спеки и acceptance-тесты |
| dice_board | Референсная игра 6×6 |
| Roadmap | Фазы реализации |
Ключевые решения
- Авторизация: гибрид — гости по коду + зарегистрированные пользователи с историей
- Сессии: переиспользуемые комнаты, смена игры без нового кода
- Клиенты: веб (Next.js) + Telegram (aiogram 3.x) в одной сессии
- Backend: FastAPI, микросервисы (или modular monolith на Phase 1)
Локальный просмотр
Сайт: http://127.0.0.1:8000
Диаграммы Mermaid
Запускайте через python -m mkdocs serve, не открывайте HTML из site/ напрямую.
После изменений в mkdocs.yml пересоберите: python -m mkdocs build.
Структура документации
00-vision/ Видение, персоны, глоссарий
01-requirements/ Требования (FR, NFR, formal)
02-architecture/ Архитектура, API, plugin SDK
03-diagrams/ Диаграммы
04-domain/ Доменная модель, FSM
05-games/ Игры (каталог 46 плагинов, семейства)
06-clients/ Веб и Telegram
07-security/ STRIDE, auth
08-operations/ Деплой, observability
09-roadmap/ Фазы реализации