docs: add sprint-016 release preflight

.plans/deploy/deploy-plan.md

@@ -20,10 +20,13 @@
 
 ## PM2 설정
 ```
-backend:  pm2 start dist/main.js --name hanarang-api --env production
-frontend: pm2 start npm --name hanarang-web -- start -- -p 3004
+backend:  pm2 start backend/dist/src/main.js --name hanarang-api --cwd /path/to/hanarang-dashboard --env production
+frontend: pm2 start npm --name hanarang-web --cwd /path/to/hanarang-dashboard/frontend -- start -- -p 3004
 ```
 
+- backend 엔트리포인트는 실제 Nest 빌드 산출물 기준 `backend/dist/src/main.js`를 사용해.
+- repo 루트에서 실행하면 `--cwd`를 명시해서 PM2가 올바른 작업 디렉터리를 잡도록 해.
+
 ## SSH 키 배포
 - Dev 서버(10.10.10.169)에서 4자매 서버로 SSH 접속할 수 있도록 키 배포 필요
 - 이랑이가 SSH 키 생성 + 각 자매 서버에 authorized_keys 추가

.plans/design/architecture.md

@@ -44,5 +44,5 @@ Backend가 SSH로 각 자매 서버에서 수집:
 ## 배포
 - **Dev 서버:** 10.10.10.169
 - **프로세스 관리:** PM2
-- **FE:** pm2 start npm --name hanarang-web -- start (포트 3004)
-- **BE:** pm2 start dist/main.js --name hanarang-api (포트 3005)
+- **FE:** `pm2 start npm --name hanarang-web --cwd /path/to/hanarang-dashboard/frontend -- start -- -p 3004`
+- **BE:** `pm2 start backend/dist/src/main.js --name hanarang-api --cwd /path/to/hanarang-dashboard` (포트 3005)

.plans/qa/SPRINT-016-release-preflight.md

@@ -0,0 +1,93 @@
+# SPRINT-016 Release Preflight
+
+- 검증 대상 repo: `https://git.nabomhalang.co.kr/hanarang/hanarang-dashboard`
+- 검증 대상 branch: `main`
+- 검증 대상 commit: `a9e1e677b0f129cc2f45e4f2624020d9d4626159` (`feat: merge SPRINT-016 isometric office dashboard`)
+- 기준 문서:
+  - `.plans/sprints/SPRINT-016.md`
+  - `.plans/design/ui/office-dashboard-design.md`
+  - `.plans/design/ui/office-chat-design.md`
+  - `docs/product-specs/openclaw-office-dashboard-prd.md`
+  - `.plans/deploy/deploy-plan.md`
+- 검증자: 하랑
+- 검증일시: `2026-04-07 13:55 KST`
+- 결과: `✅ PASSED`
+- 재검증 필요 여부: `아니야. 다만 배포 직전 운영 env / WS 프록시 확인은 필요해.`
+
+## 1. 이번 문서 보강 이유
+이번 `/office` 변경분은 코드 자체 preflight는 통과했는데, 배포 직전 확인 과정에서 아래 두 가지가 배포 게이트로 걸렸어.
+
+1. PM2 backend 실행 경로 문서가 실제 산출물과 달랐어.
+2. `/office` 변경에 대한 배포 전 검증 근거 문서가 `.plans/qa/`에 없었어.
+
+그래서 이번 문서는 **다랑이의 별도 브라우저 QA 보고서 대체가 아니라**, 현재 `main` 기준 배포 판단에 필요한 **release preflight 근거**를 남기는 용도야.
+
+## 2. 실행 결과
+- [x] `frontend npm run lint` — 성공 (`0 errors`, `20 warnings`, 전부 기존 unused-var 경고)
+- [x] `frontend npm run build` — 성공
+- [x] `backend npm run build` — 성공
+- [x] `backend npm test -- --runInBand` — 성공 (`9 suites`, `26 tests` passed)
+- [x] `backend/dist/src/main.js` 실제 산출물 존재 확인
+- [x] Next build 결과에 `/office` route 포함 확인
+
+## 3. 확인한 핵심 근거
+### 배포 문서/산출물 정합성
+- 기존 문서의 backend PM2 경로 `dist/main.js`는 실제 빌드 결과와 달랐어.
+- 실제 Nest 진입 파일은 `backend/dist/src/main.js`였고, 배포 문서와 아키텍처 문서를 이 기준으로 수정했어.
+
+### `/office` 변경분 상태
+- 오피스 대시보드 관련 파일이 `main`에 반영돼 있어.
+  - `frontend/app/office/page.tsx`
+  - `frontend/components/office/OfficeScene.tsx`
+  - `frontend/components/office/ContextPanel.tsx`
+  - `frontend/components/office/ChatWorkspace.tsx`
+  - `frontend/components/office/PipelinePanel.tsx`
+  - `frontend/components/office/ServerHealthPanel.tsx`
+- Next production build 산출물에서 `/office`가 정적 라우트로 생성되는 것까지 확인했어.
+
+### 코드 preflight
+- frontend는 lint/build 모두 통과했어.
+- backend는 build/test 모두 통과했어.
+- 현재 `main` 헤드는 `a9e1e67`로 고정 확인했어.
+
+## 4. 배포 전 운영 체크
+이건 코드 blocker는 아니고, 이랑이가 배포 직전에 확인하면 돼.
+
+- Dev 서버 env
+  - `DATABASE_URL`
+  - `JWT_SECRET`
+  - `SSH_KEY_PATH`
+  - `GITEA_BASE_URL`
+  - `GITEA_TOKEN`
+  - `CORS_ORIGINS`
+- Frontend env
+  - `NEXT_PUBLIC_API_URL`
+  - 필요 시 `NEXT_PUBLIC_WS_URL`
+- Nginx websocket 프록시 또는 WS URL 설정
+
+## 5. 최종 판정
+- **배포 문서 경로 오류 수정 완료**
+- **`/office` 변경분 release preflight 근거 문서화 완료**
+- **현재 기준 코드/빌드/테스트 blocker 없음**
+
+## 6. 최종 JSON
+```json
+{
+  "type": "release_preflight",
+  "from": "harang",
+  "task_id": "SPRINT-016-RELEASE-PREFLIGHT",
+  "repo": "https://git.nabomhalang.co.kr/hanarang/hanarang-dashboard",
+  "branch": "main",
+  "commit": "a9e1e677b0f129cc2f45e4f2624020d9d4626159",
+  "passed": true,
+  "errors": [],
+  "notes": [
+    "PM2 backend entry corrected to backend/dist/src/main.js",
+    "frontend lint/build passed",
+    "backend build/test passed",
+    "office route present in production build output",
+    "deploy-time env and websocket proxy checks remain operational checks only"
+  ],
+  "suggestion": "Safe to proceed with deploy after environment and websocket configuration checks."
+}
+```