# yuvarajucet/defect-dojo-pr-monitor architecture

> Architecture diagram of the GitHub repository yuvarajucet/defect-dojo-pr-monitor, 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/yuvarajucet/defect-dojo-pr-monitor
- Repository: https://github.com/yuvarajucet/defect-dojo-pr-monitor

## Overview

DefectDojo is a web-based application security and vulnerability management platform. Users bring in scan results through supported tool parsers or the REST API; the application tracks findings, supports deduplication and remediation, and provides reports. Its broader capabilities include product and engagement management, access control, search, metrics, surveys, and integrations such as Jira and notifications. The map combines README-documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details and wiring are not asserted.

Main entry points: [`dojo/finding/views.py`](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/views.py) (Findings), [`dojo/product/views.py`](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/product/views.py) (Products), [`dojo/authorization/authorization.py`](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/authorization/authorization.py) (Authorization), [`dojo/models.py`](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/models.py) (Domain Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Scan Ingestion"]
  node_tools["Tool Parsers<br/>[factory.py]"]
  node_importers["Scan Importers<br/>[base_importer.py]"]
end

subgraph group_core["Vulnerability Management"]
  node_products["Products<br/>[views.py]"]
  node_engagements["Engagements<br/>[views.py]"]
  node_findings["Findings<br/>[views.py]"]
  node_finding_queries["Finding Queries<br/>[queries.py]"]
  node_dedup["Deduplication<br/>[helper.py]"]
  node_models[("Domain Records<br/>[models.py]")]
  node_product_type_queries["Product Type Queries<br/>[queries.py]"]
end

subgraph group_access["Access and Views"]
  node_api["REST API<br/>[views.py]"]
  node_authorization["Authorization<br/>[authorization.py]"]
  node_permissions["Roles and Permissions"]
  node_filters["Filtering<br/>[filters.py]"]
  node_user_queries["User Queries<br/>[queries.py]"]
end

subgraph group_integrations["Reporting and Integrations"]
  node_reports["Reports<br/>[views.py]"]
  node_metrics["Metrics<br/>[views.py]"]
  node_search["Search<br/>[views.py]"]
  node_jira["Jira Integration<br/>[helper.py]"]
  node_jira_views["Jira Views<br/>[views.py]"]
  node_notifications["Notifications<br/>[helper.py]"]
  node_celery["Background Tasks<br/>[celery.py]"]
  node_surveys["Surveys<br/>[views.py]"]
end

node_user(("Security User"))

node_user -->|"uses API"| node_api
node_user -->|"uploads scans"| node_tools
node_tools -.->|"parses results"| node_importers
node_importers -.->|"creates records"| node_models
node_api -.->|"manages records"| node_models
node_user -.->|"manages products"| node_products
node_products -->|"organizes testing"| node_engagements
node_engagements -->|"tracks findings"| node_findings
node_findings -->|"reads and writes"| node_models
node_findings -->|"uses queries"| node_finding_queries
node_findings -->|"updates findings"| node_dedup
node_dedup -->|"updates records"| node_models
node_findings -->|"links issues"| node_jira
node_jira_views -.->|"uses integration"| node_jira
node_authorization -->|"checks roles"| node_permissions
node_products -->|"checks access"| node_authorization
node_products -->|"filters views"| node_filters
node_product_type_queries -->|"checks access"| node_authorization
node_user_queries -.->|"supports access"| node_authorization
node_user -->|"views reports"| node_reports
node_user -.->|"views metrics"| node_metrics
node_user -.->|"searches records"| node_search
node_findings -.->|"triggers notices"| node_notifications
node_notifications -->|"schedules tasks"| node_celery
node_user -.->|"uses surveys"| node_surveys

click node_api "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/api_v2/views.py"
click node_tools "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/tools/factory.py"
click node_importers "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/importers/base_importer.py"
click node_products "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/product/views.py"
click node_engagements "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/engagement/views.py"
click node_findings "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/views.py"
click node_finding_queries "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/queries.py"
click node_dedup "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/helper.py"
click node_models "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/models.py"
click node_authorization "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/authorization/authorization.py"
click node_permissions "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/authorization/roles_permissions.py"
click node_filters "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/filters.py"
click node_user_queries "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/user/queries.py"
click node_product_type_queries "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/product_type/queries.py"
click node_reports "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/reports/views.py"
click node_metrics "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/metrics/views.py"
click node_search "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/search/views.py"
click node_jira "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/jira_link/helper.py"
click node_jira_views "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/jira_link/views.py"
click node_notifications "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/notifications/helper.py"
click node_celery "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/celery.py"
click node_surveys "https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/survey/views.py"

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_tools,node_importers,node_user toneBlue
class node_products,node_engagements,node_findings,node_finding_queries,node_dedup,node_models,node_product_type_queries toneAmber
class node_api,node_authorization,node_permissions,node_filters,node_user_queries toneMint
class node_reports,node_metrics,node_search,node_jira,node_jira_views,node_notifications,node_celery,node_surveys toneRose
```

## Components

### Scan Ingestion

- [Tool Parsers](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/tools/factory.py): `dojo/tools/factory.py`
- [Scan Importers](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/importers/base_importer.py): `dojo/importers/base_importer.py`

### Vulnerability Management

- [Products](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/product/views.py): `dojo/product/views.py`
- [Engagements](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/engagement/views.py): `dojo/engagement/views.py`
- [Findings](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/views.py): `dojo/finding/views.py`
- [Finding Queries](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/queries.py): `dojo/finding/queries.py`
- [Deduplication](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/finding/helper.py): `dojo/finding/helper.py`
- [Domain Records](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/models.py): `dojo/models.py`
- [Product Type Queries](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/product_type/queries.py): `dojo/product_type/queries.py`

### Access and Views

- [REST API](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/api_v2/views.py): `dojo/api_v2/views.py`
- [Authorization](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/authorization/authorization.py): `dojo/authorization/authorization.py`
- [Roles and Permissions](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/authorization/roles_permissions.py): `dojo/authorization/roles_permissions.py`
- [Filtering](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/filters.py): `dojo/filters.py`
- [User Queries](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/user/queries.py): `dojo/user/queries.py`

### Reporting and Integrations

- [Reports](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/reports/views.py): `dojo/reports/views.py`
- [Metrics](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/metrics/views.py): `dojo/metrics/views.py`
- [Search](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/search/views.py): `dojo/search/views.py`
- [Jira Integration](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/jira_link/helper.py): `dojo/jira_link/helper.py`
- [Jira Views](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/jira_link/views.py): `dojo/jira_link/views.py`
- [Notifications](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/notifications/helper.py): `dojo/notifications/helper.py`
- [Background Tasks](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/celery.py): `dojo/celery.py`
- [Surveys](https://github.com/yuvarajucet/defect-dojo-pr-monitor/blob/development/dojo/survey/views.py): `dojo/survey/views.py`

### Other components

- **Security User**

## Connections

- Security User → REST API: uses API
- Security User → Tool Parsers: uploads scans
- Tool Parsers → Scan Importers: parses results
- Scan Importers → Domain Records: creates records
- REST API → Domain Records: manages records
- Security User → Products: manages products
- Products → Engagements: organizes testing (evidence: `dojo/product/views.py`)
- Engagements → Findings: tracks findings
- Findings → Domain Records: reads and writes (evidence: `dojo/finding/views.py`)
- Findings → Finding Queries: uses queries (evidence: `dojo/finding/views.py`)
- Findings → Deduplication: updates findings (evidence: `dojo/finding/views.py`)
- Deduplication → Domain Records: updates records (evidence: `dojo/finding/helper.py`)
- Findings → Jira Integration: links issues (evidence: `dojo/finding/views.py`)
- Jira Views → Jira Integration: uses integration
- Authorization → Roles and Permissions: checks roles (evidence: `dojo/authorization/authorization.py`)
- Products → Authorization: checks access (evidence: `dojo/product/views.py`)
- Products → Filtering: filters views (evidence: `dojo/product/views.py`)
- Product Type Queries → Authorization: checks access
- User Queries → Authorization: supports access
- Security User → Reports: views reports
- Security User → Metrics: views metrics
- Security User → Search: searches records
- Findings → Notifications: triggers notices (evidence: `dojo/finding/views.py`)
- Notifications → Background Tasks: schedules tasks (evidence: `dojo/notifications/helper.py`)
- Security User → Surveys: uses surveys
