feat: update codex live chat workflow

README.md

@@ -17,6 +17,34 @@ npm install
 npm run dev
 ```
 
+## 확인용 Preview 컨테이너
+
+실제 반영 화면을 확인할 때는 바인드 마운트 없이 별도 이미지로 빌드하는 `docker-compose.preview.yml`을 사용합니다.
+
+```bash
+docker compose -f docker-compose.preview.yml up -d --build
+```
+
+- 기본 접속 주소: `http://127.0.0.1:4173`
+- 소스 코드는 이미지 빌드 시점에 복사되므로, 로컬 파일 변경이 컨테이너에 바로 섞이지 않습니다.
+- API 프록시는 기본적으로 호스트의 `3100` 포트를 `host.docker.internal`로 바라봅니다.
+- 포트나 API 대상 변경이 필요하면 `PREVIEW_APP_PORT`, `WORK_SERVER_URL` 환경변수를 사용합니다.
+
+## 테스트용 컨테이너 운영 기준
+
+- 테스트용 컨테이너는 현재 `ai-code-app-preview` 하나만 유지합니다.
+- 이 컨테이너는 채팅 전용 테스트가 아니라 **현재 프로젝트 루트 기준 화면/기능 확인용 테스트 컨테이너**로 사용합니다.
+- `https://test.sm-home.cloud/` 운영 기준은 `화면 / -> 5174 앱 테스트 서버`, `/api/` 및 `/ws/chat` -> `127.0.0.1:3100 work-server` 입니다.
+- 위 프록시 기준은 임의로 바꾸지 말고, 변경이 필요하면 반드시 운영 목적을 먼저 문서에 남깁니다.
+- 임시 테스트 컨테이너를 추가로 띄우지 말고, 필요 시 기존 `ai-code-app-preview`만 재기동합니다.
+- 재기동은 다른 서비스까지 건드리지 않고 아래 명령으로 해당 컨테이너만 처리합니다.
+
+```bash
+docker compose -f docker-compose.preview.yml up -d --build --force-recreate --no-deps preview-app
+```
+
+- 저장소 설정에 없는 임시 테스트 컨테이너가 남아 있으면 정리 대상입니다.
+
 ## PhotoPrism
 
 루트 `docker-compose.yml`에는 PhotoPrism와 MariaDB 서비스가 포함되어 있습니다.