agentic-dev 0.2.3 → 0.2.4

package/.claude/CLAUDE.md

@@ -19,7 +19,7 @@ templates/
 │   └── skills/      # Claude Code repo-local skills (.claude/skills/<name>/SKILL.md)
 ├── .codex/          # Codex 설정, 에이전트, 스킬
 ├── client/
-│   ├── platform/    # 일반 앱 템플릿
+│   ├── web/    # 일반 앱 템플릿
 │   ├── admin/       # 어드민 템플릿
 │   ├── mobile/      # 현장형 모바일 템플릿
 │   └── landing/     # 랜딩 템플릿

package/.env.example

@@ -1,6 +1,6 @@
 SERVER_HTTP_PORT=8000
 CLIENT_LANDING_PORT=3000
-CLIENT_PLATFORM_PORT=3001
+CLIENT_WEB_PORT=3001
 CLIENT_MOBILE_PORT=3002
 CLIENT_ADMIN_PORT=4000
 
@@ -44,7 +44,7 @@ SERVER_BOOTSTRAP_OPERATOR_NAME=Template Operator
 SERVER_CORS_ORIGINS=["http://localhost:3000","http://127.0.0.1:3000","http://localhost:3001","http://127.0.0.1:3001","http://localhost:3002","http://127.0.0.1:3002","http://localhost:4000","http://127.0.0.1:4000"]
 
 CLIENT_LANDING_VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
-CLIENT_PLATFORM_VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
+CLIENT_WEB_VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
 CLIENT_MOBILE_VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
 CLIENT_ADMIN_VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1
 CLIENT_WATCH_USE_POLLING=false

package/README.md

@@ -5,7 +5,7 @@
 포함 템플릿:
 
 - [landing](./client/landing): 마케팅/브랜드 랜딩 패턴
-- [platform](./client/platform): 일반 제품형 플랫폼 앱 shell, dashboard/list/detail 패턴
+- [web](./client/web): 일반 제품형 웹 앱 shell, dashboard/list/detail 패턴
 - [mobile](./client/mobile): 다국어/현장 업무형 모바일 IN workspace 패턴
 - [admin](./client/admin): 운영 콘솔형 shell, sidebar/topbar/drawer/table 패턴
 - [server](./server): HTTP 기반 hexagonal/DDD 서버 패턴
@@ -17,7 +17,7 @@
 - 제품 DOM은 유지하고, 스타일 조정값은 `theme.ts` + CSS custom properties로 노출
 - proof/spec 전용 DOM 복제 대신 fixture data + parameter surface로 정렬
 - `server`는 hexagonal architecture 기준으로 `contracts + application + domain + infrastructure`를 사용
-- `landing`, `platform`, `mobile`, `admin`은 실제 `/api/v1/auth/login`과 `/api/v1/auth/me`를 사용하는 기준 템플릿이다.
+- `landing`, `web`, `mobile`, `admin`은 실제 `/api/v1/auth/login`과 `/api/v1/auth/me`를 사용하는 기준 템플릿이다.
 - runtime baseline은 루트 `compose.yml`을 기준으로 유지하고, 여기서 4개 frontend surface, `server`, 기본 `postgres`, optional DB profile을 함께 올린다.
 - agentic baseline은 `.claude`, `.codex`, `.agent`를 함께 유지하고 downstream repo가 role agent, skill alias, Ralph harness를 그대로 가져가도록 설계한다.
 - `sdd/03_build`는 단순 구현 목록이 아니라 실제 runtime assembly를 따라 읽는 AST-style current-state 설명을 기준으로 유지한다.
@@ -42,12 +42,12 @@ SDD / delivery 원칙:
 설치형 scaffold:
 
 ```bash
-npx agentic-dev init my-app --template platform
+npx agentic-dev init my-app --template web
 cd my-app
 cp .env.example .env
 npm install -g pnpm
 pnpm install
-cd client/platform
+cd client/web
 npm run ui:parity:bootstrap
 ```
 
@@ -74,7 +74,7 @@ docker compose up --build
 기본 compose 포트:
 
 - `client/landing`: `3000`
-- `client/platform`: `3001`
+- `client/web`: `3001`
 - `client/mobile`: `3002`
 - `client/admin`: `4000`
 - `server/http`: `8000`

package/client/{platform → web}/Dockerfile

@@ -3,13 +3,13 @@ FROM node:20-slim
 WORKDIR /app
 
 COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY client/platform/package.json ./client/platform/package.json
+COPY client/web/package.json ./client/web/package.json
 
-RUN npm install -g pnpm@10.32.0 && pnpm install --filter @do4ai/client-platform-template...
+RUN npm install -g pnpm@10.32.0 && pnpm install --filter @do4ai/client-web-template...
 
 COPY . .
 
-WORKDIR /app/client/platform
+WORKDIR /app/client/web
 
 EXPOSE 3001
 

package/client/web/Dockerfile.dev

@@ -0,0 +1,18 @@
+FROM node:20-slim
+
+WORKDIR /app
+
+RUN npm install -g pnpm@10.32.0
+
+COPY pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY client/web/package.json ./client/web/package.json
+
+RUN pnpm install --frozen-lockfile --filter @do4ai/client-web-template...
+
+COPY client/web ./client/web
+
+WORKDIR /app/client/web
+
+EXPOSE 3001
+
+CMD ["sh", "-lc", "pnpm exec vite --host 0.0.0.0 --port ${PORT:-3001}"]

package/client/{platform → web}/README.md

@@ -1,4 +1,4 @@
-# platform
+# web
 
 일반 사용자용 제품 앱 보일러플레이트다.
 
@@ -25,7 +25,7 @@ npm run dev
 npm run ui:parity:init
 ```
 
-이 단계는 repo-level contract, `ui_parity_platform_contract.yaml`, route-gap manifest를 생성한다.
+이 단계는 repo-level contract, `ui_parity_web_contract.yaml`, route-gap manifest를 생성한다.
 
 첫 proof 부트스트랩:
 
@@ -44,4 +44,4 @@ npm run ui:parity:route-gap
 npm run ui:parity:proof
 ```
 
-이 템플릿은 repo root의 `sdd/99_toolchain/01_automation` 도구를 사용하고, `client/platform/scripts/ui-parity-platform-adapter.mjs`는 앱별 adapter 예시다.
+이 템플릿은 repo root의 `sdd/99_toolchain/01_automation` 도구를 사용하고, `client/web/scripts/ui-parity-web-adapter.mjs`는 앱별 adapter 예시다.

package/client/{platform → web}/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>client-platform template</title>
+    <title>client-web template</title>
   </head>
   <body>
     <div id="root"></div>

package/client/{platform → web}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@do4ai/client-platform-template",
+  "name": "@do4ai/client-web-template",
   "private": true,
   "version": "0.1.0",
   "type": "module",
@@ -8,12 +8,12 @@
     "dev": "vite --host 0.0.0.0 --port 3001",
     "build": "tsc -b && vite build",
     "preview": "vite preview --host 0.0.0.0 --port 4301",
-    "ui:parity:init": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh ../.. platform",
-    "ui:parity:bootstrap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh ../.. platform",
-    "ui:parity:scaffold": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh scaffold ../.. platform",
-    "ui:parity:materialize-references": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh materialize_references ../.. platform",
-    "ui:parity:route-gap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap ../.. platform",
-    "ui:parity:proof": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof ../.. platform",
+    "ui:parity:init": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh ../.. web",
+    "ui:parity:bootstrap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh ../.. web",
+    "ui:parity:scaffold": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh scaffold ../.. web",
+    "ui:parity:materialize-references": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh materialize_references ../.. web",
+    "ui:parity:route-gap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap ../.. web",
+    "ui:parity:proof": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof ../.. web",
     "ui:parity": "npm run ui:parity:proof"
   },
   "dependencies": {

package/client/{platform/scripts/ui-parity-platform-adapter.mjs → web/scripts/ui-parity-web-adapter.mjs}

@@ -13,7 +13,7 @@ const routes = JSON.parse(
 const routeMap = new Map(routes.map((entry) => [entry.id, entry.route]));
 
 export default {
-  service: "templates-platform",
+  service: "templates-web",
   targetBaseUrl: "http://127.0.0.1:4301",
   viewport: {
     width: 1440,
@@ -26,7 +26,7 @@ export default {
     referenceImage: `sdd/04_verify/10_test/ui_parity/reference/${screen.id}.png`,
     readySelector: "body",
     readyTimeoutMs: 10000,
-    tags: ["template", "platform"],
+    tags: ["template", "web"],
   })),
   async preparePage(page, { route }) {
     await page.route("**/auth/me", async (routeRequest) => {
@@ -34,8 +34,8 @@ export default {
         status: 200,
         contentType: "application/json",
         body: JSON.stringify({
-          id: "tmpl-platform",
-          name: "Template Platform User",
+          id: "tmpl-web",
+          name: "Template Web User",
           email: "operator@example.com",
           role: "member",
         }),
@@ -43,17 +43,17 @@ export default {
     });
     await page.addInitScript(() => {
       window.localStorage.setItem(
-        "platform.auth.token",
+        "web.auth.token",
         JSON.stringify({
           access_token: "template-access-token",
           token_type: "bearer",
-          user_id: "tmpl-platform",
+          user_id: "tmpl-web",
         }),
       );
     });
     if (route === "/login") {
       await page.addInitScript(() => {
-        window.localStorage.removeItem("platform.auth.token");
+        window.localStorage.removeItem("web.auth.token");
       });
     }
   },

package/client/{platform → web}/src/auth/AuthProvider.tsx

@@ -3,7 +3,7 @@ import { createContext, useContext, useEffect, useMemo, useState, type ReactNode
 import { getMe, login as loginRequest } from "@/auth/auth-client";
 import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
 
-const STORAGE_KEY = "platform.auth.token";
+const STORAGE_KEY = "web.auth.token";
 
 interface AuthContextValue {
   user: AuthUser | null;

package/compose.yml

@@ -138,19 +138,19 @@ services:
     networks:
       - template-dev
 
-  client-platform:
+  client-web:
     build:
       context: .
-      dockerfile: client/platform/Dockerfile.dev
+      dockerfile: client/web/Dockerfile.dev
       network: host
     environment:
-      PORT: ${CLIENT_PLATFORM_PORT:-3001}
-      VITE_API_BASE_URL: ${CLIENT_PLATFORM_VITE_API_BASE_URL:-http://127.0.0.1:8000/api/v1}
+      PORT: ${CLIENT_WEB_PORT:-3001}
+      VITE_API_BASE_URL: ${CLIENT_WEB_VITE_API_BASE_URL:-http://127.0.0.1:8000/api/v1}
       CHOKIDAR_USEPOLLING: ${CLIENT_WATCH_USE_POLLING:-false}
     ports:
-      - "${CLIENT_PLATFORM_PORT:-3001}:${CLIENT_PLATFORM_PORT:-3001}"
+      - "${CLIENT_WEB_PORT:-3001}:${CLIENT_WEB_PORT:-3001}"
     volumes:
-      - ./client/platform:/app/client/platform
+      - ./client/web:/app/client/web
     depends_on:
       server:
         condition: service_started

package/infra/compose/.env.dev.example

@@ -15,14 +15,14 @@ DEV_SERVER_MONGODB_URL=mongodb://mongo:27017
 DEV_SERVER_MONGODB_DATABASE=template
 DEV_SERVER_JWT_SECRET=change-me
 DEV_SERVER_ACCESS_TOKEN_TTL_MINUTES=120
-DEV_SERVER_CORS_ORIGINS=https://dev-landing.example.com,https://dev-platform.example.com,https://dev-mobile.example.com,https://dev-admin.example.com
+DEV_SERVER_CORS_ORIGINS=https://dev-landing.example.com,https://dev-web.example.com,https://dev-mobile.example.com,https://dev-admin.example.com
 
 DEV_CLIENT_LANDING_PORT=13000
-DEV_CLIENT_PLATFORM_PORT=13001
+DEV_CLIENT_WEB_PORT=13001
 DEV_CLIENT_MOBILE_PORT=13002
 DEV_CLIENT_ADMIN_PORT=14000
 
 DEV_CLIENT_LANDING_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
-DEV_CLIENT_PLATFORM_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
+DEV_CLIENT_WEB_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
 DEV_CLIENT_MOBILE_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
 DEV_CLIENT_ADMIN_VITE_API_BASE_URL=https://dev-api.example.com/api/v1

package/infra/compose/.env.prod.example

@@ -16,14 +16,14 @@ PROD_SERVER_MONGODB_URL=mongodb://mongo:27017
 PROD_SERVER_MONGODB_DATABASE=template
 PROD_SERVER_JWT_SECRET=change-me
 PROD_SERVER_ACCESS_TOKEN_TTL_MINUTES=120
-PROD_SERVER_CORS_ORIGINS=https://landing.example.com,https://platform.example.com,https://mobile.example.com,https://admin.example.com
+PROD_SERVER_CORS_ORIGINS=https://landing.example.com,https://web.example.com,https://mobile.example.com,https://admin.example.com
 
 PROD_CLIENT_LANDING_PORT=23000
-PROD_CLIENT_PLATFORM_PORT=23001
+PROD_CLIENT_WEB_PORT=23001
 PROD_CLIENT_MOBILE_PORT=23002
 PROD_CLIENT_ADMIN_PORT=24000
 
 PROD_CLIENT_LANDING_VITE_API_BASE_URL=https://api.example.com/api/v1
-PROD_CLIENT_PLATFORM_VITE_API_BASE_URL=https://api.example.com/api/v1
+PROD_CLIENT_WEB_VITE_API_BASE_URL=https://api.example.com/api/v1
 PROD_CLIENT_MOBILE_VITE_API_BASE_URL=https://api.example.com/api/v1
 PROD_CLIENT_ADMIN_VITE_API_BASE_URL=https://api.example.com/api/v1

package/infra/compose/README.md

@@ -30,6 +30,6 @@ docker compose --env-file infra/compose/.env.prod -f infra/compose/prod.yml up -
 - `infra/compose/dev.yml`, `infra/compose/prod.yml`은 dedicated host/runtime split이 필요할 때 쓰는 overlay이며, root compose baseline을 대체하는 문서 기준선은 아니다.
 - provider-first canonical delivery split은 `AWS edge/domain -> OpenStack backend compute -> AWS data plane`이고, 세부 구조는 `infra/terraform/README.md`를 기준으로 설명한다.
 - `VITE_API_BASE_URL`은 컨테이너 내부 DNS가 아니라 브라우저가 도달 가능한 API URL이어야 한다.
-- 포트 역할은 root compose baseline과 같은 순서를 따른다: landing, platform, mobile, admin, server/http.
+- 포트 역할은 root compose baseline과 같은 순서를 따른다: landing, web, mobile, admin, server/http.
 - PROD 웹 앱은 `pnpm build + pnpm preview`로 기동한다.
 - OpenStack에서 자동 배포까지 묶고 싶으면 `infra/terraform/openstack/server` 또는 lower-level `openstack/dev`, `openstack/prod` root를 사용한다.

package/infra/compose/dev.yml

@@ -65,20 +65,20 @@ services:
     networks:
       - templates-dev
 
-  client-platform:
+  client-web:
     build:
       context: ../..
-      dockerfile: client/platform/Dockerfile
-    container_name: templates-client-platform-dev
+      dockerfile: client/web/Dockerfile
+    container_name: templates-client-web-dev
     restart: unless-stopped
     depends_on:
       server:
         condition: service_started
     environment:
-      VITE_API_BASE_URL: ${DEV_CLIENT_PLATFORM_VITE_API_BASE_URL}
+      VITE_API_BASE_URL: ${DEV_CLIENT_WEB_VITE_API_BASE_URL}
       PORT: 3001
     ports:
-      - "${DEV_CLIENT_PLATFORM_PORT:-13001}:3001"
+      - "${DEV_CLIENT_WEB_PORT:-13001}:3001"
     networks:
       - templates-dev
 

package/infra/compose/prod.yml

@@ -43,7 +43,7 @@ services:
       MONGODB_DATABASE: ${PROD_SERVER_MONGODB_DATABASE:-template}
       JWT_SECRET: ${PROD_SERVER_JWT_SECRET:-change-me}
       ACCESS_TOKEN_TTL_MINUTES: ${PROD_SERVER_ACCESS_TOKEN_TTL_MINUTES:-120}
-      CORS_ORIGINS: ${PROD_SERVER_CORS_ORIGINS:-https://landing.example.com,https://platform.example.com,https://mobile.example.com,https://admin.example.com}
+      CORS_ORIGINS: ${PROD_SERVER_CORS_ORIGINS:-https://landing.example.com,https://web.example.com,https://mobile.example.com,https://admin.example.com}
     ports:
       - "${PROD_SERVER_HTTP_PORT:-28000}:8000"
     networks:
@@ -66,20 +66,20 @@ services:
     networks:
       - templates-prod
 
-  client-platform:
+  client-web:
     build:
       context: ../..
-      dockerfile: client/platform/Dockerfile
-    container_name: templates-client-platform-prod
+      dockerfile: client/web/Dockerfile
+    container_name: templates-client-web-prod
     restart: unless-stopped
     depends_on:
       server:
         condition: service_started
     command: ["sh", "-lc", "pnpm build && pnpm preview --host 0.0.0.0 --port 4301"]
     environment:
-      VITE_API_BASE_URL: ${PROD_CLIENT_PLATFORM_VITE_API_BASE_URL}
+      VITE_API_BASE_URL: ${PROD_CLIENT_WEB_VITE_API_BASE_URL}
     ports:
-      - "${PROD_CLIENT_PLATFORM_PORT:-23001}:4301"
+      - "${PROD_CLIENT_WEB_PORT:-23001}:4301"
     networks:
       - templates-prod
 

package/infra/terraform/openstack/dev/terraform.tfvars.example

@@ -42,13 +42,13 @@ compose_env_content = <<-ENV
   DEV_SERVER_POSTGRES_URL=postgresql+psycopg://template:template@postgres:5432/template
   DEV_SERVER_JWT_SECRET=change-me
   DEV_SERVER_ACCESS_TOKEN_TTL_MINUTES=120
-  DEV_SERVER_CORS_ORIGINS=https://dev-landing.example.com,https://dev-platform.example.com,https://dev-mobile.example.com,https://dev-admin.example.com
+  DEV_SERVER_CORS_ORIGINS=https://dev-landing.example.com,https://dev-web.example.com,https://dev-mobile.example.com,https://dev-admin.example.com
   DEV_CLIENT_LANDING_PORT=13000
-  DEV_CLIENT_PLATFORM_PORT=13001
+  DEV_CLIENT_WEB_PORT=13001
   DEV_CLIENT_MOBILE_PORT=13002
   DEV_CLIENT_ADMIN_PORT=14000
   DEV_CLIENT_LANDING_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
-  DEV_CLIENT_PLATFORM_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
+  DEV_CLIENT_WEB_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
   DEV_CLIENT_MOBILE_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
   DEV_CLIENT_ADMIN_VITE_API_BASE_URL=https://dev-api.example.com/api/v1
 ENV

package/infra/terraform/openstack/prod/terraform.tfvars.example

@@ -43,13 +43,13 @@ compose_env_content = <<-ENV
   PROD_SERVER_POSTGRES_URL=postgresql+psycopg://template:template@postgres:5432/template
   PROD_SERVER_JWT_SECRET=change-me
   PROD_SERVER_ACCESS_TOKEN_TTL_MINUTES=120
-  PROD_SERVER_CORS_ORIGINS=https://landing.example.com,https://platform.example.com,https://mobile.example.com,https://admin.example.com
+  PROD_SERVER_CORS_ORIGINS=https://landing.example.com,https://web.example.com,https://mobile.example.com,https://admin.example.com
   PROD_CLIENT_LANDING_PORT=23000
-  PROD_CLIENT_PLATFORM_PORT=23001
+  PROD_CLIENT_WEB_PORT=23001
   PROD_CLIENT_MOBILE_PORT=23002
   PROD_CLIENT_ADMIN_PORT=24000
   PROD_CLIENT_LANDING_VITE_API_BASE_URL=https://api.example.com/api/v1
-  PROD_CLIENT_PLATFORM_VITE_API_BASE_URL=https://api.example.com/api/v1
+  PROD_CLIENT_WEB_VITE_API_BASE_URL=https://api.example.com/api/v1
   PROD_CLIENT_MOBILE_VITE_API_BASE_URL=https://api.example.com/api/v1
   PROD_CLIENT_ADMIN_VITE_API_BASE_URL=https://api.example.com/api/v1
 ENV

package/lib/scaffold.mjs

@@ -11,11 +11,11 @@ export const TEMPLATE_CONFIG = {
     composeApiVar: "CLIENT_LANDING_VITE_API_BASE_URL",
     defaultPort: 3000,
   },
-  platform: {
-    id: "platform",
-    serviceName: "client-platform",
-    composePortVar: "CLIENT_PLATFORM_PORT",
-    composeApiVar: "CLIENT_PLATFORM_VITE_API_BASE_URL",
+  web: {
+    id: "web",
+    serviceName: "client-web",
+    composePortVar: "CLIENT_WEB_PORT",
+    composeApiVar: "CLIENT_WEB_VITE_API_BASE_URL",
     defaultPort: 3001,
   },
   mobile: {
@@ -112,10 +112,10 @@ export function parseArgs(argv) {
 export function usage() {
   return [
     "Usage:",
-    "  agentic-dev init <target-dir> --template <landing|platform|mobile|admin>",
+    "  agentic-dev init <target-dir> --template <landing|web|mobile|admin>",
     "",
     "Examples:",
-    "  npx agentic-dev init my-app --template platform",
+    "  npx agentic-dev init my-app --template web",
     "  npx agentic-dev my-app --template mobile",
     "",
     "Options:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-dev",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Scaffold an agentic template repo with the selected frontend surface and shared toolchain assets.",
   "type": "module",
   "packageManager": "pnpm@10.32.0",
@@ -28,7 +28,7 @@
     "pnpm-workspace.yaml"
   ],
   "scripts": {
-    "smoke:init": "node ./bin/agentic-dev.mjs init ./.tmp-agentic-smoke --template platform --yes --force"
+    "smoke:init": "node ./bin/agentic-dev.mjs init ./.tmp-agentic-smoke --template web --yes --force"
   },
   "keywords": [
     "agentic",

package/scripts/dev/audit_sdd_build_ast.py

@@ -12,7 +12,7 @@ ROOT = Path(__file__).resolve().parents[2]
 
 SERVICE_DOCS = {
     "mobile": ROOT / "sdd/03_build/01_feature/service/mobile_surface.md",
-    "platform": ROOT / "sdd/03_build/01_feature/service/platform_surface.md",
+    "web": ROOT / "sdd/03_build/01_feature/service/web_surface.md",
     "admin": ROOT / "sdd/03_build/01_feature/service/admin_surface.md",
     "landing": ROOT / "sdd/03_build/01_feature/service/landing_surface.md",
 }
@@ -59,14 +59,14 @@ def ast_similarity() -> tuple[int, list[str]]:
     else:
         findings.append("mobile surface summary does not reflect the real provider/router/shell chain.")
 
-    platform = read(SERVICE_DOCS["platform"])
+    web = read(SERVICE_DOCS["web"])
     if contains_all(
-        platform,
+        web,
         [
-            "client/platform/src/main.tsx",
+            "client/web/src/main.tsx",
             "AuthProvider",
             "BrowserRouter",
-            "client/platform/src/app/App.tsx",
+            "client/web/src/app/App.tsx",
             "ProtectedRoute",
             "AppShell",
             "DashboardPage",
@@ -75,7 +75,7 @@ def ast_similarity() -> tuple[int, list[str]]:
     ):
         points += 2.5
     else:
-        findings.append("platform surface summary does not reflect the real app shell route tree.")
+        findings.append("web surface summary does not reflect the real app shell route tree.")
 
     admin = read(SERVICE_DOCS["admin"])
     if contains_all(
@@ -139,9 +139,9 @@ def implementation_traceability() -> tuple[int, list[str]]:
     else:
         findings.append("mobile surface summary does not trace route leaves to backend contract leaves.")
 
-    platform = read(SERVICE_DOCS["platform"])
+    web = read(SERVICE_DOCS["web"])
     if contains_all(
-        platform,
+        web,
         [
             "server/main.py",
             "server/api/http/app.py",
@@ -153,7 +153,7 @@ def implementation_traceability() -> tuple[int, list[str]]:
     ):
         points += 2.0
     else:
-        findings.append("platform surface summary does not trace dashboard and orders routes to backend contracts.")
+        findings.append("web surface summary does not trace dashboard and orders routes to backend contracts.")
 
     admin = read(SERVICE_DOCS["admin"])
     if contains_all(

package/sdd/01_planning/01_feature/auth_feature_spec.md

@@ -19,7 +19,7 @@
 
 | Actor | Description | Appears In |
 | --- | --- | --- |
-| `Platform User` | platform 서비스에서 주문/운영 기능에 접근하기 위해 인증 세션을 발급받는 사용자다. | `AUT-F001` |
+| `Web User` | web 서비스에서 주문/운영 기능에 접근하기 위해 인증 세션을 발급받는 사용자다. | `AUT-F001` |
 | `Mobile Operator` | mobile 서비스에서 이행 작업을 수행하기 위해 로그인하는 현장 운영자다. | `AUT-F001` |
 | `Admin Operator` | admin 서비스에서 카탈로그, 재고, 사용자 운영 명령을 수행하기 위해 관리자 세션을 발급받는 주체다. | `AUT-F001` |
 | `Landing Member` | landing 서비스에서 회원 전용 자원이나 개인화 동작을 사용하기 위해 로그인하는 사용자다. | `AUT-F001` |
@@ -48,7 +48,7 @@
 
 | Feature Code | Use Case | Actor | Bounded Context | Aggregate / Model | Type | Preconditions | Domain Outcome | Invariant / Business Rule |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `AUT-F001` | 이메일/비밀번호로 로그인하고 access token을 발급한다 | Platform User, Mobile Operator, Admin Operator, Landing Member | Authentication & Session | `LoginCommand`, `AuthToken`, `AuthAccountRecord` | Command | 이메일과 비밀번호가 전달되고, 인증 계정 저장소에 해당 사용자가 존재해야 한다 | access token과 `user_id`가 발급된다 | credential이 일치하지 않으면 `401 Invalid credentials`를 반환한다 |
+| `AUT-F001` | 이메일/비밀번호로 로그인하고 access token을 발급한다 | Web User, Mobile Operator, Admin Operator, Landing Member | Authentication & Session | `LoginCommand`, `AuthToken`, `AuthAccountRecord` | Command | 이메일과 비밀번호가 전달되고, 인증 계정 저장소에 해당 사용자가 존재해야 한다 | access token과 `user_id`가 발급된다 | credential이 일치하지 않으면 `401 Invalid credentials`를 반환한다 |
 | `AUT-F002` | bearer token으로 현재 세션 사용자를 해석한다 | Authenticated Client | Authentication & Session | `AuthToken`, `AuthenticatedUser`, `AuthAccountRecord` | Query | 유효한 bearer token이 전달되고 token subject가 인증 계정 저장소에 존재해야 한다 | 현재 사용자 summary를 반환한다 | token이 위조되었거나 subject 사용자가 없으면 `401 Invalid token`을 반환한다 |
 
 ## 7. Notes

package/sdd/01_planning/01_feature/catalog_feature_spec.md

@@ -21,7 +21,7 @@
 | --- | --- | --- |
 | `Landing Visitor` | 비로그인 상태로 공개 상품 카탈로그와 상품 상세를 탐색하는 방문자다. | `CAT-F001`, `CAT-F002` |
 | `Landing Member` | 로그인된 landing 회원으로 공개 상품을 둘러보고 구매 전 탐색을 수행하는 사용자다. | `CAT-F001`, `CAT-F002` |
-| `Platform User` | platform 서비스에서 주문 생성이나 운영 판단을 위해 상품 정보를 조회하는 내부 사용자다. | `CAT-F001`, `CAT-F002` |
+| `Web User` | web 서비스에서 주문 생성이나 운영 판단을 위해 상품 정보를 조회하는 내부 사용자다. | `CAT-F001`, `CAT-F002` |
 | `Admin Operator` | admin 서비스에서 상품을 등록, 수정, 상태 변경하는 운영 관리자다. | `CAT-F003`, `CAT-F004`, `CAT-F005` |
 
 ## 4. Bounded Context Summary
@@ -49,8 +49,8 @@
 
 | Feature Code | Use Case | Actor | Bounded Context | Aggregate / Model | Type | Preconditions | Domain Outcome | Invariant / Business Rule |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `CAT-F001` | 상품 카탈로그 목록을 조회한다 | Landing Visitor, Landing Member, Platform User | Product Catalog | `ProductSummary`, `ProductRecord` | Query | 상품 bootstrap 데이터가 존재해야 한다 | 공개 가능한 상품 목록을 필터와 검색 조건에 맞게 반환한다 | `status`, `category`, `q` 조건은 모두 현재 카탈로그 집합 안에서 계산한다 |
-| `CAT-F002` | 단일 상품 상세를 조회한다 | Landing Visitor, Landing Member, Platform User | Product Catalog | `ProductDetail`, `ProductRecord` | Query | 요청한 `product_id`가 저장소에 존재해야 한다 | 상세 페이지 구성을 위한 상품 전체 속성을 반환한다 | 존재하지 않는 `product_id`면 `404 Catalog product not found`를 반환한다 |
+| `CAT-F001` | 상품 카탈로그 목록을 조회한다 | Landing Visitor, Landing Member, Web User | Product Catalog | `ProductSummary`, `ProductRecord` | Query | 상품 bootstrap 데이터가 존재해야 한다 | 공개 가능한 상품 목록을 필터와 검색 조건에 맞게 반환한다 | `status`, `category`, `q` 조건은 모두 현재 카탈로그 집합 안에서 계산한다 |
+| `CAT-F002` | 단일 상품 상세를 조회한다 | Landing Visitor, Landing Member, Web User | Product Catalog | `ProductDetail`, `ProductRecord` | Query | 요청한 `product_id`가 저장소에 존재해야 한다 | 상세 페이지 구성을 위한 상품 전체 속성을 반환한다 | 존재하지 않는 `product_id`면 `404 Catalog product not found`를 반환한다 |
 | `CAT-F003` | 관리자가 새 상품을 등록한다 | Admin Operator | Product Catalog | `CreateProductCommand`, `ProductDetail`, `ProductRecord` | Command | 관리자 토큰이 유효하고 slug, 이름, 가격, variant 정보가 전달되어야 한다 | 새 상품 레코드가 생성되어 카탈로그 목록에 합류한다 | `slug`는 카탈로그 내에서 유일해야 하며 variant는 최소 1개 이상이어야 한다 |
 | `CAT-F004` | 관리자가 상품 속성을 수정한다 | Admin Operator | Product Catalog | `UpdateProductCommand`, `ProductDetail`, `ProductRecord` | Command | 관리자 토큰이 유효하고 요청한 `product_id`가 존재해야 한다 | 상품 속성이 부분 갱신되고 `updated_at`이 갱신된다 | 빈 수정 요청은 `400 No catalog product fields provided`, 중복 slug는 `409`를 반환한다 |
 | `CAT-F005` | 관리자가 상품 상태를 변경한다 | Admin Operator | Product Catalog | `UpdateProductStatusCommand`, `ProductDetail`, `ProductRecord` | Command | 관리자 토큰이 유효하고 요청한 `product_id`가 존재해야 한다 | 상품 `status`가 `draft`, `active`, `archived` 중 하나로 전환된다 | 존재하지 않는 `product_id`면 `404 Catalog product not found`를 반환한다 |

package/sdd/01_planning/01_feature/order_feature_spec.md

@@ -4,12 +4,12 @@
 
 ## 1. Purpose
 
-`orders` bounded context가 제공하는 플랫폼 주문 현황과 관리자 운영 큐 기능을 구현 기준으로 정리한다.
+`orders` bounded context가 제공하는 web 주문 현황과 관리자 운영 큐 기능을 구현 기준으로 정리한다.
 
 ## 2. Scope
 
 - 포함 범위:
-  - platform 주문 overview/list read model과 주문 생성, 상태 전이 command
+  - web 주문 overview/list read model과 주문 생성, 상태 전이 command
   - admin 주문 overview/queue read model
 - 제외 범위:
   - 외부 결제 게이트웨이 정산이나 배송사 연동
@@ -19,7 +19,7 @@
 
 | Actor | Description | Appears In |
 | --- | --- | --- |
-| `Platform User` | platform 서비스에서 주문 현황을 조회하고 신규 주문 생성이나 주문 상태 갱신을 수행하는 운영 사용자다. | `ORD-F001`, `ORD-F002`, `ORD-F003`, `ORD-F004` |
+| `Web User` | web 서비스에서 주문 현황을 조회하고 신규 주문 생성이나 주문 상태 갱신을 수행하는 운영 사용자다. | `ORD-F001`, `ORD-F002`, `ORD-F003`, `ORD-F004` |
 | `Admin Operator` | admin 서비스에서 주문 KPI와 운영 큐를 모니터링하는 관리자다. | `ORD-F005`, `ORD-F006` |
 
 ## 4. Bounded Context Summary
@@ -37,8 +37,8 @@
 | Aggregate / Model | Role |
 | --- | --- |
 | `OrderRecord` | bootstrap 기반 주문 원본 |
-| `OrderOverview` | 플랫폼 dashboard 요약 읽기 모델 |
-| `OrderSummary` | 플랫폼 orders 목록 읽기 모델 |
+| `OrderOverview` | web dashboard 요약 읽기 모델 |
+| `OrderSummary` | web orders 목록 읽기 모델 |
 | `CreateOrderCommand` | 주문 생성 명령 |
 | `UpdateOrderStatusCommand` | 주문 상태 전이 명령 |
 | `OrderStatusTransition` | 주문 상태 전이 결과 |
@@ -49,15 +49,15 @@
 
 | Feature Code | Use Case | Actor | Bounded Context | Aggregate / Model | Type | Preconditions | Domain Outcome | Invariant / Business Rule |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| `ORD-F001` | 플랫폼 주문 overview를 조회한다 | Platform User | Order Operations | `OrderOverview`, `OrderRecord` | Query | 인증 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 주문 카드, 최근 활동, 선택 주문 상세를 함께 반환한다 | overview는 최근 활동 3건과 선택 주문 1건을 항상 포함한다 |
-| `ORD-F002` | 플랫폼 주문 목록을 조회한다 | Platform User | Order Operations | `OrderSummary`, `OrderRecord` | Query | 인증 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 주문 목록을 반환한다 | 목록 행은 `id`, `product_name`, `customer_name`, `status`를 유지한다 |
-| `ORD-F003` | 신규 주문을 생성한다 | Platform User | Order Operations | `CreateOrderCommand`, `OrderRecord` | Command | 인증 토큰이 유효하고 제품, 고객, 판매자, 금액 정보가 전달되어야 한다 | 새 `OrderRecord`가 생성되어 목록과 overview에 반영된다 | 새 주문은 문자열 ID를 부여받고 `Pending`과 `Queued`를 기본 상태로 사용한다 |
-| `ORD-F004` | 주문의 결제/이행 상태를 변경한다 | Platform User | Order Operations | `UpdateOrderStatusCommand`, `OrderStatusTransition`, `OrderRecord` | Command | 인증 토큰이 유효하고 요청한 `order_id`가 존재해야 한다 | 주문의 `status`, `fulfillment_status`, `stage`가 변경된다 | 존재하지 않는 `order_id`면 `404`를 반환한다 |
-| `ORD-F005` | 관리자용 주문 overview를 조회한다 | Admin Operator | Order Operations | `AdminOrderOverview`, `OrderRecord` | Query | 관리자 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 관리자 KPI와 stage 현황을 반환한다 | admin surface는 platform surface와 다른 운영형 read model을 사용한다 |
+| `ORD-F001` | web 주문 overview를 조회한다 | Web User | Order Operations | `OrderOverview`, `OrderRecord` | Query | 인증 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 주문 카드, 최근 활동, 선택 주문 상세를 함께 반환한다 | overview는 최근 활동 3건과 선택 주문 1건을 항상 포함한다 |
+| `ORD-F002` | web 주문 목록을 조회한다 | Web User | Order Operations | `OrderSummary`, `OrderRecord` | Query | 인증 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 주문 목록을 반환한다 | 목록 행은 `id`, `product_name`, `customer_name`, `status`를 유지한다 |
+| `ORD-F003` | 신규 주문을 생성한다 | Web User | Order Operations | `CreateOrderCommand`, `OrderRecord` | Command | 인증 토큰이 유효하고 제품, 고객, 판매자, 금액 정보가 전달되어야 한다 | 새 `OrderRecord`가 생성되어 목록과 overview에 반영된다 | 새 주문은 문자열 ID를 부여받고 `Pending`과 `Queued`를 기본 상태로 사용한다 |
+| `ORD-F004` | 주문의 결제/이행 상태를 변경한다 | Web User | Order Operations | `UpdateOrderStatusCommand`, `OrderStatusTransition`, `OrderRecord` | Command | 인증 토큰이 유효하고 요청한 `order_id`가 존재해야 한다 | 주문의 `status`, `fulfillment_status`, `stage`가 변경된다 | 존재하지 않는 `order_id`면 `404`를 반환한다 |
+| `ORD-F005` | 관리자용 주문 overview를 조회한다 | Admin Operator | Order Operations | `AdminOrderOverview`, `OrderRecord` | Query | 관리자 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 관리자 KPI와 stage 현황을 반환한다 | admin surface는 web surface와 다른 운영형 read model을 사용한다 |
 | `ORD-F006` | 관리자용 거래 큐를 조회한다 | Admin Operator | Order Operations | `AdminQueueItem`, `OrderRecord` | Query | 관리자 토큰이 유효하고 주문 bootstrap 데이터가 존재해야 한다 | 주문별 운영 큐 행을 반환한다 | 큐 행은 `order_id`, `product_name`, `customer_name`, `status`, `sla`를 유지한다 |
 
 ## 7. Notes
 
-- `orders`는 platform surface와 admin surface에 서로 다른 read model을 제공한다.
+- `orders`는 web surface와 admin surface에 서로 다른 read model을 제공한다.
 - 운영 알람 feed는 별도 `alerts` context가 소유하고, `orders`는 주문 자체 read/write 모델만 유지한다.
 - template baseline의 주문 상태 전이는 내부 mutation semantics까지만 다루며 외부 결제/이벤트 연동은 포함하지 않는다.

package/sdd/01_planning/02_screen/INDEX.md

@@ -1,9 +1,9 @@
 # Screen Planning
 
 - screen code format: `{SERVICE}-S{NNN}`
-- canonical service code: `PLT`, `ADM`, `MOB`, `LND`
+- canonical service code: `WEB`, `ADM`, `MOB`, `LND`
 
-- [platform_screen_spec.pdf](./platform_screen_spec.pdf)
+- [web_screen_spec.pdf](./web_screen_spec.pdf)
 - [admin_screen_spec.pdf](./admin_screen_spec.pdf)
 - [mobile_screen_spec.pdf](./mobile_screen_spec.pdf)
 - [landing_screen_spec.pdf](./landing_screen_spec.pdf)