moolah

Moolah — Household Finance & Investment SaaS

Moolah is a multi-tenant personal finance application built with Go, focusing on simplicity, scalability, and financial integrity. It helps households manage their accounts payable, cash flow, credit card installments, and investment portfolios.

🚀 Technical Stack

• Backend: Go 1.26.1 (Standard library net/http for routing).
• Database: PostgreSQL (Querying via sqlc).
• Identity: ULID for all primary keys.
• Security: PASETO v4 tokens and OTP-only authentication.
• Infrastructure: Docker & Docker Compose.
• Linter: golangci-lint.

🏗️ Project Structure

Following a Pragmatic DDD approach:

• cmd/api/: Application entry point and DI.
• internal/domain/: Business logic, entities, and repository interfaces.
• internal/platform/: Infrastructure implementations (DB, Mailer, Middleware).
• internal/service/: Domain orchestration and business rules.
• pkg/: Generic utilities.
• docs/: Architecture Decision Records (ADRs) and Roadmap.

🛠️ Development

Prerequisites

• Go 1.26.1+
• Docker & Docker Compose
• golangci-lint
• sqlc

Getting Started

1. Clone the repository:

   git clone https://github.com/garnizeh/moolah.git
   cd moolah
   

2. Spin up infrastructure:

   docker-compose up -d
   

3. Run the application:

   make run
   

Makefile Commands

• make build: Build the API binary.
• make test: Run unit tests.
• make lint: Run the linter.
• make generate: Generate code from SQL queries using sqlc.

📈 Roadmap

See docs/ROADMAP.md for the detailed project roadmap and current status.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.