How sebasvelasco353/nummus works
Nummus is a self-hosted home-finance tracker with a Go/Gin API and PostgreSQL. The visible user workflow covers signup and login, token-based access, and authenticated account management; refresh and logout manage sessions. The README also names categories and transactions as part of the finance domain, though this tree shows their migrations rather than API handlers. The sampled source supports the API, auth, and account relationships; unsampled capabilities and database schema links are shown only where documentation or the tree supports them.
Main entry points: main.go API startup · users.model.go User operations · users.controller.go User handlers · config.go Server config
Components 17
API runtime
- API startup
server/cmd/main.go - User routes
server/internal/users/users.routes.go - Account routes
server/internal/accounts/accounts.routes.go
Identity and sessions
- User handlers
server/internal/users/users.controller.go - User operations
server/internal/users/users.model.go - JWT middleware
server/internal/middleware/auth.go - Access tokens
server/internal/auth/accessToken.go - Refresh tokens
server/internal/auth/refreshToken.go - Password hashing
server/internal/auth/password.go - Token hashing
server/internal/utils/hash.go
Finance domain
- Account handlers
server/internal/accounts/accounts.controller.go - Account operations
server/internal/accounts/accounts.model.go - Finance schema
server/internal/database/migrations
Persistence
- Server config
server/internal/config/config.go - Database connection
server/internal/config/database.go - PostgreSQL
Other components
- Web client
Connections 22
- Web client → API startup: sends requests
README.md - API startup → Server config: loads settings
server/cmd/main.go - API startup → Database connection: connects database
server/cmd/main.go - API startup → User routes: registers routes
server/cmd/main.go - API startup → Account routes: registers routes
server/cmd/main.go - User routes → User handlers: routes requests
server/internal/users/users.routes.go - Account routes → Account handlers: routes requests
server/internal/accounts/accounts.routes.go - User routes → JWT middleware: protects profile
server/internal/users/users.routes.go - Account routes → JWT middleware: protects accounts
server/internal/accounts/accounts.routes.go - User handlers → User operations: runs signup/login
server/internal/users/users.controller.go - User handlers → Refresh tokens: rotates sessions
server/internal/users/users.controller.go - User handlers → Token hashing: hashes cookie token
server/internal/users/users.controller.go - User operations → Password hashing: hashes credentials
server/internal/users/users.model.go - User operations → Access tokens: issues access token
server/internal/users/users.model.go - User operations → Refresh tokens: persists refresh token
server/internal/users/users.model.go - JWT middleware → Access tokens: validates token
server/internal/middleware/auth.go - Account handlers → Account operations: runs account operations
server/internal/accounts/accounts.controller.go - Account operations → Server config: queries database
server/internal/accounts/accounts.model.go - User operations → Server config: queries database
server/internal/users/users.model.go - Refresh tokens → Server config: queries database
server/internal/auth/refreshToken.go - Database connection → PostgreSQL: opens connection
server/internal/config/database.go - Finance schema → PostgreSQL: defines finance tables
README.md