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

@@ -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.