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
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@

目前部署來源:`frobel0520/software-engineering-workshop`。

> 開發狀態:Core/Extension 功能開發已完成,現在進入測試/驗收階段;除測試發現的問題外,不再新增功能。
> 自動化基線(2026-08-23):84 個測試檔/279 個測試、TypeScript lint、production build 與 Pages build 均通過。

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

## Git 單元
Expand Down
22 changes: 12 additions & 10 deletions docs/project-plan.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Software Engineering Workshop:專案計畫

> 狀態:Active
> 日期:2026-08-16
> 基線:`dev`(route guard 與目前 ready topics 已合併)
> 狀態:開發完成;測試/驗收進行中
> 日期:2026-08-23
> 基線:`dev`(Core 19/19、Extension 2 個與 CORE-008 已合併)

## 1. 專案目標

Expand All @@ -21,6 +21,8 @@
- Core 已開放:Git、GitHub/GitLab 遠端協作、命令列、IDE/除錯器、套件管理、環境變數、建置工具、REST API/FastAPI、身分驗證與授權、SQL、資料庫設計、索引與交易、PostgreSQL、單元測試、整合測試、日誌、Docker、CI/CD、部署,共 19 / 19
- Git v1 release gate:已完成 cowork/pipeline、keyboard、mobile、200% zoom 與 reduced-motion 驗收,`GIT-REVIEW` 已於 2026-08-16 通過。
- Extension 已開放:Guardrails、問題處理方法,共 2 個;不計入 Core 19 的完成分母
- 開發進度:M0~M6、CORE-001~CORE-008 與所有 topic task 已完成;目前不新增功能,進入測試/驗收階段
- 自動化基線:84 個測試檔/279 個測試、TypeScript lint、production build 與 Pages build 均通過
- 學習者完成數:依瀏覽器 `localStorage` 個別計算,不在專案文件中固定寫死
- 前端:Vite + React + TypeScript,靜態站點
- 持久化:瀏覽器 `localStorage`
Expand Down Expand Up @@ -105,17 +107,17 @@

### Phase 3:品質與可觀測性

- 單元測試
- 整合測試
- 日誌
- 單元測試(已完成)
- 整合測試(已完成)
- 日誌(已完成)

### Phase 4:交付與部署

- Docker 基礎
- CI/CD
- 部署
- Docker 基礎(已完成)
- CI/CD(已完成)
- 部署(已完成)

CI、GitHub Pages 與 branch protection 已是專案交付基礎;對應的 CI/CD/部署教材仍需另外製作,不因基礎設施已存在而自動標記完成
CI、GitHub Pages 與 branch protection 已是專案交付基礎;對應的 CI/CD/部署教材也已完成,目前進入測試/驗收階段

## 7. 專案交付物

Expand Down
8 changes: 7 additions & 1 deletion docs/release-audit.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,13 @@ Core 19 個 topic 全部為 `ready`,Extension 2 個 topic 維持獨立完成

- README、project plan、project SA、project SD、task breakdown、accessibility checklist、acceptance contracts 與本 audit 對齊 19/19。
- M5 Delivery 與 M6 Hardening/Release 均標記 done。
- `CORE-008` 維持非阻塞 architecture follow-up,不阻擋本 release。
- `CORE-008` 已由 PR #106 合併至 `dev`;App registry-driven dispatcher 已完成。

## DEV-008:開發收尾與測試基線

- CORE-008 PR #106 已合併至 `dev`,本機 `dev` 與 `origin/dev` 已同步,feature branch 已清理。
- 最新自動化基線:84 個測試檔/279 個測試、TypeScript lint、production build 與 Pages build 均通過。
- 目前專案階段:開發完成,進入測試/驗收;除測試發現的問題外不再新增功能。

## Known follow-up

Expand Down
6 changes: 4 additions & 2 deletions docs/task-breakdown.md
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,8 @@ M6 的 task 依賴分成兩層:`RELEASE-001`、`RELEASE-002`、`RELEASE-003`

本輪不直接建立 GitHub Milestones/Issues;先讓 task 顆粒度與 Milestone 邊界被確認,避免把錯誤拆分同步到遠端。

## 15. 目前下一個可開工 task
## 15. 目前專案狀態

目前 19 / 19 Core topic 已 ready,M1、M2、M3、M4、M5、M6 與 `CORE-008` 已完成;release PR #90 與 final documentation closeout PR #92 已合併至 `main`,GitHub Pages publish workflow #16/#17 與 live site smoke check 均通過。本專案目前沒有 canonical backlog task。
目前 19 / 19 Core topic 已 ready,M1、M2、M3、M4、M5、M6 與 `CORE-008` 已完成;release PR #90 與 final documentation closeout PR #92 已合併至 `main`,CORE-008 PR #106 已合併至 `dev`,GitHub Pages publish workflow #16/#17 與 live site smoke check 均通過。本專案目前沒有 canonical backlog task。

目前階段是測試/驗收:自動化基線為 84 個測試檔/279 個測試,另已通過 TypeScript lint、production build 與 Pages build。後續只處理測試發現的問題,不新增未排定功能。
Loading