How cybercx-sta/purpleops works
PurpleOps is a self-hosted purple-team management web app. Users manage engagements (assessments), create and update testcases, record red/blue outcomes and evidence, then review assessment statistics or export reports and framework-compatible data. Access management is a separate role-controlled workflow; import/export supports moving testcase and assessment data. The sampled Flask routes and models support the main runtime map. README capabilities also include MFA and framework-friendly templates; their implementation details were not sampled.
Main entry points: purpleops.py Flask application · model.py Domain models · assessment.py Assessment management · seeder.py Framework seeding
Components 18
Web application
- Flask application
purpleops.py - Web views
templates - Browser interactions
static/scripts
Engagement workflows
- Assessment management
blueprints/assessment.py - Assessment metrics
blueprints/assessment_utils.py - Testcase workflow
blueprints/testcase.py - Testcase utilities
blueprints/testcase_utils.py - Assessment import
blueprints/assessment_import.py - Assessment export
blueprints/assessment_export.py - DOCX report templates
custom/reports
Identity and access
- Access management
blueprints/access.py
Domain data
- Domain models
model.py - Form and access helpers
utils.py - Framework seeding
seeder.py - Knowledge-base entries
custom/knowledgebase
Other components
- Purple-team user
- MongoDB
- MITRE and Atomic sources
Connections 27
- Purple-team user → Flask application: uses
README.md - Flask application → Access management: registers routes
purpleops.py - Flask application → Assessment management: registers routes
purpleops.py - Flask application → Assessment metrics: registers routes
purpleops.py - Flask application → Assessment import: registers routes
purpleops.py - Flask application → Assessment export: registers routes
purpleops.py - Flask application → Testcase workflow: registers routes
purpleops.py - Flask application → Testcase utilities: registers routes
purpleops.py - Flask application → Domain models: initializes database
purpleops.py - Assessment management → Assessment metrics: calls hexagon metrics
blueprints/assessment.py - Assessment management → Domain models: reads and writes
blueprints/assessment.py - Assessment metrics → Domain models: queries assessment data
blueprints/assessment_utils.py - Testcase workflow → Domain models: reads and writes
blueprints/testcase.py - Testcase utilities → Domain models: reads and writes
blueprints/testcase_utils.py - Assessment import → Domain models: creates testcases
blueprints/assessment_import.py - Assessment export → Domain models: reads assessment data
blueprints/assessment_export.py - Assessment export → DOCX report templates: renders report
blueprints/assessment_export.py - Access management → Domain models: manages users and roles
blueprints/access.py - Assessment management → Form and access helpers: uses form and access helpers
blueprints/assessment.py - Testcase workflow → Form and access helpers: uses form and access helpers
blueprints/testcase.py - Access management → Form and access helpers: uses form helper
blueprints/access.py - Domain models → MongoDB: persists documents
- Framework seeding → Domain models: populates framework data
seeder.py - Framework seeding → MITRE and Atomic sources: downloads framework data
seeder.py - Framework seeding → Knowledge-base entries: loads knowledge entries
- Flask application → Web views: renders views
purpleops.py - Browser interactions → Flask application: sends UI requests