# bugraalpaslan/vplanalyzer architecture

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

- Interactive diagram: https://gitdiagram.com/bugraalpaslan/vplanalyzer
- Repository: https://github.com/bugraalpaslan/vplanalyzer

## Overview

This repository appears to be a VPL and master-data analysis web application: users review dated issue summaries and details, while the backend parses VPL and related master-data inputs and records findings. The sampled Go code confirms issue storage, summary/detail retrieval, and analysis data conversion; the HTML page names indicate dashboards and configuration screens. The excerpts omit most routing, parsing orchestration, and frontend behavior, so uncertain connections are left dashed or omitted.

Main entry points: [`main.go`](https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go) (HTTP handlers), [`frontend`](https://github.com/bugraalpaslan/vplanalyzer/tree/main/frontend) (Dashboards and forms), [`config.json`](https://github.com/bugraalpaslan/vplanalyzer/blob/main/config.json) (Runtime configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Dashboards and forms"]
  node_http["HTTP handlers<br/>[main.go]"]
end

subgraph group_analysis["Analysis"]
  node_vpl["VPL comparison<br/>[main.go]"]
  node_masterdata["Master-data checks<br/>[main.go]"]
  node_models["Domain records<br/>[types.go]"]
end

subgraph group_runtime["Runtime and state"]
  node_inputs["File inputs"]
  node_config["Runtime configuration<br/>[config.json]"]
  node_database[("SQL database")]
end

node_operator(("Operator"))

node_operator -.->|"uses"| node_frontend
node_frontend -.->|"requests"| node_http
node_http -->|"retrieves issues"| node_vpl
node_http -->|"retrieves issues"| node_masterdata
node_vpl -->|"reads VPL"| node_inputs
node_masterdata -->|"reads VPL"| node_inputs
node_masterdata -->|"inserts issues"| node_database
node_http -->|"queries issues"| node_database
node_http -->|"converts results"| node_vpl
node_http -->|"loads config"| node_config

click node_frontend "https://github.com/bugraalpaslan/vplanalyzer/tree/main/frontend"
click node_http "https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go"
click node_vpl "https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go"
click node_masterdata "https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go"
click node_models "https://github.com/bugraalpaslan/vplanalyzer/blob/main/types.go"
click node_config "https://github.com/bugraalpaslan/vplanalyzer/blob/main/config.json"

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_frontend,node_http toneBlue
class node_vpl,node_masterdata,node_models toneAmber
class node_inputs,node_config,node_database toneMint
class node_operator toneIndigo
```

## Components

### Web experience

- [Dashboards and forms](https://github.com/bugraalpaslan/vplanalyzer/tree/main/frontend): `frontend`
- [HTTP handlers](https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go): `main.go`

### Analysis

- [VPL comparison](https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go): `main.go`
- [Master-data checks](https://github.com/bugraalpaslan/vplanalyzer/blob/main/main.go): `main.go`
- [Domain records](https://github.com/bugraalpaslan/vplanalyzer/blob/main/types.go): `types.go`

### Runtime and state

- **File inputs**
- [Runtime configuration](https://github.com/bugraalpaslan/vplanalyzer/blob/main/config.json): `config.json`
- **SQL database**

### Other components

- **Operator**

## Connections

- Operator → Dashboards and forms: uses
- Dashboards and forms → HTTP handlers: requests
- HTTP handlers → VPL comparison: retrieves issues (evidence: `main.go`)
- HTTP handlers → Master-data checks: retrieves issues (evidence: `main.go`)
- VPL comparison → File inputs: reads VPL (evidence: `main.go`)
- Master-data checks → File inputs: reads VPL (evidence: `main.go`)
- Master-data checks → SQL database: inserts issues (evidence: `main.go`)
- HTTP handlers → SQL database: queries issues (evidence: `main.go`)
- HTTP handlers → VPL comparison: converts results (evidence: `main.go`)
- HTTP handlers → Runtime configuration: loads config (evidence: `main.go`)
