Skip to content

Repository files navigation

appsperu — monorepo de Rastro

RASTRO convierte señales dispersas en inteligencia clara para decidir mejor. Cada señal deja un rastro. Nosotros lo hacemos visible.

Repo: https://github.com/Treevu-ai/appsperu

Monorepo con 26 apps backend (APIs Express + Postgres por app) que exponen datos abiertos del Estado peruano (presupuesto, contrataciones, inversiones, obras públicas) cruzados por claves compartidas o matching difuso de nombres de entidad. La capa de lectura pública para humanos y agentes IA es Rastro (apps/rastro-web/, publicada en rastro.fyi); el servidor MCP (mcp-server/) expone las 26 APIs como tools de solo lectura para Claude Code, Claude Desktop, Cursor, Windsurf, Cline y Continue.dev.

Rastro es una plataforma de inteligencia que ayuda a equipos y organizaciones a encontrar, conectar y entender las señales que importan. Transformamos información dispersa en contexto accionable, con foco en trazabilidad, claridad y decisiones más seguras. Porque detrás de cada cambio, oportunidad o riesgo hay un rastro, y verlo a tiempo cambia lo que viene después.

Apps

App Dominio API
radar-ejecucion Presupuesto/ejecución (MEF) + benchmark territorial 4000
compras-publicas Contrataciones (OECE/OCDS) + proveedores/concentración 4001
radar-inversiones Inversiones (Invierte.pe) 4002
infobras Obras públicas (Contraloría) 4003
ceplan-estrategico Planificación estratégica (ObservaPerú) 4004
ceplan-geo GeoServer (capas territoriales/infraestructura) 4005
identidad-fiscal Padrón RUC (SUNAT) + cruces 4006
salud-institucional Score compuesto (agrega otras fuentes, sin BD propia) 4007
proveedores-sancionados Inhabilitaciones/multas RNP/OECE 4008
actividad-agraria Series MIDAGRI regionales (jornal, tractor, yunta) 4009
seguridad-ciudadana Denuncias policiales SIDPOL (MININTER) 4010
bcrp-comercio-exterior Comercio exterior agregado nacional (BCRP) 4011
inversion-privada Cartera APP/PA + Obras por Impuestos (PROINVERSIÓN/VERTIX) 4012
bcrp-la-libertad Síntesis de actividad económica de La Libertad (BCRP Trujillo) 4013
servicios-salud Establecimientos de salud (RENIPRESS/SUSALUD) + cruce con inversión 4014
programas-sociales Cobertura de programas sociales (INFOMIDIS/MIDIS) + cruce con inversión 4015
actividad-empresarial Empresas del sector privado por distrito (MTPE) + cruce con inversión 4016
informes-control Informes de servicios de control (Contraloría), sin datos de persona natural 4017
mindef Convenios offset, capacitación militar en el exterior y misiones de paz (MINDEF) 4018
mimp Casos de violencia contra la mujer (CEM) y consultas Chat 100 — solo agregados (MIMP) 4019
renamu Capacidad institucional municipal: vehículos, telefonía e internet (RENAMU/INEI) 4020
autoridades-electas Autoridades proclamadas por proceso electoral, sin datos de identidad (JNE) 4021
instituciones-educativas Padrón nacional de instituciones educativas, con ubicación (MINEDU/ESCALE) 4022
infracciones-ambientales Registro de infractores ambientales sancionados (OEFA/RUIAS) 4023
red-vial-subnacional Intervenciones en redes viales departamentales/vecinales (MTC/Provías Descentralizado) 4024
residuos-solidos Generación anual de residuos sólidos por distrito, serie 2019-2024 (MINAM/SIGERSOL) 4025

Levantar una app

cd apps/<nombre>/api
docker compose up -d
cp .env.example .env
npm run migrate
npm run dev

salud-institucional/api no tiene Postgres propio — solo .env con las connection strings de las otras bases y npm run dev.

Servidor MCP (Model Context Protocol)

mcp-server/ expone las 26 APIs como 104 tools de solo lectura para agentes IA vía MCP (transporte stdio). Compatible con Claude Code, Claude Desktop, Cursor, Windsurf, Cline y Continue.dev. Una vez conectado, el agente encadena los tools, razona sobre los resultados y entrega respuestas con citas verificables. Requiere que las apps ya estén corriendo — ver mcp-server/README.md.

Para conectar Rastro desde un agente: ver apps/rastro-web/DEPLOY.md y la página pública /docs/api en rastro.fyi/docs/api.

Documentación

Consultas sectoriales por terminal

cd apps/radar-ejecucion/api
npm run sectors:inventory -- --anio 2026 --limite 50
npm run ficha:sector -- --sector TRANSPORTE --anio 2026
npm run ficha:entidad -- --entity-code 831 --anio 2026
npm run comparativo:sectores -- --sectores SALUD,TRANSPORTE,VIVIENDA --anio 2026
npm run movimiento:presupuesto -- --anio 2026
npm run servicios:cuidados -- --tipo ALIMENTACION

Las entidades nacionales se consultan solo por gasto dirigido al departamento (META_DEPARTAMENTO); las regionales, por la unidad ejecutora con sede en La Libertad. CUI, obra y compra requieren una clave oficial exacta: Rastro muestra el vacío de vínculo cuando no la tiene.

servicios:cuidados es el registro terminal de infraestructura y alimentación: CUI→obra únicamente por igualdad exacta y proveedor→cumplimiento únicamente por RUC documentado. Cuando no existe lote, entrega o RUC oficial, Rastro muestra el vacío en vez de inferirlo.

Ingesta completa La Libertad

bash scripts/ingest-la-libertad-completo.sh

Orquesta MEF (meta departamental), Invierte (CSV nacional), INFOBRAS, OECE segmentado, ObservaPerú y BCRP. Requiere Postgres de cada app levantado y .env configurados.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages