❓ Cómo usar este sitio

Este sitio muestra, explicado paso a paso, el control de ingresos y gastos de la Granja San José de la Institución Universitaria Oriente de Caldas. Es público (los datos de una entidad pública son de todos), de solo consulta y no requiere usuario ni contraseña. Cualquier persona, sin conocimientos de sistemas ni de contabilidad, debería poder entenderlo; si algo no se entiende, conviene mejorar la explicación.

Las pantallas del sitio

📊 Inicio (resumen): La granja de un solo vistazo: cuánto entró, cuánto se gastó y qué proyectos aportan o consumen. Cada gráfico tiene un título en forma de pregunta y una lectura en palabras. Desde cualquier barra puede «bajar» al detalle del proyecto. Tiene un botón para imprimir el resumen en una página.
🗂️ Proyectos: La lista de los 17 proyectos con su área, tipo, responsable, estado y balance. Al tocar un proyecto se abre su página con producción, inventario de animales, sanidad, alimentación y todos sus movimientos.
📒 Libro diario: Todos los movimientos de dinero de 2026, con filtros. Los totales de arriba se recalculan al filtrar: sirve para responder en vivo «¿cuánto se gastó en X?». Las marcas de colores avisan cuándo un dato crudo fue normalizado o merece revisión, y el botón ✏️ permite guardar correcciones explicadas.
🚦 Controles: El semáforo de la granja: verificaciones automáticas de coherencia (¿cuadra el inventario?, ¿lo producido coincide con lo vendido?, ¿todo gasto tiene rastro en el libro diario?). Cada control dice qué revisa, qué encontró y qué se recomienda hacer.
👷 Mano de obra: Muestra los nueve cargos y costos mensuales informados por Talento Humano. Los valores ya incluyen prestaciones. El reparto por proyecto está marcado como estimación porque la granja no registra horas por proyecto.
🧾 Plantillas: Formatos en blanco para descargar y llevar los registros de la granja (horas, alimentación, recolección, inventario, donación de servicios). Se busca por nombre a medida que se escribe. Descargar es libre; cargar una plantilla nueva pide la contraseña y queda disponible para todos.
📁 Hojas de vida: El expediente documental de cada proyecto: se crean carpetas y se cargan PDF, Word, TXT, MD, Excel e imágenes. «Ver hoja de vida completa» apila todos los documentos en vertical para revisarlos de corrido (los Excel no se apilan; se descargan).

De dónde salen los datos

Todo proviene del libro «CONTROL INGRESOS Y GASTO CTT 31 JULIO.xlsx» que lleva la granja, con corte al 31 de julio de 2026. Los datos se pasaron por un proceso de normalización documentada: fechas que estaban escritas como texto se interpretaron, categorías con grafías distintas se unificaron («huevos» → «Huevos») y errores evidentes se corrigieron dejando nota (por ejemplo, un ingreso digitado como $80 cuando la observación decía $80.000). Ninguna corrección borra el dato original: todas están marcadas con 🛠 en el Libro diario y se pueden consultar una por una.

Glosario en palabras sencillas

Ingreso:: dinero que entra (una venta de huevos, café, animales…).
Egreso:: dinero que sale (compra de alimento, medicamentos, jornales…).
Balance:: ingresos menos egresos. Positivo (verde) = aporta; negativo (rojo) = consume.
Concentrado:: alimento balanceado para animales; se compra en bultos de 40 kg.
Cubeta:: bandeja de huevos: 30 huevos de gallina o 24 de codorniz. Por eso el sitio siempre aclara la unidad.
Baja:: animal que sale del inventario (muere, se vende o se consume).
Saldo:: lo que queda después de sumar entradas y restar salidas.
Trazabilidad:: poder seguir el rastro de un dato hasta su registro original en el libro.
Corte:: la fecha hasta la cual llega la información (aquí, 31 de julio de 2026).

Preguntas frecuentes

¿Puedo cambiar los datos desde este sitio?

Los datos del libro no se cambian desde aquí: el sitio muestra el corte oficial. Lo que sí se puede hacer es dejar correcciones explicadas (botón ✏️ del Libro diario), que no borran el dato original sino que lo acompañan con una nota y hacen que el sitio recalcule los totales.

Esas correcciones se guardan en el servidor: quedan visibles para cualquier persona, desde cualquier computador. Al guardar aparece un recuadro que pide una contraseña: así se evita que alguien de paso altere los libros o las correcciones. Consultar el sitio no pide contraseña en ningún momento. Los documentos de hoja de vida, en cambio, sí quedan solo en el navegador de cada quien.

¿Por qué un proyecto aparece «Sin movimientos»?

Porque en el libro de la granja no se registró ningún ingreso ni gasto para él en 2026 (les pasa a BIOINSUMOS, APICOLA, OTRO MADERAS y OTROS GRANJA). El sitio lo muestra tal cual, sin inventar ceros.

¿Por qué algunos controles salen en amarillo o rojo?

Porque la verificación automática encontró algo que no cuadra: un saldo que no coincide con la aritmética, más ventas que producción, o un gasto sin rastro. Suele deberse a un registro incompleto. El control dice exactamente qué revisar.

¿Quién puede ver este sitio?

Cualquier persona con el enlace. Es información pública de una entidad pública, presentada para que se entienda.

🛠️ Para quien mantiene el sitio

Esta parte es más técnica. Sirve para actualizar el sitio cuando llega un corte nuevo del libro, publicarlo y resolver problemas. Está pensada para que cualquier persona con conocimientos básicos pueda mantenerlo, y también como recordatorio para uno mismo.

1. Actualizar cuando llega un Excel nuevo de la granja

Los datos del sitio se generan del libro de Excel con un programa. El proceso es:

Coloque el nuevo .xlsx en la carpeta del proyecto y ajuste la ruta en tools/exportar_datos.py.
Ejecute python3 tools/exportar_datos.py. Esto regenera todos los archivos de data/.
Compruebe las cifras de control (abajo). Si el resumen las muestra, los datos cargaron completos.
Vuelva a subir la carpeta data/ con subir-solo-datos.bat.

El documento GUIA-NUEVA-VERSION-DEL-LIBRO.md trae el detalle completo (qué NO se puede cambiar en el Excel para no romper el sitio).

2. Publicar el sitio en el hosting

En la carpeta del proyecto hay tres programas de doble clic (Windows los trae de fábrica):

subir-por-ssh.bat — el recomendado: sube todo por SSH y deja los permisos correctos.
subir-todo-al-hosting.bat — lo mismo por FTP (necesita _ftp-credenciales.txt).
subir-solo-datos.bat — sube únicamente data/, para un corte nuevo.

Ninguno borra datos-servidor/, así que las correcciones, los valores de mano de obra y las plantillas cargadas no se pierden al volver a subir.

3. Cambiar la contraseña de edición

La contraseña protege el guardado (correcciones, mano de obra, cargar plantillas). Consultar es siempre libre. No está escrita en ningún archivo: en api/config.php solo vive su huella (bcrypt).

Para cambiarla: php tools/generar-clave.php "la-nueva" y pegue la línea que imprime en api/config.php, en 'claveHash'.

4. Si algo no se ve bien

Abra https://granja.rayogestion.com/diagnostico.php: comprueba, uno por uno, que todos los archivos llegaron, que la carpeta de datos tiene permiso de escritura y que las direcciones limpias funcionan.

Se ve sin colores → falta css/granja.css.
Con colores pero sin datos ni gráficos → faltan archivos de data/ o js/.
No guarda correcciones/plantillas → la carpeta datos-servidor/ no tiene permiso de escritura (póngale 755).

5. Abrir el sitio sin internet (desde un USB)

El sitio abre por doble clic en index.html, sin servidor. Sirve como respaldo para una sustentación: los datos y las plantillas de ejemplo se ven igual. Lo único que no funciona sin servidor es guardar (correcciones, mano de obra) y cargar plantillas nuevas, porque eso necesita el hosting.

ℹ️ Cifras de control (para verificar que un corte cargó completo): Ingresos $24.537.420 · Egresos $17.064.800 · Balance +$7.472.620 · Huevos de gallina 12.529 · de codorniz 5.846 · Alimentación = 86 % del gasto. Si el resumen muestra estas cifras, los datos están completos.