Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -1,190 +0,0 @@
# i18n Audit — Baseline 2026-05-25
> Generated by `scripts/i18n-audit.mjs`. Counts hardcoded user-facing
> strings in `apps/web/app/{routes,modules,routeModules,components}/**/*.{ts,tsx}`.
> Baseline only — not yet
> enforced. See `docs/contributing/i18n.md` for the migration playbook.
>
> Historical baseline note: this file is a point-in-time audit artifact from
> 2026-05-25. Re-run the audit script before using counts as current status.
>
> Current re-run note: `node scripts/i18n-audit.mjs --json` on 2026-05-29
> reports `0` hardcoded strings and `0` locale-formatting signals.
## Current Re-Run Snapshot
| Metric | Value |
| ---------------------------------------------- | ----: |
| Files scanned | 1774 |
| Files with hardcoded strings | 0 |
| Total hardcoded JSX text fragments | 0 |
| Files with locale-sensitive formatting signals | 0 |
| Total locale-sensitive formatting signals | 0 |
## Historical Baseline Summary
| Metric | Value |
| ---------------------------------------------- | ----: |
| Files scanned | 1752 |
| Files with hardcoded strings | 4 |
| Total hardcoded JSX text fragments | 26 |
| Files with locale-sensitive formatting signals | 91 |
| Total locale-sensitive formatting signals | 213 |
## Historical Top Offenders
| File | Hits |
| ----------------------------------------------------------------------- | ---: |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts` | 22 |
| `apps/web/app/routes/__test.client-throw.tsx` | 2 |
| `apps/web/app/components/ai-elements/open-in-chat.tsx` | 1 |
| `apps/web/app/modules/workflowEngine/utils/DefaultWorkflowTemplates.ts` | 1 |
## Historical Disposition
The 26 hardcoded text fragments from the 2026-05-25 baseline are no longer
reported by the current audit. The historical dispositions below explain why
they were not treated as active product UI debt at the time:
| File | Disposition |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts` | Seed/template article content. Migrate only if knowledge-base templates gain locale variants. |
| `apps/web/app/routes/__test.client-throw.tsx` | Test-only Sentry smoke route. Keep diagnostic copy literal. |
| `apps/web/app/components/ai-elements/open-in-chat.tsx` | Provider/brand name (`Scira AI`). Proper noun, do not translate. |
| `apps/web/app/modules/workflowEngine/utils/DefaultWorkflowTemplates.ts` | English-scoped default workflow payload. Migrate only if workflow templates gain locale variants. |
## Detail (first 100 hits)
| File:Line | Hardcoded text |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `apps/web/app/components/ai-elements/open-in-chat.tsx:45` | Scira AI |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:120` | Watch the demo video: |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:122` | Watch the demo video: |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:142` | Static Knowledge Base |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:142` | And the knowledge base |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:142` | Dynamic Knowledge Bases |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:142` | For all other knowledge bases, the |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:142` | You can change the hard-coded |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:144` | Static Knowledge Base |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:144` | And the knowledge base |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:144` | Dynamic Knowledge Bases |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:144` | For all other knowledge bases, the |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:144` | You can change the hard-coded |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:163` | Beispiel 2 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:164` | Beispiel 2 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:182` | Sample 2 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:183` | Sample 2 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:227` | Beispiel 1 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:228` | Beispiel 1 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:246` | Beispiel 3 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:247` | Beispiel 3 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:265` | Sample 3 |
| `apps/web/app/modules/knowledgeBase/utils/DefaultKbsTemplate.ts:266` | Sample 3 |
| `apps/web/app/modules/workflowEngine/utils/DefaultWorkflowTemplates.ts:760` | It works! |
| `apps/web/app/routes/__test.client-throw.tsx:33` | Sentry client smoke test |
| `apps/web/app/routes/__test.client-throw.tsx:34` | Triggering a synchronous client-side error. The root ErrorBoundary should pick it up and report to Sentry. |
## Formatting migration signals (first 100 hits)
| File:Line | Signal |
| ----------------------------------------------------------------------------------------------- | ---------------------------- |
| `apps/web/app/components/aceternity/infinite-moving-cards.tsx:214` | `DateUtils.dateYMDHMSMS` |
| `apps/web/app/components/aceternity/infinite-moving-cards.tsx:215` | `DateUtils.dateAgo` |
| `apps/web/app/components/analytics/AnalyticsOverview.tsx:25` | `NumberUtils.intFormat` |
| `apps/web/app/components/analytics/AnalyticsOverview.tsx:32` | `NumberUtils.intFormat` |
| `apps/web/app/components/analytics/AnalyticsOverview.tsx:64` | `NumberUtils.intFormat` |
| `apps/web/app/components/analytics/AnalyticsOverview.tsx:132` | `NumberUtils.intFormat` |
| `apps/web/app/components/analytics/AnalyticsOverviewChart.tsx:8` | `NumberUtils.intFormat` |
| `apps/web/app/components/app/events/LogsTable.tsx:92` | `DateUtils.dateAgo` |
| `apps/web/app/components/app/events/LogsTable.tsx:95` | `DateUtils.dateYMD` |
| `apps/web/app/components/app/events/LogsTable.tsx:96` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/apiKeys/ApiKeyLogsTable.tsx:30` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/apiKeys/ApiKeyLogsTable.tsx:31` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/apiKeys/ApiKeysTable.tsx:162` | `NumberUtils.intFormat` |
| `apps/web/app/components/core/apiKeys/ApiKeysTable.tsx:188` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/apiKeys/ApiKeysTable.tsx:192` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/apiKeys/ApiKeysTable.tsx:197` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/apiKeys/ApiKeysTable.tsx:198` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/pricing/UsageBasedPricesUnit.tsx:109` | `NumberUtils.numberFormat` |
| `apps/web/app/components/core/settings/members/MembersListAndTable.tsx:48` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/settings/members/MembersListAndTable.tsx:49` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/settings/subscription/ChangeSubscription.tsx:51` | `NumberUtils.intFormat` |
| `apps/web/app/components/core/settings/subscription/MyInvoices.tsx:28` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyInvoices.tsx:31` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyInvoices.tsx:32` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:31` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:32` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:42` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:60` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:63` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyPayments.tsx:64` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/settings/subscription/MyPlanFeatureUsage.tsx:38` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/settings/subscription/MyUpcomingInvoice.tsx:30` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/settings/subscription/Plan.tsx:138` | `NumberUtils.numberFormat` |
| `apps/web/app/components/core/settings/subscription/PlanFeatureDescription.tsx:86` | `NumberUtils.intFormat` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:43` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:76` | `DateUtils.dateYMDHMSMS` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:77` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:78` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:85` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/settings/subscription/TenantProduct.tsx:89` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:104` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:115` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:119` | `DateUtils.dateMonthDayYear` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:176` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:214` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:215` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:244` | `DateUtils.dateYMD` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:246` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/core/tenants/TenantsTable.tsx:251` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/users/UsersTable.tsx:118` | `DateUtils.dateDM` |
| `apps/web/app/components/core/users/UsersTable.tsx:120` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/core/users/UsersTable.tsx:121` | `DateUtils.dateAgo` |
| `apps/web/app/components/core/users/UsersTable.tsx:224` | `DateUtils.dateAgo` |
| `apps/web/app/components/entities/properties/FormulaControl.tsx:39` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/entities/relationships/EntityRelationshipsTable.tsx:63` | `NumberUtils.intFormat` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:8` | `DateUtils.dateYMD` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:12` | `DateUtils.dateYMD` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:14` | `DateUtils.dateDMY` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:16` | `DateUtils.dateMDY` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:18` | `DateUtils.dateAgo` |
| `apps/web/app/components/entities/rows/cells/RowDateCell.tsx:20` | `DateUtils.dateYMD` |
| `apps/web/app/components/entities/rows/cells/RowFolioCell.tsx:6` | `NumberUtils.pad` |
| `apps/web/app/components/entities/rows/cells/RowNumberCell.tsx:11` | `NumberUtils.intFormat` |
| `apps/web/app/components/entities/rows/cells/RowNumberCell.tsx:13` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/entities/rows/cells/RowNumberCell.tsx:15` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/entities/rows/cells/RowNumberCell.tsx:15` | `NumberUtils.currencyFormat` |
| `apps/web/app/components/entities/rows/cells/RowNumberCell.tsx:17` | `NumberUtils.percentFormat` |
| `apps/web/app/components/entities/rows/RowActivity.tsx:132` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/entities/rows/RowActivity.tsx:132` | `DateUtils.dateAgo` |
| `apps/web/app/components/entities/rows/RowLogComment.tsx:88` | `DateUtils.dateAgo` |
| `apps/web/app/components/entities/rows/RowLogComment.tsx:89` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/entities/rows/RowLogComment.tsx:89` | `DateUtils.dateAgo` |
| `apps/web/app/components/entities/rows/RowLogs.tsx:24` | `DateUtils.dateDM` |
| `apps/web/app/components/entities/rows/RowLogs.tsx:79` | `DateUtils.dateYMDHMS` |
| `apps/web/app/components/entities/rows/RowLogs.tsx:80` | `DateUtils.dateHMS` |
| `apps/web/app/components/entities/views/EntityViewsTable.tsx:188` | `NumberUtils.intFormat` |
| `apps/web/app/components/ui/input/InputDate.tsx:172` | `DateUtils.dateYMD` |
| `apps/web/app/components/ui/multi-select.tsx:312` | `NumberUtils.intFormat` |
| `apps/web/app/components/ui/tables/PreviewTableSimple.tsx:45` | `NumberUtils.decimalFormat` |
| `apps/web/app/components/ui/tables/PreviewTableSimple.tsx:52` | `DateUtils.dateYMD` |
| `apps/web/app/modules/api/components/ApiKeyLogsDetails.tsx:96` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/api/components/ApiKeyLogsDetails.tsx:98` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/api/components/ApiKeyLogsDetails.tsx:166` | `NumberUtils.custom` |
| `apps/web/app/modules/api/components/ApiKeyLogsSummary.tsx:123` | `NumberUtils.intFormat` |
| `apps/web/app/modules/api/components/ApiKeyLogsSummary.tsx:136` | `NumberUtils.custom` |
| `apps/web/app/modules/chatbot/components/chat-list.tsx:52` | `DateUtils.dateAgo` |
| `apps/web/app/modules/codeGenerator/service/CodeGeneratorService.ts:243` | `DateUtils.dateYMD` |
| `apps/web/app/modules/codeGenerator/templates/routes/api/CodeTemplate.Routes.Edit.Api.ts:59` | `NumberUtils.pad` |
| `apps/web/app/modules/codeGenerator/templates/routes/views/CodeTemplate.Routes.Edit.View.ts:69` | `NumberUtils.pad` |
| `apps/web/app/modules/emailMarketing/components/EmailMarketingSummaryRoute.tsx:21` | `NumberUtils.decimalFormat` |
| `apps/web/app/modules/emailMarketing/components/EmailMarketingSummaryRoute.tsx:27` | `NumberUtils.decimalFormat` |
| `apps/web/app/modules/emailMarketing/components/EmailMarketingSummaryRoute.tsx:36` | `NumberUtils.numberFormat` |
| `apps/web/app/modules/emailMarketing/components/OutboundEmailsTable.tsx:177` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/emailMarketing/components/OutboundEmailsTable.tsx:178` | `DateUtils.dateYMD` |
| `apps/web/app/modules/emailMarketing/components/OutboundEmailsTable.tsx:179` | `DateUtils.dateAgo` |
| `apps/web/app/modules/emailMarketing/components/OutboundEmailsTable.tsx:213` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/events/components/EventDetails.tsx:26` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/events/components/EventDetails.tsx:62` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/events/components/EventDetails.tsx:68` | `DateUtils.dateYMDHMS` |
| `apps/web/app/modules/events/components/EventsTable.tsx:103` | `DateUtils.dateAgo` |
@@ -36,7 +36,9 @@ apps/web/public/locales/
│ ├── crm.json # Per-area: CRM surfaces
│ ├── auth.json # Per-area: authentication surfaces
│ └── emailMarketing.json # Per-area: email marketing surfaces
└── en/ (same structure)
├── en/ (same structure)
├── pl/ · ru/ · uk/ · hu/ (same structure, release-gated)
└── <locale>-formal/ (nine sparse formal-override namespace files)
```
`translations.json` is the historical bag-of-keys. **New work should land
@@ -97,6 +99,8 @@ i18next's `{{name}}` interpolation, so a gradual migration is safe.
| en | one, other |
| de | one, other |
| pl | one, few, many, other |
| ru, uk | one, few, many, other |
| hu | one, other |
| ar | zero, one, two, few, many, other |
| ja, zh | other (no plural distinction) |
@@ -127,10 +131,15 @@ identical output on server + client.
When a request arrives, the server picks a locale in this order:
1. `User.locale` (set via the profile locale-picker)
2. `Tenant.defaultLocale`
3. `Accept-Language` header (browser default)
2. Tenant default locale when the tenant contract exposes one
3. Locale cookie / `Accept-Language` header (browser default)
4. App fallback (`de`, see `packages/i18n/src/index.ts#defaultLocale`)
Every candidate is filtered through `I18N_ENABLED_LOCALES`. Disabled locales
cannot be activated by stored preferences, cookies, request parameters or
browser headers. The checked-in default remains `de,en`; review locales are
enabled individually on staging only after their manifest is current.
The resolved locale is stored in the i18n cookie (`_i18n`) and surfaced
to React via `useTranslation().i18n.language`. The picker UI lives in
`apps/web/app/modules/users/components/UserProfileSettings.tsx` (rendered
@@ -164,7 +173,17 @@ calls the root `setLocale` action.
by copying the English files
3. Run `pnpm verify:i18n` — the parity check enforces all namespaces have
matching keys
4. Have the translation reviewed before merging
4. Add all nine `<locale>-formal` namespace files; they may be sparse but must
fall back through `<locale>-formal → <locale> → de`
5. Update `docs/contributing/i18n/reviews/<locale>.json` with German source hashes
6. Run `pnpm verify:i18n`
7. Keep the locale disabled until the documented native-speaker gate passes
`scripts/i18n-translate-catalog.ts` is a build-time helper only. It writes
static catalogs and is never part of a HiveGrid runtime or deployment image.
`scripts/i18n-quality.ts` blocks stale hashes, damaged placeholders/ICU
arguments/tags/URLs, mojibake, non-NFC text, untranslated German sentences and
incomplete CLDR plural categories.
## Auditing hardcoded strings
@@ -179,10 +198,8 @@ node scripts/i18n-audit.mjs
# → docs/contributing/i18n-audit-<YYYY-MM-DD>.md
```
The current audit snapshot is `docs/contributing/i18n-audit-2026-05-25.md`.
Its re-run section is the active product-UI baseline: 0 hardcoded
route/component strings and 0 locale-formatting signals as of 2026-05-29.
The 2026-05-25 findings remain in that file as historical disposition only.
Audit-Reports sind lokale, datierte Arbeitsartefakte und werden nicht als dauerhafte Quelle im Repo
gepflegt. Der ausführbare Vertrag ist `pnpm verify:i18n`.
The repo-wide `pnpm verify:i18n` script enforces three guards:
@@ -0,0 +1,31 @@
# HiveGrid translation glossary
German is the semantic source. English is the context reference. Product names, provider names,
protocol identifiers and user-authored content are never translated automatically.
| German | Meaning | Polish | Russian | Ukrainian | Hungarian |
| --- | --- | --- | --- | --- | --- |
| Projekt | Central commercial and operational record | projekt | проект | проєкт | projekt |
| Auftrag | Confirmed customer order, represented by a project type | zlecenie | заказ | замовлення | megrendelés |
| Angebot | Commercial quotation | oferta | коммерческое предложение | комерційна пропозиція | ajánlat |
| Rechnung | Invoice | faktura | счёт | рахунок | számla |
| Abnahme | Formal acceptance of completed work | odbiór | приёмка | приймання | műszaki átadás |
| Mangel | Defect requiring remediation | usterka | дефект | недолік | hiba |
| Baustelle | Physical work site | plac budowy | строительная площадка | будівельний майданчик | munkaterület |
| Monteur | Field technician / installer | monter | монтажник | монтажник | szerelő |
| Plantafel | Scheduling board for crews and work | tablica planowania | доска планирования | дошка планування | ütemezőtábla |
| Pipeline | Configurable project view by stage | pipeline | воронка | воронка | folyamatnézet |
| Automation | Automatically executed rule | automatyzacja | автоматизация | автоматизація | automatizálás |
| Workflow | Multi-step automated process | przepływ pracy | рабочий процесс | робочий процес | munkafolyamat |
| Mandant | Tenant/company workspace, never a customer contact | organizacja | организация | організація | szervezet |
| Kontakt | Natural person or contact record | kontakt | контакт | контакт | kapcsolattartó |
| Firma | Company record | firma | компания | компанія | vállalat |
| Kunde | Customer | klient | клиент | клієнт | ügyfél |
## Locked terminology rules
- `HiveGrid`, Mollie, Mailjet, Authentik, Meilisearch and product/provider names stay unchanged.
- `Projekt` remains the central entity. Do not reintroduce a separate Deal/Order handoff in translation.
- Pipeline is a project view, not a second data model.
- Keep placeholders, ICU arguments, HTML/React tags, URLs, email addresses and protocol identifiers byte-identical.
- Translate only system copy. Names, stages, project titles and customer-authored portal templates stay untouched.
@@ -0,0 +1,36 @@
# Six-locale rollout and rollback
Polish (`pl`), Ukrainian (`uk`), Russian (`ru`) and Hungarian (`hu`) ship as static catalogs but remain disabled until their own release gate passes. The checked-in and production default for `I18N_ENABLED_LOCALES` is `de,en`.
## Release gate
Each locale must have a current `reviews/<locale>.json` manifest before activation. A native speaker reviews all Auth, error, billing, transactional-mail and formal-override copy, completes the critical App and Customer Portal journeys, and records at least 200 stratified samples from the other namespaces. The manifest records reviewer, date, sample size and corrections. A changed German source hash makes the catalog review-pending again.
Technical presence is not release approval. `packages/i18n/src/locales.ts` keeps every new locale in the `review` stage, so production configuration rejects it even if it is added to the environment variable. The stage may move to `production` only after the manifest gate has passed.
## Staged activation
Activate one locale at a time on staging in this order:
1. `pl`
2. `uk`
3. `ru`
4. `hu`
For each locale, append only that code to `I18N_ENABLED_LOCALES`, deploy the same immutable image, and run the Du/Sie browser and mail UAT. Cover login/password reset, navigation/dashboard/search, CRM/projects/pipelines/workflows, destructive dialogs/errors/toasts, billing/checkout, settings/language changes, Customer Portal and transactional mail. Check desktop, tablet and mobile layouts, including Cyrillic, Polish `ą ć ę ł ń ó ś ź ż` and Hungarian `á é í ó ö ő ú ü ű`.
After corrections and a completed manifest, promote the locale release stage, add it to the production environment variable and monitor the deploy. Do not activate multiple new locales in the same rollout step.
## Performance gate
Run `pnpm verify:i18n-performance`. It measures synchronous JSON parsing and retained RSS for `de,en` versus all six base/formal bundles in isolated Node processes. A delta above 250 ms or 30 MB fails the command and requires locale-scoped cached loading before release. Record the measured result in the ticket implementation note.
Measurement on 2026-08-02: the median `de,en` load was 11.29 ms and 5.30 MB retained RSS; all six locales loaded in 33.17 ms and 16.59 MB. The resulting delta was **+21.88 ms and +11.29 MB**, so eager once-per-process loading remains within the release contract.
## Rollback
Remove the affected locale from `I18N_ENABLED_LOCALES`, redeploy, and if needed redeploy the previous immutable image SHA. Catalog files may remain in the image: disabled locales cannot be selected or activated through a stored preference, cookie, request parameter or `Accept-Language` header. No database rollback is required.
## Next candidates
Romanian is the next planned expansion, but this change intentionally adds no `ro` type, catalog or runtime option. Turkish and Bulgarian remain later market candidates only.
@@ -0,0 +1,8 @@
# Hungarian style guide (`hu`)
- Base bundle: direct, friendly `te`; use natural Hungarian suffixes and word order.
- Formal bundle: consistently use `Ön` and matching verb forms.
- Prefer `projekt`, `megrendelés`, `ajánlat`, `számla`, `műszaki átadás`, `hiba`, `szerelő` and `ütemezőtábla`.
- Use Hungarian quotation marks „…”, double acute accents (`ő`, `ű`) and locale formatting (`hu-HU`).
- Plurals must contain `one` and `other`; test 0, 1, 2, 5, 21 and a decimal.
- Keep buttons short; put consequences and recovery guidance in the supporting copy.
@@ -0,0 +1,8 @@
# Polish style guide (`pl`)
- Base bundle: direct, friendly `ty`, concise verbs, natural Polish word order.
- Formal bundle: polite, gender-neutral constructions; avoid forcing `Pan/Pani` when an impersonal form is natural.
- Prefer `projekt`, `zlecenie`, `oferta`, `faktura`, `odbiór`, `usterka`, `monter` and `tablica planowania` per the glossary.
- Use Polish quotation marks „…”, correct diacritics and locale formatting (`pl-PL`).
- Plurals must contain `one`, `few`, `many`, and `other`; test 0, 1, 2, 5, 21 and a decimal.
- Destructive actions must state the object and consequence explicitly.
@@ -0,0 +1,44 @@
{
"locale": "hu",
"sourceLocale": "de",
"sourceHashes": {
"translations": "16aef502ee1eaef511b434a4a92772b30043e444c9305268975df322702a3b0f",
"errors": "0141365c27bdc7f6f65c84127ff14db2487a2e9f375e59ae4c3314aa73a40dab",
"mail": "ef4a7dd1bff1bd89b85b2fa1b98924d3022c8a97c68ad3dc28c8fabaf72ddc88",
"common": "cf0b6c706669d92c5435c3731c66fcacfb95e8da987f80322f76a29b124060b7",
"settings": "2bf765820cb3413b59b07f9e317f0665c8a43d9eb572536b345731d03ec82e0f",
"billing": "3e24655ffb2db4c20fb63fc5568a4f2b133c6399417e6a059337899d66080a3f",
"crm": "130b45f670c483a31b19309d77abaed94aff8d649568393e33a3025fa3121dcb",
"auth": "756c2701e4f899c1a8e355693ca147c8470efc37c53ff4ec53424998ca3f37c6",
"emailMarketing": "585dc34b82c89d22fc70e89949083be81b9ca7fe80640f5ed4eb9d73c9f6414e"
},
"machineTranslation": {
"status": "complete",
"provider": "Google Translate static build tool",
"completedAt": "2026-08-02T13:53:30.944Z"
},
"automatedReview": {
"status": "complete",
"checkedAt": "2026-08-02T19:26:32Z",
"checks": [
"key parity",
"protected-token integrity",
"ICU plural categories",
"Unicode NFC and mojibake",
"source hash freshness"
]
},
"nativeReview": {
"status": "pending",
"reviewer": null,
"reviewedAt": null,
"criticalSurfaces": [],
"sampleSize": 0,
"corrections": [],
"releaseBlockers": ["Native speaker must verify and correct informal base tone, formal overrides, terminology and natural phrasing."]
},
"release": {
"status": "disabled",
"enabledEnvironments": []
}
}
@@ -0,0 +1,44 @@
{
"locale": "pl",
"sourceLocale": "de",
"sourceHashes": {
"translations": "16aef502ee1eaef511b434a4a92772b30043e444c9305268975df322702a3b0f",
"errors": "0141365c27bdc7f6f65c84127ff14db2487a2e9f375e59ae4c3314aa73a40dab",
"mail": "ef4a7dd1bff1bd89b85b2fa1b98924d3022c8a97c68ad3dc28c8fabaf72ddc88",
"common": "cf0b6c706669d92c5435c3731c66fcacfb95e8da987f80322f76a29b124060b7",
"settings": "2bf765820cb3413b59b07f9e317f0665c8a43d9eb572536b345731d03ec82e0f",
"billing": "3e24655ffb2db4c20fb63fc5568a4f2b133c6399417e6a059337899d66080a3f",
"crm": "130b45f670c483a31b19309d77abaed94aff8d649568393e33a3025fa3121dcb",
"auth": "756c2701e4f899c1a8e355693ca147c8470efc37c53ff4ec53424998ca3f37c6",
"emailMarketing": "585dc34b82c89d22fc70e89949083be81b9ca7fe80640f5ed4eb9d73c9f6414e"
},
"machineTranslation": {
"status": "complete",
"provider": "Google Translate static build tool",
"completedAt": "2026-08-02T13:51:51.924Z"
},
"automatedReview": {
"status": "complete",
"checkedAt": "2026-08-02T19:26:32Z",
"checks": [
"key parity",
"protected-token integrity",
"ICU plural categories",
"Unicode NFC and mojibake",
"source hash freshness"
]
},
"nativeReview": {
"status": "pending",
"reviewer": null,
"reviewedAt": null,
"criticalSurfaces": [],
"sampleSize": 0,
"corrections": [],
"releaseBlockers": ["Native speaker must verify and correct informal base tone, formal overrides, terminology and natural phrasing."]
},
"release": {
"status": "disabled",
"enabledEnvironments": []
}
}
@@ -0,0 +1,44 @@
{
"locale": "ru",
"sourceLocale": "de",
"sourceHashes": {
"translations": "16aef502ee1eaef511b434a4a92772b30043e444c9305268975df322702a3b0f",
"errors": "0141365c27bdc7f6f65c84127ff14db2487a2e9f375e59ae4c3314aa73a40dab",
"mail": "ef4a7dd1bff1bd89b85b2fa1b98924d3022c8a97c68ad3dc28c8fabaf72ddc88",
"common": "cf0b6c706669d92c5435c3731c66fcacfb95e8da987f80322f76a29b124060b7",
"settings": "2bf765820cb3413b59b07f9e317f0665c8a43d9eb572536b345731d03ec82e0f",
"billing": "3e24655ffb2db4c20fb63fc5568a4f2b133c6399417e6a059337899d66080a3f",
"crm": "130b45f670c483a31b19309d77abaed94aff8d649568393e33a3025fa3121dcb",
"auth": "756c2701e4f899c1a8e355693ca147c8470efc37c53ff4ec53424998ca3f37c6",
"emailMarketing": "585dc34b82c89d22fc70e89949083be81b9ca7fe80640f5ed4eb9d73c9f6414e"
},
"machineTranslation": {
"status": "complete",
"provider": "Google Translate static build tool",
"completedAt": "2026-08-02T13:52:02.016Z"
},
"automatedReview": {
"status": "complete",
"checkedAt": "2026-08-02T19:26:32Z",
"checks": [
"key parity",
"protected-token integrity",
"ICU plural categories",
"Unicode NFC and mojibake",
"source hash freshness"
]
},
"nativeReview": {
"status": "pending",
"reviewer": null,
"reviewedAt": null,
"criticalSurfaces": [],
"sampleSize": 0,
"corrections": [],
"releaseBlockers": ["Native speaker must verify and correct informal base tone, formal overrides, terminology and natural phrasing."]
},
"release": {
"status": "disabled",
"enabledEnvironments": []
}
}
@@ -0,0 +1,44 @@
{
"locale": "uk",
"sourceLocale": "de",
"sourceHashes": {
"translations": "16aef502ee1eaef511b434a4a92772b30043e444c9305268975df322702a3b0f",
"errors": "0141365c27bdc7f6f65c84127ff14db2487a2e9f375e59ae4c3314aa73a40dab",
"mail": "ef4a7dd1bff1bd89b85b2fa1b98924d3022c8a97c68ad3dc28c8fabaf72ddc88",
"common": "cf0b6c706669d92c5435c3731c66fcacfb95e8da987f80322f76a29b124060b7",
"settings": "2bf765820cb3413b59b07f9e317f0665c8a43d9eb572536b345731d03ec82e0f",
"billing": "3e24655ffb2db4c20fb63fc5568a4f2b133c6399417e6a059337899d66080a3f",
"crm": "130b45f670c483a31b19309d77abaed94aff8d649568393e33a3025fa3121dcb",
"auth": "756c2701e4f899c1a8e355693ca147c8470efc37c53ff4ec53424998ca3f37c6",
"emailMarketing": "585dc34b82c89d22fc70e89949083be81b9ca7fe80640f5ed4eb9d73c9f6414e"
},
"machineTranslation": {
"status": "complete",
"provider": "Google Translate static build tool",
"completedAt": "2026-08-02T13:52:24.903Z"
},
"automatedReview": {
"status": "complete",
"checkedAt": "2026-08-02T19:26:32Z",
"checks": [
"key parity",
"protected-token integrity",
"ICU plural categories",
"Unicode NFC and mojibake",
"source hash freshness"
]
},
"nativeReview": {
"status": "pending",
"reviewer": null,
"reviewedAt": null,
"criticalSurfaces": [],
"sampleSize": 0,
"corrections": [],
"releaseBlockers": ["Native speaker must verify and correct informal base tone, formal overrides, terminology and natural phrasing."]
},
"release": {
"status": "disabled",
"enabledEnvironments": []
}
}
@@ -0,0 +1,8 @@
# Russian style guide (`ru`)
- Base bundle: direct, friendly `ты`; avoid bureaucratic calques.
- Formal bundle: consistently polite `вы`, capitalized only where natural in direct address.
- Prefer `проект`, `заказ`, `коммерческое предложение`, `счёт`, `приёмка`, `дефект`, `монтажник` and `доска планирования`.
- Use Russian quotation marks «…», Cyrillic text and locale formatting (`ru-RU`).
- Plurals must contain `one`, `few`, `many`, and `other`; test 0, 1, 2, 5, 21 and a decimal.
- Keep concise UI labels; explain irreversible outcomes in dialogs and errors.
@@ -0,0 +1,8 @@
# Ukrainian style guide (`uk`)
- Base bundle: direct, friendly `ти`, written in natural contemporary Ukrainian.
- Formal bundle: consistently polite `ви`; avoid Russian calques.
- Prefer `проєкт`, `замовлення`, `комерційна пропозиція`, `рахунок`, `приймання`, `недолік`, `монтажник` and `дошка планування`.
- Use Ukrainian quotation marks «…», the letters `і`, `ї`, `є`, `ґ` correctly and locale formatting (`uk-UA`).
- Plurals must contain `one`, `few`, `many`, and `other`; test 0, 1, 2, 5, 21 and a decimal.
- Errors and destructive actions should be concrete, calm and actionable.
@@ -24,7 +24,7 @@ explains:
| Lint rules | `eslint-plugin-jsx-a11y` (`plugin:jsx-a11y/recommended`) | `pnpm lint` |
| Brand-token contrast | `scripts/verify-color-contrast.mjs` (zero-dep, fails CI on regress) | `pnpm verify:color-contrast` |
| Browser-level WCAG sweep | `@axe-core/playwright` | `pnpm verify:e2e-a11y` |
| CI gate | `.github/workflows/a11y.yml` + `.gitea/workflows/a11y.yml` | every PR + push to main |
| CI gate | `.gitea/workflows/a11y.yml` | manual deep audit; fast contracts remain in default CI |
| Keyboard "skip to content" | `apps/web/app/components/core/SkipToContent.tsx` | rendered in `AppLayout` |
Browser-level mobile public coverage includes landing, legal pages, error
@@ -234,7 +234,7 @@ requires tenant credentials plus `E2E_TENANT_DASHBOARD_PATH`,
`E2E_WORKFLOW_RUN_MANUAL_PATH`, `E2E_WORKFLOW_WEBHOOK_RUN_MANUAL_PATH`, and
`PLUGIN_BINARY_BASE_PATH`, and turns
missing inputs or unavailable 400/403/404/login responses into failures.
Scheduled GitHub/Gitea readiness workflows run this contract against staging
The scheduled Gitea readiness workflow runs this contract against staging
with `E2E_BROWSER_MATRIX=1`, `E2E_A11Y_STRICT=1`, and
`E2E_ALLOW_WORKFLOW_RUN=1`.
Legacy-Provider/provider-live paths and mutating account/workflow actions stay separately