How dharmpatel1857-cmyk/cybershield works
CyberShield is a local-first URL-review application: users sign in to the dashboard, submit a URL (or review a paused browser navigation), inspect explainable heuristic findings, and manage scan history and incidents. The FastAPI backend owns authentication, analysis, persistence, dashboard summaries, incident management, reports, and optional local-AI advice; deterministic rules determine recorded risk. The browser extension is an optional entry point. Edges reflect the excerpts, source-index references, and README; unsampled extension and API internals are not inferred beyond documented behavior.
Main entry points: main.py FastAPI Application · models.py Domain Records · scans.py Scan Endpoints · db.py SQL Database
Components 19
User Interfaces
- Security Dashboard
frontend/src/App.tsx - Dashboard API Client
frontend/src/api.ts - Navigation Review Extension
extension/service_worker.js
API Workflows
- FastAPI Application
backend/app/main.py - Account and Sessions
backend/app/api/auth.py - Scan Endpoints
backend/app/api/scans.py - Incident Tracking
backend/app/api/incidents.py - User Settings
backend/app/api/settings.py - Assistant Endpoints
backend/app/api/assistant.py
URL Analysis
- URL Rule Analysis
backend/app/services/detection.py - Local AI Advice
backend/app/services/assistant.py
Identity and Data
- Session Security
backend/app/core/security.py - Domain Records
backend/app/models.py - SQL Database
backend/app/db.py - Request and Response Schemas
backend/app/schemas.py
Insights and Reports
- Dashboard Summary
backend/app/api/scans.py - Report Exports
backend/app/api/reports.py
Other components
- User
- Local Ollama
Connections 31
- User → Security Dashboard: reviews URLs
README.md - Security Dashboard → Dashboard API Client: requests data
frontend/src/App.tsx - Dashboard API Client → FastAPI Application: calls API
README.md - User → Navigation Review Extension: reviews navigation
README.md - Navigation Review Extension → Scan Endpoints: submits navigation
README.md - FastAPI Application → Account and Sessions: registers routes
backend/app/main.py - FastAPI Application → Scan Endpoints: registers routes
backend/app/main.py - FastAPI Application → Incident Tracking: registers routes
backend/app/main.py - FastAPI Application → User Settings: registers routes
backend/app/main.py - FastAPI Application → Assistant Endpoints: registers routes
backend/app/main.py - FastAPI Application → Report Exports: registers routes
backend/app/main.py - Account and Sessions → Session Security: creates sessions
backend/app/api/auth.py - Account and Sessions → Domain Records: persists accounts
backend/app/api/auth.py - Scan Endpoints → URL Rule Analysis: analyzes URL
backend/app/api/scans.py - Scan Endpoints → Local AI Advice: requests AI advice
backend/app/api/scans.py - Scan Endpoints → Domain Records: stores scan findings
backend/app/api/scans.py - Scan Endpoints → Session Security: authenticates requests
backend/app/api/scans.py - Incident Tracking → Domain Records: manages incidents
backend/app/api/incidents.py - User Settings → Domain Records: reads and updates settings
backend/app/api/settings.py - Assistant Endpoints → Local AI Advice: requests advice
backend/app/api/assistant.py - Assistant Endpoints → Domain Records: loads scan context
backend/app/api/assistant.py - Local AI Advice → Local Ollama: sends local prompt
backend/app/services/assistant.py - Dashboard Summary → Domain Records: summarizes scans
backend/app/api/scans.py - Report Exports → Domain Records: reads report records
backend/app/api/reports.py - Domain Records → SQL Database: defines persisted records
backend/app/models.py - Account and Sessions → SQL Database: uses database session
backend/app/api/auth.py - Scan Endpoints → SQL Database: uses database session
backend/app/api/scans.py - Incident Tracking → SQL Database: uses database session
backend/app/api/incidents.py - User Settings → SQL Database: uses database session
backend/app/api/settings.py - Assistant Endpoints → SQL Database: uses database session
backend/app/api/assistant.py - Report Exports → SQL Database: uses database session
backend/app/api/reports.py