# integerous/goquality-dev-contents architecture

> Architecture diagram of the GitHub repository integerous/goquality-dev-contents, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/integerous/goquality-dev-contents
- Repository: https://github.com/integerous/goquality-dev-contents

## Overview

##### Project Type and Purpose
- This repository is not a web-app or library, but a **curated collection of developer content** (≈1,500 links down-selected to ≈450) organized into 16 topic folders. In effect, it’s the **content source** for goquality.dev, a static “high-quality dev content” site.

##### File Structure Analysis
- Top-level:
- LICENSE
- README.md (project overview & huge list of curated links)
- 고퀄리티 컨텐츠 모음/ (the “content” folder)
- Inside “고퀄리티 컨텐츠 모음/”: 16 numbered subfolders (“1. 개발 일반”, “2. 개발자 커리어”, … “16. 기타”), each with its own README.md to list links for that category.
- No “src”, “frontend” or “backend” code – all files are Markdown; presumably a static‐site generator (Hugo/Jekyll/etc.) converts these to HTML.

##### Architecture Components
a. Content Repository
- Markdown files in GitHub (your source of truth).
b. Static Site Generator (SSG)
- Hugo/Jekyll/Next.js Export: reads folder structure + frontmatter, renders pages.
c. CI/CD Pipeline
- GitHub Actions (or Netlify build hook) detects pushes to main, runs SSG, outputs `/public` or `dist`.
d. Hosting & CDN
- The generated static assets are deployed to a static host (GitHub Pages, Netlify, Vercel) and served via a CDN.
e. User’s Browser
- Requests goquality.dev, assets returned from CDN, page rendered with responsive HTML/CSS/JS.

##### Component Interactions
- Developer → (push) → GitHub repo
- GitHub Actions → (build) → Static HTML/CSS/JS
- Actions → (deploy) → Hosting platform (Netlify/Vercel/GH-Pages)
- CDN edges cache content
- End-user browser → CDN edge → content

##### Architectural Patterns & Principles
- **Content-As-Code**: Markdown + Git versioning
- **Static-First**: no dynamic backend; scale via CDN
- **CI/CD**: automated build & deploy on commits
- **Folder-Driven Routing**: folder names → URL structure (/1.-%EA%B0%9C%EB%B0%9C-%EC%9D%BC%EB%B0%98 → /category/dev-general)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    Developer["Developer"] 
    classDef developer fill:#d3d3d3,stroke:#333,stroke-width:1px

    %% Repository
    GitHubRepo[(GitHub Repo)]:::repo
    classDef repo fill:#87CEFA,stroke:#333,stroke-width:1px

    subgraph "Content Repository (Markdown Source)"
        README["README.md"]
        LICENSE["LICENSE"]
        ContentFolder["고퀄리티 컨텐츠 모음/"]
        class README,LICENSE,ContentFolder repo
        subgraph "16 Category Folders"
            C1["1. 개발 일반"]
            C2["2. 개발자 커리어"]
            C3["3. 언어 & 프레임워크"]
            C4["4. 프론트엔드"]
            C5["5. 백엔드"]
            C6["6. DB"]
            C7["7. 모바일"]
            C8["8. 인프라 & DevOps"]
            C9["9. AI"]
            C10["10. 데이터"]
            C11["11. 게임 개발"]
            C12["12. 컴퓨터 공학"]
            C13["13. 블록체인"]
            C14["14. 보안"]
            C15["15. 도구"]
            C16["16. 기타"]
            class C1,C2,C3,C4,C5,C6,C7,C8,C9,C10,C11,C12,C13,C14,C15,C16 repo
        end
        ContentFolder --> C1
        C1 --> C2
        C2 --> C3
        C3 --> C4
        C4 --> C5
        C5 --> C6
        C6 --> C7
        C7 --> C8
        C8 --> C9
        C9 --> C10
        C10 --> C11
        C11 --> C12
        C12 --> C13
        C13 --> C14
        C14 --> C15
        C15 --> C16
    end

    %% CI/CD and SSG
    CI["CI/CD Pipeline"]:::cicd
    classDef cicd fill:#98FB98,stroke:#333,stroke-width:1px
    SSG["Static Site Generator"]:::ssg
    classDef ssg fill:#FFA500,stroke:#333,stroke-width:1px

    %% Hosting & CDN
    Hosting["Hosting Platform"]:::hosting
    CDN["CDN Edge Nodes"]:::hosting
    classDef hosting fill:#9370DB,stroke:#333,stroke-width:1px

    %% Browser
    Browser["User Browser"]:::browser
    classDef browser fill:#FFD700,stroke:#333,stroke-width:1px

    %% Flows
    Developer -->|push| GitHubRepo
    GitHubRepo -->|trigger build| CI
    CI -->|build & export| SSG
    SSG -->|deploy| Hosting
    Hosting -->|cache & serve| CDN
    Browser -->|HTTP GET| CDN
    CDN -->|HTTP response| Browser

    %% Click Events
    click ContentFolder "https://github.com/integerous/goquality-dev-contents/tree/master/고퀄리티 컨텐츠 모음/"
    click README "https://github.com/integerous/goquality-dev-contents/blob/master/README.md"
    click LICENSE "https://github.com/integerous/goquality-dev-contents/tree/master/LICENSE"
    click C1 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/1. 개발 일반/README.md"
    click C2 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/2. 개발자 커리어/README.md"
    click C3 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/3. 언어 & 프레임워크/README.md"
    click C4 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/4. 프론트엔드/README.md"
    click C5 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/5. 백엔드/README.md"
    click C6 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/6. DB/README.md"
    click C7 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/7. 모바일/README.md"
    click C8 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/8. 인프라 & DevOps/README.md"
    click C9 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/9. AI/README.md"
    click C10 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/10. 데이터/README.md"
    click C11 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/11. 게임 개발/README.md"
    click C12 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/12. 컴퓨터 공학/README.md"
    click C13 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/13. 블록체인/README.md"
    click C14 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/14. 보안/README.md"
    click C15 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/15. 도구/README.md"
    click C16 "https://github.com/integerous/goquality-dev-contents/blob/master/고퀄리티 컨텐츠 모음/16. 기타/README.md"

    class Developer developer
```
