# microsoft/security-101 architecture

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

- Interactive diagram: https://gitdiagram.com/microsoft/security-101
- Repository: https://github.com/microsoft/security-101

## Overview

##### Main Components
- Source Code Repository: Represent the GitHub repository as the central hub where all content, configurations, and workflows reside.
- Static Website (Frontend): Include the index.html and images directories as the presentation layer that renders the course content to learners.
- Build & Deployment Infrastructure: Highlight the .github/workflows directory containing ‘deploy.yaml’ and ‘jekyll-gh-pages.yml’ files, which indicate automated deployment using GitHub Actions and possibly Jekyll for transforming Markdown to HTML.
- Project Management & Support: Include components for documentation and best practices such as README.md, CODE_OF_CONDUCT.md, SECURITY.md, and SUPPORT.md.
- External Integrations: If applicable, denote dependencies on GitHub Pages (or another hosting service) driven by the workflows, and potentially integration with Microsoft Learn as referenced in the README.

##### Relationships and Interactions
- Deployment: Show how changes pushed to the repository trigger workflows that automatically deploy the updated static site to GitHub Pages or another hosting service.
- Version Control & Collaboration: Illustrate how GitHub’s issue templates, pull requests, and community contributions (indicated by provided issue/feature templates) connect to the management of course content and updates.

##### Architectural Patterns & Design Principles
- Content-Driven Static Architecture: Emphasize that the project is designed for delivering content. The separation between content (Markdown/quiz files) and presentation (HTML/CSS assets) is crucial.
- CI/CD Automation: Highlight the continuous integration and deployment process via GitHub Actions workflows. This encapsulates modern DevOps practices.
- Modular Organization: Note the design principle of modularity. Each module is self-contained and could potentially be updated independently, reflecting a loosely coupled design.

##### Technologies, Frameworks, and Libraries
- GitHub & Git: For version control and collaboration.
- Markdown: For content creation.
- Jekyll (implied by jekyll-gh-pages.yml): For static site generation.
- GitHub Actions: For CI/CD (automated build and deployment).
- HTML/CSS (and possibly JavaScript) for the frontend presentation.

##### Additional Elements
- Location of quizzes (e.g., End of module quiz files) as integral parts of the learning feedback mechanism.
- If space allows, illustrate external links (e.g., video introduction, further Microsoft learning resources) to indicate how the curriculum extends beyond the repository.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Repo["GitHub Repository"]:::repository

    subgraph "Course Content"
        M1["Module 1: Basic Security Concepts"]:::content
        M2["Module 2: Identity & Access Management"]:::content
        M3["Module 3: Network Security"]:::content
        M4["Module 4: SecOps"]:::content
        M5["Module 5: AppSec"]:::content
        M6["Module 6: Infrastructure"]:::content
        M7["Module 7: Data Security"]:::content
        M8["Module 8: AI Security"]:::content
    end

    subgraph "Static Website (Frontend)"
        INDEX["index.html"]:::static
        IMAGES["images"]:::static
    end

    subgraph "Build & Deployment Infrastructure"
        DEPLOY["deploy.yaml"]:::build
        JEKYLL["jekyll-gh-pages.yml"]:::build
    end

    subgraph "Project Management & Support"
        README["README.md"]:::support
        CODE["CODE_OF_CONDUCT.md"]:::support
        SECURITY["SECURITY.md"]:::support
        SUPPORT["SUPPORT.md"]:::support
    end

    subgraph "External Integrations & Issue Management"
        ISSUE["ISSUE_TEMPLATE"]:::integration
        BUG["bug_report.md"]:::integration
        FEATURE["feature_request.md"]:::integration
    end

    EXTERNAL["GitHub Pages"]:::external
    USER["Learner"]:::external

    %% Repository contains all major components
    Repo -->|"contains"| M1
    Repo -->|"contains"| M2
    Repo -->|"contains"| M3
    Repo -->|"contains"| M4
    Repo -->|"contains"| M5
    Repo -->|"contains"| M6
    Repo -->|"contains"| M7
    Repo -->|"contains"| M8
    Repo -->|"contains"| INDEX
    Repo -->|"contains"| IMAGES
    Repo -->|"contains"| DEPLOY
    Repo -->|"contains"| JEKYLL
    Repo -->|"contains"| README
    Repo -->|"contains"| CODE
    Repo -->|"contains"| SECURITY
    Repo -->|"contains"| SUPPORT
    Repo -->|"contains"| ISSUE
    ISSUE -->|"includes"| BUG
    ISSUE -->|"includes"| FEATURE

    %% Content processing and deployment flow
    M1 & M2 & M3 & M4 & M5 & M6 & M7 & M8 -->|"markdown_processed"| DEPLOY
    DEPLOY & JEKYLL -->|"generates_HTML"| INDEX
    DEPLOY & JEKYLL -->|"generates_assets"| IMAGES
    INDEX & IMAGES -->|"deployed_to"| EXTERNAL
    USER -->|"accesses"| EXTERNAL

    %% Click Events
    click Repo "https://github.com/microsoft/security-101/blob/main/."
    click M1 "https://github.com/microsoft/security-101/blob/main/1.1 The CIA triad and other key concepts.md"
    click INDEX "https://github.com/microsoft/security-101/blob/main/index.html"
    click IMAGES "https://github.com/microsoft/security-101/tree/main/images"
    click DEPLOY "https://github.com/microsoft/security-101/blob/main/.github/workflows/deploy.yaml"
    click JEKYLL "https://github.com/microsoft/security-101/blob/main/.github/workflows/jekyll-gh-pages.yml"
    click README "https://github.com/microsoft/security-101/blob/main/README.md"
    click CODE "https://github.com/microsoft/security-101/blob/main/CODE_OF_CONDUCT.md"
    click SECURITY "https://github.com/microsoft/security-101/blob/main/SECURITY.md"
    click SUPPORT "https://github.com/microsoft/security-101/blob/main/SUPPORT.md"
    click ISSUE "https://github.com/microsoft/security-101/tree/main/.github/ISSUE_TEMPLATE"
    click BUG "https://github.com/microsoft/security-101/blob/main/.github/ISSUE_TEMPLATE/bug_report.md"
    click FEATURE "https://github.com/microsoft/security-101/blob/main/.github/ISSUE_TEMPLATE/feature_request.md"

    %% Styles
    classDef repository fill:#BBDEFB,stroke:#0D47A1,stroke-width:2px;
    classDef content fill:#B3E5FC,stroke:#0288D1,stroke-width:2px;
    classDef static fill:#F8BBD0,stroke:#880E4F,stroke-width:2px;
    classDef build fill:#FFF9C4,stroke:#F57F17,stroke-width:2px;
    classDef support fill:#C8E6C9,stroke:#388E3C,stroke-width:2px;
    classDef integration fill:#E1BEE7,stroke:#8E24AA,stroke-width:2px;
    classDef external fill:#FFECB3,stroke:#F57C00,stroke-width:2px;
```
