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）。

apps/api/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@kokorone/api",
+  "version": "0.1.0",
+  "private": true,
+  "description": "心音後端服務（NestJS）",
+  "main": "dist/main.js",
+  "scripts": {
+    "build": "tsc -b",
+    "start": "node dist/main.js"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.29",
+    "@nestjs/core": "^11.1.29",
+    "@nestjs/platform-express": "^11.1.29",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  }
+}

apps/api/src/app.module.ts

@@ -0,0 +1,7 @@
+import { Module } from "@nestjs/common";
+import { HealthController } from "./health/health.controller.js";
+
+@Module({
+  controllers: [HealthController],
+})
+export class AppModule {}

apps/api/src/health/health.controller.ts

@@ -0,0 +1,15 @@
+import { Controller, Get } from "@nestjs/common";
+
+const START_TIME = Date.now();
+
+@Controller("health")
+export class HealthController {
+  @Get()
+  check() {
+    return {
+      status: "ok",
+      version: process.env.npm_package_version ?? "0.1.0",
+      uptime: Math.floor((Date.now() - START_TIME) / 1000),
+    };
+  }
+}

apps/api/src/main.ts

@@ -0,0 +1,13 @@
+import "reflect-metadata";
+import { NestFactory } from "@nestjs/core";
+import { log } from "@kokorone/shared";
+import { AppModule } from "./app.module.js";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, { logger: false });
+  const port = Number(process.env.PORT ?? 3001);
+  await app.listen(port);
+  log("啟動", "INF", `api 服務已啟動，監聽埠 ${port}`);
+}
+
+bootstrap();

apps/api/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["src"],
+  "references": [{ "path": "../../packages/shared" }]
+}