# anchorxv/xv2-build-forge architecture

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

- Interactive diagram: https://gitdiagram.com/anchorxv/xv2-build-forge
- Repository: https://github.com/anchorxv/xv2-build-forge

## Overview

DBXV2 Build Forge is a desktop roster and moveset planner for Xenoverse 2 modders. Users build and validate preset entries in the editor, organize them into roster sheets, review or reload entries, and export selected sheets to CSV or Excel. The app controller initializes the shared in-memory store and persistence before opening the UI; views use Qt table models, searchable views, and undo commands. README capabilities include live language switching and crash-safe backups; locale files are not present in the supplied tree, and several runtime connections are supported only by documentation or the source index.

Main entry points: [`models/data_store.py`](https://github.com/anchorxv/xv2-build-forge/blob/main/models/data_store.py) (Shared Data Store), [`views/editor_tab.py`](https://github.com/anchorxv/xv2-build-forge/blob/main/views/editor_tab.py) (Preset Editor), [`views/database_tab.py`](https://github.com/anchorxv/xv2-build-forge/blob/main/views/database_tab.py) (Catalog Tabs), [`controllers/app_controller.py`](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/app_controller.py) (App Coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["App Entry<br/>[main.py]"]
  node_coordinator["App Coordinator<br/>[app_controller.py]"]
  node_window["Main Window<br/>[main_window.py]"]
  node_tabs["Tab Manager<br/>[tab_manager.py]"]
  node_theme["Theme Manager<br/>[theme_manager.py]"]
  node_settings["Settings Controller"]
end

subgraph group_authoring["Preset Authoring"]
  node_editor["Preset Editor<br/>[editor_tab.py]"]
  node_editor_logic["Editor Logic"]
  node_validators["Input Validation<br/>[validators.py]"]
  node_skill_parser["Skill Normalizer<br/>[skill_parser.py]"]
end

subgraph group_rosters["Roster Management"]
  node_roster["Roster Preview<br/>[roster_tab.py]"]
  node_sheet_detail["Sheet Details"]
  node_export["Roster Export<br/>[export_dialog.py]"]
  node_export_logic["Export Logic"]
end

subgraph group_catalog["Reference Catalogs"]
  node_database["Catalog Tabs<br/>[database_tab.py]"]
  node_db_dialog["Catalog Editor<br/>[db_entry_dialog.py]"]
end

subgraph group_core["Data and Presentation"]
  node_schemas["Domain Schemas<br/>[schemas.py]"]
  node_store[("Shared Data Store<br/>[data_store.py]")]
  node_persistence[("JSON Persistence<br/>[persistence.py]")]
  node_table_models["Qt Table Models<br/>[table_models.py]"]
  node_search["Searchable Tables"]
  node_undo["Undo Commands<br/>[undo_commands.py]"]
  node_signals{{"Signal Bus<br/>[signal_bus.py]"}}
end

node_modder(("Modder"))
node_mod_tools["External Mod Tools"]

node_modder -->|"launches"| node_main
node_main -->|"starts"| node_coordinator
node_coordinator -->|"initializes"| node_store
node_coordinator -->|"loads and backs up"| node_persistence
node_coordinator -->|"applies theme"| node_theme
node_coordinator -->|"creates"| node_window
node_window -->|"hosts"| node_tabs
node_tabs -->|"creates"| node_editor
node_tabs -->|"creates"| node_roster
node_tabs -->|"creates"| node_database
node_editor -->|"delegates to"| node_editor_logic
node_editor -->|"validates with"| node_validators
node_editor -.->|"normalizes skills"| node_skill_parser
node_editor -->|"reads and updates"| node_store
node_editor -->|"builds entries"| node_schemas
node_roster -->|"reads sheets"| node_store
node_roster -->|"opens details"| node_sheet_detail
node_sheet_detail -->|"reads entries"| node_store
node_sheet_detail -->|"requests editor load"| node_signals
node_roster -->|"opens export"| node_export
node_export_logic -->|"uses dialog"| node_export
node_export -.->|"exports files for"| node_mod_tools
node_database -->|"edits catalog entries"| node_db_dialog
node_database -->|"updates catalog"| node_store
node_database -->|"pushes commands"| node_undo
node_database -->|"displays data"| node_table_models
node_database -->|"uses table view"| node_search
node_roster -->|"displays summaries"| node_table_models
node_store -->|"saves state"| node_persistence
node_undo -->|"mutates state"| node_store
node_undo -->|"notifies changes"| node_signals
node_settings -->|"applies preferences"| node_theme
node_window -->|"opens settings"| node_settings

click node_main "https://github.com/anchorxv/xv2-build-forge/blob/main/main.py"
click node_coordinator "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/app_controller.py"
click node_window "https://github.com/anchorxv/xv2-build-forge/blob/main/views/main_window.py"
click node_tabs "https://github.com/anchorxv/xv2-build-forge/blob/main/views/tab_manager.py"
click node_editor "https://github.com/anchorxv/xv2-build-forge/blob/main/views/editor_tab.py"
click node_editor_logic "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/editor_controller.py"
click node_validators "https://github.com/anchorxv/xv2-build-forge/blob/main/models/validators.py"
click node_skill_parser "https://github.com/anchorxv/xv2-build-forge/blob/main/models/skill_parser.py"
click node_schemas "https://github.com/anchorxv/xv2-build-forge/blob/main/models/schemas.py"
click node_roster "https://github.com/anchorxv/xv2-build-forge/blob/main/views/roster_tab.py"
click node_sheet_detail "https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/sheet_detail_dialog.py"
click node_export "https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/export_dialog.py"
click node_export_logic "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/export_controller.py"
click node_database "https://github.com/anchorxv/xv2-build-forge/blob/main/views/database_tab.py"
click node_db_dialog "https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/db_entry_dialog.py"
click node_store "https://github.com/anchorxv/xv2-build-forge/blob/main/models/data_store.py"
click node_persistence "https://github.com/anchorxv/xv2-build-forge/blob/main/models/persistence.py"
click node_table_models "https://github.com/anchorxv/xv2-build-forge/blob/main/models/table_models.py"
click node_search "https://github.com/anchorxv/xv2-build-forge/blob/main/views/widgets/searchable_table_view.py"
click node_undo "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/undo_commands.py"
click node_signals "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/signal_bus.py"
click node_theme "https://github.com/anchorxv/xv2-build-forge/blob/main/styles/theme_manager.py"
click node_settings "https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/settings_controller.py"

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_main,node_coordinator,node_window,node_tabs,node_theme,node_settings toneBlue
class node_editor,node_editor_logic,node_validators,node_skill_parser toneAmber
class node_roster,node_sheet_detail,node_export,node_export_logic toneMint
class node_database,node_db_dialog toneRose
class node_schemas,node_store,node_persistence,node_table_models,node_search,node_undo,node_signals,node_modder,node_mod_tools toneIndigo
```

## Components

### Application

- [App Entry](https://github.com/anchorxv/xv2-build-forge/blob/main/main.py): `main.py`
- [App Coordinator](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/app_controller.py): `controllers/app_controller.py`
- [Main Window](https://github.com/anchorxv/xv2-build-forge/blob/main/views/main_window.py): `views/main_window.py`
- [Tab Manager](https://github.com/anchorxv/xv2-build-forge/blob/main/views/tab_manager.py): `views/tab_manager.py`
- [Theme Manager](https://github.com/anchorxv/xv2-build-forge/blob/main/styles/theme_manager.py): `styles/theme_manager.py`
- [Settings Controller](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/settings_controller.py): `controllers/settings_controller.py`

### Preset Authoring

- [Preset Editor](https://github.com/anchorxv/xv2-build-forge/blob/main/views/editor_tab.py): `views/editor_tab.py`
- [Editor Logic](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/editor_controller.py): `controllers/editor_controller.py`
- [Input Validation](https://github.com/anchorxv/xv2-build-forge/blob/main/models/validators.py): `models/validators.py`
- [Skill Normalizer](https://github.com/anchorxv/xv2-build-forge/blob/main/models/skill_parser.py): `models/skill_parser.py`

### Roster Management

- [Roster Preview](https://github.com/anchorxv/xv2-build-forge/blob/main/views/roster_tab.py): `views/roster_tab.py`
- [Sheet Details](https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/sheet_detail_dialog.py): `views/dialogs/sheet_detail_dialog.py`
- [Roster Export](https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/export_dialog.py): `views/dialogs/export_dialog.py`
- [Export Logic](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/export_controller.py): `controllers/export_controller.py`

### Reference Catalogs

- [Catalog Tabs](https://github.com/anchorxv/xv2-build-forge/blob/main/views/database_tab.py): `views/database_tab.py`
- [Catalog Editor](https://github.com/anchorxv/xv2-build-forge/blob/main/views/dialogs/db_entry_dialog.py): `views/dialogs/db_entry_dialog.py`

### Data and Presentation

- [Domain Schemas](https://github.com/anchorxv/xv2-build-forge/blob/main/models/schemas.py): `models/schemas.py`
- [Shared Data Store](https://github.com/anchorxv/xv2-build-forge/blob/main/models/data_store.py): `models/data_store.py`
- [JSON Persistence](https://github.com/anchorxv/xv2-build-forge/blob/main/models/persistence.py): `models/persistence.py`
- [Qt Table Models](https://github.com/anchorxv/xv2-build-forge/blob/main/models/table_models.py): `models/table_models.py`
- [Searchable Tables](https://github.com/anchorxv/xv2-build-forge/blob/main/views/widgets/searchable_table_view.py): `views/widgets/searchable_table_view.py`
- [Undo Commands](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/undo_commands.py): `controllers/undo_commands.py`
- [Signal Bus](https://github.com/anchorxv/xv2-build-forge/blob/main/controllers/signal_bus.py): `controllers/signal_bus.py`

### Other components

- **Modder**
- **External Mod Tools**

## Connections

- Modder → App Entry: launches (evidence: `README.md`)
- App Entry → App Coordinator: starts (evidence: `main.py`)
- App Coordinator → Shared Data Store: initializes (evidence: `controllers/app_controller.py`)
- App Coordinator → JSON Persistence: loads and backs up (evidence: `controllers/app_controller.py`)
- App Coordinator → Theme Manager: applies theme (evidence: `controllers/app_controller.py`)
- App Coordinator → Main Window: creates (evidence: `controllers/app_controller.py`)
- Main Window → Tab Manager: hosts (evidence: `views/main_window.py`)
- Tab Manager → Preset Editor: creates (evidence: `views/tab_manager.py`)
- Tab Manager → Roster Preview: creates (evidence: `views/tab_manager.py`)
- Tab Manager → Catalog Tabs: creates (evidence: `views/tab_manager.py`)
- Preset Editor → Editor Logic: delegates to (evidence: `views/editor_tab.py`)
- Preset Editor → Input Validation: validates with (evidence: `views/editor_tab.py`)
- Preset Editor → Skill Normalizer: normalizes skills
- Preset Editor → Shared Data Store: reads and updates (evidence: `views/editor_tab.py`)
- Preset Editor → Domain Schemas: builds entries (evidence: `views/editor_tab.py`)
- Roster Preview → Shared Data Store: reads sheets (evidence: `views/roster_tab.py`)
- Roster Preview → Sheet Details: opens details (evidence: `views/roster_tab.py`)
- Sheet Details → Shared Data Store: reads entries (evidence: `views/dialogs/sheet_detail_dialog.py`)
- Sheet Details → Signal Bus: requests editor load
- Roster Preview → Roster Export: opens export (evidence: `views/roster_tab.py`)
- Export Logic → Roster Export: uses dialog (evidence: `controllers/export_controller.py`)
- Roster Export → External Mod Tools: exports files for (evidence: `README.md`)
- Catalog Tabs → Catalog Editor: edits catalog entries (evidence: `views/database_tab.py`)
- Catalog Tabs → Shared Data Store: updates catalog (evidence: `views/database_tab.py`)
- Catalog Tabs → Undo Commands: pushes commands (evidence: `views/database_tab.py`)
- Catalog Tabs → Qt Table Models: displays data (evidence: `views/database_tab.py`)
- Catalog Tabs → Searchable Tables: uses table view (evidence: `views/database_tab.py`)
- Roster Preview → Qt Table Models: displays summaries (evidence: `views/roster_tab.py`)
- Shared Data Store → JSON Persistence: saves state (evidence: `models/data_store.py`)
- Undo Commands → Shared Data Store: mutates state (evidence: `controllers/undo_commands.py`)
- Undo Commands → Signal Bus: notifies changes (evidence: `controllers/undo_commands.py`)
- Settings Controller → Theme Manager: applies preferences (evidence: `controllers/settings_controller.py`)
- Main Window → Settings Controller: opens settings (evidence: `views/main_window.py`)
