How rafaelfcarneiro/patty works
PATTY is a local-first personal finance manager whose primary workflow is an AI client calling the MCP server; REST and a dashboard are additional surfaces. Requests reach shared controllers and domain logic, which operate on encrypted libSQL data. Authentication and client setup govern access, while finance capabilities include transaction tracking, budgeting, credit cards, recurring rules, and investments. The README documents these product branches; sampled source confirms MCP-to-controller reuse, HTTP route mounting, and database construction, but not every domain handler’s internal calls.
Main entry points: controllers Request controllers · driver.ts Encrypted SQLite file · auth.ts Authentication · server.ts MCP server
Components 20
User interfaces
- MCP server
src/diplomat/mcp/server.ts - REST and UI
src/diplomat/http/routes.ts - CLI setup
src/diplomat/cli/commands.ts
Finance domain
- Request controllers
src/controllers - Transactions
src/controllers/transaction/core.ts - Accounts and transfers
src/controllers/account/account.ts - Budgets and categories
src/controllers/budgets.ts - Cards and bills
src/controllers/credit-card/credit-card.ts - Recurring rules
src/controllers/recurring.ts - Investments
src/controllers/investment/portfolio.ts - Import and export
src/composition/import.ts
Identity and setup
- Authentication
src/composition/auth.ts - Sign-in flow
src/composition/sign-in/wiring.ts - Client configuration
src/diplomat/client-config/clients.ts
Persistence
- OS keychain
- Database repositories
src/diplomat/db/repos - Encrypted SQLite file
src/diplomat/db/driver.ts - Database schema
src/diplomat/db/schema.ts
Other components
- AI client
- Finance user
Connections 18
- AI client → MCP server: requests finance actions
README.md - Finance user → REST and UI: uses dashboard
README.md - Finance user → CLI setup: runs setup
README.md - MCP server → Request controllers: delegates to
src/diplomat/mcp/server.ts - REST and UI → Request controllers: routes requests
src/diplomat/http/routes.ts - Request controllers → Transactions: handles domain requests
- Request controllers → Accounts and transfers: handles domain requests
- Request controllers → Budgets and categories: handles domain requests
- Request controllers → Cards and bills: handles domain requests
- Request controllers → Recurring rules: handles domain requests
- Request controllers → Investments: handles domain requests
- CLI setup → Client configuration: configures clients
README.md - Authentication → Sign-in flow: creates sign-in
src/composition/auth.ts - Authentication → Database repositories: builds dependencies
src/composition/auth.ts - Sign-in flow → OS keychain: stores sign-in
- Import and export → Encrypted SQLite file: moves finance data
- Database repositories → Encrypted SQLite file: reads and writes
src/diplomat/db/repos/client-grants.ts - Encrypted SQLite file → Database schema: uses schema
src/diplomat/db/driver.ts