# fhbzc/css_program architecture

> Architecture diagram of the GitHub repository fhbzc/css_program, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fhbzc/css_program
- Repository: https://github.com/fhbzc/css_program

## Overview

##### Project type and purpose
- This is an open-source content repository (static markdown-based site) hosted on GitHub.
- It maintains lists of programs, researchers, and industry groups in computational social science.
- It provides a contributor workflow (issue templates, pull requests) for community updates.

##### File structure
- Top-level directories/files:
- .github/ISSUE_TEMPLATE/…md  → GitHub issue templates for guided contributions
- README.md, README_ch.md       → Main landing documentation (English and Chinese)
- programs_en.md                → Master/PhD program listings
- researcher_en.md              → Researcher listings
- industry_en.md                → Industry group listings
- LICENSE                       → Project license
- No frontend/backend code: purely static markdown.
- No build scripts or deployment configs (relying on GitHub’s built-in markdown renderer).

##### README for additional insights
- Describes purpose, structure, and contribution guidelines.
- No external services beyond GitHub are mentioned.
- Contribution process: issues → PRs → merge.

##### Main components
a. GitHub Repository
– Content files: README.md, programs_en.md, researcher_en.md, industry_en.md
– Configuration: .github/ISSUE_TEMPLATE/*.md, LICENSE
b. Contributors
– End users (students/researchers) browse content
– Community contributors open issues & submit pull requests
c. GitHub Platform
– Issue tracker & templates
– Pull request workflow
– Merge process
– (Optional) GitHub Pages if enabled for hosting
d. End-user consumption
– Browsing the markdown on GitHub or via a static site

##### Relationships & interactions
- Contributors → GitHub (create Issues via templates)
- Contributors → Git (fork, clone, commit, push, PR)
- GitHub → Repository (hosts content and issue templates)
- Users → GitHub (view documentation)

##### Architectural patterns & design principles
- Single-source content stored in markdown (DRY, human‐readable)
- GitHub workflow for CI (manual review) and collaboration
- Issue-template–driven governance (standardization for contributions)

##### Relevant technologies
- Git (version control)
- GitHub (hosting, issue tracker, pull requests)
- Markdown (content format)
- Optional: GitHub Pages (static site hosting)

##### Summary of essential elements
- Repository components and file types
- Contributor workflow and GitHub services
- Data flow: creation, review, publishing, consumption

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    User(["User"]):::actor
    Contributor(["Contributor"]):::actor

    %% GitHub Platform and Repository
    subgraph "GitHub Platform" 
        direction TB
        subgraph "GitHub Repository"
            direction TB
            subgraph "Content Files"
                direction TB
                READMEmd["README.md"]:::contentFiles
                READMEch["README_ch.md"]:::contentFiles
                programs["programs_en.md"]:::contentFiles
                researcher["researcher_en.md"]:::contentFiles
                industry["industry_en.md"]:::contentFiles
            end
            license["LICENSE"]:::config
            subgraph "Issue Templates"
                direction TB
                tmpl1["--add-new-industry-group--.md"]:::config
                tmpl2["--add-new-program--.md"]:::config
                tmpl3["--hiring-css-researchers--.md"]:::config
                tmpl4["-add-new-researcher-.md"]:::config
                tmpl5["-hiring-css-students-.md"]:::config
            end
        end
        IssueTracker(["Issue Tracker"]):::process
        PullRequest(["Pull Request Workflow"]):::process
        Merge(["Review & Merge"]):::process
        GitHubPages(["GitHub Pages (Optional)"]):::platform
    end

    %% Flows
    Contributor -->|"creates issue"| IssueTracker
    IssueTracker -->|"uses template"| tmpl1
    IssueTracker -->|"uses template"| tmpl2
    IssueTracker -->|"uses template"| tmpl3
    IssueTracker -->|"uses template"| tmpl4
    IssueTracker -->|"uses template"| tmpl5
    Contributor -->|"opens PR"| PullRequest
    PullRequest -->|"triggers review"| Merge
    Merge -->|"updates content"| READMEmd
    Merge -->|"updates content"| READMEch
    Merge -->|"updates content"| programs
    Merge -->|"updates content"| researcher
    Merge -->|"updates content"| industry
    User -->|"browses on GitHub"| READMEmd
    User -->|"browses on site"| GitHubPages

    %% Click Events
    click READMEmd "https://github.com/fhbzc/css_program/blob/main/README.md"
    click READMEch "https://github.com/fhbzc/css_program/blob/main/README_ch.md"
    click programs "https://github.com/fhbzc/css_program/blob/main/programs_en.md"
    click researcher "https://github.com/fhbzc/css_program/blob/main/researcher_en.md"
    click industry "https://github.com/fhbzc/css_program/blob/main/industry_en.md"
    click license "https://github.com/fhbzc/css_program/tree/main/LICENSE"
    click tmpl1 "https://github.com/fhbzc/css_program/blob/main/.github/ISSUE_TEMPLATE/--add-new-industry-group--.md"
    click tmpl2 "https://github.com/fhbzc/css_program/blob/main/.github/ISSUE_TEMPLATE/--add-new-program--.md"
    click tmpl3 "https://github.com/fhbzc/css_program/blob/main/.github/ISSUE_TEMPLATE/--hiring-css-researchers--.md"
    click tmpl4 "https://github.com/fhbzc/css_program/blob/main/.github/ISSUE_TEMPLATE/-add-new-researcher-.md"
    click tmpl5 "https://github.com/fhbzc/css_program/blob/main/.github/ISSUE_TEMPLATE/-hiring-css-students-.md"

    %% Styles
    classDef contentFiles fill:#cce5ff,stroke:#004085
    classDef process fill:#d4edda,stroke:#155724
    classDef platform fill:#fff3cd,stroke:#856404
    classDef config fill:#f8d7da,stroke:#721c24
    classDef actor fill:#e2e3e5,stroke:#6c757d
```
