# caueb/chimas architecture

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

## Overview

Chimas is a client-side Snaffler and Group3r output analysis application. Users load scan files, then inspect Snaffler file/share findings or Group3r GPO settings and security misconfigurations; optional BloodHound exports add affected-asset and precedence context. The graph emphasizes the App-owned upload, view selection, scoring, and export actions, with parsers and analysis utilities as an internal layer. Relationships are based on the supplied excerpts, SOURCE INDEX references, and README; unsampled implementations are represented only where documented or indexed.

Main entry points: [`src/App.tsx`](https://github.com/caueb/chimas/blob/main/src/App.tsx) (View coordinator), [`src/components/Misconfigurations.tsx`](https://github.com/caueb/chimas/blob/main/src/components/Misconfigurations.tsx) (Security baseline), [`src/components/GPODetails.tsx`](https://github.com/caueb/chimas/blob/main/src/components/GPODetails.tsx) (GPO settings), [`src/components/Dashboard.tsx`](https://github.com/caueb/chimas/blob/main/src/components/Dashboard.tsx) (Findings dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app["View coordinator<br/>[App.tsx]"]
  node_upload["File upload<br/>[FileUpload.tsx]"]
  node_table["Results table<br/>[Table.tsx]"]
  node_pagination["Pagination<br/>[Pagination.tsx]"]
  node_layout["Panel layout<br/>[PanelLayout.tsx]"]
  node_storage[("Browser storage<br/>[useLocalStorage.ts]")]
end

subgraph group_snaffler["Snaffler analysis"]
  node_dashboard["Findings dashboard<br/>[Dashboard.tsx]"]
  node_files["File findings"]
  node_shares["Share findings<br/>[ShareResults.tsx]"]
  node_attack["Attack opportunities"]
end

subgraph group_group3r["Group3r analysis"]
  node_gpodashboard["GPO inventory<br/>[GPODashboard.tsx]"]
  node_gpodetails["GPO settings<br/>[GPODetails.tsx]"]
  node_gporesults["GPO findings<br/>[GPOResults.tsx]"]
  node_misconfigs["Security baseline"]
  node_bhmodal["BloodHound import"]
end

subgraph group_analysis["Parsing and analysis"]
  node_fileprocessor["Upload processor<br/>[fileProcessor.ts]"]
  node_fileparser["Snaffler parser<br/>[parser.ts]"]
  node_risk["Risk scoring<br/>[riskScoring.ts]"]
  node_export["Report export<br/>[exporter.ts]"]
  node_gpoparser["GPO parser<br/>[GPOParser.ts]"]
  node_detection["Misconfiguration detection"]
  node_values["Security value definitions"]
  node_bhparser["BloodHound resolver"]
end

node_user(("Analyst"))
node_bhdata["BloodHound exports"]

node_user -->|"selects files"| node_upload
node_app -->|"renders"| node_upload
node_app -->|"processes upload"| node_fileprocessor
node_fileprocessor -->|"parses Snaffler"| node_fileparser
node_app -->|"scores findings"| node_risk
node_app -->|"selects view"| node_dashboard
node_app -->|"selects view"| node_files
node_app -->|"selects view"| node_shares
node_dashboard -->|"uses parsed data"| node_fileparser
node_dashboard -->|"renders"| node_attack
node_files -->|"renders"| node_table
node_shares -->|"uses parsed data"| node_fileparser
node_app -->|"exports selected view"| node_export
node_app -->|"selects view"| node_gpodashboard
node_app -->|"selects view"| node_gpodetails
node_app -->|"selects view"| node_gporesults
node_app -->|"selects view"| node_misconfigs
node_gpodashboard -->|"uses GPO data"| node_gpoparser
node_gpodetails -->|"uses GPO data"| node_gpoparser
node_gporesults -->|"uses GPO data"| node_gpoparser
node_misconfigs -->|"detects issues"| node_detection
node_misconfigs -->|"uses definitions"| node_values
node_user -->|"loads exports"| node_bhmodal
node_bhmodal -->|"parses exports"| node_bhparser
node_bhdata -->|"provides JSON"| node_bhmodal
node_gpodetails -->|"resolves GPO assets"| node_bhparser
node_misconfigs -->|"uses asset mapping"| node_bhparser
node_misconfigs -->|"renders results"| node_table
node_misconfigs -->|"pages results"| node_pagination
node_gpodetails -->|"pages GPOs"| node_pagination
node_layout -->|"persists panel sizes"| node_storage

click node_app "https://github.com/caueb/chimas/blob/main/src/App.tsx"
click node_upload "https://github.com/caueb/chimas/blob/main/src/components/FileUpload.tsx"
click node_fileprocessor "https://github.com/caueb/chimas/blob/main/src/utils/fileProcessor.ts"
click node_fileparser "https://github.com/caueb/chimas/blob/main/src/utils/parser.ts"
click node_risk "https://github.com/caueb/chimas/blob/main/src/utils/riskScoring.ts"
click node_dashboard "https://github.com/caueb/chimas/blob/main/src/components/Dashboard.tsx"
click node_files "https://github.com/caueb/chimas/blob/main/src/components/FileResultsView.tsx"
click node_shares "https://github.com/caueb/chimas/blob/main/src/components/ShareResults.tsx"
click node_attack "https://github.com/caueb/chimas/blob/main/src/components/AttackOpportunities.tsx"
click node_export "https://github.com/caueb/chimas/blob/main/src/utils/exporter.ts"
click node_gpoparser "https://github.com/caueb/chimas/blob/main/src/utils/GPOParser.ts"
click node_gpodashboard "https://github.com/caueb/chimas/blob/main/src/components/GPODashboard.tsx"
click node_gpodetails "https://github.com/caueb/chimas/blob/main/src/components/GPODetails.tsx"
click node_gporesults "https://github.com/caueb/chimas/blob/main/src/components/GPOResults.tsx"
click node_misconfigs "https://github.com/caueb/chimas/blob/main/src/components/Misconfigurations.tsx"
click node_detection "https://github.com/caueb/chimas/blob/main/src/utils/misconfigDetection.ts"
click node_values "https://github.com/caueb/chimas/blob/main/src/utils/valueDefinitions.ts"
click node_bhmodal "https://github.com/caueb/chimas/blob/main/src/components/BloodHoundModal.tsx"
click node_bhparser "https://github.com/caueb/chimas/blob/main/src/utils/bloodhoundParser.ts"
click node_table "https://github.com/caueb/chimas/blob/main/src/components/shared/Table.tsx"
click node_pagination "https://github.com/caueb/chimas/blob/main/src/components/shared/Pagination.tsx"
click node_layout "https://github.com/caueb/chimas/blob/main/src/components/shared/PanelLayout.tsx"
click node_storage "https://github.com/caueb/chimas/blob/main/src/hooks/useLocalStorage.ts"

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_upload,node_table,node_pagination,node_layout,node_storage toneBlue
class node_dashboard,node_files,node_shares,node_attack toneAmber
class node_gpodashboard,node_gpodetails,node_gporesults,node_misconfigs,node_bhmodal toneMint
class node_fileprocessor,node_fileparser,node_risk,node_export,node_gpoparser,node_detection,node_values,node_bhparser toneRose
class node_user,node_bhdata toneIndigo
```

## Components

### Application shell

- [View coordinator](https://github.com/caueb/chimas/blob/main/src/App.tsx): `src/App.tsx`
- [File upload](https://github.com/caueb/chimas/blob/main/src/components/FileUpload.tsx): `src/components/FileUpload.tsx`
- [Results table](https://github.com/caueb/chimas/blob/main/src/components/shared/Table.tsx): `src/components/shared/Table.tsx`
- [Pagination](https://github.com/caueb/chimas/blob/main/src/components/shared/Pagination.tsx): `src/components/shared/Pagination.tsx`
- [Panel layout](https://github.com/caueb/chimas/blob/main/src/components/shared/PanelLayout.tsx): `src/components/shared/PanelLayout.tsx`
- [Browser storage](https://github.com/caueb/chimas/blob/main/src/hooks/useLocalStorage.ts): `src/hooks/useLocalStorage.ts`

### Snaffler analysis

- [Findings dashboard](https://github.com/caueb/chimas/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [File findings](https://github.com/caueb/chimas/blob/main/src/components/FileResultsView.tsx): `src/components/FileResultsView.tsx`
- [Share findings](https://github.com/caueb/chimas/blob/main/src/components/ShareResults.tsx): `src/components/ShareResults.tsx`
- [Attack opportunities](https://github.com/caueb/chimas/blob/main/src/components/AttackOpportunities.tsx): `src/components/AttackOpportunities.tsx`

### Group3r analysis

- [GPO inventory](https://github.com/caueb/chimas/blob/main/src/components/GPODashboard.tsx): `src/components/GPODashboard.tsx`
- [GPO settings](https://github.com/caueb/chimas/blob/main/src/components/GPODetails.tsx): `src/components/GPODetails.tsx`
- [GPO findings](https://github.com/caueb/chimas/blob/main/src/components/GPOResults.tsx): `src/components/GPOResults.tsx`
- [Security baseline](https://github.com/caueb/chimas/blob/main/src/components/Misconfigurations.tsx): `src/components/Misconfigurations.tsx`
- [BloodHound import](https://github.com/caueb/chimas/blob/main/src/components/BloodHoundModal.tsx): `src/components/BloodHoundModal.tsx`

### Parsing and analysis

- [Upload processor](https://github.com/caueb/chimas/blob/main/src/utils/fileProcessor.ts): `src/utils/fileProcessor.ts`
- [Snaffler parser](https://github.com/caueb/chimas/blob/main/src/utils/parser.ts): `src/utils/parser.ts`
- [Risk scoring](https://github.com/caueb/chimas/blob/main/src/utils/riskScoring.ts): `src/utils/riskScoring.ts`
- [Report export](https://github.com/caueb/chimas/blob/main/src/utils/exporter.ts): `src/utils/exporter.ts`
- [GPO parser](https://github.com/caueb/chimas/blob/main/src/utils/GPOParser.ts): `src/utils/GPOParser.ts`
- [Misconfiguration detection](https://github.com/caueb/chimas/blob/main/src/utils/misconfigDetection.ts): `src/utils/misconfigDetection.ts`
- [Security value definitions](https://github.com/caueb/chimas/blob/main/src/utils/valueDefinitions.ts): `src/utils/valueDefinitions.ts`
- [BloodHound resolver](https://github.com/caueb/chimas/blob/main/src/utils/bloodhoundParser.ts): `src/utils/bloodhoundParser.ts`

### Other components

- **Analyst**
- **BloodHound exports**

## Connections

- Analyst → File upload: selects files
- View coordinator → File upload: renders (evidence: `src/App.tsx`)
- View coordinator → Upload processor: processes upload (evidence: `src/App.tsx`)
- Upload processor → Snaffler parser: parses Snaffler (evidence: `src/utils/fileProcessor.ts`)
- View coordinator → Risk scoring: scores findings (evidence: `src/App.tsx`)
- View coordinator → Findings dashboard: selects view (evidence: `src/App.tsx`)
- View coordinator → File findings: selects view (evidence: `src/App.tsx`)
- View coordinator → Share findings: selects view (evidence: `src/App.tsx`)
- Findings dashboard → Snaffler parser: uses parsed data (evidence: `src/components/Dashboard.tsx`)
- Findings dashboard → Attack opportunities: renders (evidence: `src/components/Dashboard.tsx`)
- File findings → Results table: renders (evidence: `src/components/FileResultsView.tsx`)
- Share findings → Snaffler parser: uses parsed data (evidence: `src/components/ShareResults.tsx`)
- View coordinator → Report export: exports selected view (evidence: `src/App.tsx`)
- View coordinator → GPO inventory: selects view (evidence: `src/App.tsx`)
- View coordinator → GPO settings: selects view (evidence: `src/App.tsx`)
- View coordinator → GPO findings: selects view (evidence: `src/App.tsx`)
- View coordinator → Security baseline: selects view (evidence: `src/App.tsx`)
- GPO inventory → GPO parser: uses GPO data (evidence: `src/components/GPODashboard.tsx`)
- GPO settings → GPO parser: uses GPO data (evidence: `src/components/GPODetails.tsx`)
- GPO findings → GPO parser: uses GPO data (evidence: `src/components/GPOResults.tsx`)
- Security baseline → Misconfiguration detection: detects issues (evidence: `src/components/Misconfigurations.tsx`)
- Security baseline → Security value definitions: uses definitions (evidence: `src/components/Misconfigurations.tsx`)
- Analyst → BloodHound import: loads exports
- BloodHound import → BloodHound resolver: parses exports (evidence: `src/components/BloodHoundModal.tsx`)
- BloodHound exports → BloodHound import: provides JSON
- GPO settings → BloodHound resolver: resolves GPO assets (evidence: `src/components/GPODetails.tsx`)
- Security baseline → BloodHound resolver: uses asset mapping (evidence: `src/components/Misconfigurations.tsx`)
- Security baseline → Results table: renders results (evidence: `src/components/Misconfigurations.tsx`)
- Security baseline → Pagination: pages results (evidence: `src/components/Misconfigurations.tsx`)
- GPO settings → Pagination: pages GPOs (evidence: `src/components/GPODetails.tsx`)
- Panel layout → Browser storage: persists panel sizes
