# yaakov-portnoy/techids architecture

> Architecture diagram of the GitHub repository yaakov-portnoy/techids, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yaakov-portnoy/techids
- Repository: https://github.com/yaakov-portnoy/techids

## Overview

Techids combines a public STEM-education website with a private submission-management system. Visitors explore organization information, workshops, lessons, and the gallery; they can submit workshop, contact, or involvement forms. The Express API validates and stores submissions, while administrators sign in, review them, and update statuses. The graph includes the website’s documented capability pages and the sampled API, authentication, and SQLite layers. Some page-to-API links are supported by the source index’s import references; unsampled internals are not inferred.

Main entry points: [`src/App.jsx`](https://github.com/yaakov-portnoy/techids/blob/main/src/App.jsx) (Page Router), [`src/api.js`](https://github.com/yaakov-portnoy/techids/blob/main/src/api.js) (Frontend API Client), [`server/server.js`](https://github.com/yaakov-portnoy/techids/blob/main/server/server.js) (Express API), [`src/pages/Home.jsx`](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Home.jsx) (Home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Website"]
  node_router["Page Router<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_about["About<br/>[About.jsx]"]
  node_workshops["Workshops<br/>[Workshops.jsx]"]
  node_lessons["Lessons<br/>[Lessons.jsx]"]
  node_gallery["Gallery<br/>[Gallery.jsx]"]
  node_notfound["Not Found<br/>[NotFound.jsx]"]
  node_pageparts["Shared Page UI<br/>[PageParts.jsx]"]
end

subgraph group_engagement["Visitor Engagement"]
  node_request["Workshop Request"]
  node_contact["Contact Form<br/>[Contact.jsx]"]
  node_involvement["Get Involved<br/>[GetInvolved.jsx]"]
end

subgraph group_admin["Administration"]
  node_adminlogin["Admin Login<br/>[AdminLogin.jsx]"]
  node_dashboard["Submission Dashboard<br/>[AdminDashboard.jsx]"]
end

subgraph group_backend["API and Storage"]
  node_apihelper["Frontend API Client<br/>[api.js]"]
  node_express["Express API<br/>[server.js]"]
  node_auth["Admin Auth Guard<br/>[auth.js]"]
  node_database[("SQLite Store<br/>[db.js]")]
end

node_visitor(("Visitor"))

node_visitor -->|"opens pages"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_workshops
node_router -->|"routes to"| node_lessons
node_router -->|"routes to"| node_gallery
node_router -->|"routes to"| node_notfound
node_router -->|"routes to"| node_request
node_router -->|"routes to"| node_contact
node_router -->|"routes to"| node_involvement
node_router -->|"routes to"| node_adminlogin
node_router -->|"routes to"| node_dashboard
node_home -->|"renders shared UI"| node_pageparts
node_workshops -->|"renders shared UI"| node_pageparts
node_request -->|"submits form"| node_apihelper
node_contact -->|"submits form"| node_apihelper
node_involvement -->|"submits form"| node_apihelper
node_adminlogin -->|"uses API client"| node_apihelper
node_dashboard -->|"uses API client"| node_apihelper
node_apihelper -->|"sends API requests"| node_express
node_express -->|"reads and writes"| node_database
node_express -->|"guards admin routes"| node_auth

click node_router "https://github.com/yaakov-portnoy/techids/blob/main/src/App.jsx"
click node_home "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Home.jsx"
click node_about "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/About.jsx"
click node_workshops "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Workshops.jsx"
click node_lessons "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Lessons.jsx"
click node_gallery "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Gallery.jsx"
click node_notfound "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/NotFound.jsx"
click node_pageparts "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/PageParts.jsx"
click node_request "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/RequestWorkshop.jsx"
click node_contact "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Contact.jsx"
click node_involvement "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/GetInvolved.jsx"
click node_adminlogin "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/AdminLogin.jsx"
click node_dashboard "https://github.com/yaakov-portnoy/techids/blob/main/src/pages/AdminDashboard.jsx"
click node_apihelper "https://github.com/yaakov-portnoy/techids/blob/main/src/api.js"
click node_express "https://github.com/yaakov-portnoy/techids/blob/main/server/server.js"
click node_auth "https://github.com/yaakov-portnoy/techids/blob/main/server/auth.js"
click node_database "https://github.com/yaakov-portnoy/techids/blob/main/server/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_home,node_about,node_workshops,node_lessons,node_gallery,node_notfound,node_pageparts toneBlue
class node_request,node_contact,node_involvement toneAmber
class node_adminlogin,node_dashboard toneMint
class node_apihelper,node_express,node_auth,node_database toneRose
class node_visitor toneIndigo
```

## Components

### Public Website

- [Page Router](https://github.com/yaakov-portnoy/techids/blob/main/src/App.jsx): `src/App.jsx`
- [Home](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [About](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/About.jsx): `src/pages/About.jsx`
- [Workshops](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Workshops.jsx): `src/pages/Workshops.jsx`
- [Lessons](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Lessons.jsx): `src/pages/Lessons.jsx`
- [Gallery](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Gallery.jsx): `src/pages/Gallery.jsx`
- [Not Found](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/NotFound.jsx): `src/pages/NotFound.jsx`
- [Shared Page UI](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/PageParts.jsx): `src/pages/PageParts.jsx`

### Visitor Engagement

- [Workshop Request](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/RequestWorkshop.jsx): `src/pages/RequestWorkshop.jsx`
- [Contact Form](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/Contact.jsx): `src/pages/Contact.jsx`
- [Get Involved](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/GetInvolved.jsx): `src/pages/GetInvolved.jsx`

### Administration

- [Admin Login](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/AdminLogin.jsx): `src/pages/AdminLogin.jsx`
- [Submission Dashboard](https://github.com/yaakov-portnoy/techids/blob/main/src/pages/AdminDashboard.jsx): `src/pages/AdminDashboard.jsx`

### API and Storage

- [Frontend API Client](https://github.com/yaakov-portnoy/techids/blob/main/src/api.js): `src/api.js`
- [Express API](https://github.com/yaakov-portnoy/techids/blob/main/server/server.js): `server/server.js`
- [Admin Auth Guard](https://github.com/yaakov-portnoy/techids/blob/main/server/auth.js): `server/auth.js`
- [SQLite Store](https://github.com/yaakov-portnoy/techids/blob/main/server/db.js): `server/db.js`

### Other components

- **Visitor**

## Connections

- Visitor → Page Router: opens pages (evidence: `src/App.jsx`)
- Page Router → Home: routes to (evidence: `src/App.jsx`)
- Page Router → About: routes to (evidence: `src/App.jsx`)
- Page Router → Workshops: routes to (evidence: `src/App.jsx`)
- Page Router → Lessons: routes to (evidence: `src/App.jsx`)
- Page Router → Gallery: routes to (evidence: `src/App.jsx`)
- Page Router → Not Found: routes to (evidence: `src/App.jsx`)
- Page Router → Workshop Request: routes to (evidence: `src/App.jsx`)
- Page Router → Contact Form: routes to (evidence: `src/App.jsx`)
- Page Router → Get Involved: routes to (evidence: `src/App.jsx`)
- Page Router → Admin Login: routes to (evidence: `src/App.jsx`)
- Page Router → Submission Dashboard: routes to (evidence: `src/App.jsx`)
- Home → Shared Page UI: renders shared UI (evidence: `src/pages/Home.jsx`)
- Workshops → Shared Page UI: renders shared UI (evidence: `src/pages/Workshops.jsx`)
- Workshop Request → Frontend API Client: submits form (evidence: `src/pages/RequestWorkshop.jsx`)
- Contact Form → Frontend API Client: submits form (evidence: `src/pages/Contact.jsx`)
- Get Involved → Frontend API Client: submits form (evidence: `src/pages/GetInvolved.jsx`)
- Admin Login → Frontend API Client: uses API client (evidence: `src/pages/AdminLogin.jsx`)
- Submission Dashboard → Frontend API Client: uses API client (evidence: `src/pages/AdminDashboard.jsx`)
- Frontend API Client → Express API: sends API requests (evidence: `README.md`)
- Express API → SQLite Store: reads and writes (evidence: `server/server.js`)
- Express API → Admin Auth Guard: guards admin routes (evidence: `server/server.js`)
