How alan-fdez/compass works
Compass is a Spanish public-tender radar: it ingests PLACSP notices, filters and ranks them for a company profile, then analyzes a selected tender’s PCAP on demand and computes a cited bid-eligibility verdict. The graph preserves the README’s major stages and product capabilities. Some matching, API, and frontend relationships are documented in the README but their source was not sampled; those links cite that documentation rather than implying direct calls between uninspected modules.
Main entry points: router.py Route registry · analysis.py Analysis endpoints · graph.py Extraction graph · fusion.py Hybrid ranking
Components 30
Dashboard
- Tender dashboard
frontend/src/app/page.tsx - Company profile
frontend/src/app/perfil/page.tsx - Tender detail
frontend/src/app/tenders/[...expediente]/page.tsx - Match views
frontend/src/components/matches/MatchList.tsx - Analysis panel
frontend/src/components/analysis/AnalysisPanel.tsx - Analysis polling
frontend/src/hooks/useAnalysisPolling.ts - API client
frontend/src/lib/api/client.ts
API
- FastAPI app
backend/src/compass/main.py - Route registry
backend/src/compass/api/router.py - Analysis endpoints
backend/src/compass/api/routes/analysis.py - Match endpoints
backend/src/compass/api/routes/matches.py - Provider endpoints
backend/src/compass/api/routes/providers.py - Backfill endpoint
backend/src/compass/api/routes/ingestion.py
Tender ingestion
- Ingestion tasks
backend/src/compass/ingestion/tasks.py - Daily ingestion
backend/src/compass/ingestion/daily_ingestion.py - Tender store
backend/src/compass/tenders/repository.py - Tender records
backend/src/compass/tenders/models.py
Matching
- Hybrid ranking
backend/src/compass/matching/fusion.py - Matching queries
backend/src/compass/matching/repository.py - Embedding generation
backend/src/compass/matching/embeddings.py
Pliego analysis
- Analysis task
backend/src/compass/analysis/tasks.py - Extraction graph
backend/src/compass/analysis/graph.py - PCAP handling
backend/src/compass/analysis/document.py - LLM provider
backend/src/compass/analysis/openrouter.py - Citation checks
backend/src/compass/analysis/verification.py - Eligibility verdict
backend/src/compass/analysis/verdict.py - Analysis records
backend/src/compass/analysis/repository.py
Other components
- Company user
- PLACSP feed
- Langfuse tracing
Connections 38
- Company user → Tender dashboard: views matches
- Company user → Company profile: sets profile
- Company user → Tender detail: opens tender
- Tender detail → Analysis panel: shows analysis
- Analysis panel → Analysis polling: requests status
- Tender dashboard → API client: loads matches
- Company profile → API client: saves profile
- Analysis panel → API client: starts analysis
- Analysis polling → API client: polls status
- API client → FastAPI app: calls API
- FastAPI app → Route registry: mounts routes
backend/src/compass/main.py - Route registry → Analysis endpoints: registers
backend/src/compass/api/router.py - Route registry → Match endpoints: registers
backend/src/compass/api/router.py - Route registry → Provider endpoints: registers
backend/src/compass/api/router.py - Route registry → Backfill endpoint: registers
backend/src/compass/api/router.py - Backfill endpoint → Ingestion tasks: queues backfill
backend/src/compass/api/routes/ingestion.py - PLACSP feed → Daily ingestion: provides notices
- Ingestion tasks → Daily ingestion: runs
backend/src/compass/ingestion/tasks.py - Daily ingestion → Tender store: upserts tenders
backend/src/compass/ingestion/daily_ingestion.py - Tender store → Tender records: persists
backend/src/compass/tenders/repository.py - Tender records → Hybrid ranking: supplies corpus
- Provider endpoints → Hybrid ranking: supplies profile
- Match endpoints → Hybrid ranking: requests ranking
- Hybrid ranking → Matching queries: queries candidates
- Hybrid ranking → Tender dashboard: returns ranked matches
- Ingestion tasks → Embedding generation: queues embeddings
backend/src/compass/ingestion/tasks.py - Embedding generation → Tender records: writes vectors
backend/src/compass/matching/tasks.py - Analysis endpoints → Analysis task: queues analysis
backend/src/compass/api/routes/analysis.py - Analysis task → Extraction graph: runs extraction
backend/src/compass/analysis/tasks.py - Analysis task → PCAP handling: downloads PCAP
backend/src/compass/analysis/tasks.py - Extraction graph → PCAP handling: reads document
backend/src/compass/analysis/graph.py - Extraction graph → LLM provider: calls model
backend/src/compass/analysis/graph.py - Extraction graph → Citation checks: checks citations
backend/src/compass/analysis/graph.py - Analysis task → Analysis records: loads and saves
backend/src/compass/analysis/tasks.py - Analysis endpoints → Eligibility verdict: computes eligibility
backend/src/compass/api/routes/analysis.py - Analysis endpoints → Analysis records: reads analysis
backend/src/compass/api/routes/analysis.py - Analysis endpoints → Tender detail: returns cited result
- Extraction graph → Langfuse tracing: traces calls