cacao-accounting 0.0.1.dev20260722

Accounting solution for the management of Accounts Payable, Accounts Receivable, Inventory, Treasury and General Accounting.

Cacao Accounting

Aplicación contable web y de escritorio para PYMEs que centraliza tesorería, compras, ventas, inventario y contabilidad general.

Estado actual

• En desarrollo activo en la rama main con base en Python 3.12, Flask y SQLAlchemy.
• Arquitectura basada en blueprints por módulo: auth, bancos, compras, ventas, inventario, contabilidad, document_flow, imports y más.
• Soporte inicial de AR/AP, pagos/cobros, conciliación, inventario con valuación, impuestos y reglas fiscales, documentos operativos, importaciones masivas y trazabilidad documental.
• UI con Alpine.js, smart-select y diseño de formularios transaccionales compartidos.
• Internacionalización preparada para es y en.
• Calidad integrada con black, ruff, flake8, mypy, pydocstyle y pytest.

Nota: el proyecto sigue siendo de desarrollo y no está listo para uso en producción.

Características principales implementadas

• Cuentas por cobrar y cuentas por pagar.
• Gestión de inventario con Stock Reconciliation y valuación de ajustes.
• Payment entry con impuestos y cargos visibles, reglas fiscales y aplicación de referencias.
• Matriz de flujo documental (document_flow) para crear documentos derivados y mantener trazabilidad.
• Administración de clientes/proveedores con contactos, direcciones, grupos y cuentas por compañía.
• Motor fiscal unificado para preview y persistencia de reglas fiscales.
• Proceso de importación masiva de datos y documentos operativos.
• Revalorización cambiaria auditada y soporte para múltiples libros/ledgers.

Uso recomendado para desarrolladores

• Crear un entorno virtual: python -m venv .venv
• Activar el entorno: source .venv/bin/activate
• Instalar dependencias: pip install -r requirements.txt
• Para habilitar características en la nube (como validación MIME segura en la subida de archivos), instale las dependencias opcionales: pip install cacao-accounting[cloud]
• Ejecutar pruebas: CACAO_TEST=True LOGURU_LEVEL=WARNING SECRET_KEY=ASD123kljaAddS python -m pytest -v -s --exitfirst --slow=True

CLI - cacaoctl

cacaoctl es la interfaz de línea de comandos oficial para administrar Cacao Accounting.

# Inicializar la base de datos
cacaoctl db init

# Iniciar servidor de desarrollo
cacaoctl run

# Iniciar servidor de producción (Waitress)
cacaoctl serve

# Ver estado del sistema
cacaoctl status

# Ver configuración activa
cacaoctl config

# Consola interactiva con contexto de la aplicación
cacaoctl shell

Para más detalles, consulta la documentación de cacaoctl.

Demo online

Live demo at:
URL: https://cacao-accounting.onrender.com/login
User: cacao
Password: cacao

Wait to the free render instance to wake up.

Participar en el proyecto

Todos los aportes son bienvenidos. Consulta el archivo CONTRIBUTING para más detalles.

Licencia

Derechos de autor 2024 - 2026 William José Moreno Reyes

Autorizado en virtud de la Licencia de Apache, Versión 2.0 (la "Licencia"); se prohíbe utilizar este archivo excepto en cumplimiento de la Licencia. Podrá obtener una copia de la Licencia en:

http://www.apache.org/licenses/LICENSE-2.0

A menos que lo exijan las leyes pertinentes o se haya establecido por escrito, el software distribuido en virtud de la Licencia se distribuye “TAL CUAL”, SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Véase la Licencia para consultar el texto específico relativo a los permisos y limitaciones establecidos en la Licencia.