How baneado85/geopredia works
GeoPredIA is a georisk decision hub: users compare zone evaluations, inspect specialist explanations and evidence, then record a human review. The main runtime is FastAPI with local SQLite; official scoring is documented as a SAC responsibility, while CSV snapshots are imported without recalculation. Telemetry, optional BPA/HANA adapters, and a separate CAP dataset service are additional product branches. Relationships reflect the README and shown source references; several integration connections are explicitly unverified.
Main entry points: api.py FastAPI · engine.py Agent engine · store.py SQLite records · app.js Web console
Components 22
User experience
- Web console
frontend/console/app.js - FastAPI
agents/api.py - Human review
agents/api.py
Evaluation and agents
- Snapshot import
agents/sac.py - Agent engine
agents/engine.py - Specialists
agents/agents - Coordinator
agents/agents/coordinator_agent.py
Evidence and records
- Zone data
agents/data.py - SQLite records
agents/store.py - Audit history
agents/store.py - Telemetry intake
agents/api.py
External integrations
- SAC scoring
analytics - Groq LLM
- BPA adapter
agents/integrations.py - HANA reader
agents/integrations.py - HANA publisher
agents/hana_publish.py
Official dataset service
- CAP OData service
backend/srv/geopredia-service.js - CAP SQLite dataset
backend/db/schema.cds
Other components
- Reviewer
- ESP32 / simulator
- SAP BPA
- SAP HANA
Connections 23
- Reviewer → Web console: uses
README.md - Web console → FastAPI: calls
README.md - SAC scoring → Snapshot import: exports snapshot
README.md - Snapshot import → FastAPI: imports evaluations
agents/api.py - FastAPI → Zone data: reads zone data
agents/api.py - FastAPI → Agent engine: runs agents
agents/api.py - Agent engine → Specialists: analyzes evidence
- Agent engine → Groq LLM: optionally requests
agents/engine.py - Agent engine → Coordinator: coordinates findings
- FastAPI → SQLite records: persists records
README.md - Reviewer → Human review: submits decision
README.md - Human review → SQLite records: records review
agents/store.py - SQLite records → Audit history: appends events
agents/store.py - ESP32 / simulator → Telemetry intake: sends readings
README.md - Telemetry intake → SQLite records: stores readings
agents/api.py - FastAPI → BPA adapter: starts workflow
agents/api.py - BPA adapter → SAP BPA: starts instance
agents/integrations.py - SAP BPA → Human review: sends callback
README.md - FastAPI → HANA reader: imports zones
agents/api.py - HANA reader → SAP HANA: reads view
agents/integrations.py - FastAPI → HANA publisher: publishes events
agents/api.py - HANA publisher → SAP HANA: writes event batch
agents/hana_publish.py - CAP OData service → CAP SQLite dataset: serves dataset