# happyhackinghigh/myfirstsecurity architecture

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

- Interactive diagram: https://gitdiagram.com/happyhackinghigh/myfirstsecurity
- Repository: https://github.com/happyhackinghigh/myfirstsecurity

## Overview

##### Project type and purpose
- This repo is not a conventional code-base but a structured collection of cybersecurity training materials, slide decks, labs and VM images.
- Its purpose is to host and organize course modules (e.g. “From Linux To CTF”, “MyFirstAI”, “MyFirstWebSecurity”), provide links to virtual machine images, CTF platforms, surveys and reference docs for students.

##### File structure
- Top-level directories correspond to course modules (“Cource”, “From Linux To CTF”, “MyFirstAI”, etc.).
- Each module folder contains markdown lessons, PDFs, PPTX slide decks, code samples or VM download links.
- A handful of “global” files (README.md, various .pptx installers) describe environment setup.
- No compiled code, no server-side scripts—this is purely content.

##### README for additional insights
- The README lists:
- Links to the live CTF/training platform (URLs and IPs)
- Downloadable VM images (Ubuntu, Kali) with credentials
- Links to surveys and announcements
- It implies external services (web CTF portal, OVA download server) as part of the learning workflow.

a. Main components:
- Learner’s workstation (with VirtualBox/VMs)
- Content repository (this GitHub repo)
- Download server (HTTP host for OVA images)
- CTF platform (web service at 140.110.112.27)
- Survey endpoints (tinyurl links)
- Optional external news sources (ithome.com.tw)
b. Relationships & interactions:
- Learner clones/pulls the repo → reads lessons & slide decks
- Learner downloads OVA from the download server → imports into VM host
- Learner connects VM → accesses CTF platform over the internet
- Learner submits survey responses → survey service
- Instructor updates repo → GitHub hosting → triggers student pull
c. Architectural patterns/design principles:
- Content Distribution: Git (version control) + HTTP file server + static file hosting
- Client-server interactions: learner VM ↔ CTF web service
- Separation of concerns:
– Static content vs. dynamic service (CTF portal) vs. VM imaging
d. Key technologies/frameworks:
- Git/GitHub for content versioning
- HTTP(S) for OVA distribution
- VirtualBox or VMware for training VMs
- Static Markdown and PPTX for lesson delivery
- Web survey services (TinyURL links)

##### Essential architectural elements
- External dependencies: VM host, CTF portal, survey endpoints.
- Student’s workflow from cloning materials to completing exercises.
- Do not over-complicate: break the system into content storage, distribution, runtime environment, and assessment/feedback components.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Content Repository"
        GitHubRepo["GitHub Repo"]:::repo
        Cource["Cource Module"]:::repo
        FL2CTF["From Linux To CTF Module"]:::repo
        MF_AI["MyFirstAI Module"]:::repo
        MF_Crypto["MyFirstCrypto Module"]:::repo
        MF_Forensic["MyFirstForensics Module"]:::repo
        MF_Net["MyFirstNetworking Module"]:::repo
        MF_Pen["MyFirstPenTesting Module"]:::repo
        MF_Pwning["MyFirstPwning Module"]:::repo
        MF_Web["MyFirstWebSecurity Module"]:::repo
        MF_Re["MyFristRe Module"]:::repo
        VMGuide["VM Image Download Guide"]:::repo
        PyGuide["Python Env Setup Guide"]:::repo
    end

    Instructor["Instructor"]:::client
    LearnerVM["Learner VM Host"]:::client

    subgraph "Distribution"
        DownloadServer["VM Download Server"]:::servers
    end

    subgraph "Live Services"
        CTFPlatform["CTF Platform"]:::servers
        SurveyService["Survey Service"]:::external
        NewsService["News Feed"]:::external
    end

    Instructor -->|updates| GitHubRepo
    GitHubRepo -->|"git clone"| LearnerVM
    DownloadServer -->|"http GET OVA"| LearnerVM
    LearnerVM -->|"http(s) requests"| CTFPlatform
    LearnerVM -->|"survey POST"| SurveyService
    LearnerVM -->|"news fetch"| NewsService

    click GitHubRepo "https://github.com/happyhackinghigh/myfirstsecurity/blob/master//README.md"
    click Cource "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//Cource/"
    click FL2CTF "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//From Linux To CTF/"
    click MF_AI "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstAI/"
    click MF_Crypto "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstCrypto/"
    click MF_Forensic "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstForensics/"
    click MF_Net "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstNetworking/"
    click MF_Pen "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstPenTesting/"
    click MF_Pwning "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstPwning/"
    click MF_Web "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFirstWebSecurity/"
    click MF_Re "https://github.com/happyhackinghigh/myfirstsecurity/tree/master//MyFristRe/"
    click VMGuide "https://github.com/happyhackinghigh/myfirstsecurity/blob/master//Ubuntu 16.04_Vulnerability-images使用手冊.pptx"
    click PyGuide "https://github.com/happyhackinghigh/myfirstsecurity/blob/master//Python環境建置.pptx"
    click SurveyService "https://github.com/happyhackinghigh/myfirstsecurity/blob/master//README.md"

    classDef repo fill:#D6EAF8,stroke:#2980B9,stroke-width:1px
    classDef servers fill:#D5F5E3,stroke:#27AE60,stroke-width:1px
    classDef client fill:#F9E79F,stroke:#B9770E,stroke-width:1px
    classDef external fill:#FDEDEC,stroke:#C0392B,stroke-width:1px,stroke-dasharray: 5 5
```
