Skip to content

Repository files navigation

ALFB v2.0 — Automation Local Food Bank

Versión: 2.0.0 Estado: Diseño y preimplantación Fecha: agosto de 2026


¿Qué es ALFB?

ALFB es un proyecto de transformación digital para un Banco de Alimentos real. Su objetivo es modernizar la gestión interna, automatizar procesos y sentar las bases para utilizar inteligencia artificial de forma local y segura.

No es un proyecto académico ni teórico: se va a implantar realmente y se usará a diario por empleados y voluntarios.


Contexto: ¿por qué ahora?

El Banco de Alimentos ha recibido una nueva infraestructura informática (servidor con GPU NVIDIA RTX 5090, NAS, red de alta velocidad) que permite abordar un proyecto mucho más ambicioso que el que se había planteado antes.

El sistema actual se basa en Excel y correo electrónico, lo que genera:

· pérdidas de tiempo, · errores manuales, · dificultad para encontrar documentos, · falta de trazabilidad en las operaciones.

ALFB v2.0 nace para resolver estos problemas, aprovechando la nueva tecnología y el conocimiento acumulado durante años.


Enfoque fundamental

Datos fiables → automatización → analítica → inteligencia artificial.

No vamos a empezar creando un chatbot o un modelo de IA. Primero construimos una base de datos sólida, digitalizamos los documentos, automatizamos los procesos manuales y, solo cuando todo funcione, añadiremos inteligencia artificial para ayudar a las personas.

La IA será un asistente, no un sustituto. Las decisiones críticas (modificar inventario, aprobar entregas, etc.) siempre requerirán autorización humana.


¿Qué conseguirá ALFB?

· Un único sistema para gestionar asociaciones, productos, inventario, peticiones, entregas, vehículos, voluntariado y documentos. · Trazabilidad completa de cada operación: desde la entrada de un producto hasta su entrega. · Gestión documental inteligente: búsqueda rápida de cualquier documento (facturas, albaranes, cartas, etc.) mediante OCR y metadatos. · Acceso remoto seguro para el personal fijo, con roles y permisos. · IA local para responder preguntas sobre la documentación, detectar anomalías o prever necesidades, sin enviar datos a servicios externos.


Tecnologías principales

Área Tecnología Sistema operativo Linux Server LTS Contenedores Docker + Docker Compose Base de datos PostgreSQL + pgvector Backend Python + FastAPI + SQLAlchemy Frontend React + TypeScript OCR Tesseract (inicialmente) IA local Modelos abiertos (LLM, embeddings, RAG) Control de versiones Git + GitHub


Roadmap resumido

  1. Fase 1 – Infraestructura y datos Servidor, Linux, Docker, PostgreSQL, NAS, copias de seguridad, modelo de datos y migración piloto desde Excel.
  2. Fase 2 – Aplicación operativa Gestión de asociaciones, productos, inventario, peticiones, entregas, vehículos y voluntariado.
  3. Fase 3 – Gestión documental inteligente OCR, metadatos, indexación y búsqueda en todos los documentos.
  4. Fase 4 – IA local LLM, embeddings, RAG y asistente conversacional.
  5. Fase 5 – Predicción Modelos para estimar necesidades, estacionalidad y consumo.
  6. Fase 6 – Recomendación y optimización Sugerencias para rotación de productos, planificación de voluntarios y rutas de reparto.

Cada fase es autocontenida: aunque no se completen las siguientes, el sistema ya aporta valor.


Estructura del repositorio

ALFB/
├── README.md
├── CHANGELOG.md
├── .gitignore
└── docs/
    ├── 01-introduccion.md
    ├── 02-situacion-actual.md
    ├── ... (28 archivos de documentación)
    └── 28-glosario.md

La documentación completa está en la carpeta docs/. Empieza por docs/01-introduccion.md para conocer todos los detalles.


Estado actual

Estamos en la Fase 1 – Sprint 0: inventario físico del servidor, comprobación de la red/NAS, instalación del sistema operativo y creación de este repositorio.

El código fuente (backend, frontend, scripts) se añadirá a medida que avancemos.


Contribuciones

El proyecto lo desarrolla un equipo reducido (voluntarios y personal del Banco). Si quieres colaborar, ponte en contacto con la dirección del Banco de Alimentos. Para contribuciones externas, se requiere coordinación previa.


Licencia

Pendiente de definir. Se recomienda una licencia abierta (tipo MIT), pero se decidirá conjuntamente con la entidad.


Más información

Consulta la documentación completa o contacta con el equipo técnico del proyecto.


¡Gracias por tu interés en ALFB!

About

Automation Local Food Bank

Topics

Resources

Stars

3 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors