Skip to content
Merged
Show file tree
Hide file tree
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
44 changes: 28 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Software Engineering Workshop

一個可以動手操作、也可以逐章擴充的軟體工程教材站。
> 一個可以動手操作、也可以逐章擴充的軟體工程教材站。

## 概覽

網站:https://frobel0520.github.io/software-engineering-workshop/ (部署來源:`frobel0520/software-engineering-workshop`)

Expand All @@ -12,21 +14,7 @@

目前可操作的 Core 主題有 19 / 19 個:**Git**、**GitHub/GitLab 遠端協作**、**命令列**、**IDE/除錯器**、**套件管理**、**環境變數**、**建置工具**、**REST API/FastAPI**、**身分驗證/授權**、**SQL**、**資料庫設計**、**索引與交易**、**PostgreSQL**、**單元測試**、**整合測試**、**日誌**、**Docker 基礎**、**CI/CD**、**部署**;另有 2 個不計入 Core 進度的 Extension:**Guardrails**、**問題處理方法**。Core 19 個主題全部開放。

## Git 單元

- Git Lesson:涵蓋 `clone`、`add`、`commit`、`push`、`pull`、`fetch`、`checkout`、`rebase`、`stash`、`cherry-pick`、`merge` 與 GitHub/GitLab `fork`。
- 指令式 cowork Lab:親自走過 local history → remote branch → PR/MR → pipeline → merge。
- Pipeline fixture:顯示 `checkout`、`npm ci`、`test`、`lint`、`build` jobs 與 conflict/retry 情境。
- 確定性的瀏覽器模擬引擎,不會動到使用者電腦上的真實 repository。
- 進度保存在瀏覽器;每個已開放主題完成 Lab 後,才會標記該主題完成。

## Auth 單元

- Entra ID、OIDC、SSO 與七個 App Registration 設定值。
- 假資料驅動的設定判斷與 Authorization Code + PKCE 流程 Demo。
- 不連線 Microsoft、不處理真實帳號或 Secret。

## 其他已開放主題
## 主要功能/內容

- 遠端協作:模擬 `branch → commit → fetch → rebase → push → PR → CI → merge` 閉環。
- 命令列:在固定 fixture 中練習工作目錄、檔案讀取、搜尋與檢查流程。
Expand All @@ -43,6 +31,30 @@
- Guardrails Extension:模擬輸入、輸出與工具呼叫的安全防線,不連線真實模型。
- 問題處理 Extension:從問題定義、重現、蒐證、假設、錯誤邊界到驗證與預防復發。

## 現況與已知限制

Core/Extension 功能開發已完成,現處測試與驗收階段。原 README 記錄 2026-08-23 的自動化基線;本次未重跑測試。

## 授權與來源

Repository 根目錄未見授權檔;此 README 不另行宣告使用或再散布權利。

---

## Git 單元

- Git Lesson:涵蓋 `clone`、`add`、`commit`、`push`、`pull`、`fetch`、`checkout`、`rebase`、`stash`、`cherry-pick`、`merge` 與 GitHub/GitLab `fork`。
- 指令式 cowork Lab:親自走過 local history → remote branch → PR/MR → pipeline → merge。
- Pipeline fixture:顯示 `checkout`、`npm ci`、`test`、`lint`、`build` jobs 與 conflict/retry 情境。
- 確定性的瀏覽器模擬引擎,不會動到使用者電腦上的真實 repository。
- 進度保存在瀏覽器;每個已開放主題完成 Lab 後,才會標記該主題完成。

## Auth 單元

- Entra ID、OIDC、SSO 與七個 App Registration 設定值。
- 假資料驅動的設定判斷與 Authorization Code + PKCE 流程 Demo。
- 不連線 Microsoft、不處理真實帳號或 Secret。

## 本機啟動

```bash
Expand Down
2 changes: 1 addition & 1 deletion docs/guardrail-rebuild-feature-brief.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

> 狀態:Implemented v1
> 日期:2026-08-16
> 參考來源:`C:\Users\ytwei\Projects\Guardrail-Workshop`
> 參考來源:[guardrail-workshop](https://github.com/frobel0520/guardrail-workshop)
> 依附架構:`docs/project-sa.md`、`docs/project-sd.md`

## 1. 定位
Expand Down
Loading