Task #901
open[T-3] 產生 VS Code 可開啟的 BEAM 工作區
0%
Description
h2. 權威文件
docs/00-governance/OPS-001_GCP環境建置與Redmine遷移_任務書.md
h3. 範圍
交付 @cardcore.code-workspace@（backend／frontend／ops／docs 四根）、@.vscode/settings.json@（JDK21 runtime、format on save、排除 build/）、@extensions.json@、@tasks.json@（build／test／dev／ops up）、@launch.json@（以 env.sh 之 JDK21 啟動單一服務）。
h3. 驗收
@code cardcore.code-workspace@ 四根皆載入¶
Tasks 可執行（至少 @frontend: test@ 與 @backend: compileJava@）¶
不含任何憑證（人工複核）¶
h3. 備註
本項不依賴 GCP，可立即執行。
RA Updated by Redmine Admin about 11 hours ago
h2. T-3 完成：VS Code 工作區（2026-10-25，#A-396）
h3. 交付
| 檔案 | 內容 |
| @cardcore.code-workspace@ | 四根：backend／frontend／ops／docs（皆實測存在） |
| @.vscode/settings.json@ | JDK 21 runtime 明確指定（java.configuration.runtimes／jdt.ls.java.home／import.gradle.java.home）、format on save、watcher/search 排除 @build/@ |
| @.vscode/extensions.json@ | 7 個建議擴充（Java Pack／Gradle／ESLint／Prettier／YAML／Docker／REST Client） |
| @.vscode/tasks.json@ | 11 個任務：env 版本、backend compile/build/test、單一服務 bootRun（@pickString@ 18 服務）、frontend dev/test/typecheck、ops 起基礎設施、部署作業台 API、docs 結構檢查 |
| @.vscode/launch.json@ | jar 啟動（@envFile@ 指 @ops/local/.env@）／遠端附加 5005 |
| @README.md@ | 新增「用 VS Code 開啟（第一次）」三步＋任務表 |
h3. 驗證
- @backend: compileJava@ 等效指令 → exit 0
- @frontend: typecheck@（@tsc --noEmit@）→ 無錯誤
- 5 個 JSON／JSONC 檔全部通過解析
- 無憑證入版控：@ops/local/.env@ 已在 @.gitignore@；@launch.json@ 僅以 @envFile@ 引用
h3. ★ 設計要點
- 必須明確指定 JDK 21：本機系統預設為 Java 8（Legacy ECS 用），不指定會出現「Gradle 說 OK、javac 說 class file version 錯」——本專案今日已踩過一次（12-7 範例）。
- 所有 task 都先 @source ops/local/env.sh@，避免使用者環境不對時誤判程式問題。
h3. 備註
T-3 不依賴 GCP，故先行完成；T-1／T-2 仍待憑證（見 OPS-001 憑證需求）。