merge dev into main (beginner lessons)

Author: DucMinhNe

README.md

@@ -1,56 +1,83 @@
-# 📒 nodejs-deep-dive
+# 📚 nodejs-course
 
-> A growing collection of notes, examples, and exercises covering JavaScript
-> internals and Node.js. Maintained as part of a Node.js course I taught.
+> A full Node.js course — from JavaScript fundamentals to Node core, Express,
+> databases, and production practices. Built from the material I taught as an
+> IT lecturer.
 
-![license](https://img.shields.io/badge/license-MIT-green.svg) ![node](https://img.shields.io/badge/node-18+-339933.svg) ![status](https://img.shields.io/badge/status-active-brightgreen.svg)
+![license](https://img.shields.io/badge/license-MIT-green.svg) ![node](https://img.shields.io/badge/node-18+-339933.svg) ![lessons](https://img.shields.io/badge/lessons-36-blue.svg) ![topics](https://img.shields.io/badge/topics-78-orange.svg) ![status](https://img.shields.io/badge/status-active-brightgreen.svg)
 
-## Table of Contents
+---
 
-### JavaScript Fundamentals
-- [Hoisting & TDZ](./topics/hoisting/)
-- [Closures & Scope](./topics/closures-and-scope/)
-- [`this` binding & arrow functions](./topics/this-binding/)
-- [Prototypes & classes](./topics/prototypes/)
-- [Promises & async/await](./topics/async-promises/)
-- [The event loop](./topics/event-loop/)
-- [Currying & higher-order functions](./topics/currying/)
-- [Modules: CommonJS vs ESM](./topics/modules/)
+## How this course is organised
 
-### Node.js Core
-- [Streams](./topics/streams/)
-- [File system (`fs`)](./topics/fs-module/)
-- [HTTP module](./topics/http-module/)
-- [Process & environment](./topics/process-env/)
-- [`child_process`](./topics/child-process/)
-- [Worker threads](./topics/worker-threads/)
-- [Cluster mode](./topics/cluster/)
+- **`lessons/`** — the structured curriculum for beginners. Start here and go
+  in order. Each lesson covers one concept with notes, a runnable example, and
+  an exercise.
+- **`topics/`** — deeper dives into specific areas (JS internals, Node modules,
+  Express, databases, DevOps). Reference these once you're comfortable with the
+  basics.
 
-### Web framework: Express
-- [Routing & basics](./topics/express-basics/)
-- [Middleware](./topics/express-middleware/)
-- [Error handling](./topics/express-error-handling/)
-- [JWT authentication](./topics/jwt-auth/)
+## Curriculum (lessons/)
 
-### Database
-- [MongoDB / Mongoose](./topics/mongoose/)
+### Part 1 — Getting started
+1. [Setting up Node.js](./lessons/01-setup-node/)
+2. [Your first program](./lessons/02-first-program/)
+3. [Running code & the REPL](./lessons/03-running-and-repl/)
+4. [Comments](./lessons/04-comments/)
+5. [Syntax: statements & semicolons](./lessons/05-syntax-and-semicolons/)
+6. [Naming conventions](./lessons/06-naming-conventions/)
 
-### Testing
-- [Jest fundamentals](./topics/jest/)
+### Part 2 — Values & types
+7. [Variables: let, const, var](./lessons/07-variables/)
+8. [Data types](./lessons/08-data-types/)
+9. [Strings](./lessons/09-strings/)
+10. [Numbers](./lessons/10-numbers/)
+11. [Booleans & truthiness](./lessons/11-booleans/)
+12. [null vs undefined](./lessons/12-null-undefined/)
+13. [Type conversion](./lessons/13-type-conversion/)
 
-### Best practices
-- [Production checklist](./topics/best-practices/)
+### Part 3 — Operators & control flow
+14. [Arithmetic operators](./lessons/14-arithmetic-operators/)
+15. [Comparison operators](./lessons/15-comparison-operators/)
+16. [Logical operators](./lessons/16-logical-operators/)
+17. [if / else](./lessons/17-if-else/)
+18. [switch](./lessons/18-switch/)
+19. [Ternary operator](./lessons/19-ternary/)
+20. [while & do-while](./lessons/20-while-loops/)
+21. [for loops](./lessons/21-for-loops/)
 
----
+### Part 4 — Functions & scope
+22. [Functions](./lessons/22-functions/)
+23. [Function expressions vs declarations](./lessons/23-function-expressions/)
+24. [Arrow functions](./lessons/24-arrow-functions/)
+25. [Function parameters](./lessons/25-function-parameters/)
+26. [Scope](./lessons/26-scope/)
+
+### Part 5 — Data structures
+27. [Arrays](./lessons/27-arrays/)
+28. [Iterating arrays](./lessons/28-array-iteration/)
+29. [Objects](./lessons/29-objects/)
+
+### Part 6 — Async & Node basics
+30. [Callbacks](./lessons/30-callbacks/)
+31. [Input & output](./lessons/31-input-output/)
+32. [Modules: require & exports](./lessons/32-modules-require/)
+33. [Command-line arguments](./lessons/33-cli-args/)
+34. [Environment variables](./lessons/34-env-vars/)
+35. [Error handling basics](./lessons/35-error-handling-basics/)
+
+## Deep-dive topics (topics/)
 
-## How to use
+JavaScript internals (hoisting, closures, prototypes, the event loop…), Node
+core modules (streams, fs, crypto, worker threads…), Express (middleware, auth,
+validation…), databases (Postgres, Mongo, Redis…), and production concerns
+(Docker, CI, profiling, security). See the [`topics/`](./topics/) directory.
 
-Each topic has its own folder containing:
-- A `README.md` with the lecture notes
-- `examples/*.js` with runnable code samples
-- `exercise.js` with a small practice task
+## Running examples
 
-Browse by topic, or follow the order above for a structured walkthrough.
+```bash
+node lessons/01-setup-node/examples/check-version.js
+```
 
 ## License
 

lessons/01-setup-node/README.md

@@ -0,0 +1,18 @@
+# Lesson 01: Setting up Node.js
+
+Install Node, manage versions, and run your first file.
+
+## What you'll learn
+
+- download the LTS version from nodejs.org, or use a version manager (nvm)
+- `node -v` and `npm -v` confirm the install
+- `nvm install 20 && nvm use 20` to switch versions
+- run a file: `node app.js`
+
+## Example
+
+See `examples/`.
+
+## Exercise
+
+Install Node 20 with nvm and print your version.

lessons/01-setup-node/examples/check-version.js

@@ -0,0 +1,4 @@
+// run with: node check-version.js
+console.log('Node version:', process.version);
+console.log('Platform:', process.platform);
+console.log('You are ready to go!');

lessons/01-setup-node/exercise.js

@@ -0,0 +1,3 @@
+// Lesson 01 exercise: Install Node 20 with nvm and print your version.
+// TODO: your solution here
+module.exports = {};

lessons/02-first-program/README.md

@@ -0,0 +1,18 @@
+# Lesson 02: Your first program
+
+Hello world, and how a JS file is executed.
+
+## What you'll learn
+
+- a `.js` file is a script run top-to-bottom
+- `console.log(...)` prints to the terminal
+- no compile step — Node runs the source directly
+- statements usually end with `;` (optional, see ASI lesson)
+
+## Example
+
+See `examples/`.
+
+## Exercise
+
+Print 'Hello, <your name>' using a variable.

lessons/02-first-program/examples/hello.js

@@ -0,0 +1,9 @@
+// the classic first program
+console.log('Hello, world!');
+
+// you can print multiple values
+console.log('1 + 1 =', 1 + 1);
+
+// and use variables
+const name = 'Minh';
+console.log('Hi,', name);

lessons/02-first-program/exercise.js

@@ -0,0 +1,3 @@
+// Lesson 02 exercise: Print 'Hello, <your name>' using a variable.
+// TODO: your solution here
+module.exports = {};

lessons/03-running-and-repl/README.md

@@ -0,0 +1,18 @@
+# Lesson 03: Running code & the REPL
+
+Two ways to run JS: a file, or the interactive REPL.
+
+## What you'll learn
+
+- `node file.js` runs a script
+- `node` with no args opens the REPL (Read-Eval-Print-Loop)
+- in the REPL, `_` holds the last result
+- `.exit` or Ctrl-D leaves the REPL
+
+## Example
+
+See `examples/`.
+
+## Exercise
+
+Open the REPL and compute the area of a circle radius 3.

lessons/03-running-and-repl/examples/repl-demo.txt

@@ -0,0 +1,10 @@
+$ node
+> 1 + 1
+2
+> _ * 10
+20
+> const x = 5
+undefined
+> x ** 2
+25
+> .exit

lessons/03-running-and-repl/exercise.js

@@ -0,0 +1,3 @@
+// Lesson 03 exercise: Open the REPL and compute the area of a circle radius 3.
+// TODO: your solution here
+module.exports = {};