# 新課程上架前複審清單

六門新課都是 AI 撰寫的草稿(`published = false`),所有指令與設定都**沒有在真實環境執行過**。上架前請由熟悉該領域的人複審。
下列項目是各課撰寫時自己標示「不確定」的地方,建議優先檢查。

## 通用建議
- 在 Ubuntu 22.04 / 24.04 虛擬機照每門課的 lab(實作任務)完整跑一遍,確認指令、輸出與驗收標準。
- 工具版本、映像標籤、軟體庫分支名會過期,上架前核對。
- 互動終端機(模擬器)的輸出格式是仿真,與真實系統可能有細微差異(欄寬、版本字串、時間)。

## 1. Linux 系統管理實戰(`linux-admin`,7 章)
- **SSH 與 `ssh.socket`**:Ubuntu 22.10 起 sshd 改用 socket activation,只改 Port 可能不生效;24.04 是否屬實需實機確認。
- **sshd 設定順序**:「重複項目以第一個值為準」與雲端映像 `50-cloud-init.conf` 覆蓋設定的說法。
- **netplan / firewalld / nmcli / ufw**:`routes: - to: default` 寫法、`netplan try` 倒數、`firewall-cmd --runtime-to-permanent`、rich rule、`ufw --dry-run enable`。
- **ch04 LVM / loop 裝置 lab**:`losetup -P --find --show`、`parted -s … mkpart`、`findmnt --verify`;預期的 `df` 數值(約 280 MB / 680 MB)是估算。
- **ch02 套件**:24.04 軟體庫改用 `ubuntu.sources`(deb822);remove 後 `/etc/nginx/nginx.conf` 是否保留;`dpkg -l` 範例輸出。
- **ch03**:結束代碼 203/EXEC、217/USER、200/CHDIR、start-limit-hit;`systemctl show -p MainPID`。
- **ch06**:Debian `run-parts` 略過含句點的檔名、crontab 的 `%` 需寫 `\%`、`journalctl -u cron`(RHEL 為 `crond`)。
- 課程文字裡縮排的 heredoc(`tee … <<'EOF'`)學員貼上時結束符可能不在行首。

## 2. Linux 伺服器架設實戰(`linux-server`,8 章)
- **ssh.socket / sshd_config.d**:同上;`50-cloud-init.conf`、`ufw allow OpenSSH`、`KbdInteractiveAuthentication` 在 22.04 的可用性。
- **ch03 PHP-FPM**:版本與 socket 路徑(22.04 為 8.1、24.04 為 8.3)、`snippets/fastcgi-php.conf`、`php-fpm8.3 -t`、`a2enconf php8.3-fpm`。
- **ch04 HTTPS**:certbot snap 安裝流程、ufw `Nginx Full` profile、Certbot 產生的 `options-ssl-nginx.conf` / `ssl-dhparams.pem`、RHEL/EPEL 說明。
- **ch05**:`ufw allow from <網段> to any app Samba`、`showmount` 在純 NFSv4 可能查不到、RHEL SELinux 布林值(只寫概念)。
- **ch06 BIND**:`type primary`(9.16 起)、AppArmor 與區域檔路徑、netplan 設定 DNS;lab 步驟 8「不增加 serial 時主伺服器通常仍會載入新內容」這句不夠確定。
- **ch07**:fail2ban `backend = systemd` 預設值、`dnf needs-restarting -r`、`dnf-automatic`。
- **ch08**:Laravel 的 Nginx 設定與 storage 權限、「fastcgi 後不需額外設定信任代理」、備份腳本,建議有 Laravel 經驗的人看。

## 3. 容器管理與應用(`container-practice`,8 章)
- **MariaDB**:`healthcheck.sh --connect --innodb_initialized`、`MARIADB_ROOT_PASSWORD_FILE` / `MARIADB_PASSWORD_FILE` 在 `mariadb:11.4` 是否支援。
- **ch07 ARG 洩漏**:`--build-arg` 的值是否出現在 `docker image history --no-trunc`;BuildKit 實際輸出格式。
- **ch08 OOM 實驗**:`--memory=50m --memory-swap=50m` 配 300MB 的 Python,預期 exit 137 / OOMKilled=true,依主機 cgroup 設定而異。
- **映像標籤**:`mariadb:11.4`、`golang:1.23-alpine`、`adminer:4`、`registry:2`、`node:22-alpine`、`alpine:3.20`、`flask==3.0.3`、`gunicorn==23.0.0` 是否仍存在。
- `docker scout` / `trivy` 只寫了用法;Compose 的 `mem_limit`、`cpus` 在最新規格是否仍建議;PostgreSQL 新版資料目錄掛載路徑(ch04 只文字提醒)。

## 4. Kubernetes 入門到實戰(`kubernetes-practice`,9 章)
- **指令旗標**:`kubectl autoscale --cpu-percent`(新版可能是 `--cpu`)、`kubectl debug --target`、`kubectl create quota --hard`。
- **版本說法**:dockershim 於 1.24 移除、「Ingress API 已凍結、後繼是 Gateway API」。
- **環境細節**:minikube `addons enable ingress` / `tunnel` / `service --url`;kind 需 extraPortMappings 才能直連 NodePort;兩者預設 StorageClass 行為不同。
- **映像標籤**:`nginxinc/nginx-unprivileged:1.26/1.27`、`busybox:1.36/1.37`;Helm lab 用 `helm create` 預設範本的 nginx 標籤。
- **YAML 與 lab 行為**:`defaultMode: 0400` 八進位寫法、`tail /dev/zero` 觸發 OOMKilled、`requests.cpu: "100"` 觸發 Pending、ConfigMap 掛載檔更新時間。
- 所有 YAML 沒用 `kubectl apply --dry-run` / kubeval 實測。

## 5. 嵌入式 Linux 開發實戰(`embedded-linux`,8 章)
- **libgpiod 1.x vs 2.x**:教材以 1.6.x 為主;2.x 的 `gpioset` 預設常駐、`gpioget` 輸出格式、Raspberry Pi 5 的 gpiochip 編號。
- **ch06 gpio-sim**:configfs 操作(`num_lines`、`live`、rmdir 順序),需 Linux 5.17+ 且核心有編譯該模組;不能在 QEMU virt 內做。
- **Yocto**:override 冒號語法、`INIT_MANAGER = "systemd"` 與舊寫法的版本界線、`S = "${WORKDIR}"` 新版改 UNPACKDIR、MIT 授權檔 md5、`debug-tweaks`、分支名 `scarthgap` 要換成發布時的 LTS。
- **Buildroot / U-Boot**:`qemu_aarch64_virt_defconfig`、`raspberrypi4_64_defconfig`、登入帳號、gdbserver menuconfig 路徑;`bootcount` / `altbootcmd` 流程;`-bios u-boot.bin` 範例。
- spidev 的 compatible(新版核心不再接受單純 `"spidev"`);RAUC `system.conf`;platform driver 範例未寫 `.remove`;git tag / branch 是否存在。
- **dd 燒錄 SD 卡**(ch05/07/08)寫錯裝置會毀掉系統碟——整份教材請重點檢查警告與 `lsblk` 比對流程。

## 6. AI 商業落地實戰(`ai-business-60s`,5 章,商學院)
- **法規敘述**(請法務或專業人士看):EP08 個資法與反垃圾郵件原則、EP11 個資法委外與國際傳輸、EP03 肖像權/聲音權與授權、EP05 合約初審的免責定位。皆為原則性提醒,沒引用條文。
- **工具功能**:Midjourney/FLUX、HeyGen/ElevenLabs、Otter/Fathom、Dify、Clay、Perplexity、ChatGPT 進階資料分析(原 Code Interpreter)的名稱與定位是否仍正確。
- **替代方案**:通義聽悟、FastGPT、小紅書、Genspark 已附台灣可用替代,但替代品的可用性未確認。
- EP10 實作設計為「學員自選三個公開市售商品」、不指名真實品牌,請確認符合意圖;範例日期與金額(如 EP08 的 2025/10/1、EP01 的 NT$65)皆為虛構。
- 測驗題難度未校準,建議抽看。

## 互動終端機(模擬器)已知限制
- 不支援 heredoc、`$(…)` 命令替換、`2>` / `2>&1`、`xargs`、vim/nano、互動式 shell、`truncate`。
- 任務檢查(`out`)只比對標準輸出,看不到錯誤訊息;失敗類指令只能用 `ran` 檢查。
- 解答(solution)裡不能放會失敗的指令(驗證器視為錯誤),「看失敗訊息」類任務只能在說明文字提示。
- admin 與 docker 模組同時啟用時 `curl` 會互相覆蓋,docker 要排在 `modules` 最後。
- 核心 `can()` 不看群組權限位元;`ls -l` 群組欄位目前印的是擁有者(admin 模組建議核心改印 `node.group`);沒有符號連結顯示。
- 虛擬時間:kubectl/helm 每個指令前進 10 秒、docker 每個指令前進 2 秒;任務檢查不推進時間,solution 結尾需放一兩個 `get`。
