Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
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
|
||||
|
||||
Reference in new issue
Block a user