Somma

Personal finance and vehicle fleet management platform split into two integrated modules sharing a PostgreSQL database.

Architecture

apps/
  somma-expenses/
    backend/          Go API (Port 3300)
    web/              React frontend (Port 3400)
  somma-vehicles/
    backend/          Go API (Port 3310)
    web/              React frontend (Port 3410)
  doc/                OpenAPI specification and Swagger UI
database/
  migrations/         Shared SQL migrations
  seeds/              Seed data scripts
  cmd/migrate/        Database migration CLI
docker-compose.yml     Docker orchestration
go.work               Go workspace config

Modules

• somma-expenses: Personal finance module (income, expenses, budgets, categories, analytics).
• somma-vehicles: Vehicle and fuel refill log module (consumption tracking, cost/km, odometer history).

Shared Database Integration

Both modules connect to the same somma PostgreSQL database and share user authentication tables. When a refueling log is saved in somma-vehicles, a corresponding transaction is automatically generated in somma-expenses under the EXPENSE type and Fuel category. Cascading deletes and foreign keys maintain synchronization across both services.

Development

Prerequisites

• Go 1.25+
• Node.js 22+
• Docker / Podman

Running Services

Start all containers, migrations, and seeds:

make up

Service Endpoints

Service	Type	Port	Endpoint
Expenses Web	Frontend	3400	http://localhost:3400
Expenses API	Backend	3300	http://localhost:3300
Vehicles Web	Frontend	3410	http://localhost:3410
Vehicles API	Backend	3310	http://localhost:3310
PostgreSQL	Database	5454	localhost:5454/somma

Documentation

• 📋 Roadmap & TODOs - Planned features and project roadmap
• 📐 Architecture - System architecture and components