Finanzas — módulo de Convive

Gastos compartidos del hogar con splits (50/50, equitativo, porcentajes, importes personalizados), adjuntos de recibos y ciclo de pago (pending → claimed → confirmed).

Forma parte del ecosistema de Convive.

Instalación

Desde la UI de Convive (/settings/modules → Marketplace o pestaña "Origen personalizado"):

convive/module-expenses

O por CLI:

docker compose exec server npm run module:install -- convive/module-expenses

Endpoints (montados bajo /api/m/expenses y compatibilidad /api/expenses)

Método	Ruta	Descripción
GET	/expenses	Listar (filtros: from, to, categoryId, status, userId)
GET	/expenses/:id	Detalle con splits
POST	/expenses	Crear (multipart si hay recibo)
PATCH	/expenses/:id	Editar (solo creador)
DELETE	/expenses/:id	Eliminar (solo creador o owner)
POST	/expenses/:id/claim-paid	Deudor marca pagado
POST	/expenses/:id/confirm-paid	Pagador confirma

Tablas que crea

• expenses (principal)
• expense_splits (detalle por miembro)

Las migraciones son idempotentes — desinstalar y reinstalar conserva los datos.

Exporta para otros módulos

• ctx.exports.computeSplits(...) — usado por recurring-expenses y shopping.

Dependencias

Ninguna. Es un módulo base del que dependen otros.

Licencia

MIT