From dcd4c283b80fafa853053f427b73e249d6e194fa Mon Sep 17 00:00:00 2001
From: kjh2064 <kjh2064@gmail.com>
Date: Sat, 4 Jul 2026 21:21:36 +0900
Subject: [PATCH] docs: split smoke commands and clarify runbook

---
 .gitea/workflows/browser-e2e.yml |  3 ++-
 README.md                        | 39 +++++---------------------------
 package.json                     |  4 +++-
 3 files changed, 11 insertions(+), 35 deletions(-)

diff --git a/.gitea/workflows/browser-e2e.yml b/.gitea/workflows/browser-e2e.yml
index 1b5583b..cb6dd42 100644
--- a/.gitea/workflows/browser-e2e.yml
+++ b/.gitea/workflows/browser-e2e.yml
@@ -78,7 +78,8 @@ jobs:
           E2E_ADMIN_PASSWORD: TestAdmin@123456
         run: |
           echo "Running smoke checks on Desktop Chrome (production verification)"
-          npm run test:e2e:smoke -- --project="Desktop Chrome"
+          npm run test:e2e:public-smoke
+          npm run test:e2e:admin-smoke
 
       - name: Browser E2E verification
         env:
diff --git a/README.md b/README.md
index 367fd2c..780e3de 100644
--- a/README.md
+++ b/README.md
@@ -172,40 +172,13 @@ master 브랜치에 푸시하면 파이프라인이 다음 단계를 수행합
 
 ## E2E / Smoke
 
-공개/관리자 분리 검증은 다음 순서로 실행합니다.
+공개/관리자 분리 검증은 아래 명령을 사용합니다.
 
-```bash
-npm run test:e2e:smoke -- --project="Public Smoke"
-npm run test:e2e:smoke -- --project="Admin Smoke"
-```
-
-원격 배포본을 검증할 때는 `E2E_BASE_URL`을 명시합니다.
-
-```bash
-$env:E2E_BASE_URL="https://www.taxbaik.com/taxbaik"
-npm run test:e2e:smoke -- --project="Public Smoke"
-npm run test:e2e:smoke -- --project="Admin Smoke"
-```
-
-배포 직후 공용/관리자 응답만 빠르게 확인할 때는 smoke 스크립트를 직접 실행합니다.
-
-```bash
-ROOT_URL="https://www.taxbaik.com/" \
-ADMIN_URL="https://www.taxbaik.com/taxbaik/admin/login" \
-bash ./scripts/taxbaik-smoke.sh
-```
-
-Windows PowerShell에서는 이렇게 실행합니다.
-
-```powershell
-$env:E2E_BASE_URL = "https://www.taxbaik.com/taxbaik"
-npm run test:e2e:smoke -- --project="Public Smoke"
-npm run test:e2e:smoke -- --project="Admin Smoke"
-
-$env:ROOT_URL = "https://www.taxbaik.com/"
-$env:ADMIN_URL = "https://www.taxbaik.com/taxbaik/admin/login"
-bash ./scripts/taxbaik-smoke.sh
-```
+| 용도 | Bash | PowerShell |
+| --- | --- | --- |
+| Public smoke | `E2E_BASE_URL=https://www.taxbaik.com/taxbaik npm run test:e2e:public-smoke` | `$env:E2E_BASE_URL="https://www.taxbaik.com/taxbaik"; npm run test:e2e:public-smoke` |
+| Admin smoke | `E2E_BASE_URL=https://www.taxbaik.com/taxbaik npm run test:e2e:admin-smoke` | `$env:E2E_BASE_URL="https://www.taxbaik.com/taxbaik"; npm run test:e2e:admin-smoke` |
+| Direct smoke script | `ROOT_URL="https://www.taxbaik.com/" ADMIN_URL="https://www.taxbaik.com/taxbaik/admin/login" bash ./scripts/taxbaik-smoke.sh` | `$env:ROOT_URL="https://www.taxbaik.com/"; $env:ADMIN_URL="https://www.taxbaik.com/taxbaik/admin/login"; bash ./scripts/taxbaik-smoke.sh` |
 
 ---
 
diff --git a/package.json b/package.json
index 906a7de..553c256 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,9 @@
   "scripts": {
     "test:e2e": "playwright test",
     "test:e2e:headed": "playwright test --headed",
-    "test:e2e:smoke": "playwright test --grep @smoke"
+    "test:e2e:smoke": "playwright test --grep @smoke",
+    "test:e2e:public-smoke": "playwright test --project=\"Public Smoke\" tests/e2e/public-smoke.spec.ts",
+    "test:e2e:admin-smoke": "playwright test --project=\"Admin Smoke\" tests/e2e/admin-smoke.spec.ts"
   },
   "devDependencies": {
     "@playwright/test": "1.57.0"