Telegram Finance Bot

Personal-finance bot for two whitelisted users (author + partner). Records expenses, income, and transfers through a strict double-entry ledger; reports daily and monthly summaries; supports voiding individual transactions.

Status: MVP-1 functional scope shipped (Plans 1–14). Production-deployed on a single VPS via Docker Compose for two whitelisted Telegram users.

Why this is in the portfolio: the project is small enough to document end-to-end yet has all the artifacts a corporate SA produces — SRS, ADRs, diagrams, implementation plans — without the regulatory weight that often constrains real-world documentation.

Documentation

• System Requirements Specification — full SRS, reverse-engineered from code, design doc, and 22 ADRs.
• Architecture Decision Records — 6 of 22 ADRs migrated for portfolio. Lean format.
• Diagrams:
  • C4 Context
  • ERD
  • Sequence — Record Expense
  • Sequence — Void
  • State — Transaction Lifecycle
• Implementation Plans — chronological record of how the design was turned into shipped code.

Constraints

• Audience: 2 whitelisted users (author + partner). Not designed for SaaS scale.
• Hosting: single VPS, Docker Compose. No K8s, no managed services beyond the VPS.
• Data sovereignty: all data stays on operator-controlled hardware. No third-party logging, no telemetry leaving the host.