# mojimoon/cityu-cs architecture

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

- Interactive diagram: https://gitdiagram.com/mojimoon/cityu-cs
- Repository: https://github.com/mojimoon/cityu-cs

## Overview

CityU CS is a student-maintained study reference: course-organized Markdown notes, corresponding PDFs, and educational projects. The main workflow is a student choosing a course from the README, then studying its notes; project examples provide a separate hands-on branch. The CS3201 example includes a TCP client and server supporting message and file exchange. The README documents the notes and project collections; source excerpts show the client/server behavior, but do not establish their runtime wiring beyond the socket protocol.

Main entry points: [`src`](https://github.com/mojimoon/cityu-cs/tree/main/src) (Course notes), [`README.md`](https://github.com/mojimoon/cityu-cs/blob/main/README.md) (Course guide), [`projects/CS3201/BulletinClientBoard.py`](https://github.com/mojimoon/cityu-cs/blob/main/projects/CS3201/BulletinClientBoard.py) (Bulletin client), [`projects`](https://github.com/mojimoon/cityu-cs/tree/main/projects) (Mini projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Course catalog"]
  node_course_catalog["Course guide<br/>[README.md]"]
end

subgraph group_study["Study materials"]
  node_course_notes["Course notes"]
  node_pdf_notes["PDF notes"]
  node_cs_core["Core CS topics"]
  node_cs_electives["CS electives"]
  node_other_courses["Other courses"]
end

subgraph group_examples["Project examples"]
  node_projects_collection["Mini projects"]
  node_network_client["Bulletin client"]
  node_network_server["Bulletin server"]
end

node_student(("Student"))
node_network_service(("TCP socket"))

node_student -->|"chooses course"| node_course_catalog
node_course_catalog -->|"links Markdown"| node_course_notes
node_course_catalog -->|"links PDFs"| node_pdf_notes
node_student -->|"studies"| node_course_notes
node_student -->|"studies"| node_pdf_notes
node_course_notes -->|"includes topics"| node_cs_core
node_course_notes -->|"includes topics"| node_cs_electives
node_course_notes -->|"includes courses"| node_other_courses
node_course_catalog -->|"lists projects"| node_projects_collection
node_projects_collection -->|"includes example"| node_network_client
node_network_client -->|"connects by TCP"| node_network_service
node_network_server -->|"serves TCP"| node_network_service
node_network_client -.->|"exchanges commands"| node_network_server

click node_course_catalog "https://github.com/mojimoon/cityu-cs/blob/main/README.md"
click node_course_notes "https://github.com/mojimoon/cityu-cs/tree/main/src"
click node_pdf_notes "https://github.com/mojimoon/cityu-cs/tree/main/notes"
click node_cs_core "https://github.com/mojimoon/cityu-cs/tree/main/src/CS3103"
click node_cs_electives "https://github.com/mojimoon/cityu-cs/tree/main/src/CS3481"
click node_other_courses "https://github.com/mojimoon/cityu-cs/tree/main/src/CB2400"
click node_projects_collection "https://github.com/mojimoon/cityu-cs/tree/main/projects"
click node_network_client "https://github.com/mojimoon/cityu-cs/blob/main/projects/CS3201/BulletinClientBoard.py"
click node_network_server "https://github.com/mojimoon/cityu-cs/blob/main/projects/CS3201/2023_3201_server_final.py"

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_course_catalog toneBlue
class node_course_notes,node_pdf_notes,node_cs_core,node_cs_electives,node_other_courses toneAmber
class node_projects_collection,node_network_client,node_network_server toneMint
class node_student,node_network_service toneIndigo
```

## Components

### Course catalog

- [Course guide](https://github.com/mojimoon/cityu-cs/blob/main/README.md): `README.md`

### Study materials

- [Course notes](https://github.com/mojimoon/cityu-cs/tree/main/src): `src`
- [PDF notes](https://github.com/mojimoon/cityu-cs/tree/main/notes): `notes`
- [Core CS topics](https://github.com/mojimoon/cityu-cs/tree/main/src/CS3103): `src/CS3103`
- [CS electives](https://github.com/mojimoon/cityu-cs/tree/main/src/CS3481): `src/CS3481`
- [Other courses](https://github.com/mojimoon/cityu-cs/tree/main/src/CB2400): `src/CB2400`

### Project examples

- [Mini projects](https://github.com/mojimoon/cityu-cs/tree/main/projects): `projects`
- [Bulletin client](https://github.com/mojimoon/cityu-cs/blob/main/projects/CS3201/BulletinClientBoard.py): `projects/CS3201/BulletinClientBoard.py`
- [Bulletin server](https://github.com/mojimoon/cityu-cs/blob/main/projects/CS3201/2023_3201_server_final.py): `projects/CS3201/2023_3201_server_final.py`

### Other components

- **Student**
- **TCP socket**

## Connections

- Student → Course guide: chooses course (evidence: `README.md`)
- Course guide → Course notes: links Markdown (evidence: `README.md`)
- Course guide → PDF notes: links PDFs (evidence: `README.md`)
- Student → Course notes: studies (evidence: `README.md`)
- Student → PDF notes: studies (evidence: `README.md`)
- Course notes → Core CS topics: includes topics (evidence: `README.md`)
- Course notes → CS electives: includes topics (evidence: `README.md`)
- Course notes → Other courses: includes courses (evidence: `README.md`)
- Course guide → Mini projects: lists projects (evidence: `README.md`)
- Mini projects → Bulletin client: includes example (evidence: `README.md`)
- Bulletin client → TCP socket: connects by TCP (evidence: `projects/CS3201/BulletinClientBoard.py`)
- Bulletin server → TCP socket: serves TCP (evidence: `projects/CS3201/2023_3201_server_final.py`)
- Bulletin client → Bulletin server: exchanges commands
