Skip to content

Finance Manager Architecture

Welcome to the comprehensive architecture documentation for Finance Manager.

📚 Documentation

  • Quick Reference — 5-minute overview of deployment stack, data domains, and top improvements
  • System Diagrams — ASCII diagrams of all system layers, data flows, and security model
  • Detailed Reference — Complete technical reference with 20+ improvements and architecture decisions
  • Improvement Roadmap — Phased refactoring plan with effort estimates

🚀 Contributing

See Contributing for how to build locally and add new pages.

📖 Overview

This site provides:

  • System architecture — All layers: frontend, backend, database, external integrations
  • Data flows — How assets, transactions, and prices flow through the system
  • Security model — Encryption, blind indexing, fingerprinting for sensitive data
  • Improvement roadmap — 20+ architectural improvements prioritized by impact
  • Implementation guides — How to build and extend the system

🏗️ Architecture at a Glance

Frontend: React/Vite with Tailwind CSS + inline styles
Backend: FastAPI monolith (~50 endpoints)
Database: SQLAlchemy ORM (SQLite dev, PostgreSQL prod)
External APIs: Finnhub/Alpha Vantage (market data), Ollama (LLM categorization)
Deployment: Docker Compose stack on Uberspace

Last Updated: 2026-05-10
Documentation Version: 0.1.0