Open-source personal finance manager. Self-hosted, privacy-first.
fix: seed default categories in all supported languages (#658)
Luis Angel Hernández Hernándezd990f40de025
diff --git a/backend/app/data/default_categories.json b/backend/app/data/default_categories.jsonnew file mode 100644index 00000000..7d050364--- /dev/null+++ b/backend/app/data/default_categories.json@@ -0,0 +1,538 @@+{+ "groups": {+ "housing": {+ "names": {+ "en": "Housing",+ "pt-BR": "Moradia",+ "pt-PT": "Habitação",+ "de": "Wohnen",+ "fr": "Logement",+ "es": "Vivienda",+ "it": "Casa",+ "pl": "Mieszkanie",+ "ru": "Жильё",+ "uk": "Житло",+ "nl": "Wonen",+ "sk": "Bývanie",+ "hu": "Lakhatás",+ "cs": "Bydlení",+ "el": "Στέγαση",+ "hi": "आवास",+ "ja": "住居"+ },+ "aliases": ["Alojamiento"],+ "icon": "house",+ "color": "#8B5CF6",+ "position": 0+ },+ "food": {+ "names": {+ "en": "Food & Dining",+ "pt-BR": "Alimentação",+ "pt-PT": "Alimentação",+ "de": "Essen & Trinken",+ "fr": "Alimentation & Restaurants",+ "es": "Alimentación",+ "it": "Cibo e Ristoranti",+ "pl": "Jedzenie",+ "ru": "Еда и рестораны",+ "uk": "Їжа та ресторани",+ "nl": "Eten & Drinken",+ "sk": "Jedlo a reštaurácie",+ "hu": "Étkezés és éttermek",+ "cs": "Jídlo a restaurace",+ "el": "Φαγητό & Εστίαση",+ "hi": "भोजन और रेस्तरां",+ "ja": "食費・外食"+ },+ "aliases": ["Comida y Cena"],+ "icon": "utensils-crossed",+ "color": "#F59E0B",+ "position": 1+ },+ "transport": {+ "names": {+ "en": "Transport",+ "pt-BR": "Transporte",+ "pt-PT": "Transportes",+ "de": "Transport",+ "fr": "Transport",+ "es": "Transporte",+ "it": "Trasporti",+ "pl": "Transport",+ "ru": "Транспорт",+ "uk": "Транспорт",+ "nl": "Transport",+ "sk": "Doprava",+ "hu": "Közlekedés",+ "cs": "Doprava",+ "el": "Μεταφορές",+ "hi": "परिवहन",+ "ja": "交通"+ },+ "icon": "car",+ "color": "#3B82F6",+ "position": 2+ },+ "lifestyle": {+ "names": {+ "en": "Lifestyle",+ "pt-BR": "Estilo de Vida",+ "pt-PT": "Estilo de Vida",+ "de": "Lifestyle",+ "fr": "Style de vie",+ "es": "Estilo de Vida",+ "it": "Stile di Vita",+ "pl": "Styl życia",+ "ru": "Образ жизни",+ "uk": "Спосіб життя",+ "nl": "Levensstijl",+ "sk": "Životný štýl",+ "hu": "Életmód",+ "cs": "Životní styl",+ "el": "Τρόπος ζωής",+ "hi": "जीवनशैली",+ "ja": "ライフスタイル"+ },+ "icon": "sparkles",+ "color": "#EC4899",+ "position": 3+ },+ "income": {+ "names": {+ "en": "Income",+ "pt-BR": "Renda",+ "pt-PT": "Rendimentos",+ "de": "Einkommen",+ "fr": "Revenus",+ "es": "Ingresos",+ "it": "Entrate",+ "pl": "Przychody",+ "ru": "Доходы",+ "uk": "Доходи",+ "nl": "Inkomen",+ "sk": "Príjmy",+ "hu": "Bevételek",+ "cs": "Příjmy",+ "el": "Εισόδημα",+ "hi": "आय",+ "ja": "収入"+ },+ "icon": "trending-up",+ "color": "#16A34A",+ "position": 5+ },+ "other": {+ "names": {+ "en": "Other",+ "pt-BR": "Outros",+ "pt-PT": "Outros",+ "de": "Sonstiges",+ "fr": "Autres",+ "es": "Otros",+ "it": "Altro",+ "pl": "Inne",+ "ru": "Другое",+ "uk": "Інше",+ "nl": "Overig",+ "sk": "Ostatné",+ "hu": "Egyéb",+ "cs": "Ostatní",+ "el": "Άλλα",+ "hi": "अन्य",+ "ja": "その他"+ },+ "icon": "circle-help",+ "color": "#64748B",+ "position": 4+ }+ },+ "categories": {+ "housing": {+ "names": {+ "en": "Housing",+ "pt-BR": "Moradia",+ "pt-PT": "Habitação",+ "de": "Wohnen",+ "fr": "Logement",+ "es": "Vivienda",+ "it": "Casa",+ "pl": "Mieszkanie",+ "ru": "Жильё",+ "uk": "Житло",+ "nl": "Wonen",+ "sk": "Bývanie",+ "hu": "Lakhatás",+ "cs": "Bydlení",+ "el": "Στέγαση",+ "hi": "आवास",+ "ja": "住居"+ },+ "group": "housing",+ "icon": "house",+ "color": "#8B5CF6"+ },+ "food": {+ "names": {+ "en": "Food & Dining",+ "pt-BR": "Alimentação",+ "pt-PT": "Alimentação",+ "de": "Essen & Trinken",+ "fr": "Alimentation & Restaurants",+ "es": "Alimentación",+ "it": "Cibo e Ristoranti",+ "pl": "Jedzenie",+ "ru": "Еда и рестораны",+ "uk": "Їжа та ресторани",+ "nl": "Eten & Drinken",+ "sk": "Jedlo a reštaurácie",+ "hu": "Étkezés és éttermek",+ "cs": "Jídlo a restaurace",+ "el": "Φαγητό & Εστίαση",+ "hi": "भोजन और रेस्तरां",+ "ja": "食費・外食"+ },+ "group": "food",+ "icon": "utensils-crossed",+ "color": "#F59E0B"+ },+ "transport": {+ "names": {+ "en": "Transport",+ "pt-BR": "Transporte",+ "pt-PT": "Transportes",+ "de": "Transport",+ "fr": "Transport",+ "es": "Transporte",+ "it": "Trasporti",+ "pl": "Transport",+ "ru": "Транспорт",+ "uk": "Транспорт",+ "nl": "Transport",+ "sk": "Doprava",+ "hu": "Közlekedés",+ "cs": "Doprava",+ "el": "Μεταφορές",+ "hi": "परिवहन",+ "ja": "交通"+ },+ "group": "transport",+ "icon": "car",+ "color": "#3B82F6"+ },+ "groceries": {+ "names": {+ "en": "Groceries",+ "pt-BR": "Mercado",+ "pt-PT": "Supermercado",+ "de": "Lebensmittel",+ "fr": "Courses",+ "es": "Supermercado",+ "it": "Spesa",+ "pl": "Zakupy spożywcze",+ "ru": "Продукты",+ "uk": "Продукти",+ "nl": "Boodschappen",+ "sk": "Potraviny",+ "hu": "Élelmiszer",+ "cs": "Potraviny",+ "el": "Σούπερ μάρκετ",+ "hi": "किराना",+ "ja": "食料品"+ },+ "group": "food",+ "icon": "shopping-cart",+ "color": "#10B981"+ },+ "health": {+ "names": {+ "en": "Health",+ "pt-BR": "Saúde",+ "pt-PT": "Saúde",+ "de": "Gesundheit",+ "fr": "Santé",+ "es": "Salud",+ "it": "Salute",+ "pl": "Zdrowie",+ "ru": "Здоровье",+ "uk": "Здоров'я",+ "nl": "Gezondheid",+ "sk": "Zdravie",+ "hu": "Egészség",+ "cs": "Zdraví",+ "el": "Υγεία",+ "hi": "स्वास्थ्य",+ "ja": "健康・医療"+ },+ "group": "lifestyle",+ "icon": "pill",+ "color": "#EF4444"+ },+ "leisure": {+ "names": {+ "en": "Leisure",+ "pt-BR": "Lazer",+ "pt-PT": "Lazer",+ "de": "Freizeit",+ "fr": "Loisirs",+ "es": "Ocio",+ "it": "Tempo Libero",+ "pl": "Rozrywka",+ "ru": "Досуг",+ "uk": "Дозвілля",+ "nl": "Vrije tijd",+ "sk": "Voľný čas",+ "hu": "Szabadidő",+ "cs": "Volný čas",+ "el": "Ψυχαγωγία",+ "hi": "मनोरंजन",+ "ja": "娯楽"+ },+ "group": "lifestyle",+ "icon": "gamepad-2",+ "color": "#EC4899"+ },+ "subscriptions": {+ "names": {+ "en": "Subscriptions",+ "pt-BR": "Assinaturas",+ "pt-PT": "Subscrições",+ "de": "Abonnements",+ "fr": "Abonnements",+ "es": "Suscripciones",+ "it": "Abbonamenti",+ "pl": "Subskrypcje",+ "ru": "Подписки",+ "uk": "Підписки",+ "nl": "Abonnementen",+ "sk": "Predplatné",+ "hu": "Előfizetések",+ "cs": "Předplatné",+ "el": "Συνδρομές",+ "hi": "सदस्यता",+ "ja": "サブスクリプション"+ },+ "group": "other",+ "icon": "smartphone",+ "color": "#6366F1"+ },+ "education": {+ "names": {+ "en": "Education",+ "pt-BR": "Educação",+ "pt-PT": "Educação",+ "de": "Bildung",+ "fr": "Éducation",+ "es": "Educación",+ "it": "Istruzione",+ "pl": "Edukacja",+ "ru": "Образование",+ "uk": "Освіта",+ "nl": "Educatie",+ "sk": "Vzdelávanie",+ "hu": "Oktatás",+ "cs": "Vzdělávání",+ "el": "Εκπαίδευση",+ "hi": "शिक्षा",+ "ja": "教育"+ },+ "group": "lifestyle",+ "icon": "book-open",+ "color": "#22C55E"+ },+ "transfers": {+ "names": {+ "en": "Transfers",+ "pt-BR": "Transferências",+ "pt-PT": "Transferências",+ "de": "Umbuchungen",+ "fr": "Virements",+ "es": "Transferencias",+ "it": "Trasferimenti",+ "pl": "Przelewy",+ "ru": "Переводы",+ "uk": "Перекази",+ "nl": "Overboekingen",+ "sk": "Prevody",+ "hu": "Átvezetések",+ "cs": "Převody",+ "el": "Μεταφορά κεφαλαίων",+ "hi": "स्थानांतरण",+ "ja": "振替"+ },+ "group": "other",+ "icon": "arrow-left-right",+ "color": "#64748B",+ "treat_as_transfer": true+ },+ "investments": {+ "names": {+ "en": "Investments",+ "pt-BR": "Investimentos",+ "pt-PT": "Investimentos",+ "de": "Investitionen",+ "fr": "Investissements",+ "es": "Inversiones",+ "it": "Investimenti",+ "pl": "Inwestycje",+ "ru": "Инвестиции",+ "uk": "Інвестиції",+ "nl": "Investeringen",+ "sk": "Investície",+ "hu": "Befektetések",+ "cs": "Investice",+ "el": "Επενδύσεις",+ "hi": "निवेश",+ "ja": "投資"+ },+ "group": "other",+ "icon": "trending-up",+ "color": "#0EA5E9",+ "treat_as_transfer": true+ },+ "salary": {+ "names": {+ "en": "Salary & Income",+ "pt-BR": "Salário & Renda",+ "pt-PT": "Salário & Rendimentos",+ "de": "Gehalt & Einnahmen",+ "fr": "Salaire & Revenus",+ "es": "Salario e Ingresos",+ "it": "Stipendio e Entrate",+ "pl": "Wynagrodzenie i Przychody",+ "ru": "Зарплата и доходы",+ "uk": "Зарплата та доходи",+ "nl": "Salaris & Inkomen",+ "sk": "Mzda a príjmy",+ "hu": "Fizetés és bevételek",+ "cs": "Mzda a příjmy",+ "el": "Μισθός & Εισοδήματα",+ "hi": "वेतन और आय",+ "ja": "給与・収入"+ },+ "group": "income",+ "icon": "banknote",+ "color": "#16A34A"+ },+ "shopping": {+ "names": {+ "en": "Shopping",+ "pt-BR": "Compras",+ "pt-PT": "Compras",+ "de": "Shopping",+ "fr": "Achats",+ "es": "Compras",+ "it": "Shopping",+ "pl": "Zakupy",+ "ru": "Покупки",+ "uk": "Покупки",+ "nl": "Winkelen",+ "sk": "Nákupy",+ "hu": "Vásárlás",+ "cs": "Nákupy",+ "el": "Αγορές",+ "hi": "खरीदारी",+ "ja": "ショッピング"+ },+ "group": "other",+ "icon": "shopping-bag",+ "color": "#F97316"+ },+ "donations": {+ "names": {+ "en": "Donations",+ "pt-BR": "Doações",+ "pt-PT": "Donativos",+ "de": "Spenden",+ "fr": "Dons",+ "es": "Donaciones",+ "it": "Donazioni",+ "pl": "Darowizny",+ "ru": "Пожертвования",+ "uk": "Пожертви",+ "nl": "Donaties",+ "sk": "Dary",+ "hu": "Adományok",+ "cs": "Dary",+ "el": "Δωρεές",+ "hi": "दान",+ "ja": "寄付"+ },+ "group": "other",+ "icon": "heart-handshake",+ "color": "#D946EF"+ },+ "personal_care": {+ "names": {+ "en": "Personal Care",+ "pt-BR": "Cuidados Pessoais",+ "pt-PT": "Cuidados Pessoais",+ "de": "Körperpflege",+ "fr": "Soins personnels",+ "es": "Cuidado Personal",+ "it": "Cura Personale",+ "pl": "Higiena osobista",+ "ru": "Уход за собой",+ "uk": "Догляд за собою",+ "nl": "Persoonlijke verzorging",+ "sk": "Osobná starostlivosť",+ "hu": "Személyes ápolás",+ "cs": "Osobní péče",+ "el": "Προσωπική φροντίδα",+ "hi": "व्यक्तिगत देखभाल",+ "ja": "美容・ケア"+ },+ "group": "lifestyle",+ "icon": "scissors",+ "color": "#F472B6"+ },+ "taxes": {+ "names": {+ "en": "Taxes & Fees",+ "pt-BR": "Impostos & Taxas",+ "pt-PT": "Impostos & Taxas",+ "de": "Steuern & Gebühren",+ "fr": "Impôts & Taxes",+ "es": "Impuestos y Tasas",+ "it": "Tasse e Imposte",+ "pl": "Podatki i Opłaty",+ "ru": "Налоги и сборы",+ "uk": "Податки та збори",+ "nl": "Belastingen & Heffingen",+ "sk": "Dane a poplatky",+ "hu": "Adók és díjak",+ "cs": "Daně a poplatky",+ "el": "Φόροι & Τέλη",+ "hi": "कर और शुल्क",+ "ja": "税金・手数料"+ },+ "group": "other",+ "icon": "landmark",+ "color": "#78716C"+ },+ "other": {+ "names": {+ "en": "Other",+ "pt-BR": "Outros",+ "pt-PT": "Outros",+ "de": "Sonstiges",+ "fr": "Autres",+ "es": "Otros",+ "it": "Altro",+ "pl": "Inne",+ "ru": "Другое",+ "uk": "Інше",+ "nl": "Overig",+ "sk": "Ostatné",+ "hu": "Egyéb",+ "cs": "Ostatní",+ "el": "Άλλα",+ "hi": "अन्य",+ "ja": "その他"+ },+ "group": "other",+ "icon": "circle-help",+ "color": "#6B7280"+ }+ }+}diff --git a/backend/app/services/category_defaults.py b/backend/app/services/category_defaults.pynew file mode 100644index 00000000..24f346f6--- /dev/null+++ b/backend/app/services/category_defaults.py@@ -0,0 +1,47 @@+"""Default category/group taxonomy seeded into new workspaces.++The data lives in app/data/default_categories.json so that supporting a+new language, or adding a new default category or group, is a data-only+change: add the entries there and every seeding and name-matching code+path picks them up.++Each entry has a stable internal key and the shape+``{"names": {lang: display_name}, "icon": ..., "color": ...}``; groups+also carry ``position``, categories carry ``group`` (the group's+internal key) and optionally ``treat_as_transfer``. Any entry may list+``aliases``: former display names that are matched but never seeded, so+workspaces created before a rename aren't given a duplicate.+"""++import json+from importlib.resources import files++# importlib.resources (rather than Path(__file__)) so the file is found in+# every install mode — editable, wheel, or zipped — as long as it's declared+# as package data (see [tool.setuptools.package-data] in pyproject.toml).+_taxonomy = json.loads(+ files("app").joinpath("data", "default_categories.json").read_text(encoding="utf-8")+)++DEFAULT_GROUPS: dict[str, dict] = _taxonomy["groups"]+DEFAULT_CATEGORIES: dict[str, dict] = _taxonomy["categories"]++# Maps category internal key -> group internal key+CATEGORY_TO_GROUP: dict[str, str] = {+ key: data["group"] for key, data in DEFAULT_CATEGORIES.items()+}+++def localized_name(data: dict, lang: str) -> str:+ """Display name for `lang`: requested language, then English, then any+ available translation. Never raises on a partially-translated entry —+ a missing language must degrade to a readable name, not break seeding."""+ names = data["names"]+ fallback = names.get("en") or next(iter(names.values()))+ return str(names.get(lang, fallback))+++def name_variants(data: dict) -> set[str]:+ """Every name an existing entry may carry: each language's display+ name plus any former names listed under ``aliases``."""+ return set(data["names"].values()) | set(data.get("aliases", ()))diff --git a/backend/app/services/category_group_service.py b/backend/app/services/category_group_service.pyindex d1e61097..96ae4890 100644--- a/backend/app/services/category_group_service.py+++ b/backend/app/services/category_group_service.py@@ -8,47 +8,16 @@ from sqlalchemy.orm import selectinloadfrom app.models.category import Categoryfrom app.models.category_group import CategoryGroupfrom app.schemas.category_group import CategoryGroupCreate, CategoryGroupUpdate+from app.services.category_defaults import DEFAULT_GROUPS, localized_nameclass CategoryGroupVisibilityError(ValueError):"""Raised when visibility is changed for a user-created category group."""-# Language-keyed translations for default groups-# Keys are internal identifiers, values are {lang: display_name}-DEFAULT_GROUPS_I18N = {- "housing": {"ru": "Жильё", "uk": "Житло", "de": "Wohnen", "fr": "Logement", "it": "Casa", "pl": "Mieszkanie", "es": "Alojamiento", "sk": "Bývanie", "en": "Housing", "pt-BR": "Moradia", "pt-PT": "Habitação", "icon": "house", "color": "#8B5CF6", "position": 0},- "food": {"ru": "Еда и рестораны", "uk": "Їжа та ресторани", "de": "Essen & Trinken", "fr": "Alimentation & Restaurants", "it": "Cibo e Ristoranti", "pl": "Jedzenie", "es": "Comida y Cena", "sk": "Jedlo a reštaurácie", "en": "Food & Dining", "pt-BR": "Alimentação", "pt-PT": "Alimentação", "icon": "utensils-crossed", "color": "#F59E0B", "position": 1},- "transport": {"ru": "Транспорт", "uk": "Транспорт", "de": "Transport", "fr": "Transport", "it": "Trasporti", "pl": "Transport", "es": "Transporte", "sk": "Doprava", "en": "Transport", "pt-BR": "Transporte", "pt-PT": "Transportes", "icon": "car", "color": "#3B82F6", "position": 2},- "lifestyle": {"ru": "Образ жизни", "uk": "Спосіб життя", "de": "Lifestyle", "fr": "Style de vie", "it": "Stile di Vita", "pl": "Styl życia", "es": "Estilo de Vida", "sk": "Životný štýl", "en": "Lifestyle", "pt-BR": "Estilo de Vida", "pt-PT": "Estilo de Vida", "icon": "sparkles", "color": "#EC4899", "position": 3},- "income": {"ru": "Доходы", "uk": "Доходи", "de": "Einkommen", "fr": "Revenus", "it": "Entrate", "pl": "Przychody", "es": "Ingresos", "sk": "Príjmy", "en": "Income", "pt-BR": "Renda", "pt-PT": "Rendimentos", "icon": "trending-up", "color": "#16A34A", "position": 5},- "other": {"ru": "Другое", "uk": "Інше", "de": "Sonstiges", "fr": "Autres", "it": "Altro", "pl": "Inne", "es": "Otros", "sk": "Ostatné", "en": "Other", "pt-BR": "Outros", "pt-PT": "Outros", "icon": "circle-help", "color": "#64748B", "position": 4},-}--# Maps category internal key -> group internal key-CATEGORY_TO_GROUP = {- "housing": "housing",- "food": "food",- "groceries": "food",- "transport": "transport",- "health": "lifestyle",- "leisure": "lifestyle",- "education": "lifestyle",- "subscriptions": "other",- "salary": "income",- "shopping": "other",- "donations": "other",- "personal_care": "lifestyle",- "taxes": "other",- "transfers": "other",- "investments": "other",- "other": "other",-}--def _resolve_group_name(key: str, lang: str) -> str:- entry = DEFAULT_GROUPS_I18N.get(key, {})- return str(entry.get(lang, entry.get("en", key)))+ entry = DEFAULT_GROUPS.get(key)+ return localized_name(entry, lang) if entry else keyasync def create_default_groups(@@ -59,8 +28,8 @@ async def create_default_groups() -> dict[str, CategoryGroup]:"""Create default category groups for a user. Returns dict of internal_key -> group. Uses flush (not commit)."""groups = {}- for key, data in DEFAULT_GROUPS_I18N.items():- name = data.get(lang, data.get("en", key))+ for key, data in DEFAULT_GROUPS.items():+ name = localized_name(data, lang)group = CategoryGroup(user_id=user_id,workspace_id=workspace_id,diff --git a/backend/app/services/category_service.py b/backend/app/services/category_service.pyindex b99266e5..9c3c48f7 100644--- a/backend/app/services/category_service.py+++ b/backend/app/services/category_service.py@@ -13,7 +13,12 @@ from app.models.recurring_transaction import RecurringTransactionfrom app.models.rule import Rulefrom app.models.transaction import Transactionfrom app.schemas.category import CategoryCreate, CategoryUpdate-from app.services.category_group_service import CATEGORY_TO_GROUP, create_default_groups+from app.services.category_defaults import (+ CATEGORY_TO_GROUP,+ DEFAULT_CATEGORIES,+ localized_name,+)+from app.services.category_group_service import create_default_groupsclass CategoryVisibilityError(ValueError):@@ -28,31 +33,6 @@ class CategoryTransferError(ValueError):"""Raised when the destination given for a deletion cannot take the references."""-# Language-keyed translations for default categories-# Keys are internal identifiers used to map to groups and rules.-# `treat_as_transfer` marks categories whose transactions are flows, not-# income/expense — they're excluded from report aggregations like paired-# transfers are.-DEFAULT_CATEGORIES_I18N = {- "housing": {"en": "Housing", "pt-BR": "Moradia", "pt-PT": "Habitação", "de": "Wohnen", "fr": "Logement", "nl": "Wonen", "sk": "Bývanie", "icon": "house", "color": "#8B5CF6"},- "food": {"en": "Food & Dining", "pt-BR": "Alimentação", "pt-PT": "Alimentação", "de": "Essen & Trinken", "fr": "Alimentation & Restaurants", "nl": "Eten & Drinken", "sk": "Jedlo a reštaurácie", "icon": "utensils-crossed", "color": "#F59E0B"},- "transport": {"en": "Transport", "pt-BR": "Transporte", "pt-PT": "Transportes", "de": "Transport", "fr": "Transport", "nl": "Transport", "sk": "Doprava", "icon": "car", "color": "#3B82F6"},- "groceries": {"en": "Groceries", "pt-BR": "Mercado", "pt-PT": "Supermercado", "de": "Lebensmittel", "fr": "Courses", "nl": "Boodschappen", "sk": "Potraviny", "icon": "shopping-cart", "color": "#10B981"},- "health": {"en": "Health", "pt-BR": "Saúde", "pt-PT": "Saúde", "de": "Gesundheit", "fr": "Santé", "nl": "Gezondheid", "sk": "Zdravie", "icon": "pill", "color": "#EF4444"},- "leisure": {"en": "Leisure", "pt-BR": "Lazer", "pt-PT": "Lazer", "de": "Freizeit", "fr": "Loisirs", "nl": "Vrije tijd", "sk": "Voľný čas", "icon": "gamepad-2", "color": "#EC4899"},- "subscriptions": {"en": "Subscriptions", "pt-BR": "Assinaturas", "pt-PT": "Subscrições", "de": "Abonnements", "fr": "Abonnements", "nl": "Abonnementen", "sk": "Predplatné", "icon": "smartphone", "color": "#6366F1"},- "education": {"en": "Education", "pt-BR": "Educação", "pt-PT": "Educação", "de": "Bildung", "fr": "Éducation", "nl": "Educatie", "sk": "Vzdelávanie", "icon": "book-open", "color": "#22C55E"},- "transfers": {"en": "Transfers", "pt-BR": "Transferências", "pt-PT": "Transferências", "de": "Umbuchungen", "fr": "Virements", "nl": "Overboekingen", "sk": "Prevody", "icon": "arrow-left-right", "color": "#64748B", "treat_as_transfer": True},- "investments": {"en": "Investments", "pt-BR": "Investimentos", "pt-PT": "Investimentos", "de": "Investitionen", "fr": "Investissements", "nl": "Investeringen", "sk": "Investície", "icon": "trending-up", "color": "#0EA5E9", "treat_as_transfer": True},- "salary": {"en": "Salary & Income", "pt-BR": "Salário & Renda", "pt-PT": "Salário & Rendimentos", "de": "Gehalt & Einnahmen", "fr": "Salaire & Revenus", "nl": "Salaris & Inkomen", "sk": "Mzda a príjmy", "icon": "banknote", "color": "#16A34A"},- "shopping": {"en": "Shopping", "pt-BR": "Compras", "pt-PT": "Compras", "de": "Shopping", "fr": "Achats", "nl": "Winkelen", "sk": "Nákupy", "icon": "shopping-bag", "color": "#F97316"},- "donations": {"en": "Donations", "pt-BR": "Doações", "pt-PT": "Donativos", "de": "Spenden", "fr": "Dons", "nl": "Donaties", "sk": "Dary", "icon": "heart-handshake", "color": "#D946EF"},- "personal_care": {"en": "Personal Care", "pt-BR": "Cuidados Pessoais", "pt-PT": "Cuidados Pessoais", "de": "Körperpflege", "fr": "Soins personnels", "nl": "Persoonlijke verzorging", "sk": "Osobná starostlivosť", "icon": "scissors", "color": "#F472B6"},- "taxes": {"en": "Taxes & Fees", "pt-BR": "Impostos & Taxas", "pt-PT": "Impostos & Taxas", "de": "Steuern & Gebühren", "fr": "Impôts & Taxes", "nl": "Belastingen & Heffingen", "sk": "Dane a poplatky", "icon": "landmark", "color": "#78716C"},- "other": {"en": "Other", "pt-BR": "Outros", "pt-PT": "Outros", "de": "Sonstiges", "fr": "Autres", "nl": "Overig", "sk": "Ostatné", "icon": "circle-help", "color": "#6B7280"},-}--async def create_default_categories(session: AsyncSession,user_id: uuid.UUID,@@ -90,8 +70,8 @@ async def create_default_categories(groups = await create_default_groups(session, user_id, lang, workspace_id=workspace_id)categories = []- for key, data in DEFAULT_CATEGORIES_I18N.items():- name = data.get(lang, data.get("en", key))+ for key, data in DEFAULT_CATEGORIES.items():+ name = localized_name(data, lang)group_key = CATEGORY_TO_GROUP.get(key)group = groups.get(group_key) if group_key else Nonecategory = Category(diff --git a/backend/app/services/rule_service.py b/backend/app/services/rule_service.pyindex edbebd38..089e2ebd 100644--- a/backend/app/services/rule_service.py+++ b/backend/app/services/rule_service.py@@ -19,17 +19,20 @@ from app.schemas.rule import (RulePreviewResponse,RuleUpdate,)-+from app.services.category_defaults import (+ CATEGORY_TO_GROUP,+ DEFAULT_CATEGORIES,+ DEFAULT_GROUPS,+ localized_name,+ name_variants,+)from app.services.category_service import get_assignable_category_ids-from app.services.rule_engine import (apply_rule_actions,compile_rule_regex,evaluate_conditions,)-from app.services.category_service import DEFAULT_CATEGORIES_I18N-class DuplicateRuleError(Exception):"""Raised when a rule with the same name already exists for a user."""@@ -581,11 +584,8 @@ def _resolve_categories_by_internal_key(which language the user's categories were created in."""key_to_id: dict[str, str] = {}- non_name_fields = {"icon", "color", "treat_as_transfer"}- for internal_key, data in DEFAULT_CATEGORIES_I18N.items():- for field, value in data.items():- if field in non_name_fields:- continue+ for internal_key, data in DEFAULT_CATEGORIES.items():+ for value in data["names"].values():cat_id = categories_by_name.get(value)if cat_id:key_to_id[internal_key] = cat_id@@ -720,16 +720,6 @@ async def _ensure_categories_for_keys(happens to be pt-BR. Returns the count of newly-created categories."""from app.models.category_group import CategoryGroup- from app.services.category_group_service import (- CATEGORY_TO_GROUP,- DEFAULT_GROUPS_I18N,- )- from app.services.category_service import DEFAULT_CATEGORIES_I18N-- non_name_fields = {"icon", "color", "treat_as_transfer", "position"}-- def variants(data: dict) -> set[str]:- return {v for k, v in data.items() if k not in non_name_fields}existing_cats = list((@@ -747,8 +737,8 @@ async def _ensure_categories_for_keys(missing_keys = [keyfor key in internal_keys- if (data := DEFAULT_CATEGORIES_I18N.get(key))- and not (variants(data) & existing_cat_names)+ if (data := DEFAULT_CATEGORIES.get(key))+ and not (name_variants(data) & existing_cat_names)]if not missing_keys:return 0@@ -770,11 +760,11 @@ async def _ensure_categories_for_keys(}groups_by_key: dict[str, CategoryGroup] = {}for gkey in needed_group_keys:- gdata = DEFAULT_GROUPS_I18N.get(gkey)+ gdata = DEFAULT_GROUPS.get(gkey)if not gdata:continuematch = next(- (g for g in existing_groups if g.name in variants(gdata)), None+ (g for g in existing_groups if g.name in name_variants(gdata)), None)if match:groups_by_key[gkey] = match@@ -782,7 +772,7 @@ async def _ensure_categories_for_keys(group = CategoryGroup(user_id=user_id,workspace_id=workspace_id,- name=gdata.get(lang, gdata["en"]),+ name=localized_name(gdata, lang),icon=gdata["icon"],color=gdata["color"],position=gdata["position"],@@ -793,12 +783,12 @@ async def _ensure_categories_for_keys(await session.flush()for key in missing_keys:- data = DEFAULT_CATEGORIES_I18N[key]+ data = DEFAULT_CATEGORIES[key]target_group = groups_by_key.get(CATEGORY_TO_GROUP.get(key))cat = Category(user_id=user_id,workspace_id=workspace_id,- name=data.get(lang, data["en"]),+ name=localized_name(data, lang),icon=data["icon"],color=data["color"],is_system=True,diff --git a/backend/pyproject.toml b/backend/pyproject.tomlindex e42a7967..034ca9ee 100644--- a/backend/pyproject.toml+++ b/backend/pyproject.toml@@ -72,6 +72,11 @@ dev = [[tool.setuptools.packages.find]include = ["app*"]+[tool.setuptools.package-data]+# Ship the category taxonomy in wheels/non-editable installs; without this it+# only exists in editable (-e) installs and the backend crashes at import.+app = ["data/*.json"]+[tool.pytest.ini_options]# Fail on configuration/marker typos, duplicate parameter IDs and unexpected# xfail passes instead of silently weakening the suite.diff --git a/backend/tests/test_category_group_service.py b/backend/tests/test_category_group_service.pyindex 5ffc177a..dc1b1ef1 100644--- a/backend/tests/test_category_group_service.py+++ b/backend/tests/test_category_group_service.py@@ -6,8 +6,8 @@ from sqlalchemy.ext.asyncio import AsyncSessionfrom app.models.category import Categoryfrom app.schemas.category_group import CategoryGroupCreate, CategoryGroupUpdate+from app.services.category_defaults import DEFAULT_GROUPSfrom app.services.category_group_service import (- DEFAULT_GROUPS_I18N,create_default_groups,create_group,delete_group,@@ -27,7 +27,7 @@ async def test_create_default_groups(session: AsyncSession, test_user, test_workgroups = await create_default_groups(session, test_user.id, lang="pt-BR")await session.commit()- assert len(groups) == len(DEFAULT_GROUPS_I18N)+ assert len(groups) == len(DEFAULT_GROUPS)assert "housing" in groupsassert "food" in groupsassert "income" in groups@@ -113,7 +113,7 @@ async def test_get_groups_ordered_by_position(session: AsyncSession, test_user,await session.commit()groups = await get_groups(session, test_workspace.id)- assert len(groups) == len(DEFAULT_GROUPS_I18N)+ assert len(groups) == len(DEFAULT_GROUPS)positions = [g.position for g in groups]assert positions == sorted(positions)diff --git a/backend/tests/test_category_service.py b/backend/tests/test_category_service.pyindex b5a9a113..90f78d86 100644--- a/backend/tests/test_category_service.py+++ b/backend/tests/test_category_service.py@@ -1,4 +1,5 @@import uuid+from pathlib import Pathimport pytestfrom sqlalchemy import select@@ -8,8 +9,13 @@ from app.models.category import Categoryfrom app.models.category_group import CategoryGroupfrom app.schemas.category import CategoryCreate, CategoryUpdatefrom app.services.category_group_service import get_groups+from app.services.category_defaults import (+ DEFAULT_CATEGORIES,+ DEFAULT_GROUPS,+ localized_name,+ name_variants,+)from app.services.category_service import (- DEFAULT_CATEGORIES_I18N,create_category,create_default_categories,delete_category,@@ -17,6 +23,7 @@ from app.services.category_service import (get_category,update_category,)+from app.services.rule_service import _ensure_categories_for_keys# ---------------------------------------------------------------------------@@ -28,7 +35,7 @@ from app.services.category_service import (async def test_create_default_categories(session: AsyncSession, test_user, test_workspace):categories = await create_default_categories(session, test_user.id, lang="pt-BR")- assert len(categories) == len(DEFAULT_CATEGORIES_I18N)+ assert len(categories) == len(DEFAULT_CATEGORIES)names = {c.name for c in categories}assert "Moradia" in names@@ -44,7 +51,7 @@ async def test_create_default_categories(session: AsyncSession, test_user, test_async def test_create_default_categories_german(session: AsyncSession, test_user, test_workspace):categories = await create_default_categories(session, test_user.id, lang="de")- assert len(categories) == len(DEFAULT_CATEGORIES_I18N)+ assert len(categories) == len(DEFAULT_CATEGORIES)names = {c.name for c in categories}assert "Wohnen" in names@@ -60,7 +67,7 @@ async def test_create_default_categories_german(session: AsyncSession, test_userasync def test_create_default_categories_french(session: AsyncSession, test_user, test_workspace):categories = await create_default_categories(session, test_user.id, lang="fr")- assert len(categories) == len(DEFAULT_CATEGORIES_I18N)+ assert len(categories) == len(DEFAULT_CATEGORIES)names = {c.name for c in categories}assert "Logement" in names@@ -76,7 +83,7 @@ async def test_create_default_categories_french(session: AsyncSession, test_userasync def test_create_default_categories_european_portuguese(session: AsyncSession, test_user, test_workspace):categories = await create_default_categories(session, test_user.id, lang="pt-PT")- assert len(categories) == len(DEFAULT_CATEGORIES_I18N)+ assert len(categories) == len(DEFAULT_CATEGORIES)names = {c.name for c in categories}assert "Habitação" in names@@ -104,7 +111,7 @@ async def test_create_default_categories_links_to_groups(session: AsyncSession,categories = await create_default_categories(session, test_user.id, lang="pt-BR")with_group = [c for c in categories if c.group_id is not None]- assert len(with_group) == len(DEFAULT_CATEGORIES_I18N)+ assert len(with_group) == len(DEFAULT_CATEGORIES)@pytest.mark.asyncio@@ -117,6 +124,98 @@ async def test_create_default_categories_english(session: AsyncSession, test_useassert "Transport" in names+ "lang", ["es", "it", "pl", "ru", "uk", "nl", "sk", "hu", "cs", "el", "hi", "ja"]+)+async def test_create_default_categories_localized(session: AsyncSession, test_user, test_workspace, lang):+ categories = await create_default_categories(session, test_user.id, lang=lang)++ assert len(categories) == len(DEFAULT_CATEGORIES)++ names = {c.name for c in categories}+ assert names == {data["names"][lang] for data in DEFAULT_CATEGORIES.values()}++ for cat in categories:+ assert cat.is_system is True++ groups = await get_groups(session, test_workspace.id, include_hidden=True)+ group_names = {g.name for g in groups}+ assert group_names == {data["names"][lang] for data in DEFAULT_GROUPS.values()}+++def test_default_taxonomy_covers_all_supported_languages():+ """Read the languages off the UI bundles instead of repeating them here.++ A hand-written list is a copy, and a copy goes stale the moment a locale+ PR lands: the taxonomy then seeds English for the new language and nothing+ says so. Deriving the list means adding `frontend/src/locales/xx.json`+ fails this test until the taxonomy covers `xx` too.+ """+ locales = Path(__file__).resolve().parents[2] / "frontend" / "src" / "locales"+ if not locales.is_dir():+ pytest.skip("frontend locales not available outside a full checkout")+ langs = sorted(p.stem for p in locales.glob("*.json"))+ assert "en" in langs, f"no locale bundles found in {locales}"++ entries = {f"category '{k}'": d for k, d in DEFAULT_CATEGORIES.items()} | {+ f"group '{k}'": d for k, d in DEFAULT_GROUPS.items()+ }+ for label, data in entries.items():+ for lang in langs:+ assert lang in data["names"], f"{label} is missing a '{lang}' translation"+++def test_localized_name_falls_back_safely():+ entry = {"names": {"en": "Housing", "es": "Vivienda"}}+ assert localized_name(entry, "es") == "Vivienda"+ assert localized_name(entry, "xx") == "Housing"+ # No English either: any available translation beats an exception.+ assert localized_name({"names": {"de": "Wohnen"}}, "xx") == "Wohnen"+++def test_aliases_are_matched_but_never_seeded():+ housing = DEFAULT_GROUPS["housing"]+ assert "Alojamiento" in name_variants(housing)+ assert localized_name(housing, "es") == "Vivienda"+++async def test_ensure_categories_reuses_group_under_former_spanish_name(+ session: AsyncSession, test_user, test_workspace+):+ """A Spanish workspace seeded before the rename still has "Alojamiento";+ importing a housing rule must file into it, not add a "Vivienda" twin."""+ legacy = CategoryGroup(+ user_id=test_user.id,+ workspace_id=test_workspace.id,+ name="Alojamiento",+ icon="house",+ color="#8B5CF6",+ position=0,+ is_system=True,+ )+ session.add(legacy)+ await session.flush()++ created = await _ensure_categories_for_keys(+ session, test_workspace.id, test_user.id, {"housing"}, "es"+ )++ assert created == 1+ groups = await get_groups(session, test_workspace.id, include_hidden=True)+ assert [g.name for g in groups] == ["Alojamiento"]+ housing = (+ await session.execute(+ select(Category).where(+ Category.workspace_id == test_workspace.id,+ Category.name == "Vivienda",+ )+ )+ ).scalar_one()+ assert housing.group_id == legacy.id++@pytest.mark.asyncioasync def test_create_default_categories_race_guard(session: AsyncSession, test_user, test_workspace):"""Second call should return existing instead of duplicating."""