# wimi321/lizzieyzy-next architecture

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

- Interactive diagram: https://gitdiagram.com/wimi321/lizzieyzy-next
- Repository: https://github.com/wimi321/lizzieyzy-next

## Overview

LizzieYzy Next is a desktop Go-review application centered on KataGo. The documented user journey is to retrieve a Fox game by nickname, analyze the game quickly, then use win-rate and heatmap views to find important mistakes. The repository also includes engine-game play, remote compute, board synchronization, and engine setup. The tree and excerpts support the main modules, but do not show every UI-to-service connection; documented but unsampled feature links cite the README, and other uncertain links are omitted.

Main entry points: [`src/main/java/featurecat/lizzie/Lizzie.java`](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/Lizzie.java) (Application startup), [`src/main/java/featurecat/lizzie/gui/FoxKifuDownload.java`](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/FoxKifuDownload.java) (Fox game retrieval), [`src/main/java/featurecat/lizzie/analysis/EngineManager.java`](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java) (Engine management), [`src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java`](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java) (Remote compute config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_startup["Application startup<br/>[Lizzie.java]"]
  node_config["Configuration<br/>[Config.java]"]
  node_desktop["Desktop interface<br/>[LizzieFrame.java]"]
end

subgraph group_review["Game review"]
  node_board["Board and history"]
  node_fox["Fox game retrieval"]
  node_quick["Whole-game analysis"]
  node_analysis["Engine analysis<br/>[Leelaz.java]"]
  node_visuals["Review visualizations<br/>[AnalysisFrame.java]"]
end

subgraph group_engines["Engines and compute"]
  node_engine_manager["Engine management<br/>[EngineManager.java]"]
  node_engine_setup["KataGo setup"]
  node_engine_commands["Engine commands"]
  node_remote_config["Remote compute config"]
  node_remote_catalog["Remote engine catalog"]
  node_remote_transport["Remote engine transport"]
end

subgraph group_capabilities["Additional features"]
  node_engine_game["Engine games"]
  node_sync["Board synchronization<br/>[ReadBoard.java]"]
  node_teacher["Go teaching"]
end

node_user(("Go player"))
node_player(("Go player"))
node_fox_service["Fox service"]
node_katago["KataGo engine"]

node_user -->|"opens"| node_startup
node_startup -->|"loads"| node_config
node_startup -->|"starts"| node_desktop
node_player -->|"enters nickname"| node_fox
node_fox -->|"retrieves games"| node_fox_service
node_fox -->|"provides game"| node_board
node_player -->|"requests analysis"| node_quick
node_quick -.->|"runs analysis"| node_analysis
node_analysis -.->|"sends commands"| node_katago
node_player -->|"reviews results"| node_visuals
node_startup -.->|"initializes"| node_engine_manager
node_engine_manager -.->|"uses setup"| node_engine_setup
node_engine_manager -.->|"resolves commands"| node_engine_commands
node_player -->|"configures remote compute"| node_remote_config
node_remote_config -.->|"loads catalog"| node_remote_catalog
node_remote_config -.->|"connects engine"| node_remote_transport
node_player -.->|"plays engine game"| node_engine_game
node_player -->|"synchronizes board"| node_sync
node_player -.->|"requests guidance"| node_teacher

click node_startup "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/Lizzie.java"
click node_config "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/Config.java"
click node_desktop "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/LizzieFrame.java"
click node_board "https://github.com/wimi321/lizzieyzy-next/tree/main/src/main/java/featurecat/lizzie/rules"
click node_fox "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/FoxKifuDownload.java"
click node_quick "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/WholeGameAnalysisSession.java"
click node_analysis "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/Leelaz.java"
click node_visuals "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/AnalysisFrame.java"
click node_engine_manager "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java"
click node_engine_setup "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/util/KataGoAutoSetupHelper.java"
click node_engine_commands "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/util/AnalysisEngineCommandHelper.java"
click node_remote_config "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java"
click node_remote_catalog "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/remote/ZhiziEngineCatalogService.java"
click node_remote_transport "https://github.com/wimi321/lizzieyzy-next/tree/main/src/main/java/featurecat/lizzie/analysis/remote"
click node_engine_game "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/enginegame/EngineGameModule.java"
click node_sync "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/ReadBoard.java"
click node_teacher "https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/teacher/TeacherLlmClient.java"

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_startup,node_config,node_desktop toneBlue
class node_board,node_fox,node_quick,node_analysis,node_visuals toneAmber
class node_engine_manager,node_engine_setup,node_engine_commands,node_remote_config,node_remote_catalog,node_remote_transport toneMint
class node_engine_game,node_sync,node_teacher toneRose
class node_user,node_player,node_fox_service,node_katago toneIndigo
```

## Components

### Application

- [Application startup](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/Lizzie.java): `src/main/java/featurecat/lizzie/Lizzie.java`
- [Configuration](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/Config.java): `src/main/java/featurecat/lizzie/Config.java`
- [Desktop interface](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/LizzieFrame.java): `src/main/java/featurecat/lizzie/gui/LizzieFrame.java`

### Game review

- [Board and history](https://github.com/wimi321/lizzieyzy-next/tree/main/src/main/java/featurecat/lizzie/rules): `src/main/java/featurecat/lizzie/rules`
- [Fox game retrieval](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/FoxKifuDownload.java): `src/main/java/featurecat/lizzie/gui/FoxKifuDownload.java`
- [Whole-game analysis](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/WholeGameAnalysisSession.java): `src/main/java/featurecat/lizzie/analysis/WholeGameAnalysisSession.java`
- [Engine analysis](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/Leelaz.java): `src/main/java/featurecat/lizzie/analysis/Leelaz.java`
- [Review visualizations](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/gui/AnalysisFrame.java): `src/main/java/featurecat/lizzie/gui/AnalysisFrame.java`

### Engines and compute

- [Engine management](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/EngineManager.java): `src/main/java/featurecat/lizzie/analysis/EngineManager.java`
- [KataGo setup](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/util/KataGoAutoSetupHelper.java): `src/main/java/featurecat/lizzie/util/KataGoAutoSetupHelper.java`
- [Engine commands](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/util/AnalysisEngineCommandHelper.java): `src/main/java/featurecat/lizzie/util/AnalysisEngineCommandHelper.java`
- [Remote compute config](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java): `src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java`
- [Remote engine catalog](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/remote/ZhiziEngineCatalogService.java): `src/main/java/featurecat/lizzie/analysis/remote/ZhiziEngineCatalogService.java`
- [Remote engine transport](https://github.com/wimi321/lizzieyzy-next/tree/main/src/main/java/featurecat/lizzie/analysis/remote): `src/main/java/featurecat/lizzie/analysis/remote`

### Additional features

- [Engine games](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/enginegame/EngineGameModule.java): `src/main/java/featurecat/lizzie/enginegame/EngineGameModule.java`
- [Board synchronization](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/analysis/ReadBoard.java): `src/main/java/featurecat/lizzie/analysis/ReadBoard.java`
- [Go teaching](https://github.com/wimi321/lizzieyzy-next/blob/main/src/main/java/featurecat/lizzie/teacher/TeacherLlmClient.java): `src/main/java/featurecat/lizzie/teacher/TeacherLlmClient.java`

### Other components

- **Go player**
- **Go player**
- **Fox service**
- **KataGo engine**

## Connections

- Go player → Application startup: opens (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Application startup → Configuration: loads (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Application startup → Desktop interface: starts (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Go player → Fox game retrieval: enters nickname
- Fox game retrieval → Fox service: retrieves games
- Fox game retrieval → Board and history: provides game
- Go player → Whole-game analysis: requests analysis
- Whole-game analysis → Engine analysis: runs analysis
- Engine analysis → KataGo engine: sends commands
- Go player → Review visualizations: reviews results
- Application startup → Engine management: initializes (evidence: `src/main/java/featurecat/lizzie/Lizzie.java`)
- Engine management → KataGo setup: uses setup (evidence: `src/main/java/featurecat/lizzie/util/KataGoAutoSetupHelper.java`)
- Engine management → Engine commands: resolves commands
- Go player → Remote compute config: configures remote compute
- Remote compute config → Remote engine catalog: loads catalog
- Remote compute config → Remote engine transport: connects engine (evidence: `src/main/java/featurecat/lizzie/analysis/remote/RemoteComputeConfig.java`)
- Go player → Engine games: plays engine game
- Go player → Board synchronization: synchronizes board
- Go player → Go teaching: requests guidance
