← volver
lucas ~/proyectos $ cat receitas-galegas-api.md
API de Receitas Galegas
El recetario tradicional gallego servido en JSON: bilingüe gallego/castellano y con búsqueda por lo que tienes en la despensa.
- FastAPI
- Python 3.12
- Pydantic
- Docker
- VPS Debian
- Traefik
El problema
El recetario gallego está repartido en PDFs de la Xunta, blogs y páginas de Wikipedia. No hay forma de preguntarle nada: ni qué cocinar con lo que queda en la nevera, ni qué lleva gluten, ni cómo se dice cada ingrediente en el otro idioma.
Mi rol
Diseño del modelo de datos, extracción y estructuración del corpus, API y despliegue.
Decisiones
- Todo el contenido existe en gallego y castellano; los nombres de los campos van siempre en gallego porque son el contrato estable de la API.
- Búsqueda por despensa que puntúa cada receta según cuántos de sus ingredientes ya tienes, y te dice lo que falta.
- Normalización tolerante a acentos, plurales y sinónimos entre los dos idiomas: 'pulpo', 'polbo' y 'polbos' caen en la misma clave.
- Corpus en JSON plano validado en el build de la imagen: una receta rota no llega a producción.
- Cada receta declara la fuente concreta de la que salió, para que el dato sea auditable.
Uso de IA
El corpus se extrajo de un cuaderno de NotebookLM con IA; el modelo de datos, la API y la infraestructura son propios.
Resultados
- 56 recetas y 55 fiestas gastronómicas
- 151 ingredientes normalizados
- 154 tests en verde