# wreckage0907/sdot architecture

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

- Interactive diagram: https://gitdiagram.com/wreckage0907/sdot
- Repository: https://github.com/wreckage0907/sdot

## Overview

##### Project type and purpose
- This repository (“SDOT”) is not a traditional full-stack application but rather a static documentation/site generator combined with a curated collection of Python solutions for algorithmic problems (likely LeetCode).
- It uses a codes directory for Python scripts, a Jekyll configuration (`_config.yml`), and a GitHub Actions workflow (`.github/workflows/generate_readme.yml`) to auto-generate or update documentation (README).

##### File structure
- Top level:
- `.github/workflows/generate_readme.yml`: CI pipeline to regenerate the README from `codes/` (or similar).
- `_config.yml` + `index.md`: Jekyll configuration and content for a GitHub Pages–hosted site.
- `codes/`: folder containing ~60 standalone Python scripts, each solving a separate problem.
- `README.md`: the root readme (likely auto-populated by the workflow).
- Patterns:
- “codes” directory is the core content.
- GitHub Actions → read code files → regenerate central documentation.
- Jekyll → static site generator → `index.md` plus any templates (not shown) → HTML pages.

##### README
- The README only shows “# SDOT,” implying it’s primarily auto-updated by the workflow.
- No explicit architectural description, so we infer from file names and workflow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Machine
    Dev["Developer Workstation"]:::dev

    %% GitHub Repository & content
    subgraph "GitHub Repository" 
        direction TB
        codes["codes/"]:::repo
        config["_config.yml"]:::repo
        index["index.md"]:::repo
        readme["README.md"]:::repo
    end

    %% CI/CD Pipeline
    subgraph "CI/CD (GitHub Actions)" 
        direction TB
        CI["GitHub Actions CI"]:::ci
        step1["Parse codes/ directory"]:::ci
        step2["Generate README.md"]:::ci
        commit["Commit updated README.md"]:::ci
    end

    %% Build and Hosting
    Jekyll["Jekyll Build"]:::build
    Pages["GitHub Pages Host"]:::host
    User["End-User Browser"]:::user

    %% Connections
    Dev -->|push commits| codes
    Dev -->|push commits| config
    Dev -->|push commits| index
    Dev -->|push commits| readme

    codes -->|push event triggers| CI
    config --> CI
    index --> CI
    readme --> CI

    CI --> step1
    step1 --> step2
    step2 --> commit
    commit --> codes

    codes -->|site build source| Jekyll
    config --> Jekyll
    index --> Jekyll
    readme --> Jekyll

    Jekyll --> Pages
    Pages --> User

    %% Click Events
    click codes "https://github.com/wreckage0907/sdot/tree/main/codes/"
    click CI "https://github.com/wreckage0907/sdot/blob/main/.github/workflows/generate_readme.yml"
    click step2 "https://github.com/wreckage0907/sdot/blob/main/.github/workflows/generate_readme.yml"
    click config "https://github.com/wreckage0907/sdot/blob/main/_config.yml"
    click index "https://github.com/wreckage0907/sdot/blob/main/index.md"
    click readme "https://github.com/wreckage0907/sdot/blob/main/README.md"

    %% Styles
    classDef dev fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef repo fill:#e6e6e6,stroke:#333,stroke-width:1px
    classDef ci fill:#bbdefb,stroke:#1e88e5,stroke-width:1px
    classDef build fill:#c8e6c9,stroke:#43a047,stroke-width:1px
    classDef host fill:#ffe0b2,stroke:#fb8c00,stroke-width:1px
    classDef user fill:#ffccbc,stroke:#d84315,stroke-width:1px
```
