From 3474d68c570fbc4a8a88553d1f0e1ad773070fd6 Mon Sep 17 00:00:00 2001 From: DEV-bot Date: Mon, 2 Mar 2026 02:13:21 +0000 Subject: [PATCH] docs(issue-225): add backend i18n baseline artifact --- ...SSUE-225-BACKEND-I18N-BASELINE-ARTIFACT.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 docs/ISSUE-225-BACKEND-I18N-BASELINE-ARTIFACT.md diff --git a/docs/ISSUE-225-BACKEND-I18N-BASELINE-ARTIFACT.md b/docs/ISSUE-225-BACKEND-I18N-BASELINE-ARTIFACT.md new file mode 100644 index 0000000..39bbe31 --- /dev/null +++ b/docs/ISSUE-225-BACKEND-I18N-BASELINE-ARTIFACT.md @@ -0,0 +1,43 @@ +# ISSUE-225 Artifact — Backend i18n baseline (resolver + fallback) + +Issue: **#225** (`[MVP][READY] #175-A: Backend i18n baseline (resolver + fallback)`) + +## Scope verified + +- Backend locale resolver supports `da` + `en` and normalizes language tags. +- Unsupported locale requests fall back to default locale (`en`). +- Error payload contract is stable for API errors: + - `error_code` + - `error` + - `locale` + +## Implementation references + +- Locale resolution + fallback chain: + - `lobby/i18n.py` + - `resolve_locale()` + - `resolve_error_message()` + - `api_error()` +- Shared locale contract source: + - `shared/i18n/lobby.json` (`locales.default=en`, supported includes `en`, `da`) + +## Acceptance checks run + +Command: + +```bash +.venv/bin/python manage.py test \ + lobby.tests.I18nResolverTests \ + lobby.tests.LobbyFlowTests \ + lobby.tests.StartRoundTests +``` + +Result: + +- `Ran 28 tests ... OK` +- Confirms resolver behavior for locale normalization + fallback and stable error payload fields across flow endpoints. + +## Notes + +- Existing merged follow-ups in `main` include Accept-Language parsing fixes for q-values and locale tag normalization. +- This artifact documents the final baseline state and verification evidence for #225. -- 2.39.5