How saber20005/cybertrace works
CyberTrace is an Arabic incident-response training platform. Learners enter through the app, browse or select an investigation, work through incident, evidence, decision, and result stages, then review progress and optionally sync it. Separate branches provide SOC-shift alert triage and server-verified SOC assessment, plus account/BLACKBOX linking and a Pro roadmap. The README documents reports, recommendations, sharing, and optional cloud progress. Some page and integration internals were not sampled; edges below are limited to visible imports/calls or documented capabilities.
Main entry points: App.jsx App router · Investigation.jsx Case workflow · InvestigationLibrary.jsx Case library · SocShift.jsx SOC shift
Components 27
Application flow
- App router
src/App.jsx - Pro roadmap
src/pages/Pro.jsx
Incident investigations
- Case library
src/pages/InvestigationLibrary.jsx - Case catalog
src/data/caseCatalog.js - Investigation cases
src/data/cases.js - Case workflow
src/pages/Investigation.jsx - Evidence workspace
src/components/InvestigationWorkspace.jsx - Workspace evidence
src/data/investigationWorkspace.js - Review and report
src/utils/investigationReport.js - Learning recommendations
src/utils/learningPlan.js
SOC training
- SOC shift
src/pages/SocShift.jsx - Shift and alert catalog
src/data/socShiftCatalog.js - Triage session scoring
src/utils/socShiftSession.js - Verified SOC assessment
src/pages/VerifiedSoc.jsx - Verified SOC service
src/blackbox/verifiedSocBackend.js
Progress and identity
- Case progress records
src/utils/caseProgress.js - XP and levels
src/utils/xp.js - Cloud progress sync
src/utils/cloudProgress.js - Browser storage
- Firebase auth and data
src/firebase.js - Account access
src/pages/Auth.jsx
BLACKBOX integration
- BLACKBOX provider
src/blackbox/BlackBoxProvider.jsx - Result sync controller
src/blackbox/controller.js - BLACKBOX backend
src/blackbox/backend.js - Learning link and account
src/blackbox/BlackBoxLink.jsx
Other components
- Learner
- BLACKBOX service
Connections 34
- Learner → App router: opens
README.md - App router → Case library: routes to
src/App.jsx - App router → Case workflow: routes to
src/App.jsx - App router → SOC shift: routes to
src/App.jsx - App router → Verified SOC assessment: routes to
src/App.jsx - App router → Account access: routes to
src/App.jsx - App router → Pro roadmap: routes to
src/App.jsx - Case library → Case catalog: reads
src/pages/InvestigationLibrary.jsx - Case catalog → Investigation cases: loads cases
src/data/cases.js - Case library → Case progress records: reads progress
src/pages/InvestigationLibrary.jsx - Case library → Learning recommendations: gets guidance
src/pages/InvestigationLibrary.jsx - Case workflow → Case catalog: gets case details
src/pages/Investigation.jsx - Case workflow → Evidence workspace: renders
src/pages/Investigation.jsx - Evidence workspace → Workspace evidence: loads evidence
src/components/InvestigationWorkspace.jsx - Case workflow → Case progress records: records result
src/pages/Investigation.jsx - Case workflow → XP and levels: awards XP
src/pages/Investigation.jsx - Case workflow → Review and report: creates report
src/pages/Investigation.jsx - SOC shift → Shift and alert catalog: loads shift
src/pages/SocShift.jsx - SOC shift → Triage session scoring: uses session
src/pages/SocShift.jsx - Triage session scoring → Shift and alert catalog: grades alerts
src/utils/socShiftSession.js - Triage session scoring → Browser storage: reads and writes
src/utils/socShiftSession.js - Verified SOC assessment → Verified SOC service: requests assessment
src/pages/VerifiedSoc.jsx - Verified SOC service → BLACKBOX service: uses service
- Case progress records → Browser storage: reads and writes
src/utils/caseProgress.js - XP and levels → Browser storage: persists XP
src/utils/xp.js - App router → Cloud progress sync: checks sync
src/App.jsx - Cloud progress sync → Firebase auth and data: syncs through
src/utils/cloudProgress.js - Account access → Firebase auth and data: authenticates
src/pages/Auth.jsx - BLACKBOX provider → Result sync controller: provides controller
src/blackbox/BlackBoxProvider.jsx - Result sync controller → BLACKBOX backend: creates backend
src/blackbox/controller.js - BLACKBOX backend → BLACKBOX service: connects to
- Case workflow → BLACKBOX provider: uses account context
src/pages/Investigation.jsx - Case workflow → Learning link and account: offers lab link
- Account access → Learning link and account: shows linking control
src/pages/Auth.jsx