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.
This commit is contained in:
ZProger
2026-08-16 18:39:52 +03:00
commit fe9b079c12
199 changed files with 14410 additions and 0 deletions

View File

@@ -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>
);
}

View File

@@ -0,0 +1,85 @@
import { Pencil, Trash2 } from "lucide-react";
import { getCategoryIcon } from "@/lib/icons";
import { formatCurrency } from "@/lib/format";
import { useTranslation } from "@/lib/i18n";
import { translateCategoryName } from "@/lib/categoryLabels";
import type { BudgetStatus } from "@/types";
interface BudgetListProps {
items: BudgetStatus[];
onEdit: (item: BudgetStatus) => void;
onDelete: (item: BudgetStatus) => void;
}
export function BudgetList({ items, onEdit, onDelete }: BudgetListProps) {
const { t } = useTranslation();
if (items.length === 0) {
return <p className="py-10 text-center text-sm text-text-muted">{t("budget.empty")}</p>;
}
return (
<ul className="divide-y divide-gridline">
{items.map((item) => {
const Icon = getCategoryIcon(item.category_icon);
const spent = Number(item.spent);
const limit = Number(item.monthly_limit);
const barColor = item.is_over_budget ? "var(--danger)" : "var(--success)";
const fillPercent = Math.min(100, item.percent);
return (
<li key={item.budget_id} className="py-3">
<div className="flex items-center gap-3">
<span
className="flex h-9 w-9 shrink-0 items-center justify-center rounded-full"
style={{ backgroundColor: `${item.category_color}26` }}
>
<Icon size={16} style={{ color: item.category_color }} />
</span>
<span className="min-w-0 flex-1 truncate text-sm font-medium text-text-primary">
{translateCategoryName(item.category_name)}
</span>
<span className="shrink-0 text-sm tabular-nums text-text-primary">
{formatCurrency(spent)} <span className="text-text-muted">/ {formatCurrency(limit)}</span>
</span>
<span className="flex shrink-0 gap-1">
<button
type="button"
aria-label={t("common.edit")}
onClick={() => onEdit(item)}
className="rounded-md p-1.5 text-text-muted hover:bg-surface-2 hover:text-text-primary"
>
<Pencil size={15} />
</button>
<button
type="button"
aria-label={t("common.delete")}
onClick={() => onDelete(item)}
className="rounded-md p-1.5 text-text-muted hover:bg-surface-2 hover:text-danger"
>
<Trash2 size={15} />
</button>
</span>
</div>
<div className="mt-2 flex items-center gap-2 pl-12">
<span className="h-1.5 flex-1 overflow-hidden rounded-full bg-surface-2">
<span
className="block h-full rounded-full"
style={{ width: `${fillPercent}%`, backgroundColor: barColor }}
/>
</span>
<span className="w-10 shrink-0 text-right text-xs tabular-nums text-text-muted">
{item.percent.toFixed(0)}%
</span>
</div>
<p className="mt-1 pl-12 text-xs" style={{ color: item.is_over_budget ? "var(--danger)" : "var(--text-muted)" }}>
{item.is_over_budget
? t("budget.overBy", { amount: formatCurrency(spent - limit) })
: t("budget.remaining", { amount: formatCurrency(limit - spent) })}
</p>
</li>
);
})}
</ul>
);
}