# sousa83/web architecture

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

- Interactive diagram: https://gitdiagram.com/sousa83/web
- Repository: https://github.com/sousa83/web

## Overview

##### Project type and purpose
- This is not a single running application but a “monorepo” of learning modules for web development fundamentals: HTML, CSS, JavaScript (including ESNext, Node, AJAX, DOM manipulation), TypeScript, React and a Webpack-based build example. Its purpose is purely educational—each top-level directory is a self-contained module demonstrating concepts, patterns or toolchains.

##### File structure
- Top-level directories:
- HTML – sample page anatomy, content tags, tables, video, etc.
- Javascript – subdivided into fundamentals, functions, arrays, ESNext features, DOM, Node, AJAX, etc.
- TypeScript – compiler example, generics, namespaces/modules, OO, types, plus a build folder with compiled JS.
- react – two separate React demo apps (“macos-calculator” and “react-learning”) each with its own package.json, src, public.
- webpack – a small app showing SCSS/assets, Webpack config, bundling assets.
- Config & build files: `.gitignore`, tsconfig.json, various package.json, webpack.config.js, Babel config.

##### README for additional insights
- Confirms that this is a learning repo covering JavaScript, TypeScript, HTML. No single runtime. No unified API surface—Node/Express code lives under Javascript/Node/Express purely as a demo.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Learning Modules
    subgraph "Learning Modules"
        HTML["HTML Module"]:::module
        CSS["CSS Module"]:::module
        subgraph "JavaScript Module"
            JSFund["Fundamentals"]:::module
            JSESNext["ESNext + Mini App"]:::module
            JSDOM["DOM Manipulation"]:::module
            JSAJAX["AJAX"]:::module
            JSNodeCore["Node Demos (Core)"]:::module
            JSNodeExpress["Node/Express Demo"]:::module
            JSNodeAPI["Node/API Demo"]:::module
        end
        subgraph "TypeScript Module"
            TSModule["TS Source"]:::module
            TSBuild["TS Build Output"]:::module
        end
        subgraph "React Module"
            ReactCalc["macOS Calculator App"]:::module
            ReactLearn["react-learning App"]:::module
        end
        WebpackMod["Webpack Build Module"]:::module
    end

    %% Build Tools
    TSC["TypeScript Compiler (tsc)"]:::tool
    Babel["Babel"]:::tool
    WebpackTool["Webpack Bundler"]:::tool

    %% Runtimes
    Browser["Browser"]:::runtime
    NodeJS["Node.js"]:::runtime

    %% Flows
    TSModule -->|" .ts → .js "| TSC
    TSC -->|"compiler.js"| TSBuild
    JSESNext -->|"ESNext/JSX → JS"| Babel
    Babel -->|"transpiled JS"| WebpackTool
    TSBuild -->|".js files"| WebpackTool
    WebpackMod -->|"static assets"| WebpackTool
    WebpackTool -->|"bundle.js / serve static"| Browser

    Browser -->|"runs HTML/CSS samples"| HTML
    Browser -->|"runs CSS samples"| CSS
    Browser -->|"runs JS demos"| JSFund
    Browser -->|"runs JS demos"| JSESNext
    Browser -->|"runs JS demos"| JSDOM
    Browser -->|"runs JS demos"| JSAJAX
    Browser -->|"runs React apps"| ReactCalc
    Browser -->|"runs React apps"| ReactLearn

    Browser -->|"AJAX GET /products"| JSNodeExpress
    Browser -->|"fetch API"| JSNodeAPI

    NodeJS -->|"runs demos"| JSNodeCore
    NodeJS -->|"runs server"| JSNodeExpress
    NodeJS -->|"runs API"| JSNodeAPI

    %% Click Events
    click HTML "https://github.com/sousa83/web/blob/master/HTML/Index.html"
    click CSS "https://github.com/sousa83/web/blob/master/CSS/index.html"
    click JSFund "https://github.com/sousa83/web/tree/master/Javascript/Fundamentos/"
    click JSESNext "https://github.com/sousa83/web/tree/master/Javascript/ESNext/"
    click JSDOM "https://github.com/sousa83/web/tree/master/Javascript/Manipulando a DOM/"
    click JSAJAX "https://github.com/sousa83/web/tree/master/Javascript/AJAX/"
    click JSNodeCore "https://github.com/sousa83/web/tree/master/Javascript/Node/"
    click JSNodeExpress "https://github.com/sousa83/web/blob/master/Javascript/Node/Express/src/server.js"
    click JSNodeAPI "https://github.com/sousa83/web/blob/master/Javascript/Node/Node-api/src/routes.js"
    click TSModule "https://github.com/sousa83/web/tree/master/TypeScript/"
    click TSBuild "https://github.com/sousa83/web/tree/master/TypeScript/build/"
    click ReactCalc "https://github.com/sousa83/web/tree/master/react/macos-calculator/"
    click ReactLearn "https://github.com/sousa83/web/tree/master/react/react-learning/"
    click WebpackMod "https://github.com/sousa83/web/tree/master/webpack/"
    click TSC "https://github.com/sousa83/web/blob/master/TypeScript/Compiler/compiler.ts"
    click Babel "https://github.com/sousa83/web/blob/master/Javascript/ESNext/Mini app/.babelrc"
    click WebpackTool "https://github.com/sousa83/web/blob/master/webpack/webpack.config.js"
    click WebpackTool "https://github.com/sousa83/web/blob/master/Javascript/ESNext/Mini app/webpack.config.js"

    %% Styles
    classDef module fill:#E0F7FA,stroke:#00838F,stroke-width:2px
    classDef tool fill:#E8F5E9,stroke:#2E7D32,stroke-width:2px,shape:hexagon
    classDef runtime fill:#FFF8E1,stroke:#F9A825,stroke-width:2px,shape:circle
```
