Escandallo Simple

Aplicación gratuita para calcular escandallos, costes por unidad y márgenes en pequeños negocios.

Permite mantener ingredientes con precio de compra, crear productos con sus cantidades, calcular el coste total de una tanda, el coste por unidad y exportar el resultado a CSV.

Origen del proyecto

Este programa se hizo originalmente para ayudar a una tienda local de cookies de Málaga, Las Delicias de mi Noe, que no tenía una forma sencilla de saber cuánto costaba producir cada galleta.

La idea fue crear una herramienta muy, muy simple: sin coste, sin internet, sin cuentas, sin paneles complicados y pensada para que una repostera local sin experiencia en ordenadores pudiera usarla sin depender de nadie. Solo abrir el programa, meter ingredientes, recetas y precios, y ver el coste real por unidad.

Es una utilidad publicada como ayuda gratuita para pequeños negocios que necesitan controlar mejor sus costes. No representa el alcance completo de los desarrollos enterprise de Peyleth; es justo lo contrario: una herramienta pequeña, práctica y hecha para resolver un problema concreto de la forma más sencilla posible.

Descargar para Windows

La forma más sencilla para usuarios no técnicos es descargar el .exe desde la página de releases:

Descargar última versión

No requiere instalación. Al ejecutarlo, la aplicación crea su base de datos local en DATOS/escandallo.sqlite.

Captura

Caracteristicas

• Gestion de ingredientes con unidad, cantidad de pack y precio de pack.
• Calculo automatico del coste por unidad de cada ingrediente.
• Gestion de productos o recetas con rendimiento por tanda.
• Desglose de costes por ingrediente.
• Margen, costes fijos por tanda y PVP manual.
• Historico local de cambios de precio y calculos guardados.
• Exportacion CSV compatible con Excel.
• Sin cuentas, sin servidor y sin dependencias externas.

Privacidad y datos

El programa guarda los datos solo en el equipo donde se ejecuta.

La base de datos se crea automaticamente en:

DATOS/escandallo.sqlite

Esa carpeta esta excluida del repositorio para no publicar datos personales, precios reales, recetas privadas ni historicos locales.

Ejecutar desde código fuente

Requisitos:

• Python 3.10 o superior.
• Tkinter, incluido normalmente con Python para Windows.

Pasos:

python -m venv .venv
.\.venv\Scripts\activate
python escandallo.py

No hace falta instalar paquetes con pip: la aplicación usa solo la biblioteca estándar de Python.

Crear un ejecutable para Windows

Dentro del entorno virtual:

pip install pyinstaller
pyinstaller EscandalloSimple.spec

El ejecutable se generará en dist/.

Consulta docs/WINDOWS_BUILD.md para el flujo completo de empaquetado y publicación.

Antes de publicar o compartir el proyecto, no subas estas carpetas:

• DATOS/
• dist/
• build/
• .venv/
• __pycache__/

Ya estan incluidas en .gitignore.

Uso basico

1. Abre la pestana Ingredientes y crea los ingredientes con su unidad base.
2. Abre la pestana Productos y crea una receta/producto con sus cantidades.
3. Abre la pestana Calcular escandallo para revisar costes y exportar CSV.

Ejemplos de unidades:

• Harina de 1 kg: unidad g, cantidad pack 1000.
• Leche de 1 l: unidad ml, cantidad pack 1000.
• Huevos por docena: unidad ud, cantidad pack 12.

Publicar en GitHub

Este proyecto está preparado para publicarse sin datos locales. Si el repositorio está vacío, el flujo habitual es:

git init
git branch -M main
git remote add origin <url-del-repositorio>
git add .
git commit -m "Prepare public release"
git push -u origin main

Licencia

MIT. Puedes usarlo, modificarlo y compartirlo gratis.