Initial public release

Aurum — a self-hosted personal finance operating system: cash flow,
net worth tracking, budgets, goals, recurring payments, reports,
proactive alerts, and a compound-interest returns calculator, all
bilingual (RU/EN) and mobile-first. Ships as a three-container Docker
Compose stack (Postgres + FastAPI + nginx-served React frontend).

See README.md for setup and CONTRIBUTING.md for development.

frontend/src/components/budget/BudgetFormModal.tsx

@@ -0,0 +1,112 @@
+import { useEffect, useState } from "react";
+import { Dialog } from "@/components/ui/Dialog";
+import { Button } from "@/components/ui/Button";
+import { Input, Label, Select } from "@/components/ui/Input";
+import { useCategories } from "@/hooks/useCategories";
+import { useCreateBudget, useUpdateBudget } from "@/hooks/useBudgets";
+import { useTranslation } from "@/lib/i18n";
+import { translateCategoryName } from "@/lib/categoryLabels";
+import type { Budget } from "@/types";
+
+interface BudgetFormModalProps {
+  open: boolean;
+  onClose: () => void;
+  budget?: Budget | null;
+  /** Expense categories that already have a budget — excluded from the
+   * create picker since each category can only carry one budget. */
+  excludeCategoryIds: number[];
+}
+
+export function BudgetFormModal({ open, onClose, budget, excludeCategoryIds }: BudgetFormModalProps) {
+  const { t, language } = useTranslation();
+  const { data: categories } = useCategories();
+  const createBudget = useCreateBudget();
+  const updateBudget = useUpdateBudget();
+
+  const [categoryId, setCategoryId] = useState("");
+  const [monthlyLimit, setMonthlyLimit] = useState("");
+  const [error, setError] = useState<string | null>(null);
+
+  const availableCategories = (categories ?? [])
+    .filter((category) => category.kind === "expense" && !excludeCategoryIds.includes(category.id))
+    .sort((a, b) => translateCategoryName(a.name).localeCompare(translateCategoryName(b.name), language));
+
+  useEffect(() => {
+    if (!open) return;
+    if (budget) {
+      setCategoryId(String(budget.category_id));
+      setMonthlyLimit(budget.monthly_limit);
+    } else {
+      setCategoryId(availableCategories[0] ? String(availableCategories[0].id) : "");
+      setMonthlyLimit("");
+    }
+    setError(null);
+    // availableCategories is derived from `categories`, not a stable dep — only re-run on open/budget change.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open, budget]);
+
+  const isSaving = createBudget.isPending || updateBudget.isPending;
+
+  async function handleSubmit(event: React.FormEvent) {
+    event.preventDefault();
+    setError(null);
+
+    try {
+      if (budget) {
+        await updateBudget.mutateAsync({ id: budget.id, monthlyLimit });
+      } else {
+        await createBudget.mutateAsync({ category_id: Number(categoryId), monthly_limit: monthlyLimit });
+      }
+      onClose();
+    } catch {
+      setError(t("budget.form.saveError"));
+    }
+  }
+
+  return (
+    <Dialog open={open} onClose={onClose} title={budget ? t("budget.form.editTitle") : t("budget.form.newTitle")}>
+      <form onSubmit={handleSubmit} className="space-y-3">
+        <div>
+          <Label htmlFor="budget-category">{t("budget.form.categoryLabel")}</Label>
+          {budget ? (
+            <p className="text-sm text-text-primary">{translateCategoryName(budget.category_name)}</p>
+          ) : availableCategories.length === 0 ? (
+            <p className="text-sm text-text-muted">{t("budget.form.noCategoriesAvailable")}</p>
+          ) : (
+            <Select id="budget-category" required value={categoryId} onChange={(event) => setCategoryId(event.target.value)}>
+              {availableCategories.map((category) => (
+                <option key={category.id} value={category.id}>
+                  {translateCategoryName(category.name)}
+                </option>
+              ))}
+            </Select>
+          )}
+        </div>
+
+        <div>
+          <Label htmlFor="budget-limit">{t("budget.form.limitLabel")}</Label>
+          <Input
+            id="budget-limit"
+            type="number"
+            step="0.01"
+            min="0.01"
+            required
+            value={monthlyLimit}
+            onChange={(event) => setMonthlyLimit(event.target.value)}
+          />
+        </div>
+
+        {error && <p className="text-sm text-danger">{error}</p>}
+
+        <div className="flex justify-end gap-2 pt-2">
+          <Button type="button" variant="ghost" onClick={onClose}>
+            {t("common.cancel")}
+          </Button>
+          <Button type="submit" disabled={isSaving || (!budget && availableCategories.length === 0)}>
+            {isSaving ? t("common.saving") : t("common.save")}
+          </Button>
+        </div>
+      </form>
+    </Dialog>
+  );
+}