Open Budget App

🏗️ Arquitectura del Proyecto: “Open Budget App”

🔧 Stack

  • Backend: Ruby on Rails (API or Full MVC)
  • Base de datos: PostgreSQL
  • Frontend: (opcional) Hotwire (Turbo/Stimulus).
  • Autenticación: Devise o Sorcery
  • Control de versiones: Git + GitHub
  • Hosting: Coolify + Hostinguer.

📦 Modelos Principales y Relaciones

User
 └── has_many :budgets

Budget
 └── belongs_to :user
 └── has_many :budget_items
 └── has_many :expenses

BudgetItem (categoría planificada)
 └── belongs_to :budget
 └── category:string (ej. "Gastos Fijos")
 └── subcategory:string (ej. "Renta")
 └── estimated_amount:decimal

Categories (Expenses clasification)
 └── belongs_to :user
 └── has_manu :expenses
 └── has_many :budget_items
 └── t.string :name
 └── t.string :color (optional for UI tags)

Expense (gasto real)
 └── belongs_to :budget, optional: true
 └── category:string
 └── subcategory:string
 └── description:string
 └── amount:decimal
 └── spent_on:date

🗂️ Estructura de Base de Datos (schema.rb simplificado)

create_table "users" do |t|
  t.string "email", null: false
  t.string "encrypted_password"
  t.timestamps
end

create_table "budgets" do |t|
  t.references "user", foreign_key: true
  t.string "name"
  t.date "start_date"
  t.date "end_date"
  t.timestamps
end

create_table "budget_items" do |t|
  t.references "budget", foreign_key: true
  t.string "category"
  t.string "subcategory"
  t.decimal "estimated_amount", precision: 10, scale: 2
  t.timestamps
end

create_table "expenses" do |t|
  t.references "budget", foreign_key: true, null: true
  t.string "category"
  t.string "subcategory"
  t.string "description"
  t.decimal "amount", precision: 10, scale: 2
  t.date "spent_on"
  t.timestamps
end

🧠 Funcionalidades Clave (MVP)

Autenticación

  • Registro e inicio de sesión de usuarios (Devise)

Presupuestos

  • Crear presupuesto mensual (con fecha inicio y fin)
  • Añadir categorías planificadas (budget_items)
  • Registrar gastos diarios (expenses)
  • Comparar estimado vs real (gráfica o tabla)
  • Calcular diferencias por categoría

Visualización

  • Dashboard con resumen mensual (ingresos, gastos, ahorro)
  • Gráfica de pastel: % por categoría
  • Historial de presupuestos pasados

Extra (para después del MVP)

  • Recordatorios por email para registrar gastos
  • Reglas automáticas (clasificar gastos por descripción)
  • Exportar a Excel o PDF

🧪 Pruebas y Mantenimiento

  • Tests con RSpec + FactoryBotgas
  • Linter (RuboCop)
  • Deploy automático con GitHub Actions

¿Te gustaría que te prepare el código base inicial (rails new) ya con los modelos y controladores básicos generados, o prefieres que primero diseñemos las vistas o API endpoints?

FAQs

  • What happens if we remove a budget and only expenses remain?
    • We decouple expenses from budgets, so if a budget is removed, then we still keep expenses, wich are usefull for expenses tracking purposes.
  • Shall we suport categories? - Yes, we should do.

References