# ishan8727/csjourney architecture

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

- Interactive diagram: https://gitdiagram.com/ishan8727/csjourney
- Repository: https://github.com/ishan8727/csjourney

## Overview

#### Repository Shape
This is a collection of independent web-development learning projects, not a single deployable application. It combines Node.js/Express-style backend exercises, authentication examples, server-rendered CRUD work, and several standalone React/Vite frontends. Each directory with its own `package.json` is an independent runtime boundary.

#### Backend Entry Points
Node-based exercises expose separate executable entry points:
- Todo service: `WebDev/Todo/index.js`, with persistence setup in `WebDev/Todo/db.js`.
- Course-selling backend: `WebDev/courseSellingApp/index.js`, with database integration in `WebDev/courseSellingApp/db.js`.
- JWT/auth examples: `WebDev/JWTCode/index.js`, `WebDev/authMiddlewareJwt/index.js`, and `WebDev/AuthEtc/index.js`.
- CRUD/server experiments: `WebDev/CRUD/active.js`, `WebDev/CRUD/http.js`, and `WebDev/CRUD/middlewareServer.js`.

These should be treated as unrelated applications or lessons, with no shared server bootstrap or common package workspace.

#### Course-Selling API Architecture
`WebDev/courseSellingApp` is the most structured backend. Its likely control flow is:
1. `WebDev/courseSellingApp/index.js` initializes the HTTP application and mounts route modules.
2. Request domains are separated into admin, user, and course routers: `WebDev/courseSellingApp/router/admin.js`, `WebDev/courseSellingApp/router/user.js`, and `WebDev/courseSellingApp/router/course.js`.
3. Protected operations pass through role-specific middleware: `WebDev/courseSellingApp/middleware/admin.js` and `WebDev/courseSellingApp/middleware/user.js`.
4. Routers access the persistence layer configured by `WebDev/courseSellingApp/db.js`.

The admin/user middleware boundary is the core authorization boundary; route modules are the API/domain boundary; the database module isolates storage connectivity.

#### CRUD and Server-Rendered Flow
`WebDev/CRUD` contains small HTTP and middleware experiments alongside an EJS-rendered CRUD interface. Server logic in `WebDev/CRUD/active.js` or `WebDev/CRUD/middlewareServer.js` is expected to render or serve the templates in `WebDev/CRUD/views/index.ejs` and `WebDev/CRUD/views/edit.ejs`. This is distinct from the React projects: HTML is generated on the server rather than solely in the browser.

#### Authentication Samples
Authentication is explored in isolated implementations rather than a shared identity service:
- JWT creation/validation example: `WebDev/JWTCode/index.js`.
- JWT middleware and a static browser page: `WebDev/authMiddlewareJwt/index.js`, `WebDev/authMiddlewareJwt/public/index.html`.
- General auth exercise: `WebDev/AuthEtc/index.js`.

The course-selling application separately embeds its role authorization logic under `WebDev/courseSellingApp/middleware/`. There is no visible common auth library across these projects.

#### React Frontend Projects
Five separate Vite-style React applications have browser entry points in `src/main.jsx` and root composition in `src/App.jsx`:
- Learning examples: `WebDev/REACT/LearningReact/src/main.jsx`, `WebDev/REACT/LearningReact/src/App.jsx`.
- SPA experiments: `WebDev/REACT/SPA/src/main.jsx`, `WebDev/REACT/SPA/src/App.jsx`.
- Website-style frontend: `WebDev/REACT/Website/src/main.jsx`, `WebDev/REACT/Website/src/App.jsx`, with page components under `WebDev/REACT/Website/src/public/`.
- Hook demonstrations: `WebDev/REACT/custom-hooks/src/main.jsx`, `WebDev/REACT/custom-hooks/src/hooks/useFetch.js`, `WebDev/REACT/custom-hooks/src/hooks/Swr.js`.
- State experiments: `WebDev/REACT/state-experiments/src/main.jsx`, `WebDev/REACT/state-experiments/src/App.jsx`.

These are client-side projects with independent package manifests and Vite configurations, not consumers of a clearly shared backend API.

#### Supporting Learning Utilities and Infrastructure
`WebDev/node_learn` contains standalone Node/CLI and filesystem exercises, centered on `WebDev/node_learn/index.js`, `WebDev/node_learn/cli.js`, and `WebDev/node_learn/fileCounter.js`. `Dump/run.js` and related files are separate async/file-processing experiments.

Material runtimes are Node.js for backend/CLI code and browser-based React/Vite for frontend projects. Package manifests and lockfiles define dependencies per project; no container, cloud deployment, CI pipeline, or shared external-service configuration is present in the tree.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course-Selling API"]
  node_course_app["HTTP application<br/>Node entry point<br/>[index.js]"]
  node_admin_router["Admin routes<br/>API router<br/>[admin.js]"]
  node_user_router["User routes<br/>API router<br/>[user.js]"]
  node_course_router["Course routes<br/>API router<br/>[course.js]"]
  node_admin_auth{{"Admin authorization<br/>role middleware<br/>[admin.js]"}}
  node_user_auth{{"User authorization<br/>role middleware<br/>[user.js]"}}
  node_course_db[("Database integration<br/>persistence module<br/>[db.js]")]
end

subgraph group_crud["CRUD Lessons"]
  node_crud_servers["CRUD servers<br/>Node server exercises<br/>[active.js]"]
  node_crud_views["EJS CRUD views<br/>server templates<br/>[index.ejs]"]
end

subgraph group_auth["Auth Samples"]
  node_jwt_example["JWT example<br/>Node auth exercise<br/>[index.js]"]
  node_jwt_middleware["JWT middleware server<br/>Node auth exercise<br/>[index.js]"]
  node_jwt_page["Static auth page<br/>browser page<br/>[index.html]"]
  node_auth_exercise["General auth exercise<br/>Node auth exercise<br/>[index.js]"]
end

subgraph group_react["React/Vite Projects"]
  node_learning_react["Learning React app<br/>Vite browser entry<br/>[main.jsx]"]
  node_spa_react["SPA experiments<br/>Vite browser entry<br/>[main.jsx]"]
  node_website_react["Website frontend<br/>Vite browser entry<br/>[main.jsx]"]
  node_website_pages["Website pages<br/>React page components"]
  node_hooks_react["Custom-hooks app<br/>Vite browser entry<br/>[main.jsx]"]
  node_fetch_hook["Data-fetch hooks<br/>React hooks<br/>[useFetch.js]"]
  node_state_react["State experiments<br/>Vite browser entry<br/>[main.jsx]"]
end

subgraph group_utilities["Node Utilities"]
  node_node_cli["Node CLI exercises<br/>Node/CLI entry<br/>[cli.js]"]
  node_file_counter["File counter<br/>filesystem utility<br/>[fileCounter.js]"]
end

node_todo_service["Todo service<br/>Node backend<br/>[index.js]"]
node_todo_db[("Todo persistence<br/>database module<br/>[db.js]")]

node_course_app -->|"mounts"| node_admin_router
node_course_app -->|"mounts"| node_user_router
node_course_app -->|"mounts"| node_course_router
node_admin_router -->|"protects operations"| node_admin_auth
node_user_router -->|"protects operations"| node_user_auth
node_admin_auth -->|"authorized access"| node_course_db
node_user_auth -->|"authorized access"| node_course_db
node_course_router -->|"persists courses"| node_course_db
node_crud_servers -->|"renders"| node_crud_views
node_jwt_page -->|"browser requests"| node_jwt_middleware
node_website_react -->|"composes"| node_website_pages
node_hooks_react -->|"uses"| node_fetch_hook
node_node_cli -->|"uses"| node_file_counter
node_todo_service -->|"connects to"| node_todo_db

click node_course_app "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/index.js"
click node_admin_router "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/admin.js"
click node_user_router "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/user.js"
click node_course_router "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/course.js"
click node_admin_auth "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/middleware/admin.js"
click node_user_auth "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/middleware/user.js"
click node_course_db "https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/db.js"
click node_crud_servers "https://github.com/ishan8727/csjourney/blob/main/WebDev/CRUD/active.js"
click node_crud_views "https://github.com/ishan8727/csjourney/blob/main/WebDev/CRUD/views/index.ejs"
click node_jwt_example "https://github.com/ishan8727/csjourney/blob/main/WebDev/JWTCode/index.js"
click node_jwt_middleware "https://github.com/ishan8727/csjourney/blob/main/WebDev/authMiddlewareJwt/index.js"
click node_jwt_page "https://github.com/ishan8727/csjourney/blob/main/WebDev/authMiddlewareJwt/public/index.html"
click node_auth_exercise "https://github.com/ishan8727/csjourney/blob/main/WebDev/AuthEtc/index.js"
click node_learning_react "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/LearningReact/src/main.jsx"
click node_spa_react "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/SPA/src/main.jsx"
click node_website_react "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/Website/src/main.jsx"
click node_hooks_react "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/custom-hooks/src/main.jsx"
click node_fetch_hook "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/custom-hooks/src/hooks/useFetch.js"
click node_state_react "https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/state-experiments/src/main.jsx"
click node_node_cli "https://github.com/ishan8727/csjourney/blob/main/WebDev/node_learn/cli.js"
click node_file_counter "https://github.com/ishan8727/csjourney/blob/main/WebDev/node_learn/fileCounter.js"
click node_todo_service "https://github.com/ishan8727/csjourney/blob/main/WebDev/Todo/index.js"
click node_todo_db "https://github.com/ishan8727/csjourney/blob/main/WebDev/Todo/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_course_app,node_admin_router,node_user_router,node_course_router,node_admin_auth,node_user_auth,node_course_db toneBlue
class node_crud_servers,node_crud_views toneAmber
class node_jwt_example,node_jwt_middleware,node_jwt_page,node_auth_exercise toneMint
class node_learning_react,node_spa_react,node_website_react,node_website_pages,node_hooks_react,node_fetch_hook,node_state_react toneRose
class node_node_cli,node_file_counter toneIndigo
class node_todo_service,node_todo_db toneNeutral
```

## Components

### Course-Selling API

Independent Node backend with role-based API boundaries.

- [HTTP application](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/index.js): Node entry point · Initializes the course-selling API and mounts routers. · `WebDev/courseSellingApp/index.js`
- [Admin routes](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/admin.js): API router · `WebDev/courseSellingApp/router/admin.js`
- [User routes](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/user.js): API router · `WebDev/courseSellingApp/router/user.js`
- [Course routes](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/router/course.js): API router · `WebDev/courseSellingApp/router/course.js`
- [Admin authorization](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/middleware/admin.js): role middleware · `WebDev/courseSellingApp/middleware/admin.js`
- [User authorization](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/middleware/user.js): role middleware · `WebDev/courseSellingApp/middleware/user.js`
- [Database integration](https://github.com/ishan8727/csjourney/blob/main/WebDev/courseSellingApp/db.js): persistence module · Isolates storage connectivity for the API. · `WebDev/courseSellingApp/db.js`

### CRUD Lessons

Independent server-rendered HTTP experiments.

- [CRUD servers](https://github.com/ishan8727/csjourney/blob/main/WebDev/CRUD/active.js): Node server exercises · HTTP, middleware, and EJS CRUD server implementations. · `WebDev/CRUD/active.js`
- [EJS CRUD views](https://github.com/ishan8727/csjourney/blob/main/WebDev/CRUD/views/index.ejs): server templates · `WebDev/CRUD/views/index.ejs`

### Auth Samples

Separate authentication exercises without a shared identity service.

- [JWT example](https://github.com/ishan8727/csjourney/blob/main/WebDev/JWTCode/index.js): Node auth exercise · `WebDev/JWTCode/index.js`
- [JWT middleware server](https://github.com/ishan8727/csjourney/blob/main/WebDev/authMiddlewareJwt/index.js): Node auth exercise · `WebDev/authMiddlewareJwt/index.js`
- [Static auth page](https://github.com/ishan8727/csjourney/blob/main/WebDev/authMiddlewareJwt/public/index.html): browser page · `WebDev/authMiddlewareJwt/public/index.html`
- [General auth exercise](https://github.com/ishan8727/csjourney/blob/main/WebDev/AuthEtc/index.js): Node auth exercise · `WebDev/AuthEtc/index.js`

### React/Vite Projects

Independent browser runtimes.

- [Learning React app](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/LearningReact/src/main.jsx): Vite browser entry · `WebDev/REACT/LearningReact/src/main.jsx`
- [SPA experiments](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/SPA/src/main.jsx): Vite browser entry · `WebDev/REACT/SPA/src/main.jsx`
- [Website frontend](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/Website/src/main.jsx): Vite browser entry · `WebDev/REACT/Website/src/main.jsx`
- **Website pages**: React page components
- [Custom-hooks app](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/custom-hooks/src/main.jsx): Vite browser entry · `WebDev/REACT/custom-hooks/src/main.jsx`
- [Data-fetch hooks](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/custom-hooks/src/hooks/useFetch.js): React hooks · `WebDev/REACT/custom-hooks/src/hooks/useFetch.js`
- [State experiments](https://github.com/ishan8727/csjourney/blob/main/WebDev/REACT/state-experiments/src/main.jsx): Vite browser entry · `WebDev/REACT/state-experiments/src/main.jsx`

### Node Utilities

Standalone CLI and file-processing exercises.

- [Node CLI exercises](https://github.com/ishan8727/csjourney/blob/main/WebDev/node_learn/cli.js): Node/CLI entry · `WebDev/node_learn/cli.js`
- [File counter](https://github.com/ishan8727/csjourney/blob/main/WebDev/node_learn/fileCounter.js): filesystem utility · `WebDev/node_learn/fileCounter.js`

### Other components

- [Todo service](https://github.com/ishan8727/csjourney/blob/main/WebDev/Todo/index.js): Node backend · Independent persistence-backed exercise. · `WebDev/Todo/index.js`
- [Todo persistence](https://github.com/ishan8727/csjourney/blob/main/WebDev/Todo/db.js): database module · `WebDev/Todo/db.js`

## Connections

- HTTP application → Admin routes: mounts
- HTTP application → User routes: mounts
- HTTP application → Course routes: mounts
- Admin routes → Admin authorization: protects operations
- User routes → User authorization: protects operations
- Admin authorization → Database integration: authorized access
- User authorization → Database integration: authorized access
- Course routes → Database integration: persists courses
- CRUD servers → EJS CRUD views: renders
- Static auth page → JWT middleware server: browser requests
- Website frontend → Website pages: composes
- Custom-hooks app → Data-fetch hooks: uses
- Node CLI exercises → File counter: uses
- Todo service → Todo persistence: connects to
