@thanh01.pmt/curriculum-kit 1.4.42 → 1.4.44

package/dist/templates/LAB_TEMPLATE.md

@@ -0,0 +1,61 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "LAB"
+created_by: "Curriculum OS Builder"
+phase: "{{PHASE}}"
+deliverable: "P3-T2"
+version: "{{VERSION}}"
+date: "{{DATE}}"
+---
+<!-- INJECT_BODY -->
+
+# 👨‍💻 CODE LAB: [LAB TITLE]
+_Unit: U[X] | Module: M[X.X] | Lesson: Lesson [XX]_
+
+## 🎯 Overview
+This lab focuses on the practical implementation of the technical concepts covered in the lesson. Students will transition from theory to code, focusing on building, debugging, and optimizing their logic.
+
+## 🛠️ Environment & Setup
+- **Language/Framework:** [e.g., Python 3.12, Arduino C++, Node-RED]
+- **IDE/Editor:** [e.g., Thonny, Arduino IDE, VS Code]
+- **Required Libraries:** [List libraries and version if applicable]
+- **Hardware Connection:** [Optional - Brief description of circuit setup if hardware-dependent]
+
+## 📝 Lab Tasks (3-Tier Differentiation)
+
+### 🥉 Bronze (Foundational) - [X mins]
+**Objective:** Establish basic functionality.
+- **Task:** [e.g., Create a basic script to read data from the DHT11 sensor.]
+- **Requirement:** Code MUST be syntactically correct and run without errors.
+
+### 🥈 Silver (Application) - [Y mins]
+**Objective:** Add logic and data processing.
+- **Task:** [e.g., Add a conditional statement to turn on an LED if the temperature exceeds 30°C.]
+- **Requirement:** Demonstrate understanding of control flow and data comparison.
+
+### 🥇 Gold (Enrichment/Creative) - [Z mins]
+**Objective:** Optimize, extend, or integrate.
+- **Task:** [e.g., Log the temperature data to a local CSV file with timestamps.]
+- **Requirement:** Show advanced resource management (file I/O, timing, or external API integration).
+
+## 💻 Technical Reference ([SME_MANDATE])
+<!-- [SME_MANDATE] -->
+> Any code provided in this section must be verified for syntax accuracy.
+
+```python
+# [SAMPLE CODE WRAPPER]
+# Paste the core logic here for student reference.
+```
+<!-- [/SME_MANDATE] -->
+
+## 🔍 Troubleshooting & Debugging
+| Issue | Potential Cause | Solution |
+| :--- | :--- | :--- |
+| [e.g., "ImportError"] | Library not installed | Run `pip install [library]` |
+| [e.g., "Serial Timeout"] | Wrong COM port | Check Device Manager and update port in script |
+
+## 🏁 Submission & Check-off
+- [ ] Code runs successfully on the target hardware/environment.
+- [ ] Docstrings and comments are added in Vietnamese for clarity.
+- [ ] Variables follow the naming convention defined in the Content Style Guide.

package/dist/templates/SELF_LAB_template.md

@@ -0,0 +1,167 @@
+---
+id: "{{ID}}"
+title: "{{TITLE}}"
+type: "SELF_LAB"
+language: "{{LANGUAGE}}"
+difficulty: "{{DIFFICULTY}}"
+estimated_minutes: {{ESTIMATED_MINUTES}}
+tech_stack: {{TECH_STACK}}
+---
+
+# 🚀 Self-Paced Hands-On Lab: {{TITLE}}
+
+> ⏱️ **Estimated Duration:** ~{{ESTIMATED_MINUTES}} mins  
+> 🎯 **Difficulty Level:** {{DIFFICULTY_UPPER}}  
+> 🧰 **Tech Stack:** {{TECH_STACK_STR}}  
+> 💡 **Self-Learner Notice:** You are in full control of this lab. Follow the progressive challenges below. If you get stuck at any point, use the **Progressive Hints System** to get unstuck without ruining the learning experience!
+
+---
+
+## 📋 Mission Briefing & Environment Setup
+{{MISSION_BRIEFING}}
+
+### 🛫 Preflight Checklist
+{{PREFLIGHT_CHECKLIST}}
+
+---
+
+## 🎯 Progressive Challenges (3-Tier Differentiation)
+
+### 🥉 Challenge 1: Foundational Core (Bronze) — ~{{BRONZE_MINS}} mins
+**Objective:** {{BRONZE_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{BRONZE_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{BRONZE_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{BRONZE_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{BRONZE_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{BRONZE_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{BRONZE_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{BRONZE_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+### 🥈 Challenge 2: Logic & Error Handling (Silver) — ~{{SILVER_MINS}} mins
+**Objective:** {{SILVER_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{SILVER_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{SILVER_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{SILVER_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{SILVER_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{SILVER_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{SILVER_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{SILVER_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+### 🥇 Challenge 3: Edge Cases & Optimization (Gold) — ~{{GOLD_MINS}} mins
+**Objective:** {{GOLD_OBJECTIVE}}
+
+#### Tasks & Implementation Details:
+{{GOLD_TASKS}}
+
+#### 🧪 Self-Verification Command:
+```bash
+{{GOLD_VERIFY_COMMAND}}
+```
+*Expected Terminal Output:*
+```text
+{{GOLD_EXPECTED_OUTPUT}}
+```
+
+#### 💡 Progressive Hints (Expand only if stuck):
+<details>
+<summary><b>💡 Hint Level 1: Conceptual Clue</b></summary>
+
+{{GOLD_HINT_1}}
+</details>
+
+<details>
+<summary><b>🔍 Hint Level 2: Structural Skeleton</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{GOLD_HINT_2}}
+```
+</details>
+
+<details>
+<summary><b>🚨 Hint Level 3: Full Solution & Explanation</b></summary>
+
+```{{CODE_LANGUAGE}}
+{{GOLD_HINT_3_CODE}}
+```
+
+**Why this solution works:**
+{{GOLD_HINT_3_EXPLANATION}}
+</details>
+
+---
+
+## 🔍 Self-Learner Troubleshooting Matrix
+| Symptom / Error Message | Root Cause | Exact Fix |
+| :--- | :--- | :--- |
+{{TROUBLESHOOTING_ROWS}}
+
+---
+
+## 🏁 Final Lab Submission & Mastery Checklist
+{{FINAL_CHECKLIST}}