How lobaina-ehsan/vulnerfix-vulnerability-remediation-verification-platform works
VulnerFix is a Django vulnerability assessment and remediation platform. Users authenticate, submit authorized source code, and receive scan findings; the scan task runs isolated static analysis, normalizes findings, and matches them to the vulnerability knowledge base. Developers can review findings and remediation proposals, while reports summarize scan and fix outcomes. The README documents Bandit, Semgrep, custom rules, and sandbox restrictions; unsampled views and integrations are shown only where documented or referenced by the index.
Main entry points: tasks.py Scan Task · user_views.py Scan Portal · detector.py Sandboxed Detection · views.py Report Views
Components 24
Access and Scanning
- Account Views
apps/accounts/views.py - Scan Portal
apps/scans/user_views.py - Scan Task
apps/scans/tasks.py - Scans and Findings
apps/scans/models.py
Detection and Matching
- Sandboxed Detection
apps/detection/detector.py - Scanner Runner
sandbox/detector_runner.py - Finding Normalizer
apps/detection/normalizer.py - Test Payloads
apps/detection/payloads/library.py - Vulnerability Matcher
apps/knowledge/matcher.py - Knowledge and Feedback
apps/knowledge/models.py - Knowledge Management
apps/knowledge/views.py
Remediation
- Fix Review
apps/remediation/views.py - Template Fix Engine
apps/remediation/engine.py - Reviewed Fix Templates
apps/remediation/templates_fix/__init__.py - Fix Verification
apps/remediation/verification.py - Remediation Tasks
apps/remediation/tasks.py - Fix Proposals
apps/remediation/models.py
Reporting
- Report Views
apps/reports/views.py - Evaluation Metrics
apps/reports/metrics.py - PDF Reports
apps/reports/pdf.py
Other components
- User
- Developer
- Celery Worker
config/celery.py - Redis Broker
Connections 29
- User → Account Views: authenticates
README.md - Developer → Account Views: authenticates
README.md - Account Views → Scan Portal: accesses portal
- User → Scan Portal: submits code
README.md - Scan Portal → Scan Task: queues scan
apps/scans/user_views.py - Scan Portal → Scans and Findings: creates scan
apps/scans/user_views.py - Scan Task → Scans and Findings: updates findings
apps/scans/tasks.py - Scan Task → Sandboxed Detection: runs analysis
apps/scans/tasks.py - Scan Task → Finding Normalizer: normalizes output
apps/scans/tasks.py - Scan Task → Vulnerability Matcher: matches findings
apps/scans/tasks.py - Sandboxed Detection → Scanner Runner: runs in container
README.md - Sandboxed Detection → Test Payloads: uses test payloads
- Vulnerability Matcher → Knowledge and Feedback: reads vulnerability data
apps/knowledge/matcher.py - Knowledge Management → Knowledge and Feedback: manages knowledge
apps/knowledge/views.py - Knowledge Management → Vulnerability Matcher: queues retraining
apps/knowledge/views.py - Developer → Knowledge Management: teaches vulnerabilities
README.md - Developer → Fix Review: reviews fixes
README.md - Fix Review → Template Fix Engine: requests proposal
- Template Fix Engine → Reviewed Fix Templates: applies template
apps/remediation/engine.py - Remediation Tasks → Fix Verification: verifies fix
apps/remediation/tasks.py - Fix Verification → Sandboxed Detection: reruns analysis
apps/remediation/verification.py - Fix Verification → Fix Proposals: updates proposal
apps/remediation/verification.py - Report Views → Evaluation Metrics: computes metrics
apps/reports/views.py - Report Views → PDF Reports: generates PDF
apps/reports/views.py - Report Views → Scans and Findings: reads scans
apps/reports/views.py - Evaluation Metrics → Knowledge and Feedback: reads feedback
apps/reports/metrics.py - Evaluation Metrics → Fix Proposals: reads fix outcomes
apps/reports/metrics.py - Scan Task → Celery Worker: runs as task
apps/scans/tasks.py - Celery Worker → Redis Broker: dispatches tasks