docs: update wiki for 1.4.1 select contrast fix

2026-04-27 09:47:00 +03:00
parent 9a05dac051
commit e0f976d40e
6 changed files with 14 additions and 13 deletions
@@ -1,6 +1,6 @@
# База данных # База данных
GM-Relay **v1.4.0** использует PostgreSQL. Изменения схемы управляются DbUp-миграциями, встроенными в `GmRelay.Bot` как embedded resources. GM-Relay **v1.4.1** использует PostgreSQL. Изменения схемы управляются DbUp-миграциями, встроенными в `GmRelay.Bot` как embedded resources.
## Миграции ## Миграции
@@ -57,7 +57,7 @@ Telegram-группы, где организуются игры.
- `thread_id` — ID Telegram forum topic, если тема была создана. - `thread_id` — ID Telegram forum topic, если тема была создана.
- `batch_message_id` — ID исходного Telegram-сообщения с расписанием пачки. - `batch_message_id` — ID исходного Telegram-сообщения с расписанием пачки.
Bulk-операции Web в версии `1.4.0` не требуют новых таблиц: общий title/link обновляется по `batch_id`, перенос пересчитывает `scheduled_at` существующих строк, а clone создаёт новый `batch_id` и новые строки `sessions` без копирования `session_participants`. Bulk-операции Web не требуют новых таблиц: общий title/link обновляется по `batch_id`, перенос пересчитывает `scheduled_at` существующих строк, а clone создаёт новый `batch_id` и новые строки `sessions` без копирования `session_participants`.
Для активных статусов есть partial index `ix_sessions_pending` по `scheduled_at`. Для активных статусов есть partial index `ix_sessions_pending` по `scheduled_at`.
@@ -1,6 +1,6 @@
# Быстрый старт # Быстрый старт
Эта страница описывает минимальный запуск текущей версии GM-Relay **v1.4.0**. Эта страница описывает минимальный запуск текущей версии GM-Relay **v1.4.1**.
## Требования ## Требования
@@ -41,8 +41,8 @@ docker compose up -d
Compose поднимает: Compose поднимает:
- `db`: PostgreSQL 17 Alpine, БД `gmrelay_db`, пользователь `gmrelay`. - `db`: PostgreSQL 17 Alpine, БД `gmrelay_db`, пользователь `gmrelay`.
- `bot`: образ `git.codeanddice.ru/toutsu/gmrelay-bot:1.4.0`. - `bot`: образ `git.codeanddice.ru/toutsu/gmrelay-bot:1.4.1`.
- `web`: образ `git.codeanddice.ru/toutsu/gmrelay-web:1.4.0`. - `web`: образ `git.codeanddice.ru/toutsu/gmrelay-web:1.4.1`.
Web UI будет доступен на `http://localhost:8080`, если `GMRELAY_WEB_PORT` не переопределён. Web UI будет доступен на `http://localhost:8080`, если `GMRELAY_WEB_PORT` не переопределён.
@@ -1,6 +1,6 @@
# Развёртывание # Развёртывание
Текущий production-like способ запуска GM-Relay **v1.4.0** — Docker Compose из `compose.yaml`. Текущий production-like способ запуска GM-Relay **v1.4.1** — Docker Compose из `compose.yaml`.
## Сервисы Docker Compose ## Сервисы Docker Compose
@@ -15,13 +15,13 @@
`bot`: `bot`:
- образ: `git.codeanddice.ru/toutsu/gmrelay-bot:1.4.0`; - образ: `git.codeanddice.ru/toutsu/gmrelay-bot:1.4.1`;
- запускается после успешного healthcheck сервиса `db`; - запускается после успешного healthcheck сервиса `db`;
- переменные окружения: `ConnectionStrings__gmrelaydb`, `Telegram__BotToken`. - переменные окружения: `ConnectionStrings__gmrelaydb`, `Telegram__BotToken`.
`web`: `web`:
- образ: `git.codeanddice.ru/toutsu/gmrelay-web:1.4.0`; - образ: `git.codeanddice.ru/toutsu/gmrelay-web:1.4.1`;
- запускается после успешного healthcheck сервиса `db`; - запускается после успешного healthcheck сервиса `db`;
- переменные окружения: `ConnectionStrings__gmrelaydb`, `Telegram__BotToken`, `Telegram__BotUsername`; - переменные окружения: `ConnectionStrings__gmrelaydb`, `Telegram__BotToken`, `Telegram__BotUsername`;
- порт: `${GMRELAY_WEB_PORT:-8080}:8080`; - порт: `${GMRELAY_WEB_PORT:-8080}:8080`;
@@ -92,7 +92,7 @@ docker compose down -v
## Поведение миграций ## Поведение миграций
Бот применяет DbUp-миграции при старте до обработки Telegram updates. В версии `1.4.0` новых миграций нет: bulk-операции Web используют существующие поля `sessions.batch_id`, `sessions.batch_message_id`, `sessions.title`, `sessions.join_link` и `sessions.scheduled_at`. После обновления стоит проверить логи `bot`, чтобы убедиться, что миграции применились без ошибок. Бот применяет DbUp-миграции при старте до обработки Telegram updates. В версии `1.4.1` новых миграций нет: релиз содержит CSS-fix читаемости native select dropdown в Web Dashboard и использует существующую схему БД. После обновления стоит проверить логи `bot`, чтобы убедиться, что миграции применились без ошибок.
## Безопасность ## Безопасность
@@ -26,7 +26,7 @@ dotnet run --project src/GmRelay.AppHost
`Directory.Build.props` задаёт: `Directory.Build.props` задаёт:
- `Version`: `1.4.0`. - `Version`: `1.4.1`.
- `TargetFramework`: `net10.0`. - `TargetFramework`: `net10.0`.
- `LangVersion`: `preview`. - `LangVersion`: `preview`.
- `Nullable`: `enable`. - `Nullable`: `enable`.
@@ -1,6 +1,6 @@
# Руководство ГМа # Руководство ГМа
Руководство описывает пользовательские сценарии бота и Web-панели для GM-Relay **v1.4.0**. Руководство описывает пользовательские сценарии бота и Web-панели для GM-Relay **v1.4.1**.
## Кто считается ГМом ## Кто считается ГМом
+3 -2
@@ -1,10 +1,10 @@
# Главная # Главная
GM-Relay — Telegram-бот и Blazor-панель для организации TTRPG-сессий. Текущее состояние документации соответствует репозиторию `Toutsu/GmRelayBot` и релизу **v1.4.0**. GM-Relay — Telegram-бот и Blazor-панель для организации TTRPG-сессий. Текущее состояние документации соответствует репозиторию `Toutsu/GmRelayBot` и релизу **v1.4.1**.
## Текущий стек ## Текущий стек
- Версия проекта: `1.4.0`. - Версия проекта: `1.4.1`.
- Платформа: `.NET 10`, C# preview, nullable reference types, warnings as errors. - Платформа: `.NET 10`, C# preview, nullable reference types, warnings as errors.
- Оркестрация разработки: `.NET Aspire 13` через `src/GmRelay.AppHost`. - Оркестрация разработки: `.NET Aspire 13` через `src/GmRelay.AppHost`.
- Runtime бота: `Worker Service`, Telegram long polling, Native AOT. - Runtime бота: `Worker Service`, Telegram long polling, Native AOT.
@@ -30,6 +30,7 @@ GM-Relay — Telegram-бот и Blazor-панель для организаци
- Экспорт будущих запланированных сессий в `.ics` через `/exportcalendar`. - Экспорт будущих запланированных сессий в `.ics` через `/exportcalendar`.
- Web-панель для GM: список групп, список сессий, редактирование названия, времени, ссылки и лимита мест. - Web-панель для GM: список групп, список сессий, редактирование названия, времени, ссылки и лимита мест.
- Bulk-операции в Web Dashboard: общий `title/link` для batch, перенос всей пачки на фиксированный шаг и клонирование на следующую неделю или месяц с новым Telegram-сообщением. - Bulk-операции в Web Dashboard: общий `title/link` для batch, перенос всей пачки на фиксированный шаг и клонирование на следующую неделю или месяц с новым Telegram-сообщением.
- CSS-fix Web Dashboard: раскрывающиеся списки используют контрастный фон и текст в native select dropdown.
## Разделы ## Разделы