Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Budget Planner

A secure, localhost-only personal finance and budget analytics application modeled after corporate card reconciliation workflows (e.g., Ramp).

Status: v1 built · end-to-end smoke-tested · ⚠️ not yet validated against real bank statements

What it does

Upload PDF statements (Wells Fargo, Chase, Discover). Every parsed transaction lands in an Unreconciled Inbox — nothing reaches the analytics ledger until you manually type what the purchase actually was and categorize it. Categorization is driven by your memo, not the raw merchant name. The Analytics dashboard (burn rate, top-3 categories, subscriptions, cutback suggestions) is built only from reconciled data.

For: personal use. 100% local — all data stays in prisma/dev.db on your machine.

Quick start

# One-time setup
npm install
npm run db:push
npm run db:seed
python -m venv .venv
.venv\Scripts\pip install -r parser\requirements.txt

# Run (boots parser + web together)
npm run start:all

Open http://127.0.0.1:3000.

The parser runs on port 8000 and has no homepage — visiting 127.0.0.1:8000 directly returns 404; that's expected. The app is on 3000.

Prefer separate logs? Use two terminals: npm run parser and npm run dev.

Docs

  • CONTEXT.md — the memory file. Everything needed to pick up cold: goals, exact instructions, stack, decisions, architecture, file map. Upload this to start a new session.
  • PROGRESS.md — changelog, feature status, known issues.
  • ROADMAP.md — the single prioritized "what's next".

Tests

.venv\Scripts\python -m pytest parser   # parser unit tests (19)
npx tsc --noEmit                         # type-check
npm run build                            # production build

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages