# alejocolazurda/tienda-ciberseguridad architecture

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

- Interactive diagram: https://gitdiagram.com/alejocolazurda/tienda-ciberseguridad
- Repository: https://github.com/alejocolazurda/tienda-ciberseguridad

## Overview

##### Project Type and Purpose
- A static, frontend-only e-commerce demo (“MiTienda Ciber”) built with HTML, SCSS/CSS, and vanilla JavaScript.
- Hosted on GitHub Pages; no custom backend or database.
- Showcases a product catalog, sticky navbar/footer, responsive design, SweetAlert2 notifications, and LinkedIn-powered contact form.

##### File Structure Analysis
- Top-level HTML pages: index.html, about.html, cart.html, faq.html, hype.html.
- SCSS source under /scss; main.scss imports partials (_variables.scss, _base.scss, _layout.scss, etc.)
- Compiled CSS under /css (styles.css, source map, backup).
- /img holds static assets.
- package.json + node_modules indicate an optional local toolchain for SCSS compilation or npm-based asset management.

##### README Insights
- Frontend stack: HTML5, CSS3 (Grid/Flex), basic JS, SweetAlert2, Font Awesome.
- Deployed via GitHub Pages.
- No runtime API or database—interactivity is entirely client-side.

a. Main Components
- Developer Environment (IDE, Node.js toolchain, SCSS compiler)
- GitHub Repository (source control)
- Build Step (SCSS → CSS; optionally bundling JS)
- GitHub Pages (static site host / CDN for HTML, CSS, JS, images)
- External Services:
– SweetAlert2 (notifications, local or CDN)
– LinkedIn API (contact form submission link)
- End User Browser (renders HTML/CSS, executes JS)

b. Relationships & Data Flow
1. Developer writes/updates .html, .scss, .js locally.
2. SCSS compiler (npm script or tool) transforms /scss → /css/styles.css.
3. Developer pushes commits to GitHub repo.
4. GitHub Pages automatically serves the updated static build.
5. User’s browser requests pages/assets from GitHub Pages.
6. Browser loads external CSS/JS from Font Awesome CDN and SweetAlert2 CDN.
7. On contact form submit, browser interacts with LinkedIn’s public API/URL.
8. Browser triggers SweetAlert2 notifications on user actions.

c. Architectural Patterns & Principles
- Static Site Hosting: No server-side logic; assets delivered via CDN.
- Componentized Styles: SCSS partials for modularity (variables, layouts, components).
- Mobile-First, Responsive Design.
- Client-side enhancement only (progressive enhancement).

d. Key Technologies
- SCSS (source) → CSS3 (grid/flex)
- HTML5 Semantic Pages
- JavaScript + SweetAlert2
- Git/GitHub + GitHub Pages

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Environment
    subgraph "Developer Environment"
        IDE["IDE & Editor"]:::developer
        NodeTool["Node.js Toolchain"]:::developer
        SCSSCompiler["SCSS Compiler"]:::developer
        packageJSON["package.json"]:::developer
        packageLock["package-lock.json"]:::developer
        nodeModules["node_modules/"]:::developer
    end

    %% Build Step (SCSS → CSS)
    subgraph "Build Step"
        MainSCSS["scss/main.scss"]:::developer
        Vars["scss/_variables.scss"]:::developer
        Mixins["scss/_mixins.scss"]:::developer
        Base["scss/_base.scss"]:::developer
        Layout["scss/_layout.scss"]:::developer
        NavbarSCSS["scss/_navbar.scss"]:::developer
        Hero["scss/_hero.scss"]:::developer
        Gallery["scss/_gallery.scss"]:::developer
        AboutSCSS["scss/_about.scss"]:::developer
        CartSCSS["scss/_cart.scss"]:::developer
        HypeSCSS["scss/_hype.scss"]:::developer
        ContactSCSS["scss/_contact.scss"]:::developer
        FooterSCSS["scss/_footer.scss"]:::developer
        CSSOut["css/styles.css"]:::build
        CSSMap["css/styles.css.map"]:::build
        CSSBak["css/styles.css.bak"]:::build
    end

    %% Repository & Hosting
    subgraph "GitHub Repository & Pages"
        subgraph "Repository (Source Control)"
            README["README.md"]:::repo
            LICENSE["LICENSE"]:::repo
            Index["index.html"]:::repo
            About["about.html"]:::repo
            Cart["cart.html"]:::repo
            FAQ["faq.html"]:::repo
            Hype["hype.html"]:::repo
            CSSRepo["css/styles.css"]:::repo
            IMG["img/"]:::repo
        end
        GitHubPages["GitHub Pages (CDN/Host)"]:::hosting
    end

    %% Client Browser
    Browser["End User Browser"]:::browser

    %% External Services
    subgraph "External Services"
        FA["Font Awesome CDN"]:::external
        Swal["SweetAlert2 CDN"]:::external
        LinkedIn["LinkedIn API"]:::external
    end

    %% Data Flows & Relationships
    IDE -->|writes code| MainSCSS
    NodeTool --> SCSSCompiler
    SCSSCompiler -->|compiles| CSSOut
    SCSSCompiler -->|compiles| CSSMap
    SCSSCompiler -->|creates backup| CSSBak
    SCSSCompiler --> MainSCSS
    MainSCSS --> Vars
    MainSCSS --> Mixins
    MainSCSS --> Base
    MainSCSS --> Layout
    MainSCSS --> NavbarSCSS
    MainSCSS --> Hero
    MainSCSS --> Gallery
    MainSCSS --> AboutSCSS
    MainSCSS --> CartSCSS
    MainSCSS --> HypeSCSS
    MainSCSS --> ContactSCSS
    MainSCSS --> FooterSCSS

    IDE -->|commits| README
    IDE --> LICENSE
    IDE --> Index
    IDE --> About
    IDE --> Cart
    IDE --> FAQ
    IDE --> Hype
    IDE --> CSSRepo
    IDE --> IMG

    README -->|push| GitHubPages
    LICENSE -->|push| GitHubPages
    Index -->|push| GitHubPages
    About -->|push| GitHubPages
    Cart -->|push| GitHubPages
    FAQ -->|push| GitHubPages
    Hype -->|push| GitHubPages
    CSSRepo -->|push| GitHubPages
    IMG -->|push| GitHubPages

    GitHubPages -->|serves| Browser
    Browser -->|loads| FA
    Browser -->|loads| Swal
    Browser -->|requests| Index
    Browser -->|requests| About
    Browser -->|requests| Cart
    Browser -->|requests| FAQ
    Browser -->|requests| Hype
    Browser -->|requests| CSSRepo
    Browser -->|requests| IMG
    Browser -->|triggers| Swal
    Browser -->|submits contact| LinkedIn

    %% Click Events
    click MainSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/main.scss"
    click Vars "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_variables.scss"
    click Mixins "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_mixins.scss"
    click Base "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_base.scss"
    click Layout "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_layout.scss"
    click NavbarSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_navbar.scss"
    click Hero "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_hero.scss"
    click Gallery "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_gallery.scss"
    click AboutSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_about.scss"
    click CartSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_cart.scss"
    click HypeSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_hype.scss"
    click ContactSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_contact.scss"
    click FooterSCSS "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/scss/_footer.scss"
    click CSSOut "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/css/styles.css"
    click CSSMap "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/css/styles.css.map"
    click CSSBak "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/css/styles.css.bak"
    click nodeModules "https://github.com/alejocolazurda/tienda-ciberseguridad/tree/main/node_modules/"
    click packageJSON "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/package.json"
    click packageLock "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/package-lock.json"
    click README "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/README.md"
    click LICENSE "https://github.com/alejocolazurda/tienda-ciberseguridad/tree/main/LICENSE"
    click Index "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/index.html"
    click About "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/about.html"
    click Cart "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/cart.html"
    click FAQ "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/faq.html"
    click Hype "https://github.com/alejocolazurda/tienda-ciberseguridad/blob/main/hype.html"
    click IMG "https://github.com/alejocolazurda/tienda-ciberseguridad/tree/main/img/"

    %% Styles
    classDef developer fill:#D6E9FF,stroke:#4A90E2
    classDef build fill:#BEE7B1,stroke:#6AA84F
    classDef repo fill:#DFF2BF,stroke:#4C9900
    classDef hosting fill:#C0F0C0,stroke:#38761D
    classDef browser fill:#FFF8B8,stroke:#E69138
    classDef external fill:#FFD8B5,stroke:#E57200
```
