# ranthonybeckett/inconnu architecture

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

- Interactive diagram: https://gitdiagram.com/ranthonybeckett/inconnu
- Repository: https://github.com/ranthonybeckett/inconnu

## Overview

Inconnu is a local Windows character and Storyteller tool for Mind’s Eye Theatre Vampire games. Players and Storytellers open or create a library, import and edit Grapevine characters, then use character creation/advancement, XP tracking, purchase previews and local chronicle tools; sheets can be viewed in English or Portuguese, and the product includes backup and recovery. The graph groups the user-facing UI, character/rules workflows, chronicle tools and library persistence. Edges reflect README statements and indexed source references; unsampled modules are represented by their exact paths, with uncertain internal calls omitted.

Main entry points: [`app-rust/src/ui.rs`](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/ui.rs) (Application UI), [`app-rust/src/purchase_preview.rs`](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_preview.rs) (Spending preview), [`app-rust/src/store.rs`](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/store.rs) (Library operations), [`app-rust/src/sheet.rs`](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/sheet.rs) (Character editing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Desktop app<br/>[main.rs]"]
  node_ui_shell["Application UI<br/>[ui.rs]"]
  node_sheet_ui["Character sheets<br/>[sheet_ui.rs]"]
  node_creation_ui["Creation UI<br/>[creation_window.rs]"]
  node_purchase_ui["Purchase UI<br/>[purchase_ui.rs]"]
  node_session_ui["Session UI<br/>[session_ui.rs]"]
end

subgraph group_characters["Characters and rules"]
  node_importer["Grapevine import<br/>[importer.rs]"]
  node_sheet["Character editing<br/>[sheet.rs]"]
  node_model["Character records<br/>[model.rs]"]
  node_vampire["Vampire creation"]
  node_pricing["Rules pricing<br/>[pricing.rs]"]
  node_profiles["Creature profiles"]
  node_catalogue["Power catalogue<br/>[power_catalogue.rs]"]
  node_preview["Spending preview"]
  node_reviews["Purchase review"]
  node_xp["XP ledger<br/>[xp.rs]"]
  node_advancement["Advancement"]
  node_search["Character search<br/>[searches.rs]"]
end

subgraph group_chronicle["Chronicle tools"]
  node_sessions["Game sessions<br/>[game_sessions.rs]"]
  node_playtime["Playtime awards<br/>[playtime.rs]"]
  node_playreview["Award review<br/>[playtime_review.rs]"]
  node_legacy["Legacy profile<br/>[legacy_profile.rs]"]
end

subgraph group_library["Library and records"]
  node_store["Library operations<br/>[store.rs]"]
  node_database[("Local library database<br/>[store.rs]")]
  node_backup["Backup and recovery<br/>[safe_files.rs]"]
end

node_player(("Player / Storyteller"))

node_player -->|"opens"| node_app
node_app -->|"starts"| node_ui_shell
node_ui_shell -->|"uses"| node_sheet_ui
node_ui_shell -->|"uses"| node_purchase_ui
node_ui_shell -->|"uses"| node_session_ui
node_ui_shell -->|"uses"| node_creation_ui
node_creation_ui -->|"uses"| node_sheet_ui
node_player -->|"imports files"| node_importer
node_player -->|"edits characters"| node_sheet
node_sheet -->|"edits records"| node_model
node_sheet -->|"reads list keys"| node_importer
node_profiles -->|"uses pricing"| node_pricing
node_catalogue -->|"calculates previews"| node_pricing
node_catalogue -->|"uses power identities"| node_preview
node_preview -->|"requests prices"| node_pricing
node_preview -->|"checks profiles"| node_profiles
node_reviews -->|"creates previews"| node_preview
node_reviews -->|"checks XP history"| node_xp
node_player -->|"tracks XP"| node_xp
node_player -->|"previews spending"| node_preview
node_player -->|"creates characters"| node_vampire
node_player -->|"advances characters"| node_advancement
node_player -->|"uses chronicle tools"| node_sessions
node_sessions -->|"uses sheets"| node_model
node_playreview -->|"uses award rules"| node_playtime
node_legacy -->|"uses XP dates"| node_xp
node_player -->|"searches characters"| node_search
node_store -->|"uses importer"| node_importer
node_store -->|"uses record types"| node_model
node_store -->|"reads and writes"| node_database
node_player -->|"backs up library"| node_backup
node_player -->|"opens library"| node_store

click node_app "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/main.rs"
click node_ui_shell "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/ui.rs"
click node_sheet_ui "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/sheet_ui.rs"
click node_creation_ui "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/ui/creation_window.rs"
click node_purchase_ui "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_ui.rs"
click node_session_ui "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/session_ui.rs"
click node_importer "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/importer.rs"
click node_sheet "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/sheet.rs"
click node_model "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/model.rs"
click node_vampire "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/vampire_creation.rs"
click node_pricing "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/pricing.rs"
click node_profiles "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/creature_profiles.rs"
click node_catalogue "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/power_catalogue.rs"
click node_preview "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_preview.rs"
click node_reviews "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_reviews.rs"
click node_xp "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/xp.rs"
click node_advancement "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/mixed_advancement.rs"
click node_sessions "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/game_sessions.rs"
click node_playtime "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/playtime.rs"
click node_playreview "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/playtime_review.rs"
click node_legacy "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/legacy_profile.rs"
click node_search "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/searches.rs"
click node_store "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/store.rs"
click node_database "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/store.rs"
click node_backup "https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/safe_files.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_ui_shell,node_sheet_ui,node_creation_ui,node_purchase_ui,node_session_ui toneBlue
class node_importer,node_sheet,node_model,node_vampire,node_pricing,node_profiles,node_catalogue,node_preview,node_reviews,node_xp,node_advancement,node_search toneAmber
class node_sessions,node_playtime,node_playreview,node_legacy toneMint
class node_store,node_database,node_backup toneRose
class node_player toneIndigo
```

## Components

### Desktop interface

- [Desktop app](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/main.rs): `app-rust/src/main.rs`
- [Application UI](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/ui.rs): `app-rust/src/ui.rs`
- [Character sheets](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/sheet_ui.rs): `app-rust/src/sheet_ui.rs`
- [Creation UI](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/ui/creation_window.rs): `app-rust/src/ui/creation_window.rs`
- [Purchase UI](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_ui.rs): `app-rust/src/purchase_ui.rs`
- [Session UI](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/session_ui.rs): `app-rust/src/session_ui.rs`

### Characters and rules

- [Grapevine import](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/importer.rs): `app-rust/src/importer.rs`
- [Character editing](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/sheet.rs): `app-rust/src/sheet.rs`
- [Character records](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/model.rs): `app-rust/src/model.rs`
- [Vampire creation](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/vampire_creation.rs): `app-rust/src/vampire_creation.rs`
- [Rules pricing](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/pricing.rs): `app-rust/src/pricing.rs`
- [Creature profiles](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/creature_profiles.rs): `app-rust/src/creature_profiles.rs`
- [Power catalogue](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/power_catalogue.rs): `app-rust/src/power_catalogue.rs`
- [Spending preview](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_preview.rs): `app-rust/src/purchase_preview.rs`
- [Purchase review](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/purchase_reviews.rs): `app-rust/src/purchase_reviews.rs`
- [XP ledger](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/xp.rs): `app-rust/src/xp.rs`
- [Advancement](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/mixed_advancement.rs): `app-rust/src/mixed_advancement.rs`
- [Character search](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/searches.rs): `app-rust/src/searches.rs`

### Chronicle tools

- [Game sessions](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/game_sessions.rs): `app-rust/src/game_sessions.rs`
- [Playtime awards](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/playtime.rs): `app-rust/src/playtime.rs`
- [Award review](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/playtime_review.rs): `app-rust/src/playtime_review.rs`
- [Legacy profile](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/legacy_profile.rs): `app-rust/src/legacy_profile.rs`

### Library and records

- [Library operations](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/store.rs): `app-rust/src/store.rs`
- [Local library database](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/store.rs): `app-rust/src/store.rs`
- [Backup and recovery](https://github.com/ranthonybeckett/inconnu/blob/main/app-rust/src/safe_files.rs): `app-rust/src/safe_files.rs`

### Other components

- **Player / Storyteller**

## Connections

- Player / Storyteller → Desktop app: opens (evidence: `README.md`)
- Desktop app → Application UI: starts (evidence: `app-rust/src/main.rs`)
- Application UI → Character sheets: uses (evidence: `app-rust/src/ui.rs`)
- Application UI → Purchase UI: uses (evidence: `app-rust/src/ui.rs`)
- Application UI → Session UI: uses (evidence: `app-rust/src/ui.rs`)
- Application UI → Creation UI: uses (evidence: `app-rust/src/ui.rs`)
- Creation UI → Character sheets: uses (evidence: `app-rust/src/ui/creation_window.rs`)
- Player / Storyteller → Grapevine import: imports files (evidence: `README.md`)
- Player / Storyteller → Character editing: edits characters (evidence: `README.md`)
- Character editing → Character records: edits records (evidence: `app-rust/src/sheet.rs`)
- Character editing → Grapevine import: reads list keys (evidence: `app-rust/src/sheet.rs`)
- Creature profiles → Rules pricing: uses pricing (evidence: `app-rust/src/creature_profiles.rs`)
- Power catalogue → Rules pricing: calculates previews (evidence: `app-rust/src/power_catalogue.rs`)
- Power catalogue → Spending preview: uses power identities (evidence: `app-rust/src/power_catalogue.rs`)
- Spending preview → Rules pricing: requests prices (evidence: `app-rust/src/purchase_preview.rs`)
- Spending preview → Creature profiles: checks profiles (evidence: `app-rust/src/purchase_preview.rs`)
- Purchase review → Spending preview: creates previews (evidence: `app-rust/src/purchase_reviews.rs`)
- Purchase review → XP ledger: checks XP history (evidence: `app-rust/src/purchase_reviews.rs`)
- Player / Storyteller → XP ledger: tracks XP (evidence: `README.md`)
- Player / Storyteller → Spending preview: previews spending (evidence: `README.md`)
- Player / Storyteller → Vampire creation: creates characters (evidence: `README.md`)
- Player / Storyteller → Advancement: advances characters (evidence: `README.md`)
- Player / Storyteller → Game sessions: uses chronicle tools (evidence: `README.md`)
- Game sessions → Character records: uses sheets (evidence: `app-rust/src/game_sessions.rs`)
- Award review → Playtime awards: uses award rules (evidence: `app-rust/src/playtime_review.rs`)
- Legacy profile → XP ledger: uses XP dates (evidence: `app-rust/src/legacy_profile.rs`)
- Player / Storyteller → Character search: searches characters (evidence: `README.md`)
- Library operations → Grapevine import: uses importer (evidence: `app-rust/src/store.rs`)
- Library operations → Character records: uses record types (evidence: `app-rust/src/store.rs`)
- Library operations → Local library database: reads and writes (evidence: `app-rust/src/store.rs`)
- Player / Storyteller → Backup and recovery: backs up library (evidence: `README.md`)
- Player / Storyteller → Library operations: opens library (evidence: `README.md`)
