How marvinlerouge/portfolio-engineering-radar works
Portfolio Engineering Radar combines a local audit engine, a shared evidence-and-scoring data model, an API, and a dashboard. The primary workflow is to select a local repository, discover applicable subprojects and run analysis tools, normalize their results into findings and scores, then expose repository reports, findings, and roadmap data through the API for dashboard review. The README also describes portfolio comparison, historical tracking, and AI-assisted prioritization as intended capabilities; these are not all implemented in the sampled runtime. Connections below are limited to relationships shown by excerpts, SOURCE INDEX references, or the README.
Main entry points: orchestrator.py Audit orchestration · main.py FastAPI application · repositories.py Repository reports · cli.py Audit CLI
Components 29
Repository audits
- Audit CLI
radar-audit/src/radar_audit/cli.py - Subproject discovery
radar-audit/src/radar_audit/discovery.py - Audit orchestration
radar-audit/src/radar_audit/orchestrator.py - Analysis tool runners
radar-audit/src/radar_audit/runners - Runner contract
radar-audit/src/radar_audit/runner.py
Quality assessment
- Versioned taxonomy
radar-audit/src/radar_audit/taxonomy/seed.py - Evidence normalizers
- Scoring engine
- Audit reporting
Shared data model
- Local database
radar-core/src/radar_core/db.py - Repository records
radar-core/src/radar_core/models/repository.py - Audit results
radar-core/src/radar_core/models/audit.py - Methodology records
radar-core/src/radar_core/models/methodology.py - Findings and evidence
radar-core/src/radar_core/models/finding.py - Scores and snapshots
radar-core/src/radar_core/models/scoring.py - Roadmap records
radar-core/src/radar_core/models/roadmap.py
API services
- FastAPI application
radar-api/src/radar_api/main.py - API key authentication
radar-api/src/radar_api/auth.py - Repository reports
radar-api/src/radar_api/routers/repositories.py - Finding endpoints
radar-api/src/radar_api/routers/findings.py - Roadmap endpoints
radar-api/src/radar_api/routers/roadmap.py
Local dashboard
- Dashboard shell
radar-dashboard/src/App.vue - API client
radar-dashboard/src/api/client.ts - Repository state
radar-dashboard/src/stores/repositories.ts - Repository views
radar-dashboard/src/views - Finding components
radar-dashboard/src/components - Roadmap view
radar-dashboard/src/components/RoadmapItemRow.vue
Other components
- Engineer
- Local repositories
Connections 38
- Engineer → Audit CLI: starts audit
README.md - Local repositories → Audit CLI: provides paths
README.md - Audit CLI → Audit orchestration: invokes
radar-audit/src/radar_audit/cli.py - Audit orchestration → Subproject discovery: discovers projects
radar-audit/src/radar_audit/orchestrator.py - Audit orchestration → Analysis tool runners: runs tools
radar-audit/src/radar_audit/orchestrator.py - Analysis tool runners → Runner contract: implements
radar-audit/src/radar_audit/runners/pnpm_audit_runner.py - Audit orchestration → Versioned taxonomy: seeds methodology
radar-audit/src/radar_audit/orchestrator.py - Audit CLI → Local database: opens database
radar-audit/src/radar_audit/cli.py - Audit orchestration → Repository records: resolves repository
radar-audit/src/radar_audit/orchestrator.py - Audit orchestration → Audit results: records audit results
radar-audit/src/radar_audit/orchestrator.py - Audit orchestration → Methodology records: seeds taxonomy
- Audit orchestration → Evidence normalizers: normalizes evidence
- Evidence normalizers → Findings and evidence: creates findings
- Evidence normalizers → Scores and snapshots: creates scores
- Scoring engine → Evidence normalizers: uses normalization helpers
- Audit CLI → Audit reporting: renders reports
- Engineer → Dashboard shell: reviews portfolio
README.md - Dashboard shell → API client: uses client
- Repository state → API client: requests data
- Repository views → Repository state: uses state
radar-dashboard/src/views/RepositoryListView.vue - Repository views → Finding components: renders findings
- Roadmap view → API client: requests roadmap
- API client → FastAPI application: calls API
- FastAPI application → Repository reports: registers routes
radar-api/src/radar_api/main.py - FastAPI application → Finding endpoints: registers routes
radar-api/src/radar_api/main.py - FastAPI application → Roadmap endpoints: registers routes
radar-api/src/radar_api/main.py - Repository reports → API key authentication: requires key
- Finding endpoints → API key authentication: requires key
radar-api/src/radar_api/routers/findings.py - Roadmap endpoints → API key authentication: requires key
radar-api/src/radar_api/routers/roadmap.py - Repository reports → Repository records: reads repositories
radar-api/src/radar_api/routers/repositories.py - Repository reports → Scores and snapshots: reads scores
radar-api/src/radar_api/routers/repositories.py - Repository reports → Findings and evidence: reads findings
radar-api/src/radar_api/routers/repositories.py - Finding endpoints → Findings and evidence: uses findings
radar-api/src/radar_api/routers/findings.py - Roadmap endpoints → Roadmap records: uses roadmap
radar-api/src/radar_api/routers/roadmap.py - FastAPI application → Local database: provides sessions
- Engineer → Local repositories: maintains code
README.md - Audit orchestration → Repository records: stores audit context
radar-audit/src/radar_audit/orchestrator.py - Scoring engine → Scores and snapshots: persists assessment