# mikateproduction-wq/cerbere-smart-security-auditor architecture

> Architecture diagram of the GitHub repository mikateproduction-wq/cerbere-smart-security-auditor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mikateproduction-wq/cerbere-smart-security-auditor
- Repository: https://github.com/mikateproduction-wq/cerbere-smart-security-auditor

## Overview

CERBERE is a browser-based, offline security auditor delivered as a single HTML file. Users select files or a project folder, run local checks, review and filter findings, and export a report. The README also documents translation and an optional Claude assistant. Since no source excerpts were provided, component boundaries and relationships below are based on README documentation only; the HTML file is the sole implementation path shown in the tree.

Main entry points: [`CERBERE-Smart-Security-Auditor.html`](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html) (AI Assistant Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["File Intake"]
  node_file_selection["File Selection"]
end

subgraph group_audit["Local Audit"]
  node_audit_engine["Audit Engine"]
  node_security_framework["235-Check Framework"]
end

subgraph group_reporting["Findings & Reports"]
  node_findings["Findings & Score"]
  node_finding_filters["Finding Filters"]
  node_evidence_view["Code Evidence"]
  node_report_export["JSON / Markdown Export"]
end

subgraph group_assistant["Optional AI Assistant"]
  node_assistant_panel["AI Assistant Panel"]
  node_local_storage[("Browser Local Storage")]
end

subgraph group_interface["Interface"]
  node_language_switch["FR / EN Translation"]
end

node_user(("Auditor"))
node_anthropic_api{{"Anthropic API"}}

node_user -->|"selects files"| node_file_selection
node_file_selection -->|"starts local audit"| node_audit_engine
node_audit_engine -->|"uses checks"| node_security_framework
node_audit_engine -->|"produces findings"| node_findings
node_user -->|"filters findings"| node_finding_filters
node_user -->|"reviews evidence"| node_evidence_view
node_user -->|"exports report"| node_report_export
node_findings -->|"exports report data"| node_report_export
node_user -->|"switches language"| node_language_switch
node_language_switch -->|"translates framework"| node_security_framework
node_user -->|"configures assistant"| node_assistant_panel
node_assistant_panel -->|"stores API key"| node_local_storage
node_assistant_panel -->|"verifies key"| node_anthropic_api
node_assistant_panel -.->|"requests analysis"| node_anthropic_api
node_assistant_panel -->|"falls back to"| node_audit_engine

click node_file_selection "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_audit_engine "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_security_framework "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_findings "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_finding_filters "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_evidence_view "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_report_export "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_language_switch "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"
click node_assistant_panel "https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html"

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_file_selection toneBlue
class node_audit_engine,node_security_framework toneAmber
class node_findings,node_finding_filters,node_evidence_view,node_report_export,node_anthropic_api toneMint
class node_assistant_panel,node_local_storage toneRose
class node_language_switch,node_user toneIndigo
```

## Components

### File Intake

- [File Selection](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`

### Local Audit

- [Audit Engine](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`
- [235-Check Framework](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`

### Findings & Reports

- [Findings & Score](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`
- [Finding Filters](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`
- [Code Evidence](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`
- [JSON / Markdown Export](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`

### Optional AI Assistant

- [AI Assistant Panel](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`
- **Browser Local Storage**

### Interface

- [FR / EN Translation](https://github.com/mikateproduction-wq/cerbere-smart-security-auditor/blob/main/CERBERE-Smart-Security-Auditor.html): `CERBERE-Smart-Security-Auditor.html`

### Other components

- **Auditor**
- **Anthropic API**

## Connections

- Auditor → File Selection: selects files (evidence: `README.md`)
- File Selection → Audit Engine: starts local audit (evidence: `README.md`)
- Audit Engine → 235-Check Framework: uses checks (evidence: `README.md`)
- Audit Engine → Findings & Score: produces findings (evidence: `README.md`)
- Auditor → Finding Filters: filters findings (evidence: `README.md`)
- Auditor → Code Evidence: reviews evidence (evidence: `README.md`)
- Auditor → JSON / Markdown Export: exports report (evidence: `README.md`)
- Findings & Score → JSON / Markdown Export: exports report data (evidence: `README.md`)
- Auditor → FR / EN Translation: switches language (evidence: `README.md`)
- FR / EN Translation → 235-Check Framework: translates framework (evidence: `README.md`)
- Auditor → AI Assistant Panel: configures assistant (evidence: `README.md`)
- AI Assistant Panel → Browser Local Storage: stores API key (evidence: `README.md`)
- AI Assistant Panel → Anthropic API: verifies key (evidence: `README.md`)
- AI Assistant Panel → Anthropic API: requests analysis (evidence: `README.md`)
- AI Assistant Panel → Audit Engine: falls back to (evidence: `README.md`)