# isabellimrqs/marquesaesthetic architecture

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

- Interactive diagram: https://gitdiagram.com/isabellimrqs/marquesaesthetic
- Repository: https://github.com/isabellimrqs/marquesaesthetic

## Overview

##### Project Type and Purpose
- This is a front-end‐only, static e-commerce website ("MarquesAesthetic") built with plain HTML, CSS, and JavaScript.
- It serves as a semester integrator project demonstrating product listings (jewels, accessories, presents, etc.), a shopping cart, user account page, and admin interface mockup.

##### File‐Structure Analysis
- Top-level HTML pages: account.html, adm.html, cart.html, various category pages (feminine.html, masculine.html, etc.), and produto1.html for product detail.
- “js/” directory: individual page controllers (about.js, feminine.js, products.js, etc.) plus shared modules (funcoes.js, carrinho.js, slider.js).
- “styles/”: CSS styling (account.css, style.css).
- “image/”: static assets (product and UI images).
- “node_modules/”: development dependencies (likely for build tooling, bundlers, polyfills).

##### Key Insights from README
- No backend code present—this is purely client-side.
- Intended user flows: browse categories → view product → add to cart → view cart → (mock) checkout.
- Admin page likely simulates management features (e.g., order review).

##### Diagramming the Architecture
a. Main Components
- Browser (Client)
- Static Web Server (or CDN)
- HTML Pages (Routes)
- CSS Stylesheet(s)
- JavaScript Modules:
– Page Controllers (one per HTML page)
– Shared Utility Modules (cart management, DOM helpers, slider)
- Static Assets (images, fonts)
- (Optional) External Services—e.g., Payment Gateway API stub or Analytics

b. Relationships & Interactions
- Browser requests an HTML page from the Web Server.
- HTML page imports CSS and JS bundles.
- JS controller for that page loads:
– Reads product data (hard-coded or JSON in js/products.js).
– Implements UI interactions (slider, add‐to‐cart).
– Interacts with localStorage or in-memory “cart” module.
- User actions trigger updates to the cart module, which updates the DOM.
- When “Checkout” is clicked, the cart controller may call an external payment API stub.

c. Architectural Patterns & Principles
- Single‐Page‐Enhancement: Each HTML page has its own controller instead of a full SPA.
- Modular JavaScript: Separation between page-specific logic and shared utilities.
- Static Asset Layering: Images, CSS, and JS served separately for cache and CDN optimization.

d. Technologies & Frameworks
- Vanilla JavaScript (ES6 modules if used)
- CSS (no preprocessor)
- Static server (could be GitHub Pages, Nginx)
- Node tooling (bundler or local dev server, implied by node_modules)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Server and Client
    Browser["Browser (Client)"]:::client
    Server["Static Web Server/CDN"]:::server
    Browser -->|HTTP GET HTML/CSS/JS/Images| Server

    %% HTML Pages
    subgraph "HTML Pages" 
        account["account.html"]:::staticpages
        adm["adm.html"]:::staticpages
        cart["cart.html"]:::staticpages
        feminine["feminine.html"]:::staticpages
        masculine["masculine.html"]:::staticpages
        jewels["jewels.html"]:::staticpages
        presents["presents.html"]:::staticpages
        wedding["wedding.html"]:::staticpages
        acessories["acessories.html"]:::staticpages
        products["products.html"]:::staticpages
        produto1["produto1.html"]:::staticpages
        fale["fale_conosco.html"]:::staticpages
        index["index (1).html"]:::staticpages
        sobre["sobre_nos.html"]:::staticpages
    end
    Server -->|Serves| account
    Server -->|Serves| adm
    Server -->|Serves| cart
    Server -->|Serves| feminine
    Server -->|Serves| masculine
    Server -->|Serves| jewels
    Server -->|Serves| presents
    Server -->|Serves| wedding
    Server -->|Serves| acessories
    Server -->|Serves| products
    Server -->|Serves| produto1
    Server -->|Serves| fale
    Server -->|Serves| index
    Server -->|Serves| sobre

    %% CSS Styles
    subgraph "CSS Stylesheets"
        styleCSS["style.css"]:::css
        accountCSS["account.css"]:::css
    end
    Server -->|HTTP GET| styleCSS
    Server -->|HTTP GET| accountCSS
    account -->|link rel=stylesheet| accountCSS
    adm -->|link rel=stylesheet| styleCSS
    cart -->|link rel=stylesheet| styleCSS
    feminine -->|link rel=stylesheet| styleCSS
    masculine -->|link rel=stylesheet| styleCSS
    jewels -->|link rel=stylesheet| styleCSS
    presents -->|link rel=stylesheet| styleCSS
    wedding -->|link rel=stylesheet| styleCSS
    acessories -->|link rel=stylesheet| styleCSS
    products -->|link rel=stylesheet| styleCSS
    produto1 -->|link rel=stylesheet| styleCSS
    fale -->|link rel=stylesheet| styleCSS
    index -->|link rel=stylesheet| styleCSS
    sobre -->|link rel=stylesheet| styleCSS

    %% JavaScript Modules
    subgraph "JavaScript Page Controllers"
        homeC["home.js"]:::scripts
        aboutC["about.js"]:::scripts
        acessoriesC["acessories.js"]:::scripts
        admC["adm.js"]:::scripts
        cartC["carrinho.js"]:::scripts
        feminineC["feminine.js"]:::scripts
        masculineC["masculine.js"]:::scripts
        jewelsC["jewels.js"]:::scripts
        presentsC["presents.js"]:::scripts
        weddingC["wedding.js"]:::scripts
        productsC["products.js"]:::scripts
        produtoC["produto.js"]:::scripts
    end
    subgraph "Shared JS Utilities"
        funcoes["funcoes.js"]:::scripts
        slider["slider.js"]:::scripts
        cartUtil["carrinho.js"]:::scripts
        dados["dados.js"]:::scripts
        appInit["app.js"]:::scripts
    end

    Server -->|HTTP GET| homeC
    Server -->|HTTP GET| aboutC
    Server -->|HTTP GET| acessoriesC
    Server -->|HTTP GET| admC
    Server -->|HTTP GET| cartC
    Server -->|HTTP GET| feminineC
    Server -->|HTTP GET| masculineC
    Server -->|HTTP GET| jewelsC
    Server -->|HTTP GET| presentsC
    Server -->|HTTP GET| weddingC
    Server -->|HTTP GET| productsC
    Server -->|HTTP GET| produtoC
    Server -->|HTTP GET| funcoes
    Server -->|HTTP GET| slider
    Server -->|HTTP GET| cartUtil
    Server -->|HTTP GET| dados
    Server -->|HTTP GET| appInit

    index -->|<script src>| homeC
    sobre -->|<script src>| aboutC
    fale -->|<script src>| aboutC
    acessories -->|<script src>| acessoriesC
    adm -->|<script src>| admC
    cart -->|<script src>| cartC
    feminine -->|<script src>| feminineC
    masculine -->|<script src>| masculineC
    jewels -->|<script src>| jewelsC
    presents -->|<script src>| presentsC
    wedding -->|<script src>| weddingC
    products -->|<script src>| productsC
    produto1 -->|<script src>| produtoC

    %% Module Dependencies
    homeC -->|imports| appInit
    aboutC -->|imports| funcoes
    acessoriesC -->|imports| dados
    acessoriesC -->|imports| funcoes
    admC -->|imports| funcoes
    cartC -->|imports| cartUtil
    cartC -->|imports| funcoes
    cartC -->|uses localStorage.setItem| cartUtil
    feminineC -->|imports| dados
    feminineC -->|imports| funcoes
    masculineC -->|imports| dados
    masculineC -->|imports| funcoes
    jewelsC -->|imports| dados
    jewelsC -->|imports| funcoes
    presentsC -->|imports| dados
    presentsC -->|imports| funcoes
    weddingC -->|imports| dados
    weddingC -->|imports| funcoes
    productsC -->|imports| dados
    productsC -->|imports| funcoes
    produtoC -->|imports| dados
    produtoC -->|imports| slider
    produtoC -->|imports| funcoes

    %% Static Assets
    subgraph "Static Assets"
        images["image/"]:::assets
        productsImages["image/products/"]:::assets
    end
    Server -->|HTTP GET| images
    Server -->|HTTP GET| productsImages

    %% Dev Tooling
    nodeMod["node_modules/"]:::assets
    Server -->|build & dev server| nodeMod

    %% Checkout Flow
    cartC -->|HTTP POST checkout| PaymentAPI["Payment Gateway API (stub)"]:::external

    %% Click Events
    click account "https://github.com/isabellimrqs/marquesaesthetic/blob/main/account.html"
    click adm "https://github.com/isabellimrqs/marquesaesthetic/blob/main/adm.html"
    click cart "https://github.com/isabellimrqs/marquesaesthetic/blob/main/cart.html"
    click feminine "https://github.com/isabellimrqs/marquesaesthetic/blob/main/feminine.html"
    click masculine "https://github.com/isabellimrqs/marquesaesthetic/blob/main/masculine.html"
    click jewels "https://github.com/isabellimrqs/marquesaesthetic/blob/main/jewels.html"
    click presents "https://github.com/isabellimrqs/marquesaesthetic/blob/main/presents.html"
    click wedding "https://github.com/isabellimrqs/marquesaesthetic/blob/main/wedding.html"
    click acessories "https://github.com/isabellimrqs/marquesaesthetic/blob/main/acessories.html"
    click products "https://github.com/isabellimrqs/marquesaesthetic/blob/main/products.html"
    click produto1 "https://github.com/isabellimrqs/marquesaesthetic/blob/main/produto1.html"
    click fale "https://github.com/isabellimrqs/marquesaesthetic/blob/main/fale_conosco.html"
    click index "https://github.com/isabellimrqs/marquesaesthetic/blob/main/index (1).html"
    click sobre "https://github.com/isabellimrqs/marquesaesthetic/blob/main/sobre_nos.html"
    click styleCSS "https://github.com/isabellimrqs/marquesaesthetic/blob/main/styles/style.css"
    click accountCSS "https://github.com/isabellimrqs/marquesaesthetic/blob/main/styles/account.css"
    click homeC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/home.js"
    click aboutC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/about.js"
    click acessoriesC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/acessories.js"
    click admC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/adm.js"
    click cartC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/carrinho.js"
    click feminineC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/feminine.js"
    click masculineC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/masculine.js"
    click jewelsC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/jewels.js"
    click presentsC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/presents.js"
    click weddingC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/wedding.js"
    click productsC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/products.js"
    click produtoC "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/produto.js"
    click funcoes "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/funcoes.js"
    click slider "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/slider.js"
    click cartUtil "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/carrinho.js"
    click dados "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/dados.js"
    click appInit "https://github.com/isabellimrqs/marquesaesthetic/blob/main/js/app.js"
    click images "https://github.com/isabellimrqs/marquesaesthetic/tree/main/image/"
    click productsImages "https://github.com/isabellimrqs/marquesaesthetic/tree/main/image/products/"
    click nodeMod "https://github.com/isabellimrqs/marquesaesthetic/tree/main/node_modules/"

    %% Styles
    classDef client fill:#e8f5fd,stroke:#2196f3,stroke-width:1px
    classDef server fill:#fff3cd,stroke:#ffecb5,stroke-width:1px
    classDef staticpages fill:#e3f2fd,stroke:#90caf9,stroke-width:1px
    classDef css fill:#f5f5f5,stroke:#cfd8dc,stroke-width:1px
    classDef scripts fill:#e8f5e9,stroke:#81c784,stroke-width:1px
    classDef assets fill:#eceff1,stroke:#b0bec5,stroke-width:1px
    classDef external fill:#fff3e0,stroke:#ffb74d,stroke-width:1px
```
