@edupia-tutor/spec-driven-docs 0.14.0 → 0.14.1

package/commands/dev-smoke-test.tmpl

@@ -1,11 +1,11 @@
-# /dev-smoke-test — Smoke Test Live Service or App
+# /dev-smoke-test — Smoke Test Service hoặc App đang chạy
 
-Use when service/app is **already running**. Different from `/dev-run-test` (no live server needed).
+Dùng khi service/app **đang chạy sẵn**. Khác `/dev-run-test` (không cần live server).
 
 ## Gate
 {{include:steps/gate.md}}
 
-*Note: For this command, the target in Step 1 is a UC-ID from `$ARGUMENTS`. Context loading provides `conventions.service_run`, port information, and `tech_stack.module`.*
+*Lưu ý: Với lệnh này, target ở Bước 1 là một UC-ID từ `$ARGUMENTS`. Context loading cung cấp `conventions.service_run`, thông tin port, và `tech_stack.module`.*
 
 ## Context
 {{include:steps/context-loader.md}}
@@ -14,7 +14,7 @@ Use when service/app is **already running**. Different from `/dev-run-test` (no
 
 ## Service Detection
 
-Read `active_module` from context. Use to select the correct dev-smoke-test approach.
+Đọc `active_module` từ context. Dùng để chọn đúng cách dev-smoke-test.
 
 | Platform | Modules |
 |---|---|
@@ -24,11 +24,11 @@ Read `active_module` from context. Use to select the correct dev-smoke-test appr
 
 ---
 
-## If `platform_type = backend`
+## Nếu `platform_type = backend`
 
-### Phase 1 — Verify service is running
+### Phase 1 — Xác minh service đang chạy
 
-Read `conventions.service_run` from project-context.yaml to determine port.
+Đọc `conventions.service_run` từ project-context.yaml để xác định port.
 
 ```bash
 # Try common health endpoints (use whichever applies):
@@ -37,20 +37,20 @@ curl -s http://localhost:{port}/actuator/health   # Spring Boot
 curl -s http://localhost:{port}/ping              # some frameworks
 ```
 
-If not running → "Start with `{conventions.service_run}` from project root."
+Nếu chưa chạy → "Khởi động với `{conventions.service_run}` từ project root."
 
-### Phase 2 — Identify endpoints
+### Phase 2 — Xác định endpoint
 
-From UC-ID → find controller/handler with `@trace.implements={UC-ID}`.
-List: method, path, required auth/role.
+Từ UC-ID → tìm controller/handler có `@trace.implements={UC-ID}`.
+Liệt kê: method, path, auth/role bắt buộc.
 
-### Phase 3 — Get auth token (if needed)
+### Phase 3 — Lấy auth token (nếu cần)
 
 ```
-Endpoint requires auth. Options:
-1. Paste Bearer token (from Postman/DevTools)
-2. Use test/dev token from local config
-3. Skip — test public endpoints only
+Endpoint yêu cầu auth. Lựa chọn:
+1. Dán Bearer token (từ Postman/DevTools)
+2. Dùng test/dev token từ local config
+3. Skip — chỉ test endpoint public
 ```
 
 ### Phase 4 — Run
@@ -67,21 +67,21 @@ curl -s -X POST "http://localhost:{port}/v1/{resource}" \
   -d '{"field1": "test_value"}'
 ```
 
-| Result | Meaning |
+| Kết quả | Ý nghĩa |
 |--------|---------|
-| 200/201 + correct data | ✅ OK |
-| 200 + wrong data | ⚠️ Logic bug → /debug |
-| 400 | Wrong request body → check required fields |
-| 401 | Token expired or wrong config |
-| 403 | Wrong role → check auth rules |
+| 200/201 + đúng data | ✅ OK |
+| 200 + sai data | ⚠️ Logic bug → /debug |
+| 400 | Sai request body → kiểm tra field bắt buộc |
+| 401 | Token hết hạn hoặc sai config |
+| 403 | Sai role → kiểm tra auth rule |
 | 500 | Server error → /debug |
-| Connection refused | Service not running |
+| Connection refused | Service chưa chạy |
 
-### If `active_module = context-engineering`
+### Nếu `active_module = context-engineering`
 
-#### Phase 1 — Verify pipeline entry point is reachable
+#### Phase 1 — Xác minh entry point của pipeline tới được
 
-Run the prompt function directly with a minimal valid input:
+Chạy prompt function trực tiếp với một input hợp lệ tối thiểu:
 
 ```bash
 # Python (pytest / script):
@@ -91,30 +91,30 @@ python -c "from {module}.{function} import {function}; print({function}(input='{
 {conventions.test_command} -m smoke -v
 ```
 
-#### Phase 2 — Verify output structure
+#### Phase 2 — Xác minh cấu trúc output
 
-Check the output conforms to the expected schema:
+Kiểm tra output khớp schema kỳ vọng:
 
 ```
 Expected output schema: {output fields from @trace or tech-doc}
 Actual output: {paste output here}
 ```
 
-#### Phase 3 — Interpret results
+#### Phase 3 — Diễn giải kết quả
 
-| Result | Meaning |
+| Kết quả | Ý nghĩa |
 |--------|---------|
-| Output matches schema | ✅ OK |
-| Output present but wrong format | ⚠️ Logic bug → /debug |
-| `APIError` / `AuthenticationError` | API key invalid or service unavailable |
-| `TokenLimitError` | Input too long — check prompt template size |
-| Exception / traceback | Code error → /debug |
+| Output khớp schema | ✅ OK |
+| Output có nhưng sai format | ⚠️ Logic bug → /debug |
+| `APIError` / `AuthenticationError` | API key không hợp lệ hoặc service unavailable |
+| `TokenLimitError` | Input quá dài — kiểm tra kích thước prompt template |
+| Exception / traceback | Lỗi code → /debug |
 
 ---
 
-## If `platform_type = web-frontend`
+## Nếu `platform_type = web-frontend`
 
-### Phase 1 — Verify dev server is running
+### Phase 1 — Xác minh dev server đang chạy
 
 ```bash
 # Linux / macOS:
@@ -126,9 +126,9 @@ curl -s -o NUL -w "%{http_code}" http://localhost:{port}
 # Should return 200. If not: start with {conventions.service_run} (e.g., npm run dev)
 ```
 
-### Phase 2 — Run E2E smoke test
+### Phase 2 — Chạy E2E smoke test
 
-Identify E2E tool in the project (Playwright or Cypress):
+Xác định E2E tool trong dự án (Playwright hoặc Cypress):
 
 ```bash
 # Playwright — run scenarios tagged with this UC:
@@ -138,25 +138,25 @@ npx playwright test --grep "{UC-ID}"
 npx cypress run --spec "cypress/e2e/{UC-ID}*"
 ```
 
-If no E2E tests exist yet → open browser and manually verify:
-1. Navigate to the route for this UC
-2. Perform the main user action
-3. Confirm the expected outcome is visible
+Nếu chưa có E2E test → mở browser và verify thủ công:
+1. Điều hướng tới route của UC này
+2. Thực hiện hành động chính của người dùng
+3. Xác nhận kết quả kỳ vọng hiển thị
 
-### Phase 3 — Interpret results
+### Phase 3 — Diễn giải kết quả
 
-| Result | Meaning |
+| Kết quả | Ý nghĩa |
 |--------|---------|
-| All E2E tests pass | ✅ OK |
+| Tất cả E2E test pass | ✅ OK |
 | Assertion failed | ⚠️ Logic bug → /debug |
-| `ERR_CONNECTION_REFUSED` | Dev server not running |
-| API returns 4xx/5xx | Backend issue → check backend service |
+| `ERR_CONNECTION_REFUSED` | Dev server chưa chạy |
+| API trả về 4xx/5xx | Vấn đề backend → kiểm tra backend service |
 
 ---
 
-## If `platform_type = mobile`
+## Nếu `platform_type = mobile`
 
-### Phase 1 — Verify device/emulator is ready
+### Phase 1 — Xác minh device/emulator sẵn sàng
 
 ```bash
 # Flutter:
@@ -174,15 +174,15 @@ npx react-native run-ios       # build + install on iOS simulator
 # Open Xcode → select simulator → Product → Run
 ```
 
-### Phase 2 — Manual dev-smoke-test checklist
+### Phase 2 — Checklist dev-smoke-test thủ công
 
-For the UC under test, verify on device:
-1. Navigate to the screen for this UC
-2. Perform the main action from the `.feature` Scenario (`When` step)
-3. Confirm the expected outcome is visible (`Then` step)
-4. Check for any crash or unexpected error dialog
+Với UC đang test, verify trên device:
+1. Điều hướng tới màn của UC này
+2. Thực hiện hành động chính từ Scenario `.feature` (step `When`)
+3. Xác nhận kết quả kỳ vọng hiển thị (step `Then`)
+4. Kiểm tra có crash hoặc dialog lỗi bất ngờ không
 
-### Phase 3 — Capture issues if found
+### Phase 3 — Bắt issue nếu phát hiện
 
 ```bash
 # Flutter:
@@ -195,7 +195,7 @@ adb logcat -d | grep -i "error\|exception\|crash"
 # Copy crash log from Xcode → Devices and Simulators → View Device Logs
 ```
 
-Paste output into `/debug`.
+Dán output vào `/debug`.
 
 ---
 
@@ -212,6 +212,6 @@ Platform: {backend | web-frontend | mobile}
 
 Status legend: ✅ = OK  |  ⚠️ = Responded but wrong data / logic bug  |  ❌ = Error / not running
 
-Issues: {describe any failures}
-Next: /debug (paste error interactively) OR /fix-bug {TICKET_ID} OR ready to PR
+Issues: {mô tả các failure}
+Next: /debug (dán lỗi tương tác) HOẶC /fix-bug {TICKET_ID} HOẶC sẵn sàng PR
 ```