# bonappetitabc/bonraffle architecture

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

- Interactive diagram: https://gitdiagram.com/bonappetitabc/bonraffle
- Repository: https://github.com/bonappetitabc/bonraffle

## Overview

Bon Raffle is a Windows and macOS desktop raffle application. The host UI lets an organizer choose participant or weighted-prize mode, prepare a roster, run a draw, and review or export results. The graph emphasizes the WinUI implementation where call relationships are visible, while retaining the documented macOS app, MAX export, countdown, and update capabilities. Some capability links are documented only in the README; unsampled implementation details are not inferred.

Main entry points: [`Bon Raffle/bonraffle_winui/MainPage.xaml.cs`](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.xaml.cs) (Raffle interface), [`Bon Raffle/bonraffle_macos/BonRaffle.swift`](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/BonRaffle.swift) (macOS app), [`Bon Raffle/bonraffle_macos/RaffleModel.swift`](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/RaffleModel.swift) (macOS raffle model), [`Bon Raffle/bonraffle_winui/MaxRosterExporter.cs`](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MaxRosterExporter.cs) (MAX roster export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_winui["Windows app"]
  node_winapp["App lifecycle<br/>[App.xaml.cs]"]
  node_mainpage["Raffle interface<br/>[MainPage.xaml.cs]"]
  node_countdown["Countdown"]
  node_modes["Mode selection<br/>[MainPage.Modes.cs]"]
  node_prizeui["Prize controls<br/>[MainPage.Prizes.cs]"]
  node_updates["Update checks<br/>[AppUpdates.cs]"]
  node_macapp["macOS app<br/>[BonRaffle.swift]"]
  node_macupdates["macOS updates<br/>[AppUpdates.swift]"]
end

subgraph group_raffle["Raffle workflow"]
  node_engine["Draw engine<br/>[RaffleEngine.cs]"]
  node_macmodel["macOS raffle model<br/>[RaffleModel.swift]"]
end

subgraph group_data["Lists and persistence"]
  node_roster["CSV roster import<br/>[RaffleData.cs]"]
  node_manual[("Named rosters<br/>[ManualRoster.cs]")]
  node_prizes[("Prize sets<br/>[PrizeStore.cs]")]
  node_demo["Demo lists<br/>[DemoData.cs]"]
  node_localdata[("Local settings<br/>[RaffleData.cs]")]
  node_avatar["Avatar cache<br/>[AvatarCache.cs]"]
end

subgraph group_results["Results and exports"]
  node_history[("Winner history<br/>[DrawLog.cs]")]
  node_audit["Draw audit<br/>[MainPage.Audit.cs]"]
  node_proof["Draw proof<br/>[RaffleProof.cs]"]
  node_pdf["PDF export<br/>[DrawPdf.cs]"]
  node_macpdf["macOS PDF export<br/>[DrawPdf.swift]"]
end

subgraph group_integrations["External services"]
  node_maxexport["MAX roster export"]
  node_maxservice{{"MAX API"}}
  node_macmax["macOS MAX export"]
end

node_organizer(("Organizer"))

node_organizer -->|"starts"| node_winapp
node_winapp -->|"opens"| node_mainpage
node_organizer -.->|"operates"| node_mainpage
node_mainpage -.->|"configures"| node_countdown
node_mainpage -->|"selects mode"| node_modes
node_mainpage -->|"imports CSV"| node_roster
node_mainpage -->|"manages lists"| node_manual
node_mainpage -->|"loads examples"| node_demo
node_mainpage -->|"draws winner"| node_engine
node_mainpage -->|"loads avatars"| node_avatar
node_modes -->|"loads prize set"| node_prizes
node_prizeui -->|"edits prizes"| node_prizes
node_prizeui -->|"draws prize"| node_engine
node_mainpage -->|"records draws"| node_history
node_audit -->|"reads log"| node_history
node_audit -->|"exports PDF"| node_pdf
node_mainpage -.->|"documents draws"| node_proof
node_mainpage -->|"saves settings"| node_localdata
node_mainpage -->|"requests export"| node_maxexport
node_maxexport -->|"fetches members"| node_maxservice
node_maxexport -.->|"writes CSV"| node_localdata
node_mainpage -.->|"checks updates"| node_updates
node_organizer -.->|"uses macOS app"| node_macapp
node_macapp -->|"drives raffle"| node_macmodel
node_macmodel -->|"exports MAX roster"| node_macmax
node_macmodel -->|"exports results"| node_macpdf
node_macapp -->|"offers updates"| node_macupdates

click node_winapp "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/App.xaml.cs"
click node_mainpage "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.xaml.cs"
click node_countdown "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Countdown.cs"
click node_modes "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Modes.cs"
click node_prizeui "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Prizes.cs"
click node_updates "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/AppUpdates.cs"
click node_engine "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleEngine.cs"
click node_roster "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleData.cs"
click node_manual "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/ManualRoster.cs"
click node_prizes "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/PrizeStore.cs"
click node_demo "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DemoData.cs"
click node_localdata "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleData.cs"
click node_avatar "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/AvatarCache.cs"
click node_maxexport "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MaxRosterExporter.cs"
click node_history "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DrawLog.cs"
click node_audit "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Audit.cs"
click node_proof "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleProof.cs"
click node_pdf "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DrawPdf.cs"
click node_macapp "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/BonRaffle.swift"
click node_macmodel "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/RaffleModel.swift"
click node_macupdates "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/AppUpdates.swift"
click node_macmax "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/MaxRosterExporter.swift"
click node_macpdf "https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/DrawPdf.swift"

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_winapp,node_mainpage,node_countdown,node_modes,node_prizeui,node_updates,node_macapp,node_macupdates toneBlue
class node_engine,node_macmodel toneAmber
class node_roster,node_manual,node_prizes,node_demo,node_localdata,node_avatar toneMint
class node_history,node_audit,node_proof,node_pdf,node_macpdf toneRose
class node_maxexport,node_maxservice,node_macmax,node_organizer toneIndigo
```

## Components

### Windows app

- [App lifecycle](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/App.xaml.cs): `Bon Raffle/bonraffle_winui/App.xaml.cs`
- [Raffle interface](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.xaml.cs): `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`
- [Countdown](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Countdown.cs): `Bon Raffle/bonraffle_winui/MainPage.Countdown.cs`
- [Mode selection](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Modes.cs): `Bon Raffle/bonraffle_winui/MainPage.Modes.cs`
- [Prize controls](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Prizes.cs): `Bon Raffle/bonraffle_winui/MainPage.Prizes.cs`
- [Update checks](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/AppUpdates.cs): `Bon Raffle/bonraffle_winui/AppUpdates.cs`
- [macOS app](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/BonRaffle.swift): `Bon Raffle/bonraffle_macos/BonRaffle.swift`
- [macOS updates](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/AppUpdates.swift): `Bon Raffle/bonraffle_macos/AppUpdates.swift`

### Raffle workflow

- [Draw engine](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleEngine.cs): `Bon Raffle/bonraffle_winui/RaffleEngine.cs`
- [macOS raffle model](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/RaffleModel.swift): `Bon Raffle/bonraffle_macos/RaffleModel.swift`

### Lists and persistence

- [CSV roster import](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleData.cs): `Bon Raffle/bonraffle_winui/RaffleData.cs`
- [Named rosters](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/ManualRoster.cs): `Bon Raffle/bonraffle_winui/ManualRoster.cs`
- [Prize sets](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/PrizeStore.cs): `Bon Raffle/bonraffle_winui/PrizeStore.cs`
- [Demo lists](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DemoData.cs): `Bon Raffle/bonraffle_winui/DemoData.cs`
- [Local settings](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleData.cs): `Bon Raffle/bonraffle_winui/RaffleData.cs`
- [Avatar cache](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/AvatarCache.cs): `Bon Raffle/bonraffle_winui/AvatarCache.cs`

### Results and exports

- [Winner history](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DrawLog.cs): `Bon Raffle/bonraffle_winui/DrawLog.cs`
- [Draw audit](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MainPage.Audit.cs): `Bon Raffle/bonraffle_winui/MainPage.Audit.cs`
- [Draw proof](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/RaffleProof.cs): `Bon Raffle/bonraffle_winui/RaffleProof.cs`
- [PDF export](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/DrawPdf.cs): `Bon Raffle/bonraffle_winui/DrawPdf.cs`
- [macOS PDF export](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/DrawPdf.swift): `Bon Raffle/bonraffle_macos/DrawPdf.swift`

### External services

- [MAX roster export](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_winui/MaxRosterExporter.cs): `Bon Raffle/bonraffle_winui/MaxRosterExporter.cs`
- **MAX API**
- [macOS MAX export](https://github.com/bonappetitabc/bonraffle/blob/main/Bon%20Raffle/bonraffle_macos/MaxRosterExporter.swift): `Bon Raffle/bonraffle_macos/MaxRosterExporter.swift`

### Other components

- **Organizer**

## Connections

- Organizer → App lifecycle: starts (evidence: `Bon Raffle/bonraffle_winui/App.xaml.cs`)
- App lifecycle → Raffle interface: opens (evidence: `Bon Raffle/bonraffle_winui/App.xaml.cs`)
- Organizer → Raffle interface: operates (evidence: `README.md`)
- Raffle interface → Countdown: configures (evidence: `README.md`)
- Raffle interface → Mode selection: selects mode (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → CSV roster import: imports CSV (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → Named rosters: manages lists (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → Demo lists: loads examples (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → Draw engine: draws winner (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → Avatar cache: loads avatars (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Mode selection → Prize sets: loads prize set (evidence: `Bon Raffle/bonraffle_winui/MainPage.Modes.cs`)
- Prize controls → Prize sets: edits prizes (evidence: `Bon Raffle/bonraffle_winui/MainPage.Prizes.cs`)
- Prize controls → Draw engine: draws prize (evidence: `Bon Raffle/bonraffle_winui/MainPage.Prizes.cs`)
- Raffle interface → Winner history: records draws (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Draw audit → Winner history: reads log (evidence: `Bon Raffle/bonraffle_winui/MainPage.Audit.cs`)
- Draw audit → PDF export: exports PDF (evidence: `Bon Raffle/bonraffle_winui/MainPage.Audit.cs`)
- Raffle interface → Draw proof: documents draws
- Raffle interface → Local settings: saves settings (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- Raffle interface → MAX roster export: requests export (evidence: `Bon Raffle/bonraffle_winui/MainPage.xaml.cs`)
- MAX roster export → MAX API: fetches members (evidence: `Bon Raffle/bonraffle_winui/MaxRosterExporter.cs`)
- MAX roster export → Local settings: writes CSV (evidence: `Bon Raffle/bonraffle_winui/MaxRosterExporter.cs`)
- Raffle interface → Update checks: checks updates (evidence: `README.md`)
- Organizer → macOS app: uses macOS app (evidence: `README.md`)
- macOS app → macOS raffle model: drives raffle (evidence: `Bon Raffle/bonraffle_macos/BonRaffle.swift`)
- macOS raffle model → macOS MAX export: exports MAX roster (evidence: `Bon Raffle/bonraffle_macos/RaffleModel.swift`)
- macOS raffle model → macOS PDF export: exports results (evidence: `Bon Raffle/bonraffle_macos/RaffleModel.swift`)
- macOS app → macOS updates: offers updates (evidence: `Bon Raffle/bonraffle_macos/BonRaffle.swift`)
