# adriasir123/pi-fortinet architecture

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

- Interactive diagram: https://gitdiagram.com/adriasir123/pi-fortinet
- Repository: https://github.com/adriasir123/pi-fortinet

## Overview

##### Project type and purpose
- This is a static documentation website built with MkDocs (a Python-based static site generator).
- Its purpose is to host and present a “Memoria de Proyecto Integrado” on Fortinet cybersecurity—rich markdown content, images, code snippets, and CLI demos—all packaged as a web site.

##### File structure
- Top-level:
- .github/workflows/ci.yml → GitHub Actions CI/CD pipeline
- mkdocs.yml → MkDocs configuration (site name, theme, pages order, plugins)
- docs/ → Source markdown files, organized into subfolders (conceptos, demo, interfaz-web, etc.), plus assets (images, javascripts, stylesheets)
- README.md, LICENSE, .gitignore
- Patterns:
- “docs” is the content root for MkDocs
- Static assets separated into images/, javascripts/, stylesheets/
- CI pipeline builds and deploys to GitHub Pages

##### Key README insights
- It’s a web site (“Accede aquí: https://pi.adrianj.eu/”)
- No custom backend—purely static content
- Deployment target: GitHub Pages

##### Detailed breakdown of components
- Developer Workstation
- Tools: Markdown editor, Git CLI
- GitHub Repository
- Branches: main (source), gh-pages (deploy)
- CI config: .github/workflows/ci.yml
- CI/CD (GitHub Actions)
- Steps: checkout → setup Python → install MkDocs → mkdocs build → deploy to gh-pages
- MkDocs Configuration (mkdocs.yml)
- Site name, nav structure, plugins, theme settings
- Static Assets
- docs/images → images served alongside HTML
- docs/javascripts, docs/stylesheets → custom scripts & CSS
- Hosting Layer
- GitHub Pages serves / (root) over HTTPS
- DNS A/CNAME record pointing to GitHub Pages
- End User
- Browser fetches HTML/CSS/JS
- Content delivered via GitHub’s global CDN

## Diagram (Mermaid)

```mermaid
graph TB
    Developer["Developer Workstation"]:::external
    Developer -->|"push changes"| Repo["GitHub Repository"]:::service

    subgraph "GitHub Repository"
        CI["CI/CD Pipeline (GitHub Actions)"]:::service
        Config["MkDocs Configuration"]:::code
        Content["Source Content (docs/)"]:::code
        images["Static Assets – Images"]:::code
        js["Static Assets – JavaScript"]:::code
        css["Static Assets – Stylesheets"]:::code
        CNAME["Custom Domain Config (CNAME)"]:::code
        readme["README.md"]:::code
        license["LICENSE"]:::code
        gitignore[".gitignore"]:::code
    end

    Repo --> CI
    Repo --> Config
    Repo --> Content
    Repo --> images
    Repo --> js
    Repo --> css
    Repo --> CNAME
    Repo --> readme
    Repo --> license
    Repo --> gitignore

    subgraph "Content Files"
        home["docs/index.md"]:::code
        acceso["docs/acceso.md"]:::code
        objetivos["docs/objetivos.md"]:::code
        conceptos["docs/conceptos/"]:::code
        cli["docs/cli.md"]:::code
        demo["docs/demo/"]:::code
        webif["docs/interfaz-web/"]:::code
    end

    Content --> home
    Content --> acceso
    Content --> objetivos
    Content --> conceptos
    Content --> cli
    Content --> demo
    Content --> webif

    CI -->|"runs build"| MkDocs["MkDocs Builder"]:::service
    MkDocs -->|"generate site"| Artifacts["Build Artifacts (gh-pages branch)"]:::storage
    Artifacts -->|"deploy"| Pages["GitHub Pages"]:::service
    Pages -->|"served via HTTPS"| DNS["DNS/CDN (pi.adrianj.eu)"]:::external
    DNS -->|"fetch content"| User["End User Browser"]:::external

    click CI "https://github.com/adriasir123/pi-fortinet/blob/main/.github/workflows/ci.yml"
    click Config "https://github.com/adriasir123/pi-fortinet/blob/main/mkdocs.yml"
    click Content "https://github.com/adriasir123/pi-fortinet/tree/main/docs/"
    click images "https://github.com/adriasir123/pi-fortinet/tree/main/docs/images/"
    click js "https://github.com/adriasir123/pi-fortinet/tree/main/docs/javascripts/"
    click css "https://github.com/adriasir123/pi-fortinet/tree/main/docs/stylesheets/"
    click CNAME "https://github.com/adriasir123/pi-fortinet/tree/main/docs/CNAME"
    click home "https://github.com/adriasir123/pi-fortinet/blob/main/docs/index.md"
    click acceso "https://github.com/adriasir123/pi-fortinet/blob/main/docs/acceso.md"
    click objetivos "https://github.com/adriasir123/pi-fortinet/blob/main/docs/objetivos.md"
    click conceptos "https://github.com/adriasir123/pi-fortinet/tree/main/docs/conceptos/"
    click cli "https://github.com/adriasir123/pi-fortinet/blob/main/docs/cli.md"
    click demo "https://github.com/adriasir123/pi-fortinet/tree/main/docs/demo/"
    click webif "https://github.com/adriasir123/pi-fortinet/tree/main/docs/interfaz-web/"
    click readme "https://github.com/adriasir123/pi-fortinet/blob/main/README.md"
    click license "https://github.com/adriasir123/pi-fortinet/tree/main/LICENSE"
    click gitignore "https://github.com/adriasir123/pi-fortinet/blob/main/.gitignore"

    classDef service fill:#FFD700,stroke:#333,stroke-width:1px
    classDef code fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef storage fill:#90EE90,stroke:#333,stroke-width:1px
    classDef external fill:#FFA07A,stroke:#333,stroke-width:1px
```
