# cybercx-sta/purpleops architecture

> Architecture diagram of the GitHub repository cybercx-sta/purpleops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cybercx-sta/purpleops
- Repository: https://github.com/cybercx-sta/purpleops

## Overview

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`](https://github.com/cybercx-sta/purpleops/blob/main/purpleops.py) (Flask application), [`model.py`](https://github.com/cybercx-sta/purpleops/blob/main/model.py) (Domain models), [`blueprints/assessment.py`](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment.py) (Assessment management), [`seeder.py`](https://github.com/cybercx-sta/purpleops/blob/main/seeder.py) (Framework seeding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Flask application<br/>[purpleops.py]"]
  node_templates["Web views"]
  node_scripts["Browser interactions"]
end

subgraph group_engagement["Engagement workflows"]
  node_assessment["Assessment management<br/>[assessment.py]"]
  node_assessment_utils["Assessment metrics"]
  node_testcase["Testcase workflow<br/>[testcase.py]"]
  node_testcase_utils["Testcase utilities<br/>[testcase_utils.py]"]
  node_import["Assessment import"]
  node_export["Assessment export"]
  node_report_templates["DOCX report templates"]
end

subgraph group_identity["Identity and access"]
  node_access["Access management<br/>[access.py]"]
end

subgraph group_domain["Domain data"]
  node_models["Domain models<br/>[model.py]"]
  node_helpers["Form and access helpers<br/>[utils.py]"]
  node_seeder["Framework seeding<br/>[seeder.py]"]
  node_catalog["Knowledge-base entries"]
end

node_operator(("Purple-team user"))
node_mongo[("MongoDB")]
node_frameworks["MITRE and Atomic sources"]

node_operator -->|"uses"| node_app
node_app -->|"registers routes"| node_access
node_app -->|"registers routes"| node_assessment
node_app -->|"registers routes"| node_assessment_utils
node_app -->|"registers routes"| node_import
node_app -->|"registers routes"| node_export
node_app -->|"registers routes"| node_testcase
node_app -->|"registers routes"| node_testcase_utils
node_app -->|"initializes database"| node_models
node_assessment -->|"calls hexagon metrics"| node_assessment_utils
node_assessment -->|"reads and writes"| node_models
node_assessment_utils -->|"queries assessment data"| node_models
node_testcase -->|"reads and writes"| node_models
node_testcase_utils -->|"reads and writes"| node_models
node_import -->|"creates testcases"| node_models
node_export -->|"reads assessment data"| node_models
node_export -->|"renders report"| node_report_templates
node_access -->|"manages users and roles"| node_models
node_assessment -->|"uses form and access helpers"| node_helpers
node_testcase -->|"uses form and access helpers"| node_helpers
node_access -->|"uses form helper"| node_helpers
node_models -.->|"persists documents"| node_mongo
node_seeder -->|"populates framework data"| node_models
node_seeder -->|"downloads framework data"| node_frameworks
node_seeder -.->|"loads knowledge entries"| node_catalog
node_app -->|"renders views"| node_templates
node_scripts -.->|"sends UI requests"| node_app

click node_app "https://github.com/cybercx-sta/purpleops/blob/main/purpleops.py"
click node_templates "https://github.com/cybercx-sta/purpleops/tree/main/templates"
click node_scripts "https://github.com/cybercx-sta/purpleops/tree/main/static/scripts"
click node_access "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/access.py"
click node_assessment "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment.py"
click node_assessment_utils "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_utils.py"
click node_testcase "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/testcase.py"
click node_testcase_utils "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/testcase_utils.py"
click node_import "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_import.py"
click node_export "https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_export.py"
click node_models "https://github.com/cybercx-sta/purpleops/blob/main/model.py"
click node_helpers "https://github.com/cybercx-sta/purpleops/blob/main/utils.py"
click node_seeder "https://github.com/cybercx-sta/purpleops/blob/main/seeder.py"
click node_catalog "https://github.com/cybercx-sta/purpleops/tree/main/custom/knowledgebase"
click node_report_templates "https://github.com/cybercx-sta/purpleops/tree/main/custom/reports"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_templates,node_scripts,node_operator toneBlue
class node_assessment,node_assessment_utils,node_testcase,node_testcase_utils,node_import,node_export,node_report_templates,node_mongo toneAmber
class node_access toneMint
class node_models,node_helpers,node_seeder,node_catalog toneRose
class node_frameworks toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/cybercx-sta/purpleops/blob/main/purpleops.py): `purpleops.py`
- [Web views](https://github.com/cybercx-sta/purpleops/tree/main/templates): `templates`
- [Browser interactions](https://github.com/cybercx-sta/purpleops/tree/main/static/scripts): `static/scripts`

### Engagement workflows

- [Assessment management](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment.py): `blueprints/assessment.py`
- [Assessment metrics](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_utils.py): `blueprints/assessment_utils.py`
- [Testcase workflow](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/testcase.py): `blueprints/testcase.py`
- [Testcase utilities](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/testcase_utils.py): `blueprints/testcase_utils.py`
- [Assessment import](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_import.py): `blueprints/assessment_import.py`
- [Assessment export](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/assessment_export.py): `blueprints/assessment_export.py`
- [DOCX report templates](https://github.com/cybercx-sta/purpleops/tree/main/custom/reports): `custom/reports`

### Identity and access

- [Access management](https://github.com/cybercx-sta/purpleops/blob/main/blueprints/access.py): `blueprints/access.py`

### Domain data

- [Domain models](https://github.com/cybercx-sta/purpleops/blob/main/model.py): `model.py`
- [Form and access helpers](https://github.com/cybercx-sta/purpleops/blob/main/utils.py): `utils.py`
- [Framework seeding](https://github.com/cybercx-sta/purpleops/blob/main/seeder.py): `seeder.py`
- [Knowledge-base entries](https://github.com/cybercx-sta/purpleops/tree/main/custom/knowledgebase): `custom/knowledgebase`

### Other components

- **Purple-team user**
- **MongoDB**
- **MITRE and Atomic sources**

## Connections

- Purple-team user → Flask application: uses (evidence: `README.md`)
- Flask application → Access management: registers routes (evidence: `purpleops.py`)
- Flask application → Assessment management: registers routes (evidence: `purpleops.py`)
- Flask application → Assessment metrics: registers routes (evidence: `purpleops.py`)
- Flask application → Assessment import: registers routes (evidence: `purpleops.py`)
- Flask application → Assessment export: registers routes (evidence: `purpleops.py`)
- Flask application → Testcase workflow: registers routes (evidence: `purpleops.py`)
- Flask application → Testcase utilities: registers routes (evidence: `purpleops.py`)
- Flask application → Domain models: initializes database (evidence: `purpleops.py`)
- Assessment management → Assessment metrics: calls hexagon metrics (evidence: `blueprints/assessment.py`)
- Assessment management → Domain models: reads and writes (evidence: `blueprints/assessment.py`)
- Assessment metrics → Domain models: queries assessment data (evidence: `blueprints/assessment_utils.py`)
- Testcase workflow → Domain models: reads and writes (evidence: `blueprints/testcase.py`)
- Testcase utilities → Domain models: reads and writes (evidence: `blueprints/testcase_utils.py`)
- Assessment import → Domain models: creates testcases (evidence: `blueprints/assessment_import.py`)
- Assessment export → Domain models: reads assessment data (evidence: `blueprints/assessment_export.py`)
- Assessment export → DOCX report templates: renders report (evidence: `blueprints/assessment_export.py`)
- Access management → Domain models: manages users and roles (evidence: `blueprints/access.py`)
- Assessment management → Form and access helpers: uses form and access helpers (evidence: `blueprints/assessment.py`)
- Testcase workflow → Form and access helpers: uses form and access helpers (evidence: `blueprints/testcase.py`)
- Access management → Form and access helpers: uses form helper (evidence: `blueprints/access.py`)
- Domain models → MongoDB: persists documents
- Framework seeding → Domain models: populates framework data (evidence: `seeder.py`)
- Framework seeding → MITRE and Atomic sources: downloads framework data (evidence: `seeder.py`)
- Framework seeding → Knowledge-base entries: loads knowledge entries
- Flask application → Web views: renders views (evidence: `purpleops.py`)
- Browser interactions → Flask application: sends UI requests
