Saltar al contenido
Taveras Solutions · Ir al inicio
Agendar diagnóstico

MITPython / FastAPI

Red Humanitaria de Datos

Un índice federado para que las apps de ayuda de Venezuela compartan datos por una API común.

Reúne en un solo buscador los registros de personas desaparecidas, centros de acopio, hospitales y recursos que hoy viven en apps separadas. Cada app puede consultar la red y también aportar sus datos normalizados.

Estrellas
8
Forks
5
Lenguaje
Python / FastAPI
Licencia
MIT

EL PROBLEMA

En una emergencia aparecen muchas apps de ayuda y cada una arma su propio índice. La misma persona queda repartida entre fuentes y nadie ve el cuadro completo.

Para quién

Equipos que mantienen apps de ayuda humanitaria, voluntarios técnicos y organizaciones que necesitan buscar en varias fuentes a la vez.

QUÉ HACE

  • Búsqueda unificada con texto completo (FTS5 y BM25), por nombre, cédula, tipo de registro o ciudad.
  • 22 conectores incluidos; una fuente nueva es un solo archivo en app/connectors/builtin/.
  • Ingesta desde apps aliadas con llave propia, y escrituras cerradas por defecto si falta una llave.
  • Vista de la misma persona entre fuentes, con enlace y desenlace manual por un administrador.
  • Federación entre nodos con un feed incremental por cursor.
  • Formulario público para proponer una fuente sin tocar código, que queda pendiente de revisión.

Cómo está armado

  1. Conectores Cada fuente expone un CONNECTOR; el scheduler los sincroniza hacia el índice.
  2. API FastAPI sirve búsqueda, detalle, ingesta, entidades, peers y propuestas, documentado en OpenAPI.
  3. Índice Los registros normalizados se guardan con búsqueda FTS5; la base vive solo en cada nodo y no se versiona.
  4. Federación Los nodos se registran como peers y se nutren unos de otros con el feed ?since=.
  5. Frontend Buscador web, mapa, ficha de entidad, fuentes y página para contribuir.

Stack

FastAPIPythonOpenAPIJavaScriptDocker

Por qué lo hicimos

Busca que las apps de ayuda dejen de duplicar el mismo índice y que la comunidad lo continúe. Muestra cómo Taveras Solutions diseña integraciones entre muchas fuentes cuidando datos sensibles.

Cómo empezar

python3 -m venv .venv && source .venv/bin/activate
python -m pip install -e ".[dev]"
cp .env.example .env  # HOSPITALES_API_KEY, INGEST_API_KEY y ADMIN_API_KEY
fastapi dev app/main.py  # docs en http://127.0.0.1:8000/docs

Necesitas algo así a la medida?

Usamos estas mismas herramientas en los proyectos de nuestros clientes.