# thalesgroup-cert/watcher architecture

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

- Interactive diagram: https://gitdiagram.com/thalesgroup-cert/watcher
- Repository: https://github.com/thalesgroup-cert/watcher

## Overview

Watcher is a Django/React cybersecurity threat monitoring platform. Users authenticate, configure monitored assets and rules, and review findings and intelligence through module dashboards; the backend also gathers external threat data, generates AI summaries, and supports alerts and integrations. The graph preserves README capabilities, but unsampled modules are represented at their exact app directories; edges are limited to calls or documented behavior visible in excerpts, the SOURCE INDEX, or README.

Main entry points: [`Watcher/Watcher/threats_watcher`](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/threats_watcher) (Threat intelligence), [`Watcher/Watcher/frontend/src/components/App.js`](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/App.js) (Web application), [`Watcher/Watcher/common`](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/common) (Notifications and sharing), [`Watcher/Watcher/dns_finder`](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/dns_finder) (Domain surveillance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User experience"]
  node_appui["Web application<br/>[App.js]"]
  node_authui["Login and profile<br/>[Profile.js]"]
  node_preferences["UI preferences"]
  node_dashboard["Monitoring dashboards<br/>[Dashboard.js]"]
  node_api_actions["DataLeak actions<br/>[DataLeak.js]"]
end

subgraph group_monitor["Monitoring modules"]
  node_data_leak["Data leak detection"]
  node_dns["Domain surveillance"]
  node_sites["Site monitoring"]
  node_legitimate["Legitimate domains"]
end

subgraph group_intel["Threat intelligence"]
  node_cyber_watch["Emerging threats"]
  node_threats["Threat intelligence"]
  node_summary["AI summaries and NER<br/>[summary_manager.py]"]
  node_model["Model loader<br/>[model_manager.py]"]
end

subgraph group_platform["Platform services"]
  node_timeline["Change timeline"]
  node_accounts["Authentication"]
  node_common["Notifications and sharing"]
end

subgraph group_connect["Connectors"]
  node_connectors["Connector registry<br/>[core.py]"]
  node_connector_ui["Connector management<br/>[Dashboard.js]"]
end

node_user(("Security user"))
node_external(("Threat data sources"))
node_integrations(("External services"))
node_db[("Application database")]

node_user -->|"uses"| node_appui
node_appui -->|"routes to"| node_authui
node_appui -->|"routes to"| node_dashboard
node_appui -->|"loads identity"| node_accounts
node_authui -->|"reads preferences"| node_preferences
node_dashboard -->|"dispatches"| node_api_actions
node_api_actions -.->|"requests data"| node_data_leak
node_data_leak -.->|"stores findings"| node_db
node_dns -->|"monitors certificates"| node_external
node_dns -.->|"stores monitoring state"| node_db
node_sites -.->|"stores site state"| node_db
node_legitimate -.->|"stores domains"| node_db
node_cyber_watch -->|"tracks advisories"| node_external
node_threats -->|"fetches intelligence"| node_external
node_summary -->|"loads models"| node_model
node_threats -->|"summarizes threats"| node_summary
node_threats -.->|"stores intelligence"| node_db
node_timeline -.->|"tracks changes"| node_db
node_accounts -.->|"stores accounts"| node_db
node_common -->|"sends notifications"| node_integrations
node_connectors -.->|"serves connector management"| node_connector_ui
node_connectors -->|"connects services"| node_integrations
node_threats -->|"exports to MISP or TheHive"| node_integrations
node_cyber_watch -->|"notifies findings"| node_common
node_sites -->|"notifies findings"| node_common
node_dns -->|"notifies findings"| node_common

click node_appui "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/App.js"
click node_authui "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/accounts/Profile.js"
click node_preferences "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/services/preferencesService.js"
click node_dashboard "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/DataLeak/Dashboard.js"
click node_api_actions "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/actions/DataLeak.js"
click node_data_leak "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/data_leak"
click node_dns "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/dns_finder"
click node_sites "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/site_monitoring"
click node_legitimate "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/common"
click node_cyber_watch "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/cyber_watch"
click node_threats "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/threats_watcher"
click node_summary "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/threats_watcher/summary_manager.py"
click node_model "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/threats_watcher/model_manager.py"
click node_timeline "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/timeline"
click node_accounts "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/accounts"
click node_common "https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/common"
click node_connectors "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/connectors/core.py"
click node_connector_ui "https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/Connectors/Dashboard.js"

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_appui,node_authui,node_preferences,node_dashboard,node_api_actions,node_user toneBlue
class node_data_leak,node_dns,node_sites,node_legitimate,node_db toneAmber
class node_cyber_watch,node_threats,node_summary,node_model toneMint
class node_timeline,node_accounts,node_common toneRose
class node_connectors,node_connector_ui,node_external,node_integrations toneIndigo
```

## Components

### User experience

- [Web application](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/App.js): `Watcher/Watcher/frontend/src/components/App.js`
- [Login and profile](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/accounts/Profile.js): `Watcher/Watcher/frontend/src/components/accounts/Profile.js`
- [UI preferences](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/services/preferencesService.js): `Watcher/Watcher/frontend/src/services/preferencesService.js`
- [Monitoring dashboards](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/DataLeak/Dashboard.js): `Watcher/Watcher/frontend/src/components/DataLeak/Dashboard.js`
- [DataLeak actions](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/actions/DataLeak.js): `Watcher/Watcher/frontend/src/actions/DataLeak.js`

### Monitoring modules

- [Data leak detection](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/data_leak): `Watcher/Watcher/data_leak`
- [Domain surveillance](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/dns_finder): `Watcher/Watcher/dns_finder`
- [Site monitoring](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/site_monitoring): `Watcher/Watcher/site_monitoring`
- [Legitimate domains](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/common): `Watcher/Watcher/common`

### Threat intelligence

- [Emerging threats](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/cyber_watch): `Watcher/Watcher/cyber_watch`
- [Threat intelligence](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/threats_watcher): `Watcher/Watcher/threats_watcher`
- [AI summaries and NER](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/threats_watcher/summary_manager.py): `Watcher/Watcher/threats_watcher/summary_manager.py`
- [Model loader](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/threats_watcher/model_manager.py): `Watcher/Watcher/threats_watcher/model_manager.py`

### Platform services

- [Change timeline](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/timeline): `Watcher/Watcher/timeline`
- [Authentication](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/accounts): `Watcher/Watcher/accounts`
- [Notifications and sharing](https://github.com/thalesgroup-cert/watcher/tree/master/Watcher/Watcher/common): `Watcher/Watcher/common`

### Connectors

- [Connector registry](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/connectors/core.py): `Watcher/Watcher/connectors/core.py`
- [Connector management](https://github.com/thalesgroup-cert/watcher/blob/master/Watcher/Watcher/frontend/src/components/Connectors/Dashboard.js): `Watcher/Watcher/frontend/src/components/Connectors/Dashboard.js`

### Other components

- **Security user**
- **Threat data sources**
- **External services**
- **Application database**

## Connections

- Security user → Web application: uses (evidence: `README.md`)
- Web application → Login and profile: routes to (evidence: `Watcher/Watcher/frontend/src/components/App.js`)
- Web application → Monitoring dashboards: routes to (evidence: `Watcher/Watcher/frontend/src/components/App.js`)
- Web application → Authentication: loads identity (evidence: `Watcher/Watcher/frontend/src/components/App.js`)
- Login and profile → UI preferences: reads preferences (evidence: `Watcher/Watcher/frontend/src/components/accounts/Profile.js`)
- Monitoring dashboards → DataLeak actions: dispatches (evidence: `Watcher/Watcher/frontend/src/components/DataLeak/Dashboard.js`)
- DataLeak actions → Data leak detection: requests data
- Data leak detection → Application database: stores findings
- Domain surveillance → Threat data sources: monitors certificates (evidence: `README.md`)
- Domain surveillance → Application database: stores monitoring state
- Site monitoring → Application database: stores site state
- Legitimate domains → Application database: stores domains
- Emerging threats → Threat data sources: tracks advisories (evidence: `README.md`)
- Threat intelligence → Threat data sources: fetches intelligence (evidence: `README.md`)
- AI summaries and NER → Model loader: loads models (evidence: `Watcher/Watcher/threats_watcher/summary_manager.py`)
- Threat intelligence → AI summaries and NER: summarizes threats (evidence: `Watcher/Watcher/threats_watcher/summary_manager.py`)
- Threat intelligence → Application database: stores intelligence
- Change timeline → Application database: tracks changes
- Authentication → Application database: stores accounts
- Notifications and sharing → External services: sends notifications (evidence: `README.md`)
- Connector registry → Connector management: serves connector management
- Connector registry → External services: connects services (evidence: `README.md`)
- Threat intelligence → External services: exports to MISP or TheHive (evidence: `README.md`)
- Emerging threats → Notifications and sharing: notifies findings (evidence: `README.md`)
- Site monitoring → Notifications and sharing: notifies findings (evidence: `README.md`)
- Domain surveillance → Notifications and sharing: notifies findings (evidence: `README.md`)
