# alstonliow/fit1045 architecture

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

- Interactive diagram: https://gitdiagram.com/alstonliow/fit1045
- Repository: https://github.com/alstonliow/fit1045

## Overview

This repository is a collection of standalone C++ teaching examples, not one integrated application. Each lesson or project demonstrates a separate user-to-result workflow, from interactive games and data tools to reusable data structures. The graph groups the main example families and shows only relationships visible in sampled source or the SOURCE INDEX; it does not imply that the lessons call one another. Several core modules are represented by their exact paths, but their internal behavior is not inferred where source was not sampled.

Main entry points: [`FieldGuide/12_project/cheese-shop-cli.cpp`](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop-cli.cpp) (Cheese shop CLI), [`FieldGuide/10_Pointer&List/Mazegame/maze.cpp`](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/maze.cpp) (Maze game), [`FieldGuide/7_Multiples/7_product.cpp`](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_product.cpp) (Product database), [`FieldGuide/P8_Python/grade.cpp`](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/P8_Python/grade.cpp) (Grade analyser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_games["Interactive games"]
  node_clickgame["Click game<br/>[5_clickGame.cpp]"]
  node_reaction["Reaction game<br/>[6_gui.cpp]"]
  node_flygame["Fly game<br/>[6_fly.cpp]"]
  node_flyutils["Fly utilities<br/>[utilities.h]"]
  node_gamestates["Game states<br/>[game.cpp]"]
  node_mazegame["Maze game<br/>[maze.cpp]"]
  node_mazearray["Maze array<br/>[bounded_array.hpp]"]
  node_mazeutils["Maze utilities<br/>[utilities.h]"]
  node_map["Map explorer<br/>[map.cpp]"]
  node_maputils["Map utilities<br/>[utilities.h]"]
end

subgraph group_data["Data structures"]
  node_bounded["Bounded array<br/>[bounded_array.hpp]"]
  node_linkedlist["Linked list<br/>[linked_list.cpp]"]
  node_dynamicarray["Dynamic array<br/>[dynamic-array.hpp]"]
  node_memoryutils["Memory utilities<br/>[utilities.h]"]
end

subgraph group_apps["Data applications"]
  node_cheesec_li["Cheese shop CLI"]
  node_cheesedomain["Cheese shop domain<br/>[cheese-shop.cpp]"]
  node_cheeseheader["Cheese shop types<br/>[cheese-shop.h]"]
  node_cheeseutils["Shop utilities<br/>[utilities.h]"]
  node_products["Product database<br/>[7_product.cpp]"]
  node_productutils["Product utilities<br/>[utilities.h]"]
  node_grade["Grade analyser<br/>[grade.cpp]"]
  node_pythonutils["Python utilities<br/>[utilities.h]"]
end

subgraph group_lessons["Programming lessons"]
  node_accounts["User accounts<br/>[8_user.cpp]"]
  node_accountutils["Account utilities<br/>[utilities.h]"]
  node_sequence["Morse sequence<br/>[2_MorseCode.cpp]"]
  node_music["Music player<br/>[4_musicPlayer.cpp]"]
  node_appliedutils["Applied utilities<br/>[utilities.cpp]"]
  node_appliedheader["Applied declarations<br/>[utilities.h]"]
  node_structureutils["Code utilities<br/>[utilities.h]"]
  node_datautils["Data utilities<br/>[utilities.h]"]
  node_statesutils["State utilities<br/>[utilities.h]"]
  node_stats["Statistics lesson<br/>[7_stats_calc.cpp]"]
  node_memberutils["Member utilities<br/>[utilities.h]"]
end

node_user(("User"))

node_user -->|"plays"| node_clickgame
node_user -->|"plays"| node_reaction
node_flygame -->|"imports"| node_flyutils
node_user -->|"chooses path"| node_mazegame
node_mazegame -->|"imports"| node_mazearray
node_mazegame -->|"imports"| node_mazeutils
node_map -->|"imports"| node_maputils
node_user -->|"manages stock"| node_cheesec_li
node_cheesec_li -->|"calls domain"| node_cheesedomain
node_cheesec_li -->|"imports"| node_cheeseheader
node_cheesec_li -->|"imports"| node_cheeseutils
node_products -->|"imports"| node_productutils
node_user -->|"manages products"| node_products
node_user -->|"enters grades"| node_grade
node_grade -->|"imports"| node_pythonutils
node_user -->|"uses account menu"| node_accounts
node_accounts -->|"imports"| node_accountutils
node_appliedutils -->|"implements declarations"| node_appliedheader

click node_clickgame "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/5_StructureCode/5_clickGame.cpp"
click node_reaction "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gui.cpp"
click node_flygame "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_fly/6_fly.cpp"
click node_flyutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_fly/utilities.h"
click node_gamestates "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gameStates/game.cpp"
click node_mazegame "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/maze.cpp"
click node_mazearray "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/bounded_array.hpp"
click node_mazeutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/utilities.h"
click node_map "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_map/map.cpp"
click node_maputils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_map/utilities.h"
click node_bounded "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/9_Generic/bounded_array.hpp"
click node_linkedlist "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/linked_list.cpp"
click node_dynamicarray "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/11_DeepDiveMemory/dynamic-array.hpp"
click node_memoryutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/11_DeepDiveMemory/utilities.h"
click node_cheesec_li "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop-cli.cpp"
click node_cheesedomain "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop.cpp"
click node_cheeseheader "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop.h"
click node_cheeseutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/utilities.h"
click node_products "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_product.cpp"
click node_productutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/utilities.h"
click node_grade "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/P8_Python/grade.cpp"
click node_pythonutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/P8_Python/utilities.h"
click node_accounts "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/8_user.cpp"
click node_accountutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/utilities.h"
click node_sequence "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/2_Sequence/2_MorseCode.cpp"
click node_music "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/4_ControlFlow/4_musicPlayer.cpp"
click node_appliedutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/Applied/utilities.cpp"
click node_appliedheader "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/Applied/utilities.h"
click node_structureutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/5_StructureCode/utilities.h"
click node_datautils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/utilities.h"
click node_statesutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gameStates/utilities.h"
click node_stats "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_stats_calc.cpp"
click node_memberutils "https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/utilities.h"

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_clickgame,node_reaction,node_flygame,node_flyutils,node_gamestates,node_mazegame,node_mazearray,node_mazeutils,node_map,node_maputils,node_user toneBlue
class node_bounded,node_linkedlist,node_dynamicarray,node_memoryutils toneAmber
class node_cheesec_li,node_cheesedomain,node_cheeseheader,node_cheeseutils,node_products,node_productutils,node_grade,node_pythonutils toneMint
class node_accounts,node_accountutils,node_sequence,node_music,node_appliedutils,node_appliedheader,node_structureutils,node_datautils,node_statesutils,node_stats,node_memberutils toneRose
```

## Components

### Interactive games

- [Click game](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/5_StructureCode/5_clickGame.cpp): `FieldGuide/5_StructureCode/5_clickGame.cpp`
- [Reaction game](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gui.cpp): `FieldGuide/6_StructureData/6_gui.cpp`
- [Fly game](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_fly/6_fly.cpp): `FieldGuide/6_StructureData/6_fly/6_fly.cpp`
- [Fly utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_fly/utilities.h): `FieldGuide/6_StructureData/6_fly/utilities.h`
- [Game states](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gameStates/game.cpp): `FieldGuide/6_StructureData/6_gameStates/game.cpp`
- [Maze game](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/maze.cpp): `FieldGuide/10_Pointer&List/Mazegame/maze.cpp`
- [Maze array](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/bounded_array.hpp): `FieldGuide/10_Pointer&List/Mazegame/bounded_array.hpp`
- [Maze utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/Mazegame/utilities.h): `FieldGuide/10_Pointer&List/Mazegame/utilities.h`
- [Map explorer](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_map/map.cpp): `FieldGuide/7_Multiples/7_map/map.cpp`
- [Map utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_map/utilities.h): `FieldGuide/7_Multiples/7_map/utilities.h`

### Data structures

- [Bounded array](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/9_Generic/bounded_array.hpp): `FieldGuide/9_Generic/bounded_array.hpp`
- [Linked list](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/10_Pointer%26List/linked_list.cpp): `FieldGuide/10_Pointer&List/linked_list.cpp`
- [Dynamic array](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/11_DeepDiveMemory/dynamic-array.hpp): `FieldGuide/11_DeepDiveMemory/dynamic-array.hpp`
- [Memory utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/11_DeepDiveMemory/utilities.h): `FieldGuide/11_DeepDiveMemory/utilities.h`

### Data applications

- [Cheese shop CLI](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop-cli.cpp): `FieldGuide/12_project/cheese-shop-cli.cpp`
- [Cheese shop domain](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop.cpp): `FieldGuide/12_project/cheese-shop.cpp`
- [Cheese shop types](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/cheese-shop.h): `FieldGuide/12_project/cheese-shop.h`
- [Shop utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/12_project/utilities.h): `FieldGuide/12_project/utilities.h`
- [Product database](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_product.cpp): `FieldGuide/7_Multiples/7_product.cpp`
- [Product utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/utilities.h): `FieldGuide/7_Multiples/utilities.h`
- [Grade analyser](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/P8_Python/grade.cpp): `FieldGuide/P8_Python/grade.cpp`
- [Python utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/P8_Python/utilities.h): `FieldGuide/P8_Python/utilities.h`

### Programming lessons

- [User accounts](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/8_user.cpp): `FieldGuide/8_MemberFunc/8_user.cpp`
- [Account utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/utilities.h): `FieldGuide/8_MemberFunc/utilities.h`
- [Morse sequence](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/2_Sequence/2_MorseCode.cpp): `FieldGuide/2_Sequence/2_MorseCode.cpp`
- [Music player](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/4_ControlFlow/4_musicPlayer.cpp): `FieldGuide/4_ControlFlow/4_musicPlayer.cpp`
- [Applied utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/Applied/utilities.cpp): `FieldGuide/Applied/utilities.cpp`
- [Applied declarations](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/Applied/utilities.h): `FieldGuide/Applied/utilities.h`
- [Code utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/5_StructureCode/utilities.h): `FieldGuide/5_StructureCode/utilities.h`
- [Data utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/utilities.h): `FieldGuide/6_StructureData/utilities.h`
- [State utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/6_StructureData/6_gameStates/utilities.h): `FieldGuide/6_StructureData/6_gameStates/utilities.h`
- [Statistics lesson](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/7_Multiples/7_stats_calc.cpp): `FieldGuide/7_Multiples/7_stats_calc.cpp`
- [Member utilities](https://github.com/alstonliow/fit1045/blob/main/FieldGuide/8_MemberFunc/utilities.h): `FieldGuide/8_MemberFunc/utilities.h`

### Other components

- **User**

## Connections

- User → Click game: plays (evidence: `FieldGuide/5_StructureCode/5_clickGame.cpp`)
- User → Reaction game: plays (evidence: `FieldGuide/6_StructureData/6_gui.cpp`)
- Fly game → Fly utilities: imports (evidence: `FieldGuide/6_StructureData/6_fly/6_fly.cpp`)
- User → Maze game: chooses path (evidence: `FieldGuide/10_Pointer&List/Mazegame/maze.cpp`)
- Maze game → Maze array: imports (evidence: `FieldGuide/10_Pointer&List/Mazegame/maze.cpp`)
- Maze game → Maze utilities: imports (evidence: `FieldGuide/10_Pointer&List/Mazegame/maze.cpp`)
- Map explorer → Map utilities: imports (evidence: `FieldGuide/7_Multiples/7_map/map.cpp`)
- User → Cheese shop CLI: manages stock (evidence: `FieldGuide/12_project/cheese-shop-cli.cpp`)
- Cheese shop CLI → Cheese shop domain: calls domain (evidence: `FieldGuide/12_project/cheese-shop-cli.cpp`)
- Cheese shop CLI → Cheese shop types: imports (evidence: `FieldGuide/12_project/cheese-shop-cli.cpp`)
- Cheese shop CLI → Shop utilities: imports (evidence: `FieldGuide/12_project/cheese-shop-cli.cpp`)
- Product database → Product utilities: imports (evidence: `FieldGuide/7_Multiples/7_product.cpp`)
- User → Product database: manages products (evidence: `FieldGuide/7_Multiples/7_product.cpp`)
- User → Grade analyser: enters grades (evidence: `FieldGuide/P8_Python/grade.cpp`)
- Grade analyser → Python utilities: imports (evidence: `FieldGuide/P8_Python/grade.cpp`)
- User → User accounts: uses account menu (evidence: `FieldGuide/8_MemberFunc/8_user.cpp`)
- User accounts → Account utilities: imports (evidence: `FieldGuide/8_MemberFunc/8_user.cpp`)
- Applied utilities → Applied declarations: implements declarations (evidence: `FieldGuide/Applied/utilities.cpp`)
