quotum
API de facturación headless para SaaS y apps, escrita en Bun/TypeScript con Elysia y PostgreSQL. Gestiona suscripciones, medición de uso, créditos e integraciones con Stripe, Apple App Store y Google Play mediante proyecciones firmadas.
Ficha actualizada 26 sept 2026, 16:22 · upstream 26 sept 2026, 15:58 · release v0.15.0
Qué es quotum
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Quotum es una API de facturación autoalojada diseñada para ser headless por defecto, separando la lógica de negocio del ledger, catálogo y clientes de la interfaz de comercio. Utiliza Bun como runtime principal junto con TypeScript y el framework Elysia, almacenando datos en PostgreSQL. La arquitectura prioriza la seguridad mediante integraciones encriptadas propiedad de la base de datos, eliminando la necesidad de mantener listas de clientes a nivel de despliegue.
El sistema permite que los backends consuman proyecciones firmadas para sus modelos de lectura sin acceder directamente a las tablas internas. Incluye un CLI robusto (`quotum`) para operaciones administrativas, migraciones y gestión de catálogo. El ecosistema soporta agentes de desarrollo mediante un servidor MCP de solo lectura y define contratos HTTP explícitos en OpenAPI.
El despliegue se realiza típicamente con Docker Compose en modo headless, requiriendo configuración manual de variables de entorno para autenticación y proveedores. Antes de la versión 1.0, las migraciones de esquema evolucionan in-place, pero el README advierte sobre la necesidad de recrear la base de datos desde los archivos de migración en lugar de aplicar cambios directos a una instancia existente.
- Implementar facturación recurrente para SaaS con gestión de suscripciones y cancelaciones automáticas.
- Medir el uso de recursos (metering) en tiempo real y generar facturas basadas en consumo.
- Gestionar créditos, bonificaciones y derechos de acceso (entitlements) a funcionalidades premium.
- Integrar pagos y suscripciones con Stripe, Apple App Store y Google Play mediante webhooks firmados.
- Operar un backend headless que consume datos de facturación sin exponer la base de datos interna.
- Arquitectura headless segura que evita la exposición directa del esquema de la base de datos.
- Integraciones encriptadas gestionadas internamente por la base de datos, no a nivel de servidor.
- CLI `quotum` integrado para migraciones, inspección y gestión de catálogo declarativa.
- Soporte nativo para servidores MCP (Model Context Protocol) para acceso a agentes de IA.
- Contratos HTTP definidos en OpenAPI v1 con esquemas de errores documentados explícitamente.
- Separación clara entre backend de facturación y plataforma de comercio del merchant.
- Dependencia obligatoria de Bun como runtime, no compatible nativamente con Node.js estándar sin adaptadores.
- En versiones anteriores a 1.0, las migraciones requieren recrear la base de datos desde los archivos en lugar de aplicar cambios incrementales.
- No incluye interfaz web por defecto; requiere construir un proxy de merchant o plataforma externa para gestión UI.
- Variables de entorno críticas como `QUOTUM_AUTH_SECRET` deben configurarse manualmente antes del despliegue.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega con Docker Compose en modo headless (`deploy/compose`). Usa `.env.example` como base y define `QUOTUM_AUTH_SECRET` y credenciales de email (Resend/Cloudflare). Ejecuta migraciones con `bun run migrate`. Para producción, verifica la salud con `/ready` y rota secretos de conexión periódicamente. No uses endpoints de prueba en entornos productivos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.