# attackforge/reportgen architecture

> Architecture diagram of the GitHub repository attackforge/reportgen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/attackforge/reportgen
- Repository: https://github.com/attackforge/reportgen

## Overview

##### Main Components

a) Input Layer:
- DOCX Template Handler
- JSON Data Parser (AttackForge Project Data)

b) Core Processing Engine:
- Template Engine
- Tag Processing System
- Function Processor
- Filter System

c) Output Generation:
- DOCX Report Generator

d) Integration Components:
- Web Interface
- CLI Interface
- Node.js Library Interface

##### Key Relationships to Highlight

**[Input Sources] → [Processing Engine] → [Output Generation]**
- ↑                    ↑                     ↓
**[Integration Interfaces] ←→ [Core Components] → [DOCX Report]**

##### Specific Component Details

a) Input Sources Section:
- DOCX Template Input
- JSON Project Data Input

b) Processing Engine Section:
- Tag Processor (for handling {tags})
- Template Engine (for merging data)
- Function Processor (for logic operations)
- Filter System (for data transformation)

c) Integration Interfaces:
- Three separate interface options:
- Web Interface (primary)
- CLI Tool
- Node.js Library

##### Additional Elements

Specific features as sub-components:
- Charts Processing
- Table Generation
- Custom Fields Handler
- Style Inheritance System

##### Data Flow Indicators

- Data input flow
- Processing direction
- Output generation
- Integration points

##### Technical Details

- NPM package integration points
- Template processing pipeline
- Data transformation flow
- Style application process

## Diagram (Mermaid)

```mermaid
graph TB
    %% Define styles
    classDef input fill:#3498db,stroke:#2980b9,color:white
    classDef processing fill:#2ecc71,stroke:#27ae60,color:white
    classDef output fill:#e67e22,stroke:#d35400,color:white
    classDef interface fill:#9b59b6,stroke:#8e44ad,color:white
    
    %% Input Layer
    subgraph InputLayer["Input Layer"]
        DocxTemplate["DOCX Template Handler"]:::input
        JsonData["JSON Data Parser"]:::input
    end
    
    %% Processing Engine
    subgraph ProcessingEngine["Core Processing Engine"]
        TemplateEngine["Template Engine"]:::processing
        TagProcessor["Tag Processing System"]:::processing
        FunctionProcessor["Function Processor"]:::processing
        FilterSystem["Filter System"]:::processing
        
        subgraph Features["Processing Features"]
            Charts["Charts Processing"]:::processing
            Tables["Table Generation"]:::processing
            CustomFields["Custom Fields Handler"]:::processing
            StyleInheritance["Style Inheritance System"]:::processing
        end
        
        TemplateEngine --> TagProcessor
        TagProcessor --> FunctionProcessor
        FunctionProcessor --> FilterSystem
        FilterSystem --> Features
    end
    
    %% Integration Interfaces
    subgraph Interfaces["Integration Interfaces"]
        WebInterface["Web Interface"]:::interface
        CLITool["CLI Interface"]:::interface
        NodeLib["Node.js Library"]:::interface
    end
    
    %% Output Generation
    subgraph OutputGen["Output Generation"]
        ReportGen["DOCX Report Generator"]:::output
    end
    
    %% Connections
    DocxTemplate --> TemplateEngine
    JsonData --> TemplateEngine
    
    WebInterface --> TemplateEngine
    CLITool --> TemplateEngine
    NodeLib --> TemplateEngine
    
    Features --> ReportGen
    
    %% Legend
    subgraph Legend["Legend"]
        InputLegend["Input Components"]:::input
        ProcessingLegend["Processing Components"]:::processing
        OutputLegend["Output Components"]:::output
        InterfaceLegend["Interface Components"]:::interface
    end
```
