# alexshaaaa/candyvestor architecture

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

- Interactive diagram: https://gitdiagram.com/alexshaaaa/candyvestor
- Repository: https://github.com/alexshaaaa/candyvestor

## Overview

CandyInvest is a SwiftUI investing-and-learning simulation: users explore a candy-themed market, trade assets in a portfolio, and progress through lessons, a knowledge graph, and achievements. The primary runtime path is app setup → ContentView → feature views and TradingViewModel → market and achievement logic backed by SwiftData models. The graph also preserves the empire/canvas and learning branches documented by the source index. Source excerpts are partial; unsampled components and links are included only where the index supports them.

Main entry points: [`viewmodels/TradingViewModel.swift`](https://github.com/alexshaaaa/candyvestor/blob/main/viewmodels/TradingViewModel.swift) (Trading state and actions), [`views/canvas/InfiniteCanvasView.swift`](https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/InfiniteCanvasView.swift) (Infinite canvas), [`CandyInvestApp.swift`](https://github.com/alexshaaaa/candyvestor/blob/main/CandyInvestApp.swift) (CandyInvest app), [`views/ContentView.swift`](https://github.com/alexshaaaa/candyvestor/blob/main/views/ContentView.swift) (Root navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_app["CandyInvest app"]
  node_content["Root navigation<br/>[ContentView.swift]"]
end

subgraph group_trading["Trading simulation"]
  node_tradingvm["Trading state and actions"]
  node_marketmgr["Market simulation"]
  node_marketview["Market browser<br/>[MarketView.swift]"]
  node_assetdetail["Asset and trade detail"]
  node_candles["Price history"]
  node_chart["Candlestick chart"]
  node_portfolio["Portfolio view"]
end

subgraph group_learning["Learning and progress"]
  node_learningview["Learning hub"]
  node_lessondata[("Lesson content")]
  node_knowledgepage["Knowledge page"]
  node_knowledgegraph["Knowledge graph"]
  node_knowledge[("Knowledge nodes")]
  node_achievementmgr["Achievement rules"]
  node_achievements[("Achievement records<br/>[Achievement.swift]")]
  node_achievementview["Achievement display"]
end

subgraph group_empire["Empire exploration"]
  node_empireview["Empire dashboard"]
  node_canvas["Infinite canvas"]
  node_graphenv["Canvas state"]
  node_edgeview["Canvas connections"]
  node_neural["Neural backdrop"]
  node_profile["Player profile"]
end

subgraph group_shared["Data and presentation"]
  node_marketdata[("Market assets<br/>[CandyModels.swift]")]
  node_candlestick[("Candle records<br/>[Candlestick.swift]")]
  node_trade[("Trade records<br/>[TradeRecord.swift]")]
  node_design["Visual design system<br/>[DesignSystem.swift]"]
end

node_user(("Player"))

node_user -->|"launches"| node_app
node_app -->|"shows"| node_content
node_content -->|"uses"| node_tradingvm
node_content -->|"routes to"| node_empireview
node_content -->|"routes to"| node_knowledgepage
node_marketview -->|"uses"| node_tradingvm
node_marketview -->|"opens"| node_assetdetail
node_assetdetail -->|"executes trades"| node_tradingvm
node_assetdetail -->|"shows history"| node_candles
node_candles -->|"renders"| node_chart
node_chart -->|"reads"| node_candlestick
node_portfolio -->|"uses"| node_tradingvm
node_tradingvm -->|"controls"| node_marketmgr
node_tradingvm -->|"records trades"| node_trade
node_marketmgr -->|"updates prices"| node_marketdata
node_marketmgr -->|"stores candles"| node_candlestick
node_learningview -->|"uses"| node_tradingvm
node_learningview -->|"opens"| node_knowledgegraph
node_learningview -->|"opens"| node_achievementview
node_knowledgepage -->|"uses"| node_tradingvm
node_knowledgepage -->|"renders"| node_neural
node_knowledgegraph -->|"uses"| node_tradingvm
node_knowledgegraph -->|"renders"| node_edgeview
node_tradingvm -->|"sends events"| node_achievementmgr
node_achievementmgr -->|"unlocks"| node_achievements
node_achievementview -->|"displays"| node_achievements
node_empireview -->|"uses"| node_tradingvm
node_empireview -->|"opens"| node_profile
node_canvas -->|"uses"| node_tradingvm
node_canvas -->|"reads state"| node_graphenv
node_canvas -->|"renders"| node_edgeview
node_canvas -->|"renders"| node_neural
node_canvas -->|"displays nodes"| node_knowledge
node_canvas -->|"opens"| node_profile
node_app -->|"seeds"| node_marketdata
node_app -->|"seeds"| node_knowledge
node_app -.->|"configures UI"| node_design

click node_app "https://github.com/alexshaaaa/candyvestor/blob/main/CandyInvestApp.swift"
click node_content "https://github.com/alexshaaaa/candyvestor/blob/main/views/ContentView.swift"
click node_tradingvm "https://github.com/alexshaaaa/candyvestor/blob/main/viewmodels/TradingViewModel.swift"
click node_marketmgr "https://github.com/alexshaaaa/candyvestor/blob/main/engine/MarketManager.swift"
click node_marketview "https://github.com/alexshaaaa/candyvestor/blob/main/views/MarketView.swift"
click node_assetdetail "https://github.com/alexshaaaa/candyvestor/blob/main/views/AssetDetailView.swift"
click node_candles "https://github.com/alexshaaaa/candyvestor/blob/main/views/PriceHistoryView.swift"
click node_chart "https://github.com/alexshaaaa/candyvestor/blob/main/views/charts/CandlestickChartView.swift"
click node_portfolio "https://github.com/alexshaaaa/candyvestor/blob/main/views/PortfolioView.swift"
click node_marketdata "https://github.com/alexshaaaa/candyvestor/blob/main/models/CandyModels.swift"
click node_candlestick "https://github.com/alexshaaaa/candyvestor/blob/main/models/Candlestick.swift"
click node_trade "https://github.com/alexshaaaa/candyvestor/blob/main/models/TradeRecord.swift"
click node_learningview "https://github.com/alexshaaaa/candyvestor/blob/main/views/LearningHubView.swift"
click node_lessondata "https://github.com/alexshaaaa/candyvestor/blob/main/models/LearningModule.swift"
click node_knowledgepage "https://github.com/alexshaaaa/candyvestor/blob/main/views/KnowledgePageView.swift"
click node_knowledgegraph "https://github.com/alexshaaaa/candyvestor/blob/main/views/graph/KnowledgeGraphView.swift"
click node_knowledge "https://github.com/alexshaaaa/candyvestor/blob/main/models/KnowledgeGraph.swift"
click node_achievementmgr "https://github.com/alexshaaaa/candyvestor/blob/main/engine/AchievementManager.swift"
click node_achievements "https://github.com/alexshaaaa/candyvestor/blob/main/models/Achievement.swift"
click node_achievementview "https://github.com/alexshaaaa/candyvestor/blob/main/views/achievements/AchievementsView.swift"
click node_empireview "https://github.com/alexshaaaa/candyvestor/blob/main/views/EmpirePageView.swift"
click node_canvas "https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/InfiniteCanvasView.swift"
click node_graphenv "https://github.com/alexshaaaa/candyvestor/blob/main/engine/GraphEnvironment.swift"
click node_edgeview "https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/AnimatedEdgeView.swift"
click node_neural "https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/NeuralBackgroundView.swift"
click node_profile "https://github.com/alexshaaaa/candyvestor/blob/main/views/UserProfileView.swift"
click node_design "https://github.com/alexshaaaa/candyvestor/blob/main/design/DesignSystem.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_app,node_content toneBlue
class node_tradingvm,node_marketmgr,node_marketview,node_assetdetail,node_candles,node_chart,node_portfolio toneAmber
class node_learningview,node_lessondata,node_knowledgepage,node_knowledgegraph,node_knowledge,node_achievementmgr,node_achievements,node_achievementview toneMint
class node_empireview,node_canvas,node_graphenv,node_edgeview,node_neural,node_profile toneRose
class node_marketdata,node_candlestick,node_trade,node_design,node_user toneIndigo
```

## Components

### App entry

- [CandyInvest app](https://github.com/alexshaaaa/candyvestor/blob/main/CandyInvestApp.swift): `CandyInvestApp.swift`
- [Root navigation](https://github.com/alexshaaaa/candyvestor/blob/main/views/ContentView.swift): `views/ContentView.swift`

### Trading simulation

- [Trading state and actions](https://github.com/alexshaaaa/candyvestor/blob/main/viewmodels/TradingViewModel.swift): `viewmodels/TradingViewModel.swift`
- [Market simulation](https://github.com/alexshaaaa/candyvestor/blob/main/engine/MarketManager.swift): `engine/MarketManager.swift`
- [Market browser](https://github.com/alexshaaaa/candyvestor/blob/main/views/MarketView.swift): `views/MarketView.swift`
- [Asset and trade detail](https://github.com/alexshaaaa/candyvestor/blob/main/views/AssetDetailView.swift): `views/AssetDetailView.swift`
- [Price history](https://github.com/alexshaaaa/candyvestor/blob/main/views/PriceHistoryView.swift): `views/PriceHistoryView.swift`
- [Candlestick chart](https://github.com/alexshaaaa/candyvestor/blob/main/views/charts/CandlestickChartView.swift): `views/charts/CandlestickChartView.swift`
- [Portfolio view](https://github.com/alexshaaaa/candyvestor/blob/main/views/PortfolioView.swift): `views/PortfolioView.swift`

### Learning and progress

- [Learning hub](https://github.com/alexshaaaa/candyvestor/blob/main/views/LearningHubView.swift): `views/LearningHubView.swift`
- [Lesson content](https://github.com/alexshaaaa/candyvestor/blob/main/models/LearningModule.swift): `models/LearningModule.swift`
- [Knowledge page](https://github.com/alexshaaaa/candyvestor/blob/main/views/KnowledgePageView.swift): `views/KnowledgePageView.swift`
- [Knowledge graph](https://github.com/alexshaaaa/candyvestor/blob/main/views/graph/KnowledgeGraphView.swift): `views/graph/KnowledgeGraphView.swift`
- [Knowledge nodes](https://github.com/alexshaaaa/candyvestor/blob/main/models/KnowledgeGraph.swift): `models/KnowledgeGraph.swift`
- [Achievement rules](https://github.com/alexshaaaa/candyvestor/blob/main/engine/AchievementManager.swift): `engine/AchievementManager.swift`
- [Achievement records](https://github.com/alexshaaaa/candyvestor/blob/main/models/Achievement.swift): `models/Achievement.swift`
- [Achievement display](https://github.com/alexshaaaa/candyvestor/blob/main/views/achievements/AchievementsView.swift): `views/achievements/AchievementsView.swift`

### Empire exploration

- [Empire dashboard](https://github.com/alexshaaaa/candyvestor/blob/main/views/EmpirePageView.swift): `views/EmpirePageView.swift`
- [Infinite canvas](https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/InfiniteCanvasView.swift): `views/canvas/InfiniteCanvasView.swift`
- [Canvas state](https://github.com/alexshaaaa/candyvestor/blob/main/engine/GraphEnvironment.swift): `engine/GraphEnvironment.swift`
- [Canvas connections](https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/AnimatedEdgeView.swift): `views/canvas/AnimatedEdgeView.swift`
- [Neural backdrop](https://github.com/alexshaaaa/candyvestor/blob/main/views/canvas/NeuralBackgroundView.swift): `views/canvas/NeuralBackgroundView.swift`
- [Player profile](https://github.com/alexshaaaa/candyvestor/blob/main/views/UserProfileView.swift): `views/UserProfileView.swift`

### Data and presentation

- [Market assets](https://github.com/alexshaaaa/candyvestor/blob/main/models/CandyModels.swift): `models/CandyModels.swift`
- [Candle records](https://github.com/alexshaaaa/candyvestor/blob/main/models/Candlestick.swift): `models/Candlestick.swift`
- [Trade records](https://github.com/alexshaaaa/candyvestor/blob/main/models/TradeRecord.swift): `models/TradeRecord.swift`
- [Visual design system](https://github.com/alexshaaaa/candyvestor/blob/main/design/DesignSystem.swift): `design/DesignSystem.swift`

### Other components

- **Player**

## Connections

- Player → CandyInvest app: launches (evidence: `CandyInvestApp.swift`)
- CandyInvest app → Root navigation: shows (evidence: `CandyInvestApp.swift`)
- Root navigation → Trading state and actions: uses (evidence: `views/ContentView.swift`)
- Root navigation → Empire dashboard: routes to (evidence: `views/ContentView.swift`)
- Root navigation → Knowledge page: routes to (evidence: `views/ContentView.swift`)
- Market browser → Trading state and actions: uses (evidence: `views/MarketView.swift`)
- Market browser → Asset and trade detail: opens (evidence: `views/MarketView.swift`)
- Asset and trade detail → Trading state and actions: executes trades (evidence: `views/AssetDetailView.swift`)
- Asset and trade detail → Price history: shows history (evidence: `views/AssetDetailView.swift`)
- Price history → Candlestick chart: renders (evidence: `views/PriceHistoryView.swift`)
- Candlestick chart → Candle records: reads (evidence: `views/charts/CandlestickChartView.swift`)
- Portfolio view → Trading state and actions: uses (evidence: `views/PortfolioView.swift`)
- Trading state and actions → Market simulation: controls (evidence: `viewmodels/TradingViewModel.swift`)
- Trading state and actions → Trade records: records trades (evidence: `viewmodels/TradingViewModel.swift`)
- Market simulation → Market assets: updates prices (evidence: `engine/MarketManager.swift`)
- Market simulation → Candle records: stores candles (evidence: `engine/MarketManager.swift`)
- Learning hub → Trading state and actions: uses (evidence: `views/LearningHubView.swift`)
- Learning hub → Knowledge graph: opens (evidence: `views/LearningHubView.swift`)
- Learning hub → Achievement display: opens (evidence: `views/LearningHubView.swift`)
- Knowledge page → Trading state and actions: uses (evidence: `views/KnowledgePageView.swift`)
- Knowledge page → Neural backdrop: renders (evidence: `views/KnowledgePageView.swift`)
- Knowledge graph → Trading state and actions: uses (evidence: `views/graph/KnowledgeGraphView.swift`)
- Knowledge graph → Canvas connections: renders (evidence: `views/graph/KnowledgeGraphView.swift`)
- Trading state and actions → Achievement rules: sends events (evidence: `viewmodels/TradingViewModel.swift`)
- Achievement rules → Achievement records: unlocks (evidence: `engine/AchievementManager.swift`)
- Achievement display → Achievement records: displays (evidence: `views/achievements/AchievementsView.swift`)
- Empire dashboard → Trading state and actions: uses (evidence: `views/EmpirePageView.swift`)
- Empire dashboard → Player profile: opens (evidence: `views/EmpirePageView.swift`)
- Infinite canvas → Trading state and actions: uses (evidence: `views/canvas/InfiniteCanvasView.swift`)
- Infinite canvas → Canvas state: reads state (evidence: `views/canvas/InfiniteCanvasView.swift`)
- Infinite canvas → Canvas connections: renders (evidence: `views/canvas/InfiniteCanvasView.swift`)
- Infinite canvas → Neural backdrop: renders (evidence: `views/canvas/InfiniteCanvasView.swift`)
- Infinite canvas → Knowledge nodes: displays nodes (evidence: `views/canvas/InfiniteCanvasView.swift`)
- Infinite canvas → Player profile: opens (evidence: `views/canvas/InfiniteCanvasView.swift`)
- CandyInvest app → Market assets: seeds (evidence: `CandyInvestApp.swift`)
- CandyInvest app → Knowledge nodes: seeds (evidence: `CandyInvestApp.swift`)
- CandyInvest app → Visual design system: configures UI
