# vnoi-admin/vnoi_wiki architecture

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

- Interactive diagram: https://gitdiagram.com/vnoi-admin/vnoi_wiki
- Repository: https://github.com/vnoi-admin/vnoi_wiki

## Overview

#### Purpose and Shape
This is a content-only Vietnamese competitive-programming knowledge base. It has no application source, package manifest, CI, or deployment definition in the tree; its effective product is a Markdown/document/media corpus intended for a separate renderer or wiki host.

#### Entry Documents
Primary reader-facing entry points appear to be top-level Markdown pages: `Home.md`, `roadmap.md`, and `about.md`. Contributor workflow is documented in `contributor-tutorial.md`. `fake-homepage.md` may support an alternate landing-page representation.

#### Algorithm Curriculum
The core corpus is organized by algorithm domain. Major instructional modules include foundations in `algo/basic/`, algebra and number theory in `algo/algebra/` and `algo/math/`, dynamic programming in `algo/dp/`, and graphs in `algo/graph-theory/`. Representative hub/content paths include `algo/basic/Tai-Lieu-Thuat-Toan.md`, `algo/dp/basic-dynamic-programming-1.md`, and `algo/graph-theory/graph.md`.

#### Advanced Data Structures and Strings
Reusable competitive-programming techniques are documented rather than implemented as a unified library. Data-structure material is centered under `algo/data-structures/`, including `algo/data-structures/data-structures-overview.md`, `algo/data-structures/segment-tree-basic.md`, and `algo/data-structures/disjoint-set-union.md`. String algorithms form a parallel topic group in `algo/string/`, such as `algo/string/aho-corasick.md` and `algo/string/suffix-array.md`.

#### Supplemental Learning Content
The repository expands beyond algorithms into competition skills, language references, interviews, and computer-science topics: `algo/skill/Ki-nang-thi-cu.md`, `languages/cpp/pointers.md`, `interview/general-experience.md`, and `comp-sci/ml/machine-learning-101.md`. These are peer content domains, not runtime modules.

#### Translation and Editorial Boundary
Translated external educational material is isolated in `translate/`, preserving source-oriented categorization: `translate/emaxx/Aho-Corasick.md`, `translate/topcoder/dynamic-programming.md`, and `translate/wcipeg/Flows.md`. Original/editorial community content is separately grouped under `vnoi-magazine/`, `vnoi-interview/`, and `news-bulletin/`.

#### Assets and Runtime/Infrastructure
Markdown is the dominant format, with occasional embedded/supporting artifacts such as `algo/ahocorasickanimate.mp4`, `algo/data-structures/range-tree.html`, and `algo/data-structures/rangetree.pdf`. No backend, database, external API, build pipeline, or hosting integration is present. The primary flow is author/contributor → categorized Markdown/media → external documentation renderer/navigation; cross-links and directory conventions are therefore the principal integration boundary.

Main entry points: [`roadmap.md`](https://github.com/vnoi-admin/vnoi_wiki/blob/master/roadmap.md) (Roadmap), [`Home.md`](https://github.com/vnoi-admin/vnoi_wiki/blob/master/Home.md) (Home), [`algo/basic/Tai-Lieu-Thuat-Toan.md`](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/basic/Tai-Lieu-Thuat-Toan.md) (Foundations), [`translate/emaxx/Aho-Corasick.md`](https://github.com/vnoi-admin/vnoi_wiki/blob/master/translate/emaxx/Aho-Corasick.md) (Translated Material)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Reader Entry"]
  node_home["Home<br/>Markdown entry<br/>[Home.md]"]
  node_roadmap["Roadmap<br/>Markdown entry<br/>[roadmap.md]"]
  node_about["About<br/>Markdown entry<br/>[about.md]"]
  node_contributor_guide["Contributor Tutorial<br/>contributor guide"]
end

subgraph group_curriculum["Algorithm Curriculum"]
  node_foundations["Foundations<br/>algorithm docs"]
  node_algebra_math["Algebra &amp; Math<br/>algorithm docs<br/>[euclid.md]"]
  node_dp["Dynamic Programming<br/>algorithm docs"]
  node_graphs["Graph Theory<br/>algorithm docs<br/>[graph.md]"]
  node_data_structures["Data Structures<br/>algorithm docs"]
  node_strings["String Algorithms<br/>algorithm docs<br/>[aho-corasick.md]"]
  node_supporting_media["Supporting Media<br/>embedded artifacts"]
end

subgraph group_supplemental["Supplemental Content"]
  node_competition_skills["Competition Skills<br/>learning docs<br/>[Ki-nang-thi-cu.md]"]
  node_cpp_reference["C++ Reference<br/>language docs<br/>[pointers.md]"]
  node_interview["Interview Content<br/>learning docs"]
  node_computer_science["Computer Science<br/>learning docs"]
end

subgraph group_editorial["Translations &amp; Editorial"]
  node_translations["Translated Material<br/>translated docs<br/>[Aho-Corasick.md]"]
  node_community_editorial["Community Editorial<br/>editorial docs"]
  node_news_bulletin["News Bulletin<br/>community updates<br/>[bảng-tin.md]"]
end

node_external_renderer{{"Documentation Renderer<br/>external host"}}

node_contributor_guide -.->|"guides contributions to"| node_foundations
node_contributor_guide -.->|"guides contributions to"| node_translations
node_home -->|"links to"| node_roadmap
node_home -->|"navigates to"| node_foundations
node_home -->|"navigates to"| node_dp
node_home -->|"navigates to"| node_graphs
node_home -->|"navigates to"| node_data_structures
node_roadmap -->|"curriculum path"| node_foundations
node_roadmap -->|"curriculum path"| node_algebra_math
node_roadmap -->|"curriculum path"| node_dp
node_roadmap -->|"curriculum path"| node_graphs
node_roadmap -->|"curriculum path"| node_data_structures
node_roadmap -->|"curriculum path"| node_strings
node_data_structures -->|"uses supporting artifacts"| node_supporting_media
node_strings -->|"uses supporting artifacts"| node_supporting_media
node_translations -.->|"parallel reference material"| node_strings
node_translations -.->|"parallel reference material"| node_dp
node_community_editorial -.->|"community content"| node_home
node_home -->|"rendered by"| node_external_renderer
node_roadmap -->|"rendered by"| node_external_renderer
node_foundations -->|"rendered by"| node_external_renderer
node_competition_skills -->|"rendered by"| node_external_renderer

click node_home "https://github.com/vnoi-admin/vnoi_wiki/blob/master/Home.md"
click node_roadmap "https://github.com/vnoi-admin/vnoi_wiki/blob/master/roadmap.md"
click node_about "https://github.com/vnoi-admin/vnoi_wiki/blob/master/about.md"
click node_contributor_guide "https://github.com/vnoi-admin/vnoi_wiki/blob/master/contributor-tutorial.md"
click node_foundations "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/basic/Tai-Lieu-Thuat-Toan.md"
click node_algebra_math "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/algebra/euclid.md"
click node_dp "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/dp/basic-dynamic-programming-1.md"
click node_graphs "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/graph-theory/graph.md"
click node_data_structures "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/data-structures/data-structures-overview.md"
click node_strings "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/string/aho-corasick.md"
click node_supporting_media "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/ahocorasickanimate.mp4"
click node_competition_skills "https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/skill/Ki-nang-thi-cu.md"
click node_cpp_reference "https://github.com/vnoi-admin/vnoi_wiki/blob/master/languages/cpp/pointers.md"
click node_interview "https://github.com/vnoi-admin/vnoi_wiki/blob/master/interview/general-experience.md"
click node_computer_science "https://github.com/vnoi-admin/vnoi_wiki/blob/master/comp-sci/ml/machine-learning-101.md"
click node_translations "https://github.com/vnoi-admin/vnoi_wiki/blob/master/translate/emaxx/Aho-Corasick.md"
click node_community_editorial "https://github.com/vnoi-admin/vnoi_wiki/blob/master/vnoi-magazine/2023/1d1d-dp-optimization.md"
click node_news_bulletin "https://github.com/vnoi-admin/vnoi_wiki/blob/master/news-bulletin/b%E1%BA%A3ng-tin.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_home,node_roadmap,node_about,node_contributor_guide toneBlue
class node_foundations,node_algebra_math,node_dp,node_graphs,node_data_structures,node_strings,node_supporting_media toneAmber
class node_competition_skills,node_cpp_reference,node_interview,node_computer_science toneMint
class node_translations,node_community_editorial,node_news_bulletin toneRose
class node_external_renderer toneNeutral
```

## Components

### Reader Entry

- [Home](https://github.com/vnoi-admin/vnoi_wiki/blob/master/Home.md): Markdown entry · Primary reader-facing landing page. · `Home.md`
- [Roadmap](https://github.com/vnoi-admin/vnoi_wiki/blob/master/roadmap.md): Markdown entry · `roadmap.md`
- [About](https://github.com/vnoi-admin/vnoi_wiki/blob/master/about.md): Markdown entry · `about.md`
- [Contributor Tutorial](https://github.com/vnoi-admin/vnoi_wiki/blob/master/contributor-tutorial.md): contributor guide · `contributor-tutorial.md`

### Algorithm Curriculum

- [Foundations](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/basic/Tai-Lieu-Thuat-Toan.md): algorithm docs · `algo/basic/Tai-Lieu-Thuat-Toan.md`
- [Algebra & Math](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/algebra/euclid.md): algorithm docs · `algo/algebra/euclid.md`
- [Dynamic Programming](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/dp/basic-dynamic-programming-1.md): algorithm docs · `algo/dp/basic-dynamic-programming-1.md`
- [Graph Theory](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/graph-theory/graph.md): algorithm docs · `algo/graph-theory/graph.md`
- [Data Structures](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/data-structures/data-structures-overview.md): algorithm docs · `algo/data-structures/data-structures-overview.md`
- [String Algorithms](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/string/aho-corasick.md): algorithm docs · `algo/string/aho-corasick.md`
- [Supporting Media](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/ahocorasickanimate.mp4): embedded artifacts · Videos, HTML, and PDFs support documentation pages. · `algo/ahocorasickanimate.mp4`

### Supplemental Content

- [Competition Skills](https://github.com/vnoi-admin/vnoi_wiki/blob/master/algo/skill/Ki-nang-thi-cu.md): learning docs · `algo/skill/Ki-nang-thi-cu.md`
- [C++ Reference](https://github.com/vnoi-admin/vnoi_wiki/blob/master/languages/cpp/pointers.md): language docs · `languages/cpp/pointers.md`
- [Interview Content](https://github.com/vnoi-admin/vnoi_wiki/blob/master/interview/general-experience.md): learning docs · `interview/general-experience.md`
- [Computer Science](https://github.com/vnoi-admin/vnoi_wiki/blob/master/comp-sci/ml/machine-learning-101.md): learning docs · `comp-sci/ml/machine-learning-101.md`

### Translations & Editorial

- [Translated Material](https://github.com/vnoi-admin/vnoi_wiki/blob/master/translate/emaxx/Aho-Corasick.md): translated docs · External educational material organized by source. · `translate/emaxx/Aho-Corasick.md`
- [Community Editorial](https://github.com/vnoi-admin/vnoi_wiki/blob/master/vnoi-magazine/2023/1d1d-dp-optimization.md): editorial docs · `vnoi-magazine/2023/1d1d-dp-optimization.md`
- [News Bulletin](https://github.com/vnoi-admin/vnoi_wiki/blob/master/news-bulletin/b%E1%BA%A3ng-tin.md): community updates · `news-bulletin/bảng-tin.md`

### Other components

- **Documentation Renderer**: external host · An external wiki or renderer supplies navigation and presentation.

## Connections

- Contributor Tutorial → Foundations: guides contributions to
- Contributor Tutorial → Translated Material: guides contributions to
- Home → Roadmap: links to
- Home → Foundations: navigates to
- Home → Dynamic Programming: navigates to
- Home → Graph Theory: navigates to
- Home → Data Structures: navigates to
- Roadmap → Foundations: curriculum path
- Roadmap → Algebra & Math: curriculum path
- Roadmap → Dynamic Programming: curriculum path
- Roadmap → Graph Theory: curriculum path
- Roadmap → Data Structures: curriculum path
- Roadmap → String Algorithms: curriculum path
- Data Structures → Supporting Media: uses supporting artifacts
- String Algorithms → Supporting Media: uses supporting artifacts
- Translated Material → String Algorithms: parallel reference material
- Translated Material → Dynamic Programming: parallel reference material
- Community Editorial → Home: community content
- Home → Documentation Renderer: rendered by
- Roadmap → Documentation Renderer: rendered by
- Foundations → Documentation Renderer: rendered by
- Competition Skills → Documentation Renderer: rendered by