Skip to content

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.json
new file mode 100644
index 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.py
new file mode 100644
index 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.py
index 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 selectinload
from app.models.category import Category
from app.models.category_group import CategoryGroup
from app.schemas.category_group import CategoryGroupCreate, CategoryGroupUpdate
+from app.services.category_defaults import DEFAULT_GROUPS, localized_name
class 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 key
async 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.py
index 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 RecurringTransaction
from app.models.rule import Rule
from app.models.transaction import Transaction
from 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_groups
class 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 None
category = Category(
diff --git a/backend/app/services/rule_service.py b/backend/app/services/rule_service.py
index 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 = [
key
for 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:
continue
match = 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.toml
index 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.py
index 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 AsyncSession
from app.models.category import Category
from app.schemas.category_group import CategoryGroupCreate, CategoryGroupUpdate
+from app.services.category_defaults import DEFAULT_GROUPS
from 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_work
groups = 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 groups
assert "food" in groups
assert "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.py
index 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 Path
import pytest
from sqlalchemy import select
@@ -8,8 +9,13 @@ from app.models.category import Category
from app.models.category_group import CategoryGroup
from app.schemas.category import CategoryCreate, CategoryUpdate
from 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_user
async 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_user
async 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_use
assert "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.asyncio
async def test_create_default_categories_race_guard(session: AsyncSession, test_user, test_workspace):
"""Second call should return existing instead of duplicating."""