# ayoubbenkhiroun/variables_auditor architecture

> Architecture diagram of the GitHub repository ayoubbenkhiroun/variables_auditor, 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/ayoubbenkhiroun/variables_auditor
- Repository: https://github.com/ayoubbenkhiroun/variables_auditor

## Overview

AuditFlow Pro is a client-side BPMN governance and audit suite for Camunda 7 and 8. The main workflow is to load BPMN files and reference data, audit variables and process relationships, inspect findings, then apply coordinated fixes or export reports. Separate capabilities cover BPMN health linting, naming rules, version comparison, process governance, ROI, specifications, RACI, a data catalog, and BPMN training/modeling. The README documents the product-level flows; where source excerpts do not show module wiring, edges cite that documentation rather than implying direct calls.

Main entry points: [`js/app.js`](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js) (Audit Workspace), [`js/pmg.js`](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/pmg.js) (Process Governance), [`js/autofix.js`](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/autofix.js) (Coordinated Auto-Fix), [`js/academy.js`](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy.js) (BPMN Academy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audit["Audit &amp; Analysis"]
  node_variable_audit["Variable Audit<br/>[app.js]"]
  node_lineage["Variable Lineage<br/>[lineage.js]"]
  node_duplicates["Duplicate Detection<br/>[duplicates.js]"]
  node_bpmn_lint["BPMN Health Lint<br/>[bpmn_lint.js]"]
  node_naming_rules["Naming Rules<br/>[bpmn_rules.js]"]
  node_rule_config["Audit Rules<br/>[rules.js]"]
end

subgraph group_governance["Process Governance"]
  node_process_map["Process Mapping<br/>[app.js]"]
  node_pmg["Process Governance<br/>[pmg.js]"]
  node_data_catalog["Data Catalog<br/>[data_catalog.js]"]
  node_raci["RACI Matrix<br/>[raci_matrix.js]"]
  node_security["Security Workspace"]
end

subgraph group_outputs["Reports &amp; Fixes"]
  node_autofix["Coordinated Auto-Fix<br/>[autofix.js]"]
  node_diff["BPMN Version Diff<br/>[diff.js]"]
  node_specs["Living Specifications<br/>[specs_gen.js]"]
  node_report["Exported Reports"]
end

subgraph group_learning["Academy &amp; Modeling"]
  node_academy["BPMN Academy<br/>[academy.js]"]
  node_academy_content["Academy Content<br/>[academy_data.js]"]
  node_academy_studio["Modeling Studio<br/>[academy_studio.js]"]
end

subgraph group_platform["Client Platform"]
  node_app["Audit Workspace<br/>[app.js]"]
  node_session_store[("Local History<br/>[db.js]")]
  node_desktop["Desktop Window<br/>[main.js]"]
end

node_user(("Process Analyst"))

node_user -->|"uses"| node_app
node_desktop -->|"loads"| node_app
node_app -->|"runs audit"| node_variable_audit
node_variable_audit -->|"traces variables"| node_lineage
node_variable_audit -->|"checks duplicates"| node_duplicates
node_variable_audit -->|"maps calls"| node_process_map
node_app -->|"runs lint"| node_bpmn_lint
node_app -->|"applies rules"| node_naming_rules
node_app -.->|"configures audits"| node_rule_config
node_app -->|"opens governance"| node_pmg
node_app -->|"opens catalog"| node_data_catalog
node_app -->|"opens matrix"| node_raci
node_app -.->|"opens workspace"| node_security
node_variable_audit -->|"fixes variables"| node_autofix
node_app -->|"compares versions"| node_diff
node_app -->|"generates specifications"| node_specs
node_app -.->|"opens academy"| node_academy
node_academy -.->|"uses content"| node_academy_content
node_app -.->|"opens studio"| node_academy_studio
node_app -->|"persists history"| node_session_store
node_autofix -->|"exports ZIP"| node_report
node_app -->|"exports reports"| node_report
node_pmg -.->|"generates report"| node_report

click node_app "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js"
click node_variable_audit "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js"
click node_lineage "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/lineage.js"
click node_duplicates "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/duplicates.js"
click node_bpmn_lint "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/bpmn_lint.js"
click node_naming_rules "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/bpmn_rules.js"
click node_rule_config "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/rules.js"
click node_process_map "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js"
click node_pmg "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/pmg.js"
click node_data_catalog "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/data_catalog.js"
click node_raci "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/raci_matrix.js"
click node_security "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/security_workspace.js"
click node_autofix "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/autofix.js"
click node_diff "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/diff.js"
click node_specs "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/specs_gen.js"
click node_academy "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy.js"
click node_academy_content "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy_data.js"
click node_academy_studio "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy_studio.js"
click node_session_store "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/db.js"
click node_desktop "https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/main.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_variable_audit,node_lineage,node_duplicates,node_bpmn_lint,node_naming_rules,node_rule_config toneBlue
class node_process_map,node_pmg,node_data_catalog,node_raci,node_security toneAmber
class node_autofix,node_diff,node_specs,node_report toneMint
class node_academy,node_academy_content,node_academy_studio toneRose
class node_app,node_session_store,node_desktop,node_user toneIndigo
```

## Components

### Audit & Analysis

- [Variable Audit](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js): `js/app.js`
- [Variable Lineage](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/lineage.js): `js/lineage.js`
- [Duplicate Detection](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/duplicates.js): `js/duplicates.js`
- [BPMN Health Lint](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/bpmn_lint.js): `js/bpmn_lint.js`
- [Naming Rules](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/bpmn_rules.js): `js/bpmn_rules.js`
- [Audit Rules](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/rules.js): `js/rules.js`

### Process Governance

- [Process Mapping](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js): `js/app.js`
- [Process Governance](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/pmg.js): `js/pmg.js`
- [Data Catalog](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/data_catalog.js): `js/data_catalog.js`
- [RACI Matrix](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/raci_matrix.js): `js/raci_matrix.js`
- [Security Workspace](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/security_workspace.js): `js/security_workspace.js`

### Reports & Fixes

- [Coordinated Auto-Fix](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/autofix.js): `js/autofix.js`
- [BPMN Version Diff](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/diff.js): `js/diff.js`
- [Living Specifications](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/specs_gen.js): `js/specs_gen.js`
- **Exported Reports**

### Academy & Modeling

- [BPMN Academy](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy.js): `js/academy.js`
- [Academy Content](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy_data.js): `js/academy_data.js`
- [Modeling Studio](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/academy_studio.js): `js/academy_studio.js`

### Client Platform

- [Audit Workspace](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/app.js): `js/app.js`
- [Local History](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/js/db.js): `js/db.js`
- [Desktop Window](https://github.com/ayoubbenkhiroun/variables_auditor/blob/main/main.js): `main.js`

### Other components

- **Process Analyst**

## Connections

- Process Analyst → Audit Workspace: uses (evidence: `README.md`)
- Desktop Window → Audit Workspace: loads (evidence: `main.js`)
- Audit Workspace → Variable Audit: runs audit (evidence: `README.md`)
- Variable Audit → Variable Lineage: traces variables (evidence: `README.md`)
- Variable Audit → Duplicate Detection: checks duplicates (evidence: `README.md`)
- Variable Audit → Process Mapping: maps calls (evidence: `README.md`)
- Audit Workspace → BPMN Health Lint: runs lint (evidence: `README.md`)
- Audit Workspace → Naming Rules: applies rules (evidence: `README.md`)
- Audit Workspace → Audit Rules: configures audits
- Audit Workspace → Process Governance: opens governance (evidence: `README.md`)
- Audit Workspace → Data Catalog: opens catalog (evidence: `README.md`)
- Audit Workspace → RACI Matrix: opens matrix (evidence: `README.md`)
- Audit Workspace → Security Workspace: opens workspace
- Variable Audit → Coordinated Auto-Fix: fixes variables (evidence: `README.md`)
- Audit Workspace → BPMN Version Diff: compares versions (evidence: `README.md`)
- Audit Workspace → Living Specifications: generates specifications (evidence: `README.md`)
- Audit Workspace → BPMN Academy: opens academy
- BPMN Academy → Academy Content: uses content
- Audit Workspace → Modeling Studio: opens studio
- Audit Workspace → Local History: persists history (evidence: `README.md`)
- Coordinated Auto-Fix → Exported Reports: exports ZIP (evidence: `README.md`)
- Audit Workspace → Exported Reports: exports reports (evidence: `README.md`)
- Process Governance → Exported Reports: generates report
