# alpharceus/portfilio_new architecture

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

- Interactive diagram: https://gitdiagram.com/alpharceus/portfilio_new
- Repository: https://github.com/alpharceus/portfilio_new

## Overview

##### Project type and purpose
- This is a single‐page/static front-end portfolio website. There is no backend or server-side code in the repository—just HTML, CSS, JavaScript, and static assets (JSON data, a PDF resume, images, etc.). Its purpose is to present blogs, projects, papers, and other personal information in a dynamic, interactive way.

##### File structure
- Top-level:
- readme.md – minimal placeholder
- src/ – root of the static site
- Within src/:
- index.html, projects.html, papers.html – entry points/pages
- css/ – stylesheet files (styles.css, portfolio-pages.css)
- js/ – client-side scripts (main.js, projects.js, papers.js, star-map.js, terminal.js)
- assets/ – data/asset files (blogs.json, projects.json, papers.json, schedule.json, resume.pdf)
- No build or deployment scripts in the repo (likely hand-deployed to GitHub Pages, Netlify, etc.).

##### README for additional insights
- The README simply names the project (“portfolio_new”) without extra details. All architectural clues come from the file tree.

a. Main components
- Browser (Client) – loads HTML, CSS, JS
- Static File Server/CDN – hosts HTML/CSS/JS and asset files
- Static Assets Store – JSON data, resume PDF, images, other media
b. Relationships & interactions
- Browser sends HTTP GET requests to the Static File Server to fetch HTML, CSS, JS.
- As each page loads, the JavaScript modules fetch JSON files (via Ajax/fetch) from the same server to populate dynamic content (blog list, project list, papers list, star map, terminal interactions).
c. Architectural patterns & principles
- Static site (no application server)
- Separation of concerns:
– HTML for structure
– CSS for styling
– JS modules for data loading and interactive features
- JSON files treated as a pseudo‐API (data layer)
d. Key technologies
- HTML5, CSS3
- Vanilla JavaScript (modular scripts in src/js/)
- JSON for data
- Static hosting (GitHub Pages, Netlify, AWS S3/CloudFront, etc.)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser Component
    subgraph "Browser / Client"
        direction TB

        subgraph "UI Resources"
            direction TB
            index["index.html"]:::ui
            projectsHtml["projects.html"]:::ui
            papersHtml["papers.html"]:::ui
            stylesCss["styles.css"]:::ui
            portfolioCss["portfolio-pages.css"]:::ui
        end

        subgraph "JS Modules"
            direction TB
            mainJs["main.js"]:::js
            projectsJs["projects.js"]:::js
            papersJs["papers.js"]:::js
            starMapJs["star-map.js"]:::js
            terminalJs["terminal.js"]:::js
        end
    end

    %% Server Component
    StaticServer["Static File Server / CDN"]:::server

    %% Assets Store
    subgraph "Assets Store"
        direction TB
        blogsJson["blogs.json"]:::data
        projectsJson["projects.json"]:::data
        papersJson["papers.json"]:::data
        scheduleJson["schedule.json"]:::data
        resumePdf["resume.pdf"]:::data
    end

    %% HTTP Requests for UI and Scripts
    index -->|"HTTP GET"| StaticServer
    projectsHtml -->|"HTTP GET"| StaticServer
    papersHtml -->|"HTTP GET"| StaticServer
    stylesCss -->|"HTTP GET"| StaticServer
    portfolioCss -->|"HTTP GET"| StaticServer

    mainJs -->|"HTTP GET"| StaticServer
    projectsJs -->|"HTTP GET"| StaticServer
    papersJs -->|"HTTP GET"| StaticServer
    starMapJs -->|"HTTP GET"| StaticServer
    terminalJs -->|"HTTP GET"| StaticServer

    %% Data Fetching from Assets
    mainJs -->|"Fetch blogs.json & schedule.json"| AssetsStore
    projectsJs -->|"Fetch projects.json"| AssetsStore
    papersJs -->|"Fetch papers.json"| AssetsStore
    mainJs -->|"Download resume.pdf"| AssetsStore

    %% Assets served by Static Server
    AssetsStore -->|"Hosted on"| StaticServer

    %% Click Events
    click index "https://github.com/alpharceus/portfilio_new/blob/main/src/index.html"
    click projectsHtml "https://github.com/alpharceus/portfilio_new/blob/main/src/projects.html"
    click papersHtml "https://github.com/alpharceus/portfilio_new/blob/main/src/papers.html"
    click stylesCss "https://github.com/alpharceus/portfilio_new/blob/main/src/css/styles.css"
    click portfolioCss "https://github.com/alpharceus/portfilio_new/blob/main/src/css/portfolio-pages.css"
    click mainJs "https://github.com/alpharceus/portfilio_new/blob/main/src/js/main.js"
    click projectsJs "https://github.com/alpharceus/portfilio_new/blob/main/src/js/projects.js"
    click papersJs "https://github.com/alpharceus/portfilio_new/blob/main/src/js/papers.js"
    click starMapJs "https://github.com/alpharceus/portfilio_new/blob/main/src/js/star-map.js"
    click terminalJs "https://github.com/alpharceus/portfilio_new/blob/main/src/js/terminal.js"
    click blogsJson "https://github.com/alpharceus/portfilio_new/blob/main/src/assets/blogs.json"
    click projectsJson "https://github.com/alpharceus/portfilio_new/blob/main/src/assets/projects.json"
    click papersJson "https://github.com/alpharceus/portfilio_new/blob/main/src/assets/papers.json"
    click scheduleJson "https://github.com/alpharceus/portfilio_new/blob/main/src/assets/schedule.json"
    click resumePdf "https://github.com/alpharceus/portfilio_new/blob/main/src/assets/resume.pdf"

    %% Styles
    classDef ui fill:#E3F2FD,stroke:#2196F3,color:#0D47A1
    classDef js fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef data fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    classDef server fill:#F3E5F5,stroke:#8E24AA,color:#4A148C

    %% Alias for assets store container
    AssetsStore(("Assets Store"))
    class AssetsStore data
```
