Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

ALdia

Motor empresarial open-source para agentes de IA, con facturación, pagos y control de inventario como herramientas MCP seguras, idempotentes y auditables. Funciona localmente (offline-first), soporta múltiples países y evita la manipulación directa de bases de datos por parte del agente.

Ficha actualizada 24 sept 2026, 17:43 · upstream 24 sept 2026, 17:16 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es ALdia

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

ALdia es un motor empresarial open-source diseñado específicamente para convertir asistentes de IA en operadores comerciales confiables que manejan dinero real. En lugar de dar acceso directo a la base de datos, expone operaciones de negocio como facturación, pagos, clientes e inventario mediante 60 herramientas MCP con control de permisos. El sistema garantiza integridad financiera almacenando montos en enteros (céntimos), implementa idempotencia real para evitar duplicados por reintentos y mantiene un registro de auditoría inmutable que sobrevive incluso a borrado de base de datos.

La arquitectura es minimalista: un proceso Python con SQLite, sin dependencias complejas ni nube. Funciona offline-first (sin CDN) y permite despliegue en una sola máquina local o red interna. Soporta múltiples países mediante "paquetes" que cambian reglas fiscales y validaciones sin tocar el núcleo. Incluye herramientas para backup automático de la base de datos y gestión de errores estructurados con códigos estables para que los agentes puedan corregir acciones automáticamente.

**Casos de uso**: Asistente de IA que procesa pagos con cheques o transferencias verificando saldo antes de ejecutar; Facturación automática con validación fiscal (CAE en Argentina, sin integración fiscal en EE.UU.); Control de inventario para evitar ventas por stock insuficiente con errores estructurados; Auditoría inmutable de todas las operaciones financieras y reintentos fallidos.

**Puntos fuertes**: Idempotencia real: reserva IDs antes de ejecutar, previene duplicación en reintentos; Errores estructurados: códigos estables (ej. STOCK_INSUFICIENTE) para corrección automática; Auditoría inmutable: middleware registra todo, incluyendo intentos rechazados, sin endpoint de borrado; Offline-first: funciona sin internet, sin CDN, ideal para tiendas locales; Multi-país: soporta Argentina (CUIT/CAE) y EE.UU. (EIN/Sales Tax básico) vía configuración; Seguridad MCP: roles limitados, no usa credenciales admin por defecto.

**Limitaciones**: Sin multi-tenencia: una instalación = un negocio; Impuestos EE.UU.: solo aplica tasa fija manual, sin cálculo de jurisdicción o nexus económico; No genera formularios 1099 c

CASOS DE USO
  • Asistente de IA que procesa pagos con cheques o transferencias verificando saldo antes de ejecutar
  • Facturación automática con validación fiscal (CAE en Argentina, sin integración fiscal en EE.UU.)
  • Control de inventario para evitar ventas por stock insuficiente con errores estructurados
  • Auditoría inmutable de todas las operaciones financieras y reintentos fallidos
PUNTOS DESTACADOS
  • Idempotencia real: reserva IDs antes de ejecutar, previene duplicación en reintentos
  • Errores estructurados: códigos estables (ej. STOCK_INSUFICIENTE) para corrección automática
  • Auditoría inmutable: middleware registra todo, incluyendo intentos rechazados, sin endpoint de borrado
PRECAUCIONES
  • Sin multi-tenencia: una instalación = un negocio
  • Impuestos EE.UU.: solo aplica tasa fija manual, sin cálculo de jurisdicción o nexus económico
  • No genera formularios 1099 completos, solo hojas de trabajo
  • Acceso directo a SQLite permite edición manual si se tiene permisos de sistema
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Requiere Python 3.10+, ejecutar `instalar.sh` y `iniciar_web.sh`. Usar HTTPS con Caddy en producción. Cambiar contraseña admin obligatoriamente antes de operar. Configurar `ALDIA_HOST=0.0.0.0` para acceso remoto.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Python
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.