@@ -48,36 +69,116 @@ export function HomeDashboard() {
A calm local-first home for everyday spending.
- The dashboard is starting with the expense-tracking slice first: fast entry, visible history, and a live pulse on the current month.
+ Track expenses and paycheck timing together so the month-to-date picture stays honest.
-
- {recentExpenses.length === 0 ? (
-
- No expenses recorded yet. Start with one quick entry.
-
- ) : (
- recentExpenses.map((expense) => (
-
+
+ {snapshot?.recentExpenses.length ? (
+ snapshot.recentExpenses.map((expense) => (
+
{expense.title}
- {expense.date} · {getCategoryLabel(expense.category)}
+ {expense.date} · {getCategoryLabel(expense.category as never)}
{formatCurrencyFromCents(expense.amountCents)}
))
+ ) : (
+
+ No expenses recorded yet. Start with one quick entry.
+
)}
();
+ for (const expense of monthExpenses) {
+ categoryTotals.set(expense.category, (categoryTotals.get(expense.category) ?? 0) + expense.amountCents);
+ }
+
+ const categoryBreakdown = [...categoryTotals.entries()]
+ .map(([category, amountCents]) => ({ category, amountCents }))
+ .sort((left, right) => right.amountCents - left.amountCents);
+
+ const highestCategory = categoryBreakdown[0] ?? null;
+
+ const largestExpense =
+ monthExpenses
+ .slice()
+ .sort((left, right) => right.amountCents - left.amountCents || right.date.localeCompare(left.date))[0] ?? null;
+
+ const dailyMap = new Map();
+
+ for (const expense of monthExpenses) {
+ const current = dailyMap.get(expense.date) ?? { expensesCents: 0, paychecksCents: 0 };
+ current.expensesCents += expense.amountCents;
+ dailyMap.set(expense.date, current);
+ }
+
+ for (const paycheck of monthPaychecks) {
+ const current = dailyMap.get(paycheck.payDate) ?? { expensesCents: 0, paychecksCents: 0 };
+ current.paychecksCents += paycheck.amountCents;
+ dailyMap.set(paycheck.payDate, current);
+ }
+
+ const chart = [...dailyMap.entries()]
+ .map(([date, values]) => ({ date, ...values }))
+ .sort((left, right) => left.date.localeCompare(right.date));
+
+ return {
+ month: input.month,
+ totals: {
+ expensesCents,
+ paychecksCents,
+ netCashFlowCents,
+ averageDailySpendCents: Math.round(expensesCents / daysConsidered),
+ paycheckCoverageRatio: expensesCents > 0 ? paychecksCents / expensesCents : null,
+ },
+ comparisons: {
+ highestCategory,
+ largestExpense: largestExpense
+ ? {
+ title: largestExpense.title,
+ amountCents: largestExpense.amountCents,
+ date: largestExpense.date,
+ category: largestExpense.category,
+ }
+ : null,
+ },
+ categoryBreakdown,
+ recentExpenses: monthExpenses
+ .slice()
+ .sort((left, right) => right.date.localeCompare(left.date) || right.createdAt.getTime() - left.createdAt.getTime())
+ .slice(0, 6)
+ .map((expense) => ({
+ id: expense.id,
+ title: expense.title,
+ amountCents: expense.amountCents,
+ date: expense.date,
+ category: expense.category,
+ })),
+ chart,
+ };
+}
+
+export async function getDashboardSnapshot(month = getCurrentMonthKey()) {
+ const [expenses, paychecks] = await Promise.all([
+ db.expense.findMany({ orderBy: [{ date: "desc" }, { createdAt: "desc" }] }),
+ db.paycheck.findMany({ orderBy: [{ payDate: "desc" }, { createdAt: "desc" }] }),
+ ]);
+
+ return buildDashboardSnapshot({ month, expenses, paychecks });
+}
diff --git a/src/lib/date.ts b/src/lib/date.ts
index cc03655..8ec68cd 100644
--- a/src/lib/date.ts
+++ b/src/lib/date.ts
@@ -13,6 +13,10 @@ export function getCurrentMonthKey() {
return getMonthKeyFromLocalDate(getLocalToday());
}
+export function isCurrentMonthKey(month: string) {
+ return month === getCurrentMonthKey();
+}
+
export function isValidLocalDate(date: string) {
if (!LOCAL_DATE_PATTERN.test(date)) {
return false;
@@ -41,6 +45,15 @@ export function getMonthKeyFromLocalDate(date: string) {
return date.slice(0, 7);
}
+export function getDayOfMonthFromLocalDate(date: string) {
+ return Number.parseInt(date.slice(8, 10), 10);
+}
+
+export function getDaysInMonth(month: string) {
+ const [year, numericMonth] = month.split("-").map(Number);
+ return new Date(year, numericMonth, 0).getDate();
+}
+
export function isDateInMonth(date: string, month: string) {
return date.startsWith(`${month}-`);
}
diff --git a/src/lib/money.ts b/src/lib/money.ts
index 021557d..73343f8 100644
--- a/src/lib/money.ts
+++ b/src/lib/money.ts
@@ -20,3 +20,10 @@ export function formatCurrencyFromCents(value: number) {
maximumFractionDigits: 2,
}).format(value / 100);
}
+
+export function formatPercent(value: number) {
+ return new Intl.NumberFormat("en-US", {
+ style: "percent",
+ maximumFractionDigits: 0,
+ }).format(value);
+}