How saber20005/blackbox-lab works
BLACKBOX Lab is an Arabic static cybersecurity training application. Learners choose a track and stage, work through guided exercises, and save progress, notes, and results; the app also provides account sync, linked skills, planning, and learner reporting. The graph includes the documented training and learner-tool branches, while showing only relationships supported by the excerpts, SOURCE INDEX, or README. Some peripheral page implementations were not sampled, so their internal connections are omitted.
Main entry points: app.js App interface · index.js Grading endpoints · account-sync.js Account sync · firebase-client.js Firebase adapter
Components 26
Training experience
- App interface
app.js - Route handling
routes.js - Track content
data.js - Defense tracks
defense-tracks.js - Evidence workbench
evidence-workbench.js
Progress and accounts
- Progress and backups
progress.js - Account interface
account-ui.js - Account sync
account-sync.js - Firebase adapter
firebase-client.js
Learner tools
- Linked skills
linked-skills-ui.js - CyberTrace catalog
cybertrace-catalog.js - Session planning
training-plan.js - Planning interface
training-plan-ui.js - Missions
mission-mode.js - Portfolio
portfolio.js - Portfolio page
portfolio-page.js - Local VM inspector
local-agent/vm_inspector.py - Usage analytics
analytics.js
Verified assessments
- Grading client
verified-grading-client.js - Grading endpoints
functions/index.js - Session allocation
functions/session-store.js - Answer grading
functions/grading-core.js - SOC assessment service
functions/soc-verified-service.js - SOC scoring rules
functions/soc-verified-core.js
Other components
- Learner
- Firebase services
Connections 28
- Learner → App interface: uses
README.md - App interface → Route handling: parses routes
app.js - Route handling → Track content: validates tracks
routes.js - App interface → Track content: renders training
app.js - Track content → Defense tracks: includes tracks
data.js - App interface → Progress and backups: loads and saves
app.js - App interface → Evidence workbench: uses workbench
app.js - App interface → Account interface: uses account UI
app.js - App interface → Account sync: saves account data
app.js - Account sync → Progress and backups: normalizes state
account-sync.js - Account sync → Firebase adapter: creates backend
account-sync.js - Firebase adapter → Firebase services: reads and writes
firebase-client.js - Firebase adapter → CyberTrace catalog: normalizes receipts
firebase-client.js - App interface → Linked skills: renders skills
app.js - Linked skills → CyberTrace catalog: aggregates receipts
linked-skills-ui.js - App interface → Planning interface: uses planner UI
app.js - Planning interface → Session planning: builds session plan
training-plan-ui.js - App interface → Missions: provides missions
- App interface → Portfolio page: provides portfolio
- Portfolio page → Portfolio: uses portfolio data
portfolio-page.js - Learner → Local VM inspector: runs locally
README.md - App interface → Grading client: submits answers
app.js - Grading client → Grading endpoints: calls assessment service
- Grading endpoints → Session allocation: allocates sessions
functions/index.js - Grading endpoints → Answer grading: validates cases
functions/index.js - Grading endpoints → SOC assessment service: dispatches SOC checks
functions/index.js - SOC assessment service → SOC scoring rules: validates and scores
functions/soc-verified-service.js - App interface → Usage analytics: records events
app.js