# evil-morfar/rclootcouncil2 architecture

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

- Interactive diagram: https://gitdiagram.com/evil-morfar/rclootcouncil2
- Repository: https://github.com/evil-morfar/rclootcouncil2

## Overview

RCLootCouncil is a World of Warcraft addon, built as an Ace3-based Lua application. Its architecture is centered on a small core, a set of feature modules, shared data/utilities, and UI frames that all run inside the WoW client and talk through the game’s event and addon-message APIs.

1. Entry points and bootstrap  
The addon is rooted in `RCLootCouncil.toc`, with top-level runtime files such as `core.lua`, `ml_core.lua`, `Classes/Core.lua`, and `embeds.xml`. These files initialize the addon, register Ace3 embeds, and wire together core services, modules, and UI components.

2. Core runtime and global state  
`Classes/Core.lua` plus `Core/` files (`Constants.lua`, `CoreEvents.lua`, `Defaults.lua`, `GlobalUpdates.lua`) define the addon’s shared runtime contract: constants, event names, default settings, and global update/compatibility behavior. This is the central coordination layer that other subsystems depend on.

3. Main feature modules  
`Modules/` contains the user-facing capabilities: loot history, trade UI, voting frame, loot frame, session frame, version checks, sync, options, and CSV import. These modules represent the high-level flows of the addon and are the primary boundaries for loot distribution, candidate voting, item handoff, and history management.

4. Data model layer  
`Classes/Data/` contains the persistent and structured data objects: `Player`, `Council`, and `MLDB`. These classes model raid members, council members, and master-looter database state, and they are the main abstraction over saved variables and operational state.

5. Communication and restrictions  
`Classes/Services/Comms.lua` and `CommsRestrictions.lua` implement addon-to-addon communication, likely over `AceComm-3.0` and `ChatThrottleLib`. This is the cross-client synchronization boundary for votes, session state, version checks, and loot-related messages; restrictions govern when and what may be sent.

6. UI layer  
`UI/` and `UI/Widgets/` provide reusable frames, buttons, icons, text controls, import/export dialogs, and larger export views. Higher-level modules use these widgets to render voting, trade, session, and import/export screens. UI code is separated from logic, but closely driven by module state.

7. Utility and domain helpers  
`Classes/Utils/` and `Utils/` hold domain helpers such as item parsing, group loot handling, logging, temp tables, item storage, token/transmog/encounter journal data, popup handling, and backwards compatibility. These utilities reduce duplication and concentrate WoW-specific item and loot logic in one layer.

8. History import/export pipeline  
`Modules/History/` and `Modules/History/lootHistory.lua` manage loot history capture, while `CSVImport.lua` and the `UI/Widgets/ImportFrame.lua` / export widgets support importing and exporting historical records. The repository also includes tests for JSON and CSV import/export, indicating this is a notable data interchange boundary.

9. Reactive/event-driven internals  
The vendored `Classes/Lib/RxLua/` suggests some internal flows use observable streams and subjects rather than only direct callbacks. This is useful for modeling transient UI and event sequences such as votes, roll announcements, and state changes.

10. External libraries and platform dependencies  
The addon embeds Ace3 libraries (`AceAddon`, `AceComm`, `AceConfig`, `AceDB`, `AceGUI`, `AceEvent`, `AceTimer`, etc.), plus `LibDeflate`, `LibDialog`, `LibSharedMedia`, `LibWindow`, and dropdown/menu helpers. These are infrastructure dependencies that shape the architecture: addon lifecycle, configuration, persistence, messaging, timers, and UI construction are all delegated to these libraries.

11. WoW API boundary  
The addon is tightly coupled to the World of Warcraft API. The `__tests/wow_api/` emulation layer mirrors frame, tooltip, dropdown, and player/item APIs so logic can be tested outside the game client. This boundary is important because most runtime behavior depends on game events, frames, item links, and raid context.

12. Testing and validation architecture  
The `.specs/` tree contains unit, integration, and emulation-based tests using Busted, plus helpers for raid setup and login emulation. Tests cover core item math, comms, trade flow, voting behavior, tooltip handling, history import/export, and WoW API frame emulation, showing a layered test strategy around the same subsystem boundaries as production code.

13. Build, release, and distribution  
GitHub Actions workflows (`busted.yml`, `release.yml`, `discord-changelog.yml`) and scripts in `.scripts/` handle testing, packaging, deployment, and release notifications. This is a CI/CD boundary rather than runtime logic, but it matters for understanding how the addon is validated and shipped.

14. Overall data flow  
At runtime, WoW events and user actions enter through the core and module layer, are transformed by data/services/utils, synchronized across players via comms, and rendered through the UI. Persistent state flows into AceDB-backed storage and loot history exports/imports, while tests exercise the same paths with mocked WoW APIs and saved-variable fixtures.

Main entry points: [`Classes/Core.lua`](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Core.lua) (Addon core), [`.specs/README.md`](https://github.com/evil-morfar/rclootcouncil2/blob/develop/.specs/README.md) (Specs), [`UI/UI.lua`](https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/UI.lua) (UI root), [`Utils/Utils.lua`](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Utils/Utils.lua) (Utils)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Bootstrap"]
  node_rclootcouncil_toc["TOC<br/>addon manifest<br/>[RCLootCouncil.toc]"]
  node_core_lua["Core init<br/>bootstrap runtime<br/>[core.lua]"]
  node_ml_core_lua["ML core<br/>master-looter bootstrap<br/>[ml_core.lua]"]
end

subgraph group_core["Core runtime"]
  node_classes_core["Addon core<br/>coordination layer<br/>[Core.lua]"]
  node_core_constants["Constants<br/>[Constants.lua]"]
  node_core_events["Events<br/>event contract<br/>[CoreEvents.lua]"]
  node_core_defaults["Defaults<br/>[Defaults.lua]"]
  node_global_updates["Updates<br/>compat layer<br/>[GlobalUpdates.lua]"]
  node_comms_service["Comms<br/>addon messaging<br/>[Comms.lua]"]
  node_comms_rules["Restrictions<br/>send policy"]
  node_data_player["Player<br/>raid member model<br/>[Player.lua]"]
  node_data_council["Council<br/>[Council.lua]"]
  node_data_mldb[("MLDB<br/>loot db model<br/>[MLDB.lua]")]
  node_utils_root["Utils<br/>domain helpers<br/>[Utils.lua]"]
  node_item_utils["Item helpers<br/>item logic<br/>[Item.lua]"]
  node_loot_utils["Loot helpers<br/>loot logic<br/>[GroupLoot.lua]"]
end

subgraph group_features["Feature modules"]
  node_history_module["History<br/>[lootHistory.lua]"]
  node_csv_import["CSV import<br/>history import<br/>[CSVImport.lua]"]
  node_trade_ui["Trade UI<br/>trade flow<br/>[TradeUI.lua]"]
  node_voting_frame["Voting<br/>[votingFrame.lua]"]
  node_loot_frame["Loot frame<br/>loot flow<br/>[lootFrame.lua]"]
  node_session_frame["Session<br/>[sessionFrame.lua]"]
  node_sync_module["Sync<br/>[Sync.lua]"]
  node_version_check["Version check<br/>compat flow<br/>[versionCheck.lua]"]
  node_options_module["Options<br/>config UI<br/>[options.lua]"]
end

subgraph group_ui["UI"]
  node_ui_root["UI root<br/>frame system<br/>[UI.lua]"]
  node_widgets["Widgets<br/>reusable controls<br/>[widgets.xml]"]
  node_export_ui["Export UI<br/>export dialogs<br/>[ExportFrame.lua]"]
  node_import_ui["Import UI<br/>import dialogs<br/>[ImportFrame.lua]"]
end

subgraph group_deps["Dependencies"]
  node_ace3_libs["Ace3<br/>addon framework<br/>[AceAddon-3.0.lua]"]
  node_ui_libs["UI libs<br/>ui dependencies"]
  node_rxlua["RxLua<br/>reactive lib<br/>[Observable.lua]"]
  node_wow_api["WoW API<br/>platform boundary"]
end

subgraph group_tests["Tests"]
  node_specs["Specs<br/>test suite<br/>[README.md]"]
end

node_rclootcouncil_toc -->|"loads"| node_core_lua
node_rclootcouncil_toc -->|"loads"| node_ml_core_lua
node_core_lua -->|"initializes"| node_classes_core
node_ml_core_lua -->|"extends"| node_classes_core
node_classes_core -->|"uses"| node_core_constants
node_classes_core -->|"uses"| node_core_events
node_classes_core -->|"uses"| node_core_defaults
node_classes_core -->|"uses"| node_global_updates
node_classes_core -->|"uses"| node_comms_service
node_comms_service -->|"governed by"| node_comms_rules
node_classes_core -->|"owns state"| node_data_mldb
node_classes_core -->|"models"| node_data_player
node_classes_core -->|"models"| node_data_council
node_classes_core -->|"uses"| node_utils_root
node_utils_root -->|"includes"| node_item_utils
node_utils_root -->|"includes"| node_loot_utils
node_classes_core -->|"drives"| node_ui_root
node_ui_root -->|"builds from"| node_widgets
node_ui_root -->|"contains"| node_export_ui
node_ui_root -->|"contains"| node_import_ui
node_classes_core -->|"feeds"| node_history_module
node_history_module -->|"round-trips with"| node_csv_import
node_classes_core -->|"orchestrates"| node_sync_module
node_sync_module -->|"syncs via"| node_comms_service
node_classes_core -->|"orchestrates"| node_trade_ui
node_classes_core -->|"orchestrates"| node_voting_frame
node_classes_core -->|"orchestrates"| node_loot_frame
node_classes_core -->|"orchestrates"| node_session_frame
node_classes_core -->|"orchestrates"| node_version_check
node_classes_core -->|"configures"| node_options_module
node_ace3_libs -->|"provides"| node_classes_core
node_ui_libs -->|"provides"| node_widgets
node_rxlua -->|"enables"| node_classes_core
node_wow_api -->|"hosts"| node_classes_core
node_specs -->|"validates"| node_classes_core
node_specs -->|"validates"| node_trade_ui
node_specs -->|"validates"| node_voting_frame
node_specs -->|"validates"| node_history_module
node_specs -->|"uses"| node_wow_api

click node_rclootcouncil_toc "https://github.com/evil-morfar/rclootcouncil2/blob/develop/RCLootCouncil.toc"
click node_core_lua "https://github.com/evil-morfar/rclootcouncil2/blob/develop/core.lua"
click node_ml_core_lua "https://github.com/evil-morfar/rclootcouncil2/blob/develop/ml_core.lua"
click node_classes_core "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Core.lua"
click node_core_constants "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/Constants.lua"
click node_core_events "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/CoreEvents.lua"
click node_core_defaults "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/Defaults.lua"
click node_global_updates "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/GlobalUpdates.lua"
click node_comms_service "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Services/Comms.lua"
click node_comms_rules "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Services/CommsRestrictions.lua"
click node_data_player "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/Player.lua"
click node_data_council "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/Council.lua"
click node_data_mldb "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/MLDB.lua"
click node_utils_root "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Utils/Utils.lua"
click node_item_utils "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Utils/Item.lua"
click node_loot_utils "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Utils/GroupLoot.lua"
click node_history_module "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/History/lootHistory.lua"
click node_csv_import "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/History/CSVImport.lua"
click node_trade_ui "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/TradeUI.lua"
click node_voting_frame "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/votingFrame.lua"
click node_loot_frame "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/lootFrame.lua"
click node_session_frame "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/sessionFrame.lua"
click node_sync_module "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/Sync.lua"
click node_version_check "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/versionCheck.lua"
click node_options_module "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/options.lua"
click node_ui_root "https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/UI.lua"
click node_widgets "https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/widgets.xml"
click node_export_ui "https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/ExportFrame.lua"
click node_import_ui "https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/ImportFrame.lua"
click node_ace3_libs "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Libs/AceAddon-3.0/AceAddon-3.0.lua"
click node_ui_libs "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Libs/LibSharedMedia-3.0/LibSharedMedia-3.0.lua"
click node_rxlua "https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Lib/RxLua/Observable.lua"
click node_specs "https://github.com/evil-morfar/rclootcouncil2/blob/develop/.specs/README.md"

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_rclootcouncil_toc,node_core_lua,node_ml_core_lua toneBlue
class node_classes_core,node_core_constants,node_core_events,node_core_defaults,node_global_updates,node_comms_service,node_comms_rules,node_data_player,node_data_council,node_data_mldb,node_utils_root,node_item_utils,node_loot_utils toneAmber
class node_history_module,node_csv_import,node_trade_ui,node_voting_frame,node_loot_frame,node_session_frame,node_sync_module,node_version_check,node_options_module toneMint
class node_ui_root,node_widgets,node_export_ui,node_import_ui toneRose
class node_ace3_libs,node_ui_libs,node_rxlua,node_wow_api toneIndigo
class node_specs toneTeal
```

## Components

### Bootstrap

Addon entrypoints and wiring

- [TOC](https://github.com/evil-morfar/rclootcouncil2/blob/develop/RCLootCouncil.toc): addon manifest · Manifest that declares the addon load order and runtime files · `RCLootCouncil.toc`
- [Core init](https://github.com/evil-morfar/rclootcouncil2/blob/develop/core.lua): bootstrap runtime · Main addon bootstrap and wiring · `core.lua`
- [ML core](https://github.com/evil-morfar/rclootcouncil2/blob/develop/ml_core.lua): master-looter bootstrap · Specialized startup path for master-looter behavior · `ml_core.lua`

### Core runtime

Shared state, services, data, and utility layers

- [Addon core](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Core.lua): coordination layer · Central addon object that coordinates state, services, and modules · `Classes/Core.lua`
- [Constants](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/Constants.lua): runtime constants · Shared identifiers and configuration keys · `Core/Constants.lua`
- [Events](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/CoreEvents.lua): event contract · Internal event names and dispatch vocabulary · `Core/CoreEvents.lua`
- [Defaults](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/Defaults.lua): settings defaults · Default profile and option values · `Core/Defaults.lua`
- [Updates](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Core/GlobalUpdates.lua): compat layer · Backward-compatibility and global update behavior · `Core/GlobalUpdates.lua`
- [Comms](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Services/Comms.lua): addon messaging · Cross-client message transport and synchronization boundary · `Classes/Services/Comms.lua`
- [Restrictions](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Services/CommsRestrictions.lua): send policy · Rules governing when and what can be transmitted · `Classes/Services/CommsRestrictions.lua`
- [Player](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/Player.lua): raid member model · Structured raid member and candidate state · `Classes/Data/Player.lua`
- [Council](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/Council.lua): council model · Council membership and access state · `Classes/Data/Council.lua`
- [MLDB](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Data/MLDB.lua): loot db model · Master-looter persistent database and session state · `Classes/Data/MLDB.lua`
- [Utils](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Utils/Utils.lua): domain helpers · Shared WoW-specific helpers and compatibility utilities · `Utils/Utils.lua`
- [Item helpers](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Utils/Item.lua): item logic · Item parsing, storage, and item-centric calculations · `Classes/Utils/Item.lua`
- [Loot helpers](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Utils/GroupLoot.lua): loot logic · Group loot and auto-pass behavior helpers · `Classes/Utils/GroupLoot.lua`

### Feature modules

Main user-facing addon flows

- [History](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/History/lootHistory.lua): history flow · Loot history capture and persistence boundary · `Modules/History/lootHistory.lua`
- [CSV import](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/History/CSVImport.lua): history import · Import pipeline for historical records · `Modules/History/CSVImport.lua`
- [Trade UI](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/TradeUI.lua): trade flow · Trade-related candidate and item handoff workflow · `Modules/TradeUI.lua`
- [Voting](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/votingFrame.lua): voting flow · Voting, roll collection, and vote coordination · `Modules/votingFrame.lua`
- [Loot frame](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/lootFrame.lua): loot flow · Primary loot distribution and selection flow · `Modules/lootFrame.lua`
- [Session](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/sessionFrame.lua): session flow · Loot session management and state transitions · `Modules/sessionFrame.lua`
- [Sync](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/Sync.lua): sync flow · Module-level synchronization and state exchange · `Modules/Sync.lua`
- [Version check](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/versionCheck.lua): compat flow · Addon version probing and coordination · `Modules/versionCheck.lua`
- [Options](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Modules/options.lua): config UI · Addon configuration and settings integration · `Modules/options.lua`

### UI

Reusable widgets and frames

- [UI root](https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/UI.lua): frame system · Shared UI entrypoint and frame orchestration · `UI/UI.lua`
- [Widgets](https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/widgets.xml): reusable controls · Reusable frames, buttons, icons, text, and dialogs · `UI/Widgets/widgets.xml`
- [Export UI](https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/ExportFrame.lua): export dialogs · Export dialogs and larger export views · `UI/Widgets/ExportFrame.lua`
- [Import UI](https://github.com/evil-morfar/rclootcouncil2/blob/develop/UI/Widgets/ImportFrame.lua): import dialogs · Import dialogs and data entry screens · `UI/Widgets/ImportFrame.lua`

### Dependencies

Embedded libraries and platform boundary

- [Ace3](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Libs/AceAddon-3.0/AceAddon-3.0.lua): addon framework · Lifecycle, config, db, event, and timer infrastructure · `Libs/AceAddon-3.0/AceAddon-3.0.lua`
- [UI libs](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Libs/LibSharedMedia-3.0/LibSharedMedia-3.0.lua): ui dependencies · Shared media, dialog, window, and dropdown helpers · `Libs/LibSharedMedia-3.0/LibSharedMedia-3.0.lua`
- [RxLua](https://github.com/evil-morfar/rclootcouncil2/blob/develop/Classes/Lib/RxLua/Observable.lua): reactive lib · Observable and subject primitives for event-driven flows · `Classes/Lib/RxLua/Observable.lua`
- **WoW API**: platform boundary · In-game API for frames, events, items, and chat

### Tests

Behavioral and API emulation coverage

- [Specs](https://github.com/evil-morfar/rclootcouncil2/blob/develop/.specs/README.md): test suite · Unit, integration, and API-emulation coverage · `.specs/README.md`

## Connections

- TOC → Core init: loads · Manifest loads the main bootstrap file
- TOC → ML core: loads · Manifest also loads the master-looter bootstrap
- Core init → Addon core: initializes · Bootstrap creates and wires the central addon core
- ML core → Addon core: extends · Master-looter path builds on the shared addon core
- Addon core → Constants: uses · Core runtime consumes shared constants
- Addon core → Events: uses · Core runtime relies on shared internal events
- Addon core → Defaults: uses · Core runtime loads default settings
- Addon core → Updates: uses · Core runtime applies compatibility updates
- Addon core → Comms: uses · Core coordinates addon-to-addon communication
- Comms → Restrictions: governed by · Transmission behavior is constrained by comms rules
- Addon core → MLDB: owns state · Core keeps the main persistent loot/session database
- Addon core → Player: models · Core tracks raid member and candidate records
- Addon core → Council: models · Core tracks council membership state
- Addon core → Utils: uses · Core shares generic helpers and compatibility logic
- Utils → Item helpers: includes · Item helpers concentrate parsing and lookup logic
- Utils → Loot helpers: includes · Loot helpers isolate group loot behavior
- Addon core → UI root: drives · Core state and events drive UI composition
- UI root → Widgets: builds from · Higher-level frames are assembled from reusable widgets
- UI root → Export UI: contains · Export flows are rendered through dedicated UI frames
- UI root → Import UI: contains · Import flows are rendered through dedicated UI frames
- Addon core → History: feeds · Loot and session events flow into history capture
- History → CSV import: round-trips with · History supports import/export data interchange
- Addon core → Sync: orchestrates · Core coordinates sync module behavior
- Sync → Comms: syncs via · Sync module exchanges state across clients through comms
- Addon core → Trade UI: orchestrates · Core state drives trade handoff workflow
- Addon core → Voting: orchestrates · Core state drives voting and roll collection
- Addon core → Loot frame: orchestrates · Core state drives loot distribution UI
- Addon core → Session: orchestrates · Core state drives session transitions
- Addon core → Version check: orchestrates · Core coordinates version probing and checks
- Addon core → Options: configures · Core exposes settings through the options module
- Ace3 → Addon core: provides · Ace3 supplies lifecycle, config, db, and event infrastructure
- UI libs → Widgets: provides · Embedded UI libraries support custom controls and dialogs
- RxLua → Addon core: enables · Reactive primitives support event-driven internal flows
- WoW API → Addon core: hosts · Runtime code executes against the WoW client API
- Specs → Addon core: validates · Specs cover core logic and shared data behavior
- Specs → Trade UI: validates · Integration tests cover the trade flow
- Specs → Voting: validates · Integration tests cover voting behavior and rolls
- Specs → History: validates · Specs cover history import/export behavior
- Specs → WoW API: uses · Specs rely on an emulated WoW API boundary
