How oonexusoo/personal-finance-manager works
Personal Finance Manager is a Go service for user accounts, income and expense tracking, categorization, receipt attachments, live balance updates, and currency conversion. The main workflow is an authenticated client request routed by the API to transaction or category handlers, with services and repositories applying domain logic and persisting data in PostgreSQL; transaction changes can trigger a user-specific WebSocket balance update. Currency requests are proxied by the API to a separate gRPC service. The README documents the major capabilities; arrows reflect only relationships visible in sampled files or README, so unsampled subsystem links are omitted.
Main entry points: main.go HTTP API · transactions/handler.go Transaction endpoints · service.go Identity service · websocket/handler.go WebSocket handler
Components 21
API and identity
- HTTP API
cmd/api/main.go - Account endpoints
internal/auth/handler.go - Identity service
internal/auth/service.go - User repository
internal/auth/repository.go - JWT middleware
internal/auth/middleware.go
Finance domain
- Transaction endpoints
internal/transactions/handler.go - Transaction service
internal/transactions/service.go - Transaction repository
internal/transactions/repository.go - Category endpoints
internal/categories/handler.go - Category service
internal/categories/service.go - Category repository
internal/categories/repository.go - Receipt files
internal/transactions/handler.go
Live updates
- WebSocket handler
internal/websocket/handler.go - User broadcast hub
internal/websocket/hub.go
Currency conversion
- Currency API routes
cmd/api/main.go - gRPC currency client
internal/currency/client.go - Currency service
internal/currency/server.go - gRPC server
cmd/grpc-server/main.go
Persistence
- PostgreSQL
internal/database/postgres.go - Domain models
internal/models/models.go
Other components
- Finance client
Connections 23
- Finance client → HTTP API: sends requests
README.md - HTTP API → Account endpoints: routes auth
cmd/api/main.go - HTTP API → Transaction endpoints: routes transactions
cmd/api/main.go - HTTP API → Category endpoints: routes categories
cmd/api/main.go - HTTP API → JWT middleware: guards routes
cmd/api/main.go - HTTP API → WebSocket handler: routes WebSocket
cmd/api/main.go - Account endpoints → Identity service: calls
internal/auth/handler.go - Identity service → User repository: reads and writes
internal/auth/service.go - JWT middleware → Identity service: validates tokens
internal/auth/middleware.go - Transaction endpoints → Transaction service: calls
internal/transactions/handler.go - Transaction endpoints → Transaction repository: attachment access
internal/transactions/handler.go - Transaction endpoints → Receipt files: stores and serves
internal/transactions/handler.go - Transaction service → Transaction repository: queries transactions
internal/transactions/service.go - Category endpoints → Category service: calls
internal/categories/handler.go - Category service → Category repository: queries categories
internal/categories/service.go - HTTP API → Transaction repository: queries balance
cmd/api/main.go - HTTP API → User broadcast hub: broadcasts balance
cmd/api/main.go - WebSocket handler → User broadcast hub: registers clients
internal/websocket/handler.go - Finance client → WebSocket handler: opens connection
README.md - HTTP API → Currency API routes: configures routes
cmd/api/main.go - Currency API routes → gRPC currency client: requests rates or conversion
cmd/api/main.go - gRPC currency client → gRPC server: calls gRPC
internal/currency/client.go - gRPC server → Currency service: registers service
cmd/grpc-server/main.go