Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
178 changes: 178 additions & 0 deletions contributing/proposals/js-node-restructure.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
# 📘 JavaScript & Node.js Module Restructuring Plan Proposal

## 🎯 Goal

To restructure existing JavaScript and Node.js content into a new modular curriculum across three tracks: **Foundation**, **Frontend Specialism**, and **Backend Specialism**. The focus is on reuse, clarity, and separating concerns between frontend and backend education.

This is schemas for current module structures. I will use the same **color-coding** for the parts of new modules, so it would be obvious where is this topic is coming from. You can also use the attached file to have interactive schemas in [draw.io](https://app.diagrams.net/)

[Click to dowload hyf.drawio.zip](https://github.com/user-attachments/files/19875331/hyf.drawio.zip)

![Image](https://github.com/user-attachments/assets/894799bd-c19a-49ea-a1bc-f0c14cab66e0)

![Image](https://github.com/user-attachments/assets/53027cc4-f720-43ee-bce5-e310000298d1)

![Image](https://github.com/user-attachments/assets/c7f2a630-dfd7-4dda-aabe-f70e1c83987c)

![Image](https://github.com/user-attachments/assets/b9985e8d-90ad-4215-90ec-1275449717af)

---

## 🧱 FOUNDATION COURSE STRUCTURE

### 🎓 Final Project Strategy

**Vision:** Trainees begin shaping their Foundation course **final project**, gradually building upon it across modules. By the end, they should have:

- A frontend consuming data from a backend API
- Core business logic reused from early JavaScript work.

**Approach:**

- Start developing simple reusable logic (just functions solving problems for their future project!) in latest General JavaScript homeworks.
- Reuse and expand this logic in homeworks for Introduction modules.

### 1. Module: General JavaScript

**Duration**: 4 weeks\
**Source**: copy of JavaScript 1\
**Purpose**: Establish fundamental JavaScript knowledge. Teaches only one way to solve problems, no advanced topics or multiple approaches.

#### Topics for General JavaScript

- **Week 1**: Intro JS, Types, Setup, Operators, console.log, Errors, Variables
- **Week 2**: Conditions, Functions, Scope, For loop
- **Week 3**: Arrays (no map/filter/reduce), Objects, Call stack
- **Week 4**: Recap and Problem Solving

![Image](https://github.com/user-attachments/assets/03dd07df-6bb7-48a4-9aeb-053744da16af)

#### Final Week Homework Note

Introduce small reusable logic/function tasks already in the final week (e.g., calculating prices, transforming arrays) and encourage saving the code — these will be reused in API or frontend in later modules.

### 2. Module: Web Architecture 101

**Duration**: 1 week\
**Purpose**: Introduce shared concepts between frontend and backend. Creates a unified mental model before Introductions for specialisations and removes duplicates from modules (like API explanations).\
**Note**: It, probably, will require some new material there (we didn’t have architecture before), but we can always just stick to the topics that was introduced before in old modules.

#### Topics for Web Architecture 101 [not limited to]

- Client vs Server
- What is Backend?
- Client–Server Model
- HTTP
- JSON
- API
- Databases
- Conceptual overview of deployment (to prepare for real-world usage in final project)

![Image](https://github.com/user-attachments/assets/c01ec981-9b9a-4b4f-8bbf-71489a800e0a)

### 3. Module: Introduction to Backend

**Duration**: 1 week\
**Purpose**: Provide a hands-on primer to backend development. Enables learners to build a basic working backend (simple CRUD server or even less).\
**Reasoning**: Placing backend first in hands-on development allows learners to apply their JavaScript fundamentals while reinforcing their understanding of APIs introduced in Web Architecture 101. This progression is both natural and confidence-building: learners already know how to write logic, and now they can wrap it in endpoints (basically, another level of functions). Starting here also clarifies the API before they consume it from the frontend side.

#### Topics for Introduction to Backend

- Intro to Node.js
- Simple web server
- Using Postman to test endpoints
- CRUD implementation (focus on code, not theory)
- _Optional_: Basic DB interaction (since we have a module, but not necessary)
- Optional: Introduce a simple one-click deployment path

![Image](https://github.com/user-attachments/assets/e7516502-8137-40d0-ba8c-3999a417c408)

### 4. Module: Introduction to Frontend

**Duration**: 1 week\
**Purpose**: Demonstrate how JavaScript is used on the frontend, how to interact with DOM and how to interact with APIs from the browser.

#### Topics for Introduction to Frontend

- Browser environment (HTML vs CSS vs JS, script tag placement, debugging)
- DOM manipulation basics
- Event listeners (focus on usage, no callback explanation)
- `fetch()` for calling APIs (usage only — promises explained later)
- _Optional_: Introduce a simple one-click deployment path

![Image](https://github.com/user-attachments/assets/aab89368-8620-4ede-a0ed-3ce5575435bc)

### Open Questions

- **Deployment**: Should we provide guided deployment in Introduction modules? Just instructions, so they would be able to use them for Foundation Final Project.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this could be a good chance for students to practice reading official documentations and learning how to deploy to Vercel, Netlify etc without direct guidance from us, but rather, by figuring it out themselves by readings the docs. We can be there to supervise during the whole process.

The reasoning here will be to have the students learn the skill of reading docs as well, which is crucial for their career development.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe deployment and hosting are one of the main challenges students face during the final project. To reduce confusion and ensure consistency, I think it's important to stick to one clear approach: either the students choose a cloud provider and the mentors guide them through it, or HYF defines a single technology stack that all students use.

I lean toward @babak-f perspective - students should be encouraged to research, evaluate the pros and cons, and gain hands-on experience making these decisions themselves.


---

## 🧱 SPECIALISATIONS COURSE STRUCTURE

## Frontend & Backend Specialisations

### 1. Module: Advanced JavaScript

**Duration**: 4 weeks\
**Purpose**: Deepen JavaScript knowledge with modern concepts and patterns used in both frontend and backend development. This module is part of both the Frontend and Backend Specialisation tracks. While topics are shared, examples and homeworks must be tailored per track.

#### Topics for Advanced JavaScript

- **Week 1**: Array functions, Arrow functions
- **Week 2**: Callback functions, Asynchronicity, Scope
- **Week 3**: Promises, Async/Await
- **Week 4**: Classes, Advanced Promises

![Image](https://github.com/user-attachments/assets/2d61e291-0abd-42a6-9eca-43ee38bb4bfb)

#### Track-specific differentiation

- **Frontend Specialism**: Browser-based examples (e.g., DOM tasks, UI-based async data fetching)
- **Backend Specialism**: Server-based examples (e.g., file handling, API response management)

#### To do for Advanced JavaScript

- Rethink the final assignment structure and integration with broader project.

---

### Backend Specialisation

### 1. Module: Node.js

**Duration**: 2 weeks\
**Purpose**: Expand learners’ backend development capabilities using Node.js and Express. Builds on Introduction to Backend with more advanced tooling, patterns, and responsibilities.

#### Topics for Node.js

- **Week 1**:
- Express (intro, routing, logging, debugging)
- Middleware
- Postman (creating collections, saving queries)
- **Week 2**:
- Postman (POST, DELETE, PUT requests)
- API Design (REST, CRUD)
- Database interaction (expanded)

![Image](https://github.com/user-attachments/assets/6d309db1-e849-4412-b93c-9705b993e2a2)

**Optional changes:**

- Can optionally have an additional week to include advanced backend topics that was proposed in previous dicussions

#### To do for Node.js

- Rethink the final assignment structure and integration with broader project.

---

## Other Questions

> Should we introduce js module/import/export concept in foundation or not?

_Option 1_: It might be natural to introduce separate files in «Introduction to Backend», and then mention in «Introduction to Frontend» how it is solved there.

_Option 2_: Introduce idea of structuring files (and import/export) on «Web Architecture 101» session.

_Option 3_: Not to give this concept in Foundation, because it seems like it can be done in one file, and later they will have to have separate files in React / Node anyway.