How ivancyao/capstone-securescan works
SecureScan is a web vulnerability assessment and management platform. Users register projects and web assets, launch controlled evaluations, follow progress, review CVSS/OWASP-prioritized findings, track remediation, compare runs, and generate PDF reports. The React interface calls a FastAPI backend; the backend persists accounts and assessment data in PostgreSQL and orchestrates Nmap, with OWASP ZAP and VirusTotal documented as optional integrations. The graph covers the documented quick-analysis, metrics, administration, and reporting branches as well. Some subsystem paths and links rely on README or source-index references; unsampled internals are not inferred beyond those references.
Main entry points: database.py Database access · App.jsx React application · main.py FastAPI entry · scan_service.py Evaluation orchestration
Components 26
User interface
- React application
frontend/src/App.jsx - Data and actions
frontend/src/context/DataContext.jsx - API client
frontend/src/services/http.js - Projects and assets
frontend/src/pages/Proyectos.jsx - Evaluations and findings
frontend/src/pages/Evaluaciones.jsx - Quick analysis
frontend/src/pages/Analisis.jsx - Reports and comparison
frontend/src/pages/Reportes.jsx - Administration
frontend/src/pages/Admin.jsx
API and access
- FastAPI entry
backend/app/main.py - Authentication
backend/app/routers/auth.py - Projects and evaluations API
backend/app/routers/proyectos.py - Analysis API
backend/app/routers/analisis.py - Metrics API
backend/app/routers/metricas.py - Users and configuration API
backend/app/routers/usuarios.py
Assessment domain
- Evaluation orchestration
backend/app/scan_service.py - Quick analysis service
backend/app/analisis_service.py - Risk classification
backend/app/risk.py
Scanning integrations
- Port and service scan
backend/app/scanner.py - OWASP ZAP client
backend/app/zap_client.py - VirusTotal
Persistence and output
- PostgreSQL
- Database access
backend/app/database.py - Domain records
backend/app/models.py - Report generation API
backend/app/routers/reportes.py - PDF renderer
backend/app/reportes_pdf.py
Other components
- Organization user
Connections 31
- Organization user → React application: uses
README.md - React application → Projects and assets: routes to
frontend/src/App.jsx - React application → Evaluations and findings: routes to
frontend/src/App.jsx - React application → Quick analysis: routes to
frontend/src/App.jsx - React application → Reports and comparison: routes to
frontend/src/App.jsx - React application → Administration: routes to
frontend/src/App.jsx - Data and actions → API client: calls
frontend/src/context/DataContext.jsx - API client → FastAPI entry: sends requests
README.md - FastAPI entry → Authentication: registers
backend/app/main.py - FastAPI entry → Projects and evaluations API: registers
backend/app/main.py - FastAPI entry → Analysis API: registers
backend/app/main.py - FastAPI entry → Metrics API: registers
backend/app/main.py - FastAPI entry → Users and configuration API: registers
backend/app/main.py - Projects and evaluations API → Evaluation orchestration: starts evaluation
backend/app/routers/proyectos.py - Analysis API → Quick analysis service: invokes
backend/app/routers/analisis.py - Evaluation orchestration → Port and service scan: runs scan
backend/app/scan_service.py - Evaluation orchestration → Risk classification: classifies findings
backend/app/scan_service.py - Evaluation orchestration → OWASP ZAP client: requests scan
backend/app/scan_service.py - Evaluation orchestration → Database access: persists results
backend/app/scan_service.py - Quick analysis service → Port and service scan: uses
backend/app/analisis_service.py - Quick analysis service → Database access: accesses
backend/app/analisis_service.py - Quick analysis service → VirusTotal: checks reputation
README.md - Port and service scan → Organization user: scans authorized target
README.md - OWASP ZAP client → Risk classification: classifies findings
backend/app/zap_client.py - Database access → PostgreSQL: connects
backend/app/database.py - Domain records → Database access: defines mapped records
backend/app/models.py - Projects and evaluations API → Database access: queries and updates
backend/app/routers/proyectos.py - Authentication → Database access: accesses accounts
backend/app/routers/auth.py - Metrics API → Database access: queries metrics
backend/app/routers/metricas.py - Report generation API → PDF renderer: generates PDF
backend/app/routers/reportes.py - Report generation API → Database access: stores report records
backend/app/routers/reportes.py