# cbart-cmd/wvw-combat-insights architecture

> Architecture diagram of the GitHub repository cbart-cmd/wvw-combat-insights, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cbart-cmd/wvw-combat-insights
- Repository: https://github.com/cbart-cmd/wvw-combat-insights

## Overview

WvW Combat Insights is a Nexus addon that turns Guild Wars 2 WvW EVTC logs into combat summaries, player highlights, and healing views. Its main workflow discovers logs, reads and analyzes fights, retains reports for history/live updates, and renders independent windows; settings and localization support that experience. The tree also contains Elite Insights healing-statistics extensions. Edges are limited to relationships visible in excerpts, the source index, or README; some subsystem internals were not sampled.

Main entry points: [`src/app.rs`](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/app.rs) (Report and live state), [`src/evtc.rs`](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/evtc.rs) (EVTC analysis), [`src/ui.rs`](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/ui.rs) (Combat windows), [`src/live.rs`](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/live.rs) (Live combat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Addon runtime"]
  node_app["Report and live state<br/>[app.rs]"]
  node_log_discovery["Log discovery<br/>[logs.rs]"]
  node_settings["Addon settings<br/>[settings.rs]"]
  node_live["Live combat<br/>[live.rs]"]
end

subgraph group_analysis["Combat analysis"]
  node_parser["EVTC analysis<br/>[evtc.rs]"]
  node_healing["Healing coverage<br/>[healing.rs]"]
  node_contribution["Down contribution<br/>[contribution.rs]"]
  node_highlights["Team highlights<br/>[danger.rs]"]
  node_compression["Log decompression<br/>[inflate.rs]"]
  node_zip["Compressed logs<br/>[zip.rs]"]
end

subgraph group_presentation["Windows and language"]
  node_windows["Combat windows<br/>[ui.rs]"]
  node_translations["Addon translations<br/>[i18n.rs]"]
  node_nexus_language["Language selection<br/>[language.rs]"]
end

subgraph group_healing_ext["Healing extensions"]
  node_healing_handler["Healing event handler"]
  node_combat_item["Combat event model<br/>[CombatItem.cs]"]
  node_healing_event["Healing events<br/>[EXTHealingEvent.cs]"]
  node_healing_helpers["Healing aggregation"]
end

subgraph group_game_data["Game data"]
  node_weapon_data[("Weapon skill mapping<br/>[weapon_skills.rs]")]
  node_game_names[("Localized game names<br/>[game_names.rs]")]
end

node_player(("Player"))
node_nexus{{"Nexus / ArcDPS"}}
node_log_files["EVTC logs"]

node_player -.->|"opens addon"| node_nexus
node_nexus -.->|"starts addon"| node_app
node_log_files -.->|"provides logs"| node_log_discovery
node_app -->|"finds logs"| node_log_discovery
node_app -->|"reads fights"| node_parser
node_app -->|"loads settings"| node_settings
node_app -->|"reads archives"| node_zip
node_app -.->|"tracks combat"| node_live
node_live -->|"analyzes events"| node_parser
node_live -->|"uses settings"| node_settings
node_live -->|"updates views"| node_windows
node_parser -->|"collects healing"| node_healing
node_windows -->|"selects reports"| node_app
node_windows -->|"ranks players"| node_highlights
node_windows -->|"renders fight data"| node_parser
node_windows -.->|"formats labels"| node_translations
node_highlights -->|"reads fight metrics"| node_parser
node_highlights -->|"uses text"| node_translations
node_zip -->|"inflates data"| node_compression
node_translations -->|"selects language"| node_nexus_language
node_translations -->|"localizes names"| node_game_names
node_parser -.->|"infers weapons"| node_weapon_data
node_healing_handler -->|"reads events"| node_combat_item
node_healing_handler -->|"creates events"| node_healing_event
node_healing_helpers -->|"uses parsed data"| node_healing_handler
node_healing_helpers -->|"aggregates events"| node_healing_event

click node_app "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/app.rs"
click node_log_discovery "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/logs.rs"
click node_settings "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/settings.rs"
click node_parser "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/evtc.rs"
click node_healing "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/healing.rs"
click node_contribution "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/contribution.rs"
click node_highlights "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/danger.rs"
click node_live "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/live.rs"
click node_compression "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/inflate.rs"
click node_zip "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/zip.rs"
click node_windows "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/ui.rs"
click node_translations "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/i18n.rs"
click node_nexus_language "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/language.rs"
click node_healing_handler "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/HealingStatsExtensionHandler.cs"
click node_combat_item "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/CombatItem.cs"
click node_healing_event "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/EXTHealingEvent.cs"
click node_healing_helpers "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/EXTActorHealingHelper.cs"
click node_weapon_data "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/gw2/weapon_skills.rs"
click node_game_names "https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/gw2/game_names.rs"

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_log_discovery,node_settings,node_live toneBlue
class node_parser,node_healing,node_contribution,node_highlights,node_compression,node_zip toneAmber
class node_windows,node_translations,node_nexus_language toneMint
class node_healing_handler,node_combat_item,node_healing_event,node_healing_helpers toneRose
class node_weapon_data,node_game_names,node_player,node_nexus,node_log_files toneIndigo
```

## Components

### Addon runtime

- [Report and live state](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/app.rs): `src/app.rs`
- [Log discovery](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/logs.rs): `src/logs.rs`
- [Addon settings](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/settings.rs): `src/settings.rs`
- [Live combat](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/live.rs): `src/live.rs`

### Combat analysis

- [EVTC analysis](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/evtc.rs): `src/evtc.rs`
- [Healing coverage](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/healing.rs): `src/healing.rs`
- [Down contribution](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/contribution.rs): `src/contribution.rs`
- [Team highlights](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/danger.rs): `src/danger.rs`
- [Log decompression](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/inflate.rs): `src/inflate.rs`
- [Compressed logs](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/zip.rs): `src/zip.rs`

### Windows and language

- [Combat windows](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/ui.rs): `src/ui.rs`
- [Addon translations](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/src/i18n.rs): `src/i18n.rs`
- [Language selection](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/language.rs): `nexusbase/language.rs`

### Healing extensions

- [Healing event handler](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/HealingStatsExtensionHandler.cs): `elitei/HealingStatsExtensionHandler.cs`
- [Combat event model](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/CombatItem.cs): `elitei/CombatItem.cs`
- [Healing events](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/EXTHealingEvent.cs): `elitei/EXTHealingEvent.cs`
- [Healing aggregation](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/elitei/EXTActorHealingHelper.cs): `elitei/EXTActorHealingHelper.cs`

### Game data

- [Weapon skill mapping](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/gw2/weapon_skills.rs): `nexusbase/gw2/weapon_skills.rs`
- [Localized game names](https://github.com/cbart-cmd/wvw-combat-insights/blob/main/nexusbase/gw2/game_names.rs): `nexusbase/gw2/game_names.rs`

### Other components

- **Player**
- **Nexus / ArcDPS**
- **EVTC logs**

## Connections

- Player → Nexus / ArcDPS: opens addon (evidence: `README.md`)
- Nexus / ArcDPS → Report and live state: starts addon (evidence: `README.md`)
- EVTC logs → Log discovery: provides logs (evidence: `README.md`)
- Report and live state → Log discovery: finds logs (evidence: `src/app.rs`)
- Report and live state → EVTC analysis: reads fights (evidence: `src/app.rs`)
- Report and live state → Addon settings: loads settings (evidence: `src/app.rs`)
- Report and live state → Compressed logs: reads archives (evidence: `src/app.rs`)
- Report and live state → Live combat: tracks combat (evidence: `src/app.rs`)
- Live combat → EVTC analysis: analyzes events (evidence: `src/live.rs`)
- Live combat → Addon settings: uses settings (evidence: `src/live.rs`)
- Live combat → Combat windows: updates views (evidence: `src/live.rs`)
- EVTC analysis → Healing coverage: collects healing (evidence: `src/evtc.rs`)
- Combat windows → Report and live state: selects reports (evidence: `src/ui.rs`)
- Combat windows → Team highlights: ranks players (evidence: `src/ui.rs`)
- Combat windows → EVTC analysis: renders fight data (evidence: `src/ui.rs`)
- Combat windows → Addon translations: formats labels (evidence: `src/ui.rs`)
- Team highlights → EVTC analysis: reads fight metrics (evidence: `src/danger.rs`)
- Team highlights → Addon translations: uses text (evidence: `src/danger.rs`)
- Compressed logs → Log decompression: inflates data (evidence: `src/zip.rs`)
- Addon translations → Language selection: selects language (evidence: `src/i18n.rs`)
- Addon translations → Localized game names: localizes names (evidence: `src/i18n.rs`)
- EVTC analysis → Weapon skill mapping: infers weapons
- Healing event handler → Combat event model: reads events (evidence: `elitei/HealingStatsExtensionHandler.cs`)
- Healing event handler → Healing events: creates events (evidence: `elitei/HealingStatsExtensionHandler.cs`)
- Healing aggregation → Healing event handler: uses parsed data (evidence: `elitei/EXTActorHealingHelper.cs`)
- Healing aggregation → Healing events: aggregates events (evidence: `elitei/EXTActorHealingHelper.cs`)
