How naveens-prog/entropy works
Entropy is a deterministic static analyzer for architectural security debt: it discovers repository files, parses supported languages without executing repository code, produces rule-backed findings, and reports explainable scores. The primary workflow runs through the backend scan and analysis services; the API and dashboard expose results. Additional product branches cover scan comparison and trends, policy evaluation, AI explanations, and GitHub pull-request checks. The source index and excerpts support the central orchestration and persistence links; some unsampled integrations are shown only as unverified.
Main entry points: repository_service.py Repository service · service.py GitHub PR workflow · page.tsx Dashboard · analysis_service.py Analysis coordinator
Components 25
Scan ingestion
- Repository scanner
backend/app/repository/scanner.py - Repository service
backend/app/services/repository_service.py - Language parsers
backend/app/parser - Scan coordinator
backend/app/services/scan_service.py
Static analysis
- Analysis coordinator
backend/app/services/analysis_service.py - Analyzer registry
backend/app/analyzers/registry.py - Debt analyzers
backend/app/analyzers - Finding models
backend/app/models/domain/finding.py
Results and policy
- Debt scoring
backend/app/scoring/service.py - Policy evaluation
backend/app/policy/service.py - Scan comparison
backend/app/comparison/service.py - Scan database
backend/app/persistence/database.py
Product integrations
- AI explanations
backend/app/ai/service.py - GitHub PR workflow
backend/app/github/service.py - SARIF output
backend/app/sarif/formatter.py
User interface
- REST API
backend/app/api/v1/router.py - Dashboard
frontend/app/page.tsx - Typed API client
frontend/lib/api.ts - Findings viewer
frontend/components/findings/FindingsViewer.tsx - Score dashboard
frontend/components/dashboard/ScoreBanner.tsx - Comparison view
frontend/components/comparison/ScanComparisonView.tsx - PR workflow view
frontend/components/github/PRWorkflowView.tsx
Other components
- Developer
- Code repository
- GitHub
Connections 30
- Developer → Dashboard: reviews results
- Code repository → Repository service: provides source
- REST API → Repository service: routes scans
backend/app/api/v1/router.py - Repository service → Repository scanner: scans source
backend/app/services/repository_service.py - Repository service → Scan database: persists scans
backend/app/services/repository_service.py - Repository service → Language parsers: parses files
backend/app/services/repository_service.py - Scan coordinator → Repository service: coordinates scans
- Analysis coordinator → Repository service: loads and saves
backend/app/services/analysis_service.py - Analysis coordinator → Analyzer registry: dispatches analyzers
backend/app/services/analysis_service.py - Analyzer registry → Debt analyzers: registers analyzers
- Debt analyzers → Finding models: produces findings
- Debt scoring → Analysis coordinator: scores analysis
backend/app/scoring/service.py - Debt scoring → Repository service: scores scans
backend/app/scoring/service.py - Policy evaluation → Scan comparison: evaluates comparisons
backend/app/policy/service.py - Policy evaluation → Scan database: loads policy data
backend/app/policy/service.py - Scan comparison → Scan database: reads scan history
backend/app/comparison/service.py - GitHub → GitHub PR workflow: sends PR events
- GitHub PR workflow → Repository service: acquires and scans source
backend/app/github/service.py - GitHub PR workflow → Analysis coordinator: analyzes scans
backend/app/github/service.py - GitHub PR workflow → Scan comparison: compares scans
backend/app/github/service.py - GitHub PR workflow → Scan database: tracks PR state
backend/app/github/service.py - GitHub PR workflow → Policy evaluation: evaluates policy
backend/app/github/service.py - Dashboard → Typed API client: requests data
- Typed API client → REST API: calls endpoints
- Dashboard → Findings viewer: renders findings
- Dashboard → Score dashboard: renders scores
- Dashboard → Comparison view: renders comparisons
- Dashboard → PR workflow view: renders PR workflow
- AI explanations → Analysis coordinator: explains analysis
backend/app/ai/service.py - Developer → SARIF output: exports results