# qossayrida/realtimeproject architecture

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

- Interactive diagram: https://gitdiagram.com/qossayrida/realtimeproject
- Repository: https://github.com/qossayrida/realtimeproject

## Overview

This repository is a suite of four real-time and embedded-system simulations, not one shared runtime. Their user-to-result workflows are: run a coordinated bungee-jumping game and show scores; generate and process files while tracking directory outcomes; simulate espionage, resistance, and agency activity in a visualized world; and let a player repeat LED sequences using buttons with LCD feedback. The README establishes product capabilities and broad coordination, but several project implementations were not sampled, so those relationships are documented at a high level rather than inferred as detailed call chains.

Main entry points: [`Project2/src/main.c`](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/main.c) (Simulation Controller), [`Project3/src/main.c`](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/main.c) (Simulation Controller), [`Project1/src/main_referee.c`](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/main_referee.c) (Game Referee), [`Project4/code/main.asm`](https://github.com/qossayrida/realtimeproject/blob/master/Project4/code/main.asm) (16F877A MCU)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_jump["Bungee Game"]
  node_referee["Game Referee<br/>[main_referee.c]"]
  node_assistant_referee["Assistant Referees"]
  node_jump_players["Team Players<br/>[player.c]"]
  node_jump_config["Game Settings<br/>[config.c]"]
  node_jump_display["Game Display<br/>[gui.c]"]
end

subgraph group_files["File Simulation"]
  node_file_main["Simulation Controller<br/>[main.c]"]
  node_file_config["File Settings<br/>[config.c]"]
  node_generator["File Generators<br/>[file_generator.c]"]
  node_calculator["File Calculators<br/>[file_calculator.c]"]
  node_mover["File Movers<br/>[file_mover.c]"]
  node_inspectors["File Inspectors"]
  node_file_state[("Shared File State<br/>[config.h]")]
  node_file_display["File Display<br/>[gui.c]"]
end

subgraph group_espionage["Espionage Simulation"]
  node_espionage_main["Simulation Controller<br/>[main.c]"]
  node_resistance["Resistance Groups<br/>[resistance_group.c]"]
  node_citizens["Citizens<br/>[citizen.c]"]
  node_enemies["Enemy Spies<br/>[enemy.c]"]
  node_agency["Counter Agency"]
  node_espionage_state[("Simulation State<br/>[linked_list.h]")]
  node_espionage_display["World Display<br/>[gui.c]"]
end

subgraph group_embedded["PIC Game"]
  node_pic_game["Memory Game<br/>[main.asm]"]
  node_pic{{"16F877A MCU<br/>[main.asm]"}}
  node_buttons["Push Buttons<br/>[README.md]"]
  node_leds["Color LEDs<br/>[README.md]"]
  node_lcd["LCD Feedback<br/>[README.md]"]
end

node_player_user(("Player"))
node_file_user(("Simulation User"))
node_agency_user(("Simulation User"))
node_embedded_user(("Game Player"))

node_player_user -->|"starts game"| node_referee
node_referee -.->|"loads settings"| node_jump_config
node_referee -.->|"coordinates teams"| node_assistant_referee
node_assistant_referee -.->|"coordinates play"| node_jump_players
node_referee -->|"shows scores"| node_jump_display
node_file_user -->|"starts simulation"| node_file_main
node_file_main -.->|"loads settings"| node_file_config
node_file_main -.->|"starts workers"| node_generator
node_file_main -.->|"starts workers"| node_calculator
node_file_main -.->|"starts workers"| node_mover
node_file_main -.->|"starts workers"| node_inspectors
node_generator -.->|"updates file state"| node_file_state
node_calculator -.->|"updates file state"| node_file_state
node_mover -.->|"moves file state"| node_file_state
node_inspectors -.->|"inspects files"| node_file_state
node_file_main -->|"visualizes outcomes"| node_file_display
node_agency_user -->|"starts simulation"| node_espionage_main
node_espionage_main -->|"creates groups"| node_resistance
node_espionage_main -.->|"starts civilians"| node_citizens
node_espionage_main -.->|"starts spies"| node_enemies
node_espionage_main -.->|"starts agency"| node_agency
node_resistance -.->|"tracks members"| node_espionage_state
node_agency -.->|"tracks detections"| node_espionage_state
node_espionage_main -->|"updates display"| node_espionage_display
node_embedded_user -->|"enters sequence"| node_buttons
node_buttons -->|"sends input"| node_pic
node_pic_game -.->|"runs game logic"| node_pic
node_pic -->|"shows sequence"| node_leds
node_pic -->|"shows feedback"| node_lcd

click node_referee "https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/main_referee.c"
click node_assistant_referee "https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/assistant_referee.c"
click node_jump_players "https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/player.c"
click node_jump_config "https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/config.c"
click node_jump_display "https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/gui.c"
click node_file_main "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/main.c"
click node_file_config "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/config.c"
click node_generator "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_generator.c"
click node_calculator "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_calculator.c"
click node_mover "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_mover.c"
click node_inspectors "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_type1_inspector.c"
click node_file_state "https://github.com/qossayrida/realtimeproject/blob/master/Project2/include/config.h"
click node_file_display "https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/gui.c"
click node_espionage_main "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/main.c"
click node_resistance "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/resistance_group.c"
click node_citizens "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/citizen.c"
click node_enemies "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/enemy.c"
click node_agency "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/counter_espionage_agency.c"
click node_espionage_state "https://github.com/qossayrida/realtimeproject/blob/master/Project3/include/linked_list.h"
click node_espionage_display "https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/gui.c"
click node_pic_game "https://github.com/qossayrida/realtimeproject/blob/master/Project4/code/main.asm"
click node_pic "https://github.com/qossayrida/realtimeproject/blob/master/Project4/code/main.asm"
click node_buttons "https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md"
click node_leds "https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md"
click node_lcd "https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md"

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_referee,node_assistant_referee,node_jump_players,node_jump_config,node_jump_display,node_file_user,node_agency_user toneBlue
class node_file_main,node_file_config,node_generator,node_calculator,node_mover,node_inspectors,node_file_state,node_file_display toneAmber
class node_espionage_main,node_resistance,node_citizens,node_enemies,node_agency,node_espionage_state,node_espionage_display toneMint
class node_pic_game,node_pic,node_buttons,node_leds,node_lcd toneRose
class node_player_user,node_embedded_user toneIndigo
```

## Components

### Bungee Game

- [Game Referee](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/main_referee.c): `Project1/src/main_referee.c`
- [Assistant Referees](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/assistant_referee.c): `Project1/src/assistant_referee.c`
- [Team Players](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/player.c): `Project1/src/player.c`
- [Game Settings](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/config.c): `Project1/src/config.c`
- [Game Display](https://github.com/qossayrida/realtimeproject/blob/master/Project1/src/gui.c): `Project1/src/gui.c`

### File Simulation

- [Simulation Controller](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/main.c): `Project2/src/main.c`
- [File Settings](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/config.c): `Project2/src/config.c`
- [File Generators](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_generator.c): `Project2/src/file_generator.c`
- [File Calculators](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_calculator.c): `Project2/src/file_calculator.c`
- [File Movers](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_mover.c): `Project2/src/file_mover.c`
- [File Inspectors](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/file_type1_inspector.c): `Project2/src/file_type1_inspector.c`
- [Shared File State](https://github.com/qossayrida/realtimeproject/blob/master/Project2/include/config.h): `Project2/include/config.h`
- [File Display](https://github.com/qossayrida/realtimeproject/blob/master/Project2/src/gui.c): `Project2/src/gui.c`

### Espionage Simulation

- [Simulation Controller](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/main.c): `Project3/src/main.c`
- [Resistance Groups](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/resistance_group.c): `Project3/src/resistance_group.c`
- [Citizens](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/citizen.c): `Project3/src/citizen.c`
- [Enemy Spies](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/enemy.c): `Project3/src/enemy.c`
- [Counter Agency](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/counter_espionage_agency.c): `Project3/src/counter_espionage_agency.c`
- [Simulation State](https://github.com/qossayrida/realtimeproject/blob/master/Project3/include/linked_list.h): `Project3/include/linked_list.h`
- [World Display](https://github.com/qossayrida/realtimeproject/blob/master/Project3/src/gui.c): `Project3/src/gui.c`

### PIC Game

- [Memory Game](https://github.com/qossayrida/realtimeproject/blob/master/Project4/code/main.asm): `Project4/code/main.asm`
- [16F877A MCU](https://github.com/qossayrida/realtimeproject/blob/master/Project4/code/main.asm): `Project4/code/main.asm`
- [Push Buttons](https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md): `Project4/README.md`
- [Color LEDs](https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md): `Project4/README.md`
- [LCD Feedback](https://github.com/qossayrida/realtimeproject/blob/master/Project4/README.md): `Project4/README.md`

### Other components

- **Player**
- **Simulation User**
- **Simulation User**
- **Game Player**

## Connections

- Player → Game Referee: starts game (evidence: `README.md`)
- Game Referee → Game Settings: loads settings
- Game Referee → Assistant Referees: coordinates teams
- Assistant Referees → Team Players: coordinates play
- Game Referee → Game Display: shows scores (evidence: `README.md`)
- Simulation User → Simulation Controller: starts simulation (evidence: `README.md`)
- Simulation Controller → File Settings: loads settings
- Simulation Controller → File Generators: starts workers
- Simulation Controller → File Calculators: starts workers
- Simulation Controller → File Movers: starts workers
- Simulation Controller → File Inspectors: starts workers
- File Generators → Shared File State: updates file state
- File Calculators → Shared File State: updates file state
- File Movers → Shared File State: moves file state
- File Inspectors → Shared File State: inspects files
- Simulation Controller → File Display: visualizes outcomes (evidence: `README.md`)
- Simulation User → Simulation Controller: starts simulation (evidence: `README.md`)
- Simulation Controller → Resistance Groups: creates groups (evidence: `Project3/src/main.c`)
- Simulation Controller → Citizens: starts civilians
- Simulation Controller → Enemy Spies: starts spies
- Simulation Controller → Counter Agency: starts agency
- Resistance Groups → Simulation State: tracks members (evidence: `Project3/src/resistance_group.c`)
- Counter Agency → Simulation State: tracks detections (evidence: `Project3/src/counter_espionage_agency.c`)
- Simulation Controller → World Display: updates display (evidence: `Project3/src/main.c`)
- Game Player → Push Buttons: enters sequence (evidence: `README.md`)
- Push Buttons → 16F877A MCU: sends input (evidence: `README.md`)
- Memory Game → 16F877A MCU: runs game logic
- 16F877A MCU → Color LEDs: shows sequence (evidence: `README.md`)
- 16F877A MCU → LCD Feedback: shows feedback (evidence: `README.md`)
