# toosynxed/i-don-t-even-know--idek--game architecture

> Architecture diagram of the GitHub repository toosynxed/i-don-t-even-know--idek--game, 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/toosynxed/i-don-t-even-know--idek--game
- Repository: https://github.com/toosynxed/i-don-t-even-know--idek--game

## Overview

IDeK is a terminal-based game framework. A player enters a username and speed, then the entry point checks for an account; returning players authenticate, while new players choose a password from the supplied list. After login, the menu dispatches to market, inventory, achievements, or leaderboard. The market advances and displays simulated price ticks; inventory and achievements decode bitwise account values, and the leaderboard ranks wallet cash. The sampled code supports local CSV persistence. Firebase-related configuration exists in the tree, but the available README and source excerpts do not establish a runtime role for it.

Main entry points: [`functions_terminal.py`](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/functions_terminal.py) (Shared Helpers), [`menu_terminal.py`](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py) (Game Menu), [`main_terminal.py`](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/main_terminal.py) (Game Entry), [`market_terminal.py`](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/market_terminal.py) (Market Simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Account Access"]
  node_entry["Game Entry<br/>[main_terminal.py]"]
  node_helpers["Shared Helpers"]
end

subgraph group_game["Game Navigation"]
  node_menu["Game Menu<br/>[menu_terminal.py]"]
end

subgraph group_features["Game Features"]
  node_market["Market Simulation<br/>[market_terminal.py]"]
  node_inventory["Inventory View<br/>[menu_terminal.py]"]
  node_achievements["Achievement View<br/>[menu_terminal.py]"]
  node_leaderboard["Cash Leaderboard<br/>[menu_terminal.py]"]
end

subgraph group_state["CSV State"]
  node_passwords[("Password Options<br/>[pass_list.csv]")]
  node_account_data[("Account Credentials<br/>[user_pass.csv]")]
  node_market_history[("Market History<br/>[market_history.csv]")]
  node_inventory_data[("Inventory Bits")]
  node_achievement_data[("Achievement Bits<br/>[user_ach.csv]")]
  node_wallet_data[("Wallet Balances<br/>[user_wallets.csv]")]
  node_holdings_data[("Player Holdings<br/>[user_holdings.csv]")]
end

node_player(("Player"))

node_player -->|"starts game"| node_entry
node_entry -->|"checks login"| node_helpers
node_entry -->|"opens after login"| node_menu
node_helpers -->|"reads options"| node_passwords
node_helpers -->|"checks and saves"| node_account_data
node_menu -->|"runs market"| node_market
node_menu -->|"opens inventory"| node_inventory
node_menu -->|"opens achievements"| node_achievements
node_menu -->|"opens leaderboard"| node_leaderboard
node_market -->|"renders text"| node_helpers
node_market -->|"reads and appends"| node_market_history
node_inventory -->|"loads and decodes"| node_helpers
node_helpers -->|"reads and writes"| node_inventory_data
node_achievements -->|"loads and decodes"| node_helpers
node_helpers -->|"reads and writes"| node_achievement_data
node_leaderboard -->|"reads balances"| node_wallet_data

click node_entry "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/main_terminal.py"
click node_helpers "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/functions_terminal.py"
click node_passwords "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/pass_list.csv"
click node_account_data "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_pass.csv"
click node_menu "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py"
click node_market "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/market_terminal.py"
click node_market_history "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/market_history.csv"
click node_inventory "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py"
click node_achievements "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py"
click node_leaderboard "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py"
click node_inventory_data "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_inventories.csv"
click node_achievement_data "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_ach.csv"
click node_wallet_data "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_wallets.csv"
click node_holdings_data "https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_holdings.csv"

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_entry,node_helpers toneBlue
class node_menu toneAmber
class node_market,node_inventory,node_achievements,node_leaderboard toneMint
class node_passwords,node_account_data,node_market_history,node_inventory_data,node_achievement_data,node_wallet_data,node_holdings_data toneRose
class node_player toneIndigo
```

## Components

### Account Access

- [Game Entry](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/main_terminal.py): `main_terminal.py`
- [Shared Helpers](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/functions_terminal.py): `functions_terminal.py`

### Game Navigation

- [Game Menu](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py): `menu_terminal.py`

### Game Features

- [Market Simulation](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/market_terminal.py): `market_terminal.py`
- [Inventory View](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py): `menu_terminal.py`
- [Achievement View](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py): `menu_terminal.py`
- [Cash Leaderboard](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/menu_terminal.py): `menu_terminal.py`

### CSV State

- [Password Options](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/pass_list.csv): `pass_list.csv`
- [Account Credentials](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_pass.csv): `user_pass.csv`
- [Market History](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/market_history.csv): `market_history.csv`
- [Inventory Bits](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_inventories.csv): `user_inventories.csv`
- [Achievement Bits](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_ach.csv): `user_ach.csv`
- [Wallet Balances](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_wallets.csv): `user_wallets.csv`
- [Player Holdings](https://github.com/toosynxed/i-don-t-even-know--idek--game/blob/main/user_holdings.csv): `user_holdings.csv`

### Other components

- **Player**

## Connections

- Player → Game Entry: starts game
- Game Entry → Shared Helpers: checks login
- Game Entry → Game Menu: opens after login
- Shared Helpers → Password Options: reads options
- Shared Helpers → Account Credentials: checks and saves
- Game Menu → Market Simulation: runs market
- Game Menu → Inventory View: opens inventory
- Game Menu → Achievement View: opens achievements
- Game Menu → Cash Leaderboard: opens leaderboard
- Market Simulation → Shared Helpers: renders text
- Market Simulation → Market History: reads and appends
- Inventory View → Shared Helpers: loads and decodes
- Shared Helpers → Inventory Bits: reads and writes
- Achievement View → Shared Helpers: loads and decodes
- Shared Helpers → Achievement Bits: reads and writes
- Cash Leaderboard → Wallet Balances: reads balances