# lurkumbra/sjtu-sep architecture

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

- Interactive diagram: https://gitdiagram.com/lurkumbra/sjtu-sep
- Repository: https://github.com/lurkumbra/sjtu-sep

## Overview

This repository contains two independent educational command-line programs. Lab 1 manages class enrollment and scores: it loads student/class records, accepts scores, computes class statistics or student grades, and saves results. Lab 2 simulates Y86-64 binaries and reports register and memory changes. The graph follows the sampled entry points and runtime code; some Lab 2 implementation details, especially binary loading, were not excerpted.

Main entry points: [`lab1/main.cc`](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/main.cc) (Score CLI), [`lab1/Class.cc`](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Class.cc) (Class Scores), [`lab2/simulator.cpp`](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/simulator.cpp) (Execution Engine), [`lab2/main.cpp`](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/main.cpp) (Simulator CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lab1_app["Lab 1 Scores"]
  node_score_app["Score CLI<br/>[main.cc]"]
  node_student_records["Student Records<br/>[Students.txt]"]
  node_class_records["Class Records<br/>[Classes.txt]"]
  node_score_output["Saved Scores<br/>[score.txt]"]
end

subgraph group_lab1_domain["Lab 1 Domain"]
  node_class_model["Class Scores<br/>[Class.cc]"]
  node_student_model["Student Grades<br/>[Student.cc]"]
end

subgraph group_lab2_app["Lab 2 Simulator"]
  node_sim_cli["Simulator CLI<br/>[main.cpp]"]
  node_simulator["Execution Engine<br/>[simulator.cpp]"]
end

subgraph group_lab2_state["Lab 2 Machine State"]
  node_instruction_rules["Instruction Rules<br/>[instructions.cpp]"]
  node_register_state["Registers<br/>[registers.cpp]"]
  node_memory_state[("Memory<br/>[memory.cpp]")]
  node_condition_codes["Condition Codes<br/>[instructions.cpp]"]
end

node_operator(("User"))
node_sim_user(("User"))

node_operator -->|"uses"| node_score_app
node_score_app -->|"loads"| node_student_records
node_score_app -->|"loads"| node_class_records
node_score_app -->|"builds classes"| node_class_model
node_score_app -->|"builds students"| node_student_model
node_score_app -->|"enters scores"| node_class_model
node_score_app -->|"gets statistics"| node_class_model
node_score_app -->|"gets grades"| node_student_model
node_score_app -->|"saves scores"| node_class_model
node_class_model -->|"appends scores"| node_score_output
node_class_model -->|"wraps students"| node_student_model
node_student_model -->|"reads enrollments"| node_class_model
node_sim_user -->|"runs binary"| node_sim_cli
node_sim_cli -->|"loads and runs"| node_simulator
node_simulator -->|"fetches and accesses"| node_memory_state
node_simulator -->|"reads and updates"| node_register_state
node_simulator -->|"decodes operations"| node_instruction_rules
node_simulator -->|"computes conditions"| node_condition_codes
node_sim_cli -->|"prints changes"| node_register_state
node_sim_cli -->|"prints changes"| node_memory_state

click node_score_app "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/main.cc"
click node_student_records "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Students.txt"
click node_class_records "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Classes.txt"
click node_score_output "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/score.txt"
click node_class_model "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Class.cc"
click node_student_model "https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Student.cc"
click node_sim_cli "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/main.cpp"
click node_simulator "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/simulator.cpp"
click node_instruction_rules "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/instructions.cpp"
click node_register_state "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/registers.cpp"
click node_memory_state "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/memory.cpp"
click node_condition_codes "https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/instructions.cpp"

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_score_app,node_student_records,node_class_records,node_score_output,node_operator,node_sim_user toneBlue
class node_class_model,node_student_model toneAmber
class node_sim_cli,node_simulator toneMint
class node_instruction_rules,node_register_state,node_memory_state,node_condition_codes toneRose
```

## Components

### Lab 1 Scores

- [Score CLI](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/main.cc): `lab1/main.cc`
- [Student Records](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Students.txt): `lab1/Students.txt`
- [Class Records](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Classes.txt): `lab1/Classes.txt`
- [Saved Scores](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/score.txt): `lab1/score.txt`

### Lab 1 Domain

- [Class Scores](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Class.cc): `lab1/Class.cc`
- [Student Grades](https://github.com/lurkumbra/sjtu-sep/blob/main/lab1/Student.cc): `lab1/Student.cc`

### Lab 2 Simulator

- [Simulator CLI](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/main.cpp): `lab2/main.cpp`
- [Execution Engine](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/simulator.cpp): `lab2/simulator.cpp`

### Lab 2 Machine State

- [Instruction Rules](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/instructions.cpp): `lab2/instructions.cpp`
- [Registers](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/registers.cpp): `lab2/registers.cpp`
- [Memory](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/memory.cpp): `lab2/memory.cpp`
- [Condition Codes](https://github.com/lurkumbra/sjtu-sep/blob/main/lab2/instructions.cpp): `lab2/instructions.cpp`

### Other components

- **User**
- **User**

## Connections

- User → Score CLI: uses (evidence: `lab1/main.cc`)
- Score CLI → Student Records: loads (evidence: `lab1/main.cc`)
- Score CLI → Class Records: loads (evidence: `lab1/main.cc`)
- Score CLI → Class Scores: builds classes (evidence: `lab1/main.cc`)
- Score CLI → Student Grades: builds students (evidence: `lab1/main.cc`)
- Score CLI → Class Scores: enters scores (evidence: `lab1/main.cc`)
- Score CLI → Class Scores: gets statistics (evidence: `lab1/main.cc`)
- Score CLI → Student Grades: gets grades (evidence: `lab1/main.cc`)
- Score CLI → Class Scores: saves scores (evidence: `lab1/main.cc`)
- Class Scores → Saved Scores: appends scores (evidence: `lab1/Class.cc`)
- Class Scores → Student Grades: wraps students (evidence: `lab1/Class.cc`)
- Student Grades → Class Scores: reads enrollments (evidence: `lab1/Student.cc`)
- User → Simulator CLI: runs binary (evidence: `lab2/main.cpp`)
- Simulator CLI → Execution Engine: loads and runs (evidence: `lab2/main.cpp`)
- Execution Engine → Memory: fetches and accesses (evidence: `lab2/simulator.cpp`)
- Execution Engine → Registers: reads and updates (evidence: `lab2/simulator.cpp`)
- Execution Engine → Instruction Rules: decodes operations (evidence: `lab2/simulator.cpp`)
- Execution Engine → Condition Codes: computes conditions (evidence: `lab2/simulator.cpp`)
- Simulator CLI → Registers: prints changes (evidence: `lab2/main.cpp`)
- Simulator CLI → Memory: prints changes (evidence: `lab2/main.cpp`)
