# nighthawkcoders/portfolio_2025 architecture

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

- Interactive diagram: https://gitdiagram.com/nighthawkcoders/portfolio_2025
- Repository: https://github.com/nighthawkcoders/portfolio_2025

## Overview

##### Main Components and Architecture

- Client Layer                                           |

- Browser/Jekyll |  | Jupyter Notebooks|  | Markdown Posts |  | Interactive Tools |     |

- ↕

- GitHub Pages Infrastructure                                 |

- Jekyll Engine  |  | GitHub Actions   |  | SASS Styling   |  | Search System     |     |

- ↕

- Content Organization                                       |

- Course Content |  | Student Toolkit  |  | Teacher Tools |  | Gaming Platform   |     |

##### Key Components to Highlight

a. Educational Content Structure:
- CSA (Computer Science A)
- CSP (Computer Science Principles)
- CSSE (Computer Science Software Engineering)
- Foundation courses

b. Interactive Features:
- Student Toolkit
- Teacher Toolkit
- Gaming Platform
- Authentication System

##### Data Flow and Integration

How different components interact:
**[User Input] → [Jekyll Processing] → [GitHub Actions] → [Deployed Content]**
- ↕                      ↕                    ↕
- [Local Development] ← → [Version Control] ← → [Production Site]

##### Development Environment

Development workflow:
**[Local Environment]**
- ↓
**[Make Commands] → [Bundle Install] → [Jekyll Server]**
- ↓
**[GitHub Push] → [Actions Workflow] → [Deployment]**

##### Content Management System

Organization of content:
**[Root]**
- _notebooks (Interactive lessons)
- _posts (Static content)
- assets (Resources)
- _includes (Reusable components)
- _layouts (Page templates)

**[Base Theme (Minima)]**
- ↓
**[Custom SASS Styles]**
- ↓
**[Theme Variations]**

##### Special Features

Specialized components:
- Search functionality
- Comments system (Utterances)
- Metadata handling
- Tag system
- Navigation structure

- Blue: Core infrastructure
- Green: Educational content
- Orange: Interactive features
- Purple: Development tools
- Yellow: User interface elements

**→ : Data flow**
**↕ : Two-way interaction**
**□ : Core component**
**○ : Optional feature**

Remember to include notes about:
- Scalability considerations
- Security implementations
- Content organization principles
- Development workflow
- User interaction patterns

This will provide a complete picture of the system's architecture while highlighting its educational focus and interactive capabilities.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Browser/Jekyll Interface"]
        Jupyter["Jupyter Notebooks"]
        Markdown["Markdown Posts"]
        Interactive["Interactive Tools"]
    end

    subgraph Infrastructure
        Jekyll["Jekyll Engine"]
        Actions["GitHub Actions Pipeline"]
        SASS["SASS Styling"]
        Search["Search System"]
    end

    subgraph Content
        CourseContent["Course Organization"]
        StudentTools["Student Toolkit"]
        TeacherTools["Teacher Tools"]
        Gaming["Gaming Platform"]
    end

    subgraph CourseStructure
        CSA["CSA Course"]
        CSP["CSP Course"]
        CSSE["CSSE Course"]
    end

    %% Client Layer Connections
    Browser --> Jekyll
    Jupyter --> Jekyll
    Markdown --> Jekyll
    Interactive --> Jekyll

    %% Infrastructure Layer Connections
    Jekyll --> CourseContent
    Actions --> Jekyll
    SASS --> Browser
    Search --> Browser

    %% Content Layer Connections
    CourseContent --> CSA
    CourseContent --> CSP
    CourseContent --> CSSE
    CourseContent --> StudentTools
    CourseContent --> TeacherTools
    CourseContent --> Gaming

    %% Component Mappings with Click Events
    click Browser "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_layouts/"
    click Jupyter "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_notebooks/"
    click CSA "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_notebooks/CSA/"
    click CSP "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_notebooks/CSP/"
    click CSSE "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_notebooks/CSSE/"
    click StudentTools "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_notebooks/student_toolkit/"
    click TeacherTools "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_posts/teacher_toolkit/"
    click Gaming "https://github.com/nighthawkcoders/portfolio_2025/tree/main//assets/js/platformer3x/"
    click SASS "https://github.com/nighthawkcoders/portfolio_2025/tree/main//_sass/"
    click Search "https://github.com/nighthawkcoders/portfolio_2025/blob/main//assets/js/search.js"
    click Actions "https://github.com/nighthawkcoders/portfolio_2025/blob/main//.github/workflows/jekyll-gh-pages.yml"
    click Interactive "https://github.com/nighthawkcoders/portfolio_2025/tree/main//assets/js/"

    %% Styling
    classDef client fill:#a8d1ff
    classDef infrastructure fill:#ffb366
    classDef content fill:#90EE90
    classDef course fill:#DDA0DD

    class Browser,Jupyter,Markdown,Interactive client
    class Jekyll,Actions,SASS,Search infrastructure
    class CourseContent,StudentTools,TeacherTools,Gaming content
    class CSA,CSP,CSSE course

    %% Legend
    subgraph Legend
        Client_L["Client Layer"]:::client
        Infrastructure_L["Infrastructure Layer"]:::infrastructure
        Content_L["Content Layer"]:::content
        Course_L["Course Structure"]:::course
    end
```
