# chungchi300/reading-book architecture

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

- Interactive diagram: https://gitdiagram.com/chungchi300/reading-book
- Repository: https://github.com/chungchi300/reading-book

## Overview

This repository is primarily a curated collection of technical books, organized by topic, plus a small set of executable exercises from How To Solve It By Computer. The book-list script scans top-level directories, checks for duplicate filenames among immediate files, and writes a Markdown catalog. Exercise modules independently demonstrate value exchange and counting algorithms; no application-level workflow connecting them is shown. The README excerpt is empty, so the map follows the supplied tree and sampled code.

Main entry points: [`my-first-algorithm/( R G Dromey ) How To Solve It By Computer.pdf`](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/(%20R%20G%20Dromey%20)%20How%20To%20Solve%20It%20By%20Computer.pdf) (Algorithm Book), [`library/list_all_books.py`](https://github.com/chungchi300/reading-book/blob/master/library/list_all_books.py) (Catalog Generator), [`library`](https://github.com/chungchi300/reading-book/tree/master/library) (Topic Libraries), [`library/readme.md`](https://github.com/chungchi300/reading-book/blob/master/library/readme.md) (Book Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Book Collection"]
  node_book_topics["Topic Libraries"]
  node_topical_copies["Topical Copies"]
  node_catalog_file["Book Catalog<br/>[readme.md]"]
end

subgraph group_exercises["Algorithm Exercises"]
  node_algorithm_book["Algorithm Book"]
  node_exchange_pair["Pair Exchange<br/>[2.1.0.py]"]
  node_exchange_triple["Triple Exchange<br/>[2.1.2.py]"]
  node_exchange_quad["Quadruple Exchange<br/>[2.1.3.py]"]
  node_exchange_variants["Exchange Variants<br/>[2.1.4.py]"]
  node_pass_count["Pass Counting<br/>[2.2.0.py]"]
  node_file_pass_count["File Pass Count<br/>[2.2.1.py]"]
  node_partition_count["Partition Counts<br/>[2.2.2.py]"]
  node_pass_subtraction["Pass Subtraction<br/>[2.2.3.py]"]
end

subgraph group_utility["Catalog Utility"]
  node_catalog_script["Catalog Generator<br/>[list_all_books.py]"]
end

node_reader(("Reader"))

node_reader -.->|"browses"| node_book_topics
node_reader -.->|"studies"| node_algorithm_book
node_algorithm_book -.->|"informs"| node_exchange_pair
node_algorithm_book -.->|"informs"| node_exchange_triple
node_algorithm_book -.->|"informs"| node_exchange_quad
node_algorithm_book -.->|"informs"| node_exchange_variants
node_algorithm_book -.->|"informs"| node_pass_count
node_algorithm_book -.->|"informs"| node_file_pass_count
node_algorithm_book -.->|"informs"| node_partition_count
node_algorithm_book -.->|"informs"| node_pass_subtraction
node_catalog_script -->|"writes"| node_catalog_file

click node_book_topics "https://github.com/chungchi300/reading-book/tree/master/library"
click node_topical_copies "https://github.com/chungchi300/reading-book/tree/master/architecture"
click node_algorithm_book "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/(%20R%20G%20Dromey%20)%20How%20To%20Solve%20It%20By%20Computer.pdf"
click node_exchange_pair "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.0.py"
click node_exchange_triple "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.2.py"
click node_exchange_quad "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.3.py"
click node_exchange_variants "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.4.py"
click node_pass_count "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.0.py"
click node_file_pass_count "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.1.py"
click node_partition_count "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.2.py"
click node_pass_subtraction "https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.3.py"
click node_catalog_script "https://github.com/chungchi300/reading-book/blob/master/library/list_all_books.py"
click node_catalog_file "https://github.com/chungchi300/reading-book/blob/master/library/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_book_topics,node_topical_copies,node_catalog_file toneBlue
class node_algorithm_book,node_exchange_pair,node_exchange_triple,node_exchange_quad,node_exchange_variants,node_pass_count,node_file_pass_count,node_partition_count,node_pass_subtraction toneAmber
class node_catalog_script toneMint
class node_reader toneIndigo
```

## Components

### Book Collection

- [Topic Libraries](https://github.com/chungchi300/reading-book/tree/master/library): `library`
- [Topical Copies](https://github.com/chungchi300/reading-book/tree/master/architecture): `architecture`
- [Book Catalog](https://github.com/chungchi300/reading-book/blob/master/library/readme.md): `library/readme.md`

### Algorithm Exercises

- [Algorithm Book](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/(%20R%20G%20Dromey%20)%20How%20To%20Solve%20It%20By%20Computer.pdf): `my-first-algorithm/( R G Dromey ) How To Solve It By Computer.pdf`
- [Pair Exchange](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.0.py): `my-first-algorithm/2 Fundamental Algorithms/2.1 Exchanging the Values of Two Variables/2.1.0.py`
- [Triple Exchange](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.2.py): `my-first-algorithm/2 Fundamental Algorithms/2.1 Exchanging the Values of Two Variables/2.1.2.py`
- [Quadruple Exchange](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.3.py): `my-first-algorithm/2 Fundamental Algorithms/2.1 Exchanging the Values of Two Variables/2.1.3.py`
- [Exchange Variants](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.1%20Exchanging%20the%20Values%20of%20Two%20Variables/2.1.4.py): `my-first-algorithm/2 Fundamental Algorithms/2.1 Exchanging the Values of Two Variables/2.1.4.py`
- [Pass Counting](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.0.py): `my-first-algorithm/2 Fundamental Algorithms/2.2 Counting/2.2.0.py`
- [File Pass Count](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.1.py): `my-first-algorithm/2 Fundamental Algorithms/2.2 Counting/2.2.1.py`
- [Partition Counts](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.2.py): `my-first-algorithm/2 Fundamental Algorithms/2.2 Counting/2.2.2.py`
- [Pass Subtraction](https://github.com/chungchi300/reading-book/blob/master/my-first-algorithm/2%20Fundamental%20Algorithms/2.2%20Counting/2.2.3.py): `my-first-algorithm/2 Fundamental Algorithms/2.2 Counting/2.2.3.py`

### Catalog Utility

- [Catalog Generator](https://github.com/chungchi300/reading-book/blob/master/library/list_all_books.py): `library/list_all_books.py`

### Other components

- **Reader**

## Connections

- Reader → Topic Libraries: browses
- Reader → Algorithm Book: studies
- Algorithm Book → Pair Exchange: informs
- Algorithm Book → Triple Exchange: informs
- Algorithm Book → Quadruple Exchange: informs
- Algorithm Book → Exchange Variants: informs
- Algorithm Book → Pass Counting: informs
- Algorithm Book → File Pass Count: informs
- Algorithm Book → Partition Counts: informs
- Algorithm Book → Pass Subtraction: informs
- Catalog Generator → Book Catalog: writes (evidence: `library/list_all_books.py`)
