🧭 Журнал решений (ADR)
Архитектурные решения по dicechess-play — по одному на заметку, чтобы дописывать по ходу и ссылаться wikilink-ом. Формат лёгкий: Контекст · Решение · Последствия · Альтернативы.
| ADR | Решение | Статус | Дата |
|---|---|---|---|
| ADR-0001-Repozitoriy-dicechess-play | Новый репозиторий — форк play-среза из lab | принято | 2026-06-22 |
| ADR-0002-Klientskiy-avtoritet-do-fazy-3 | Клиент до фазы 3, затем серверный JVM/WebSocket | принято | 2026-06-22 |
| ADR-0003-Identichnost-playsite | source=playsite, guest:<uuidv7>, bot:<algorithm>, UUIDv5 | принято | 2026-06-22 |
| ADR-0004-Frontend-SvelteKit-2-PWA | SvelteKit 2 + Svelte 5 + Tailwind 4 + adapter-static + PWA | принято | 2026-06-22 |
| ADR-0005-Shlyuz-ingesta-na-Koyeb | Токен-шлюз на Koyeb → sync.jc.id.lv | реализовано | 2026-06-23 |
| ADR-0006-Bronze-arkhiv-isklyuchyon | Для playsite raw bronze-архив не делаем | принято | 2026-06-22 |
| ADR-0007-Servernyy-avtoritet-i-realtime-faza-3 | play-api Scala/cats-effect, Lichess-форма, на aurora | предложено | 2026-06-26 |
| ADR-0008-Chestnost-kubikov-server-CSPRNG-commit-reveal | Сервер бросает (CSPRNG+commit-reveal за DiceSource), не блокчейн | предложено | 2026-06-26 |
| ADR-0009-Bot-API-i-turniry | Bot-API форма Lichess; 3a bot-aware; двойной круговой, single-host | предложено | 2026-06-26 |
| ADR-0010-Anonimnye-self-service-boty | Три тира бот-идентичности; bot:anon:<uuid> unranked-песочница, рейтинг — за регистрацией | предложено | 2026-06-28 |
| ADR-0011-Laddernye-dannye-v-play-BD | Ладдерные данные (seed/pairing/рейтинг) — в play-БД; ingest не расширяем; Glicko-2/SPRT — в play-api | принято | 2026-07-16 |
| ADR-0012-Granitsa-viki-i-publichnyy-sayt-dokov | Публичный EN-сайт доков play-api (Starlight/Pages, с D.2/F); вики = внутреннее, сайт = контракты | принято | 2026-07-16 |
| ADR-0013-Sinhronnyy-webhook-dlya-botov | Синхронный request-reply webhook: stateless-конверт, verify+HMAC+SSRF-guard, надёжность = клок | принято | 2026-07-17 |
| ADR-0014-Katalog-botov-igra-s-chelovekom | Каталог ботов + ленивое создание игры по клику (флаг open_to_humans, wake-handshake, play-bot); serverless-friendly, house-боты пока не мигрируем | предложено | 2026-07-23 |
Шаблон новой ADR
--- aliases: [ADR-NNNN] tags: [type/decision, domain/play] status: active date: YYYY-MM-DD --- # ADR-NNNN · Заголовок > Статус: принято · YYYY-MM-DD **Контекст.** … **Решение.** … **Последствия.** … **Альтернативы.** …