# elias288/elelispage architecture

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

- Interactive diagram: https://gitdiagram.com/elias288/elelispage
- Repository: https://github.com/elias288/elelispage

## Overview

##### Project type and purpose
- This is a static-site “personal portfolio” built with Astro JS.
- The goal is to showcase projects, skills, and experience as a self-contained website that is built once and served as static assets.

##### File structure
- Top-level “code” folder contains the entire Astro project.
- astro.config.mjs, package.json, tsconfig.json → build config, dependencies, TypeScript setup
- src/pages → route definitions (index.astro → home page)
- src/layouts → shared wrappers (Header, Footer, Layout)
- src/components → reusable UI pieces (Welcome, SobreMi, Experiencia, etc.)
- src/content/proyectos → project detail files (each .astro is a content page)
- src/assets & static/images → raw images and static files
- src/utils & src/types → helpers (loadProjects.ts) and type definitions
- .github/workflows/deploy.yml defines the CI/CD pipeline for automated build & deploy.

##### Key insights from README
- Confirms it’s an Astro-based portfolio.
- No dynamic backend or database—pure static generation.

a. Components to include
1. Developer Workstation
- Local code editor (VSCode), source files under code/src
2. Version Control (GitHub Repo)
- code/, .github/workflows/deploy.yml
3. CI/CD Pipeline (GitHub Actions)
- Checkout code, npm install, npm run build (Astro SSG), deploy step
4. Static Site Hosting / CDN
- Host (e.g., GitHub Pages, Netlify, Vercel) serving the generated /dist folder
5. End-User Browser
- Requests HTML, CSS, JS, images from CDN/host
6. External Services (optional)
- Analytics, form-submission endpoint (if any)

b. Relationships & data flow

c. Architectural patterns & principles
- Static Site Generation (SSG) with Astro
- Component-based UI (atomic design: pages → layouts → components)
- Content-as-code (project pages under src/content)
- CI/CD for automated, repeatable builds and deployments

d. Key technologies
- Astro JS framework
- Node.js & npm (package.json, package-lock.json)
- TypeScript (tsconfig.json, .ts files)
- GitHub Actions (deploy.yml)
- Static host / CDN (e.g., Netlify, Vercel)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer and Local Code
    subgraph "Developer Workstation" 
        Dev["VSCode & Local Code"]:::external
        subgraph "Local Source Code" 
            astroConfig["astro.config.mjs"]:::code
            pkgJson["package.json"]:::code
            pkgLock["package-lock.json"]:::code
            tsconfig["tsconfig.json"]:::code
            subgraph "Pages (Routes)" 
                indexPage["index.astro"]:::code
            end
            subgraph "Layouts (Shared Wrappers)"
                Header["Header.astro"]:::code
                Footer["Footer.astro"]:::code
                Layout["Layout.astro"]:::code
            end
            subgraph "UI Components"
                Welcome["Welcome.astro"]:::code
                SobreMi["SobreMi.astro"]:::code
                Experiencia["Experiencia.astro"]:::code
                Educacion["Educacion.astro"]:::code
                Habilidades["Habilidades.astro"]:::code
                ProyectosComp["Proyectos.astro"]:::code
                Contacto["Contacto.astro"]:::code
            end
            subgraph "Content-as-Code (Projects)"
                GoL["Game-of-Life.astro"]:::code
                Seguimiento["Seguimiento-Comida.astro"]:::code
                Servidor["Servidor-Personal.astro"]:::code
                Template["Template.astro"]:::code
                Utilities["Web-Page-Utilities.astro"]:::code
                WebScraping["Web-Scraping-Concept.astro"]:::code
            end
            subgraph "Assets"
                AssetsRaw["src/assets/"]:::code
                StaticImages["static/images/"]:::code
            end
            subgraph "Utilities & Types"
                loadProjects["loadProyects.ts"]:::code
                pageConfig["page_config.ts"]:::code
                Entries["Entries.ts"]:::code
            end
        end
    end

    %% Version Control
    Repo["GitHub Repo"]:::storage

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline" 
        Checkout["Checkout code"]:::process
        Install["npm install"]:::process
        AstroBuild["Astro Build (SSG)"]:::process
        DeployStep["Deploy to Hosting"]:::process
    end

    %% Artifacts and Hosting
    Artifacts["Static Assets (dist)"]:::storage
    Host["Static Site Hosting / CDN"]:::external
    Browser["End-User Browser"]:::user

    %% Connections
    Dev -->|push commits| Repo
    Repo -->|trigger workflow| Checkout
    Checkout --> Install --> AstroBuild --> DeployStep
    AstroBuild -->|generate static files| Artifacts
    DeployStep -->|publish artifacts| Host
    Host -->|serve HTTP| Browser

    %% Click Events
    click astroConfig "https://github.com/elias288/elelispage/blob/main/code/astro.config.mjs"
    click pkgJson "https://github.com/elias288/elelispage/blob/main/code/package.json"
    click pkgLock "https://github.com/elias288/elelispage/blob/main/code/package-lock.json"
    click tsconfig "https://github.com/elias288/elelispage/blob/main/code/tsconfig.json"
    click indexPage "https://github.com/elias288/elelispage/blob/main/code/src/pages/index.astro"
    click Header "https://github.com/elias288/elelispage/blob/main/code/src/layouts/Header.astro"
    click Footer "https://github.com/elias288/elelispage/blob/main/code/src/layouts/Footer.astro"
    click Layout "https://github.com/elias288/elelispage/blob/main/code/src/layouts/Layout.astro"
    click Welcome "https://github.com/elias288/elelispage/blob/main/code/src/components/Welcome.astro"
    click SobreMi "https://github.com/elias288/elelispage/blob/main/code/src/components/SobreMi.astro"
    click Experiencia "https://github.com/elias288/elelispage/blob/main/code/src/components/Experiencia.astro"
    click Educacion "https://github.com/elias288/elelispage/blob/main/code/src/components/Educacion.astro"
    click Habilidades "https://github.com/elias288/elelispage/blob/main/code/src/components/Habilidades.astro"
    click ProyectosComp "https://github.com/elias288/elelispage/blob/main/code/src/components/Proyectos.astro"
    click Contacto "https://github.com/elias288/elelispage/blob/main/code/src/components/Contacto.astro"
    click GoL "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Game-of-Life.astro"
    click Seguimiento "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Seguimiento-Comida.astro"
    click Servidor "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Servidor-Personal.astro"
    click Template "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Template.astro"
    click Utilities "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Web-Page-Utilities.astro"
    click WebScraping "https://github.com/elias288/elelispage/blob/main/code/src/content/proyectos/Web-Scraping-Concept.astro"
    click AssetsRaw "https://github.com/elias288/elelispage/tree/main/code/src/assets/"
    click StaticImages "https://github.com/elias288/elelispage/tree/main/code/static/images/"
    click loadProjects "https://github.com/elias288/elelispage/blob/main/code/src/utils/loadProyects.ts"
    click pageConfig "https://github.com/elias288/elelispage/blob/main/code/src/utils/page_config.ts"
    click Entries "https://github.com/elias288/elelispage/blob/main/code/src/types/Entries.ts"
    click DeployStep "https://github.com/elias288/elelispage/blob/main/.github/workflows/deploy.yml"

    %% Styles
    classDef code fill:#D0E8FF,stroke:#0091EA
    classDef process fill:#D0FFD6,stroke:#00A152
    classDef external fill:#FFE0B2,stroke:#FF6D00
    classDef storage fill:#F3E5F5,stroke:#6A1B9A
    classDef user fill:#ECEFF1,stroke:#607D8B
```
