feat: 完成 A 群組 — 專案骨架與可重啟的服務

- packages/shared:TypeScript 專案參考建置鏈路、統一日誌模組(Asia/Taipei 格式)
- apps/api:最小 NestJS 服務,GET /health
- apps/web:最小 Next.js(App Router + Tailwind v4)首頁,套用品牌色票與亮暗模式
- scripts/dev-restart.mjs:讀 .dev-pids 以 process group 訊號安全停止舊行程、背景啟動 api/web 並輪詢健康檢查
- scripts/smoke:npm run smoke -- <群組代號> 冒煙測試框架,A 群組測試涵蓋 /health 與首頁內容
- 本機 port 3000 被既有服務佔用,web 開發埠改為 3100(已記錄於 todo.md)

npm run restart && npm run smoke -- A 皆通過(A-V)。
This commit is contained in:
Jeffery
2026-08-13 09:18:40 +08:00
parent 80b1383406
commit ae9c44dde7
29 changed files with 8991 additions and 8 deletions
+64
View File
@@ -0,0 +1,64 @@
#!/usr/bin/env node
import path from "node:path";
import { readdir } from "node:fs/promises";
import { existsSync } from "node:fs";
import { fileURLToPath, pathToFileURL } from "node:url";
import { log } from "../../packages/shared/dist/index.js";
const SMOKE_DIR = path.dirname(fileURLToPath(import.meta.url));
async function listGroupFiles() {
const files = await readdir(SMOKE_DIR);
return files.filter((f) => f.endsWith(".mjs") && f !== "run.mjs").sort();
}
async function runOne(file) {
const group = file.replace(/\.mjs$/, "");
const modUrl = pathToFileURL(path.join(SMOKE_DIR, file)).href;
log("冒煙測試", "INF", `開始執行 ${group} 群組冒煙測試`);
try {
const mod = await import(modUrl);
if (typeof mod.default !== "function") {
throw new Error(`${file} 未匯出預設測試函式`);
}
await mod.default();
log("冒煙測試", "INF", `${group} 群組冒煙測試全綠`);
return true;
} catch (err) {
log("冒煙測試", "ERR", `${group} 群組冒煙測試失敗:${err.message}`);
return false;
}
}
async function main() {
const arg = process.argv[2];
if (!arg) {
log("冒煙測試", "ERR", "請指定群組代號,例如:npm run smoke -- A(或 all 執行全部群組)");
process.exit(1);
}
let files;
if (arg === "all") {
files = await listGroupFiles();
if (files.length === 0) {
log("冒煙測試", "WRN", "尚無任何冒煙測試檔案");
}
} else {
const file = `${arg}.mjs`;
if (!existsSync(path.join(SMOKE_DIR, file))) {
log("冒煙測試", "ERR", `找不到群組 ${arg} 的冒煙測試檔案(scripts/smoke/${file})`);
process.exit(1);
}
files = [file];
}
let allOk = true;
for (const file of files) {
const ok = await runOne(file);
allOk = allOk && ok;
}
process.exit(allOk ? 0 : 1);
}
main();