# tech-educators/software-dev-019 architecture

> Architecture diagram of the GitHub repository tech-educators/software-dev-019, 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/tech-educators/software-dev-019
- Repository: https://github.com/tech-educators/software-dev-019

## Overview

##### Project type and purpose
- This is an educational monorepo containing two top-level modules:
– “demos”: week-by-week code examples (pure HTML/CSS/JS front-end demos and later full-stack tutorials).
– “student-guides”: Markdown reference guides.
- Purpose: provide students with bite-sized front-end exercises (Weeks 1–3) and introduce build tools, server APIs, databases in Week 4, plus supplemental guides.

##### File structure
- Top-level directories:
– demos/ : subdivided by week (week-01, week-02, week-03, week-04).
– student-guides/ : collection of reference docs.
- Inside demos/week-XX:
– Weeks 1–3: each demo is a self-contained static HTML/CSS/JS folder.
– Week 4: some demos include a “client” (HTML + Vite/JS modules) and a “server” (Express.js, .js files, SQL or Supabase).
- No shared code between weeks—each demo is standalone.
- Build/config files appear only in Vite demos (package.json, .gitignore) and Node.js server demos.

##### Key insights from README
- No explicit architecture section—project is purely a teaching codebase.
- Emphasis on “demo code” and “useful guides.”

##### Detail
- Every layer: monorepo → module → runtime components.
- Don’t omit standalone static demos—they illustrate progressive curriculum.
- Avoid over-simplification: each demo is its own self-contained piece of the course.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Monorepo Root"
        MR["Monorepo Root"]:::root
        subgraph "demos" 
            DEMO1["Week 1: Static HTML/CSS/JS"]:::static
            DEMO2["Week 2: Static JS Exercises"]:::static
            subgraph "Week 3"
                W3S["Static Demos"]:::static
                W3T["Tooling (npm/Vite)"]:::tooling
            end
            subgraph "Week 4"
                W4A["01-from-live-server-to-vite (Vite Client)"]:::tooling
                W4B["02-build-a-server-api-express (Express API)"]:::server
                W4C["03-push-project-to-github-deployment"]:::server
                W4D["04-supabase-and-servers"]:::server
                W4E["05-SQL-in-the-server"]:::server
                W4F["06-arrow-functions (Front-End)"]:::static
                W4G["07-user-input-post-routes"]:::server
                W4H["08-query-strings-get-routes"]:::server
                W4I["week04-assignment"]:::server
            end
        end
        subgraph "student-guides"
            SG["Reference Docs (Markdown)"]:::guides
        end
    end

    %% Flows
    Browser["Browser"]:::external
    Browser -->|"load static assets"| DEMO1
    Browser -->|"load static assets"| DEMO2
    Browser -->|"load static assets"| W3S
    Browser -->|"bundle via Vite"| W3T
    Browser -->|"bundle via Vite"| W4A
    Browser -->|"HTTP requests"| W4B
    Browser -->|"HTTP requests"| W4C
    Browser -->|"HTTP requests"| W4D
    Browser -->|"HTTP requests"| W4E
    Browser -->|"run front-end"| W4F
    Browser -->|"HTTP requests"| W4G
    Browser -->|"HTTP requests"| W4H
    Browser -->|"HTTP requests"| W4I

    %% Server to DB flows (generic)
    W4B -->|"queries"| DB1[(Database)]:::db
    W4C -->|"queries"| DB2[(Database)]:::db
    W4D -->|"Supabase REST"| DB3[(Supabase)]:::db
    W4E -->|"SQL queries"| DB4[(Database)]:::db
    W4G -->|"POST routes"| DB5[(Database)]:::db
    W4H -->|"GET routes"| DB6[(Database)]:::db
    W4I -->|"assignment DB"| DB7[(Database)]:::db

    Browser -. "view guides" .-> SG

    %% Click Events
    click MR "https://github.com/tech-educators/software-dev-019/blob/main/README.md"
    click MR "https://github.com/tech-educators/software-dev-019/blob/main/.gitignore"
    click demos "https://github.com/tech-educators/software-dev-019/tree/main/demos/"
    click SG "https://github.com/tech-educators/software-dev-019/tree/main/student-guides/"
    click DEMO1 "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-01/"
    click DEMO2 "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-02/"
    click W3T "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-03/07-npm/"
    click W3T "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-03/09-unit-testing/"
    click W4A "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/01-from-live-server-to-vite/"
    click W4B "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/02-build-a-server-api-express/server.js"
    click W4C "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/03-push-project-to-github-deployment/client/"
    click W4C "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/03-push-project-to-github-deployment/server/server.js"
    click W4D "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/04-supabase-and-servers/client/"
    click W4D "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/04-supabase-and-servers/server/server.js"
    click W4E "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/05-SQL-in-the-server/client/"
    click W4E "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/05-SQL-in-the-server/server/queries.sql"
    click W4E "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/05-SQL-in-the-server/server.js"
    click W4F "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/06-arrow-functions/app.js"
    click W4G "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/07-user-input-post-routes/client/"
    click W4G "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/07-user-input-post-routes/server/server.js"
    click W4H "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/08-query-strings-get-routes/client/"
    click W4H "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/08-query-strings-get-routes/server/server.js"
    click W4I "https://github.com/tech-educators/software-dev-019/tree/main/demos/week-04/week04-assignment/client/"
    click W4I "https://github.com/tech-educators/software-dev-019/blob/main/demos/week-04/week04-assignment/server/server.js"

    %% Styles
    classDef root fill:#FFD700,stroke:#333,stroke-width:2px
    classDef static fill:#ADD8E6,stroke:#333
    classDef tooling fill:#90EE90,stroke:#333
    classDef server fill:#FFA500,stroke:#333
    classDef db fill:#9370DB,stroke:#333
    classDef guides fill:#D3D3D3,stroke:#333
    classDef external fill:#FFFFFF,stroke-dasharray: 5 5,stroke:#666
```
