# tlbootcamp/tlroadmap architecture

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

- Interactive diagram: https://gitdiagram.com/tlbootcamp/tlroadmap
- Repository: https://github.com/tlbootcamp/tlroadmap

## Overview

##### Project type and purpose
- This is an open-source, static documentation website (“Teamlead Roadmap”) built with VuePress (Vue.js–based static site generator).
- Purpose: present a knowledge base of team-lead skills and competencies, enable contributions (issues, pull requests), host multilingual content, and deploy as a static site.

##### File structure
- Top-level:
- package.json – Node/NPM dependencies and scripts
- README.md, CONTRIBUTING.md, LICENSE.md – project metadata and contribution guides
- crowdin.yml – translation sync configuration
- tools/ – helper scripts (check_directory_tree.sh), PlantUML jar, Python requirements
- skills/ – supplementary skill requirements in Markdown
- tlroadmap/ – core site content and site config (.vuepress folder)
- translations/ – translation infrastructure
- tlroadmap/.vuepress: VuePress configuration (config.js), custom theme, Vue components, static assets
- .github/workflows: CI/CD pipelines for link checking, site build & deploy

##### README for additional insights
- Describes site purpose, contribution workflow, license (Creative Commons SA 4.0).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    Contributors["Contributors"]:::actor
    EndUsers["End Users (Browsers/Mobile)"]:::actor

    %% Repository
    subgraph "GitHub Repository" 
        GitHubRepo["Root Directory"]:::code
        GitHubDotGitHub[".github/"]:::code
    end

    %% Content Sources
    subgraph "Content Sources" 
        TlRoadmap["tlroadmap/ (Markdown)"]:::content
        Skills["skills/"]:::content
        Translations["translations/"]:::content
    end

    %% Static Site Generator
    subgraph "VuePress (SSG)" 
        Config["config.js"]:::build
        ThemeDir["theme/"]:::build
        Components["Roadmap.vue & Banner.vue"]:::build
        PublicAssets["public/"]:::build
        Styles["palette.styl"]:::build
    end

    %% CI/CD
    subgraph "CI/CD (GitHub Actions)" 
        WorkflowBuild["tlroadmap_site.yaml"]:::code
        WorkflowLinks["tlroadmap_checkbrokenlinks_weekly.yaml"]:::code
        WorkflowAll["tlroadmap_workflow.yaml"]:::code
    end

    %% Translation Management
    Crowdin["Crowdin"]:::external

    %% Tooling
    subgraph "Tooling & Scripts"
        CheckTree["check_directory_tree.sh"]:::external
        PlantUML["plantuml.jar"]:::external
        Requirements["requirements.txt"]:::external
    end

    %% Package Config
    PackageJSON["package.json"]:::code

    %% Deployment & Hosting
    Hosting["Hosting/CDN"]:::hosting

    %% Flows
    Contributors --> GitHubRepo
    GitHubRepo --> WorkflowAll
    GitHubRepo --> WorkflowBuild
    GitHubRepo --> WorkflowLinks
    WorkflowBuild -->|"build with VuePress"| Config
    Config --> ThemeDir
    ThemeDir --> Components
    Components --> PublicAssets
    PublicAssets --> Hosting
    WorkflowBuild --> Hosting
    Hosting --> EndUsers
    GitHubRepo --> TlRoadmap
    GitHubRepo --> Skills
    GitHubRepo --> Translations
    Crowdin -.->|"sync translations"| Translations
    Translations -.->|"pull updates"| Crowdin
    GitHubRepo --> Crowdin
    GitHubRepo --> PackageJSON
    GitHubRepo --> CheckTree
    GitHubRepo --> PlantUML
    GitHubRepo --> Requirements

    %% Click events
    click GitHubRepo "https://github.com/tlbootcamp/tlroadmap/blob/master/."
    click GitHubDotGitHub "https://github.com/tlbootcamp/tlroadmap/tree/master/.github/"
    click TlRoadmap "https://github.com/tlbootcamp/tlroadmap/tree/master/tlroadmap/"
    click Skills "https://github.com/tlbootcamp/tlroadmap/tree/master/skills/"
    click Translations "https://github.com/tlbootcamp/tlroadmap/tree/master/translations/"
    click Config "https://github.com/tlbootcamp/tlroadmap/blob/master/tlroadmap/.vuepress/config.js"
    click ThemeDir "https://github.com/tlbootcamp/tlroadmap/tree/master/tlroadmap/.vuepress/theme/"
    click Components "https://github.com/tlbootcamp/tlroadmap/blob/master/tlroadmap/.vuepress/components/Roadmap.vue"
    click PublicAssets "https://github.com/tlbootcamp/tlroadmap/tree/master/tlroadmap/.vuepress/public/"
    click Styles "https://github.com/tlbootcamp/tlroadmap/blob/master/tlroadmap/.vuepress/styles/palette.styl"
    click WorkflowBuild "https://github.com/tlbootcamp/tlroadmap/blob/master/.github/workflows/tlroadmap_site.yaml"
    click WorkflowLinks "https://github.com/tlbootcamp/tlroadmap/blob/master/.github/workflows/tlroadmap_checkbrokenlinks_weekly.yaml"
    click WorkflowAll "https://github.com/tlbootcamp/tlroadmap/blob/master/.github/workflows/tlroadmap_workflow.yaml"
    click Crowdin "https://github.com/tlbootcamp/tlroadmap/blob/master/crowdin.yml"
    click CheckTree "https://github.com/tlbootcamp/tlroadmap/blob/master/tools/check_directory_tree.sh"
    click PlantUML "https://github.com/tlbootcamp/tlroadmap/blob/master/tools/plantuml.jar"
    click Requirements "https://github.com/tlbootcamp/tlroadmap/blob/master/tools/requirements.txt"
    click PackageJSON "https://github.com/tlbootcamp/tlroadmap/blob/master/package.json"

    %% Styles
    classDef code fill:#D6E9FF,stroke:#2B7CE9,color:#0B1C7A
    classDef content fill:#E8F5E9,stroke:#2E7D32,color:#1B5E20
    classDef build fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef external fill:#F3E5F5,stroke:#9C27B0,color:#4A148C
    classDef hosting fill:#F5F5F5,stroke:#9E9E9E,color:#424242
    classDef actor fill:#FFF8E1,stroke:#FFB300,color:#8A4F00
```
