# mcaesarar2-boop/business-simulator architecture

> Architecture diagram of the GitHub repository mcaesarar2-boop/business-simulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mcaesarar2-boop/business-simulator
- Repository: https://github.com/mcaesarar2-boop/business-simulator

## Overview

Billionaire Simulator is an offline-first Android business-and-lifestyle tycoon game. Players build business holdings, manage their finances and taxes, and acquire personal assets; Compose screens present these activities, with game state and local saves described by the README. The source excerpts are limited, so the graph preserves README-documented capabilities and uses tree-supported paths, but omits uncertain screen-to-engine and persistence call wiring.

Main entry points: [`app/src/main/java/com/example/MainActivity.kt`](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/MainActivity.kt) (App Entry), [`app/src/main/java/com/example/Screens.kt`](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/Screens.kt) (Game Screens), [`app/src/main/java/com/example/StockMarketScreen.kt`](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/StockMarketScreen.kt) (Market Screen), [`app/src/main/java/com/example/ui/HoldingDashboardScreen.kt`](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/HoldingDashboardScreen.kt) (Mega Holding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Experience"]
  node_activity["App Entry<br/>[MainActivity.kt]"]
  node_screens["Game Screens<br/>[Screens.kt]"]
  node_market_screen["Market Screen"]
  node_game_state["Game State<br/>[GameViewModel.kt]"]
  node_save_repo["Save Repository"]
end

subgraph group_business["Business Empires"]
  node_holding["Mega Holding"]
  node_industries["Business Verticals"]
  node_business_data["Business Data"]
  node_real_estate["Real Estate"]
  node_aviation["Aviation"]
  node_maritime["Cruise Operations<br/>[CruiseEngine.kt]"]
  node_theme_parks["Theme Parks<br/>[ThemeParkEngine.kt]"]
end

subgraph group_wealth["Wealth Management"]
  node_markets["Stocks &amp; Crypto"]
  node_market_data["Market Data"]
  node_family_office["Family Office"]
  node_tax["Tax &amp; Audit"]
  node_ledger["Financial Ledger"]
  node_index["Tycoon Index"]
end

subgraph group_personal["Private Lifestyle"]
  node_collections["Luxury Collections"]
  node_garage["Garage<br/>[GarageScreen.kt]"]
  node_portfolio["Private Portfolio"]
end

node_player(("Player"))

node_player -->|"opens"| node_activity
node_player -->|"manages"| node_screens
node_player -->|"trades"| node_market_screen
node_player -->|"builds"| node_holding
node_player -->|"operates"| node_industries
node_player -->|"invests"| node_real_estate
node_player -->|"manages"| node_aviation
node_player -->|"operates"| node_maritime
node_player -->|"develops"| node_theme_parks
node_player -->|"trades"| node_markets
node_player -->|"manages"| node_family_office
node_player -->|"reports taxes"| node_tax
node_player -->|"reviews"| node_ledger
node_player -->|"compares wealth"| node_index
node_player -->|"collects"| node_collections
node_player -->|"parks vehicles"| node_garage
node_player -->|"manages"| node_portfolio

click node_activity "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_screens "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/Screens.kt"
click node_market_screen "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/StockMarketScreen.kt"
click node_game_state "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/GameViewModel.kt"
click node_save_repo "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/SaveGameRepository.kt"
click node_holding "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/HoldingDashboardScreen.kt"
click node_industries "https://github.com/mcaesarar2-boop/business-simulator/tree/main/app/src/main/java/com/example/ui"
click node_business_data "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/BusinessDataGenerator.kt"
click node_real_estate "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/RealEstateScreen.kt"
click node_aviation "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/AviationDashboard.kt"
click node_maritime "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/CruiseEngine.kt"
click node_theme_parks "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/ThemeParkEngine.kt"
click node_markets "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/PrivateStockMarketScreen.kt"
click node_market_data "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/StockDataGenerator.kt"
click node_family_office "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/FamilyOfficeScreen.kt"
click node_tax "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/TaxAndAuditScreen.kt"
click node_ledger "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/FinancialHistoryScreen.kt"
click node_index "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/GlobalTycoonIndexScreen.kt"
click node_collections "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/CollectionScreen.kt"
click node_garage "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/GarageScreen.kt"
click node_portfolio "https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/PrivatePortfolioScreen.kt"

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_activity,node_screens,node_market_screen,node_game_state,node_save_repo toneBlue
class node_holding,node_industries,node_business_data,node_real_estate,node_aviation,node_maritime,node_theme_parks toneAmber
class node_markets,node_market_data,node_family_office,node_tax,node_ledger,node_index toneMint
class node_collections,node_garage,node_portfolio toneRose
class node_player toneIndigo
```

## Components

### App Experience

- [App Entry](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [Game Screens](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/Screens.kt): `app/src/main/java/com/example/Screens.kt`
- [Market Screen](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/StockMarketScreen.kt): `app/src/main/java/com/example/StockMarketScreen.kt`
- [Game State](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/GameViewModel.kt): `app/src/main/java/com/example/viewmodel/GameViewModel.kt`
- [Save Repository](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/SaveGameRepository.kt): `app/src/main/java/com/example/data/SaveGameRepository.kt`

### Business Empires

- [Mega Holding](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/HoldingDashboardScreen.kt): `app/src/main/java/com/example/ui/HoldingDashboardScreen.kt`
- [Business Verticals](https://github.com/mcaesarar2-boop/business-simulator/tree/main/app/src/main/java/com/example/ui): `app/src/main/java/com/example/ui`
- [Business Data](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/BusinessDataGenerator.kt): `app/src/main/java/com/example/data/BusinessDataGenerator.kt`
- [Real Estate](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/RealEstateScreen.kt): `app/src/main/java/com/example/ui/RealEstateScreen.kt`
- [Aviation](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/AviationDashboard.kt): `app/src/main/java/com/example/ui/AviationDashboard.kt`
- [Cruise Operations](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/CruiseEngine.kt): `app/src/main/java/com/example/viewmodel/CruiseEngine.kt`
- [Theme Parks](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/viewmodel/ThemeParkEngine.kt): `app/src/main/java/com/example/viewmodel/ThemeParkEngine.kt`

### Wealth Management

- [Stocks & Crypto](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/PrivateStockMarketScreen.kt): `app/src/main/java/com/example/ui/PrivateStockMarketScreen.kt`
- [Market Data](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/data/StockDataGenerator.kt): `app/src/main/java/com/example/data/StockDataGenerator.kt`
- [Family Office](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/FamilyOfficeScreen.kt): `app/src/main/java/com/example/ui/FamilyOfficeScreen.kt`
- [Tax & Audit](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/TaxAndAuditScreen.kt): `app/src/main/java/com/example/ui/TaxAndAuditScreen.kt`
- [Financial Ledger](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/FinancialHistoryScreen.kt): `app/src/main/java/com/example/ui/FinancialHistoryScreen.kt`
- [Tycoon Index](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/GlobalTycoonIndexScreen.kt): `app/src/main/java/com/example/ui/GlobalTycoonIndexScreen.kt`

### Private Lifestyle

- [Luxury Collections](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/CollectionScreen.kt): `app/src/main/java/com/example/ui/CollectionScreen.kt`
- [Garage](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/GarageScreen.kt): `app/src/main/java/com/example/ui/GarageScreen.kt`
- [Private Portfolio](https://github.com/mcaesarar2-boop/business-simulator/blob/main/app/src/main/java/com/example/ui/PrivatePortfolioScreen.kt): `app/src/main/java/com/example/ui/PrivatePortfolioScreen.kt`

### Other components

- **Player**

## Connections

- Player → App Entry: opens
- Player → Game Screens: manages
- Player → Market Screen: trades
- Player → Mega Holding: builds
- Player → Business Verticals: operates
- Player → Real Estate: invests
- Player → Aviation: manages
- Player → Cruise Operations: operates
- Player → Theme Parks: develops
- Player → Stocks & Crypto: trades
- Player → Family Office: manages
- Player → Tax & Audit: reports taxes
- Player → Financial Ledger: reviews
- Player → Tycoon Index: compares wealth
- Player → Luxury Collections: collects
- Player → Garage: parks vehicles
- Player → Private Portfolio: manages