검증 문서 갱신

docs/guides/local-development.md

@@ -381,7 +381,7 @@ RAG 임베딩/리랭커 의존성은 기본 이미지에 설치하지 않는다.
 ```powershell
 # 백엔드 (apps/api)
 cd apps\api
-python -m pytest app/ -q              # 현재 145 pass
+python -m pytest app/ -q              # 현재 178 pass
 python -m pytest engine_gateway\ -q   # 현재 11 pass
 
 # 웹 (apps/web)

docs/guides/testing.md

@@ -15,7 +15,7 @@ Vignette 저장소의 모든 검증 수단(백엔드 단위 테스트, 웹 타
 
 | 검증 | 작업 디렉터리 | 명령 | DB | API(8000) | 웹(5173) | 엔진GW(9099) | 브라우저 | 현재 통과 |
 |---|---|---|---|---|---|---|---|---|
-| 백엔드 단위 테스트 | `apps/api` | `python -m pytest app/ -q` | 불필요 | 불필요 | 불필요 | 불필요 | 불필요 | 145 pass |
+| 백엔드 단위 테스트 | `apps/api` | `python -m pytest app/ -q` | 불필요 | 불필요 | 불필요 | 불필요 | 불필요 | 178 pass |
 | 엔진 게이트웨이 테스트 | `apps/api` | `python -m pytest engine_gateway/ -q` | 불필요 | 불필요 | 불필요 | 불필요 | 불필요 | 11 pass |
 | API 타입 생성 체크 | `apps/web` | `npm run check:api-types` | 불필요 | 불필요 | 불필요 | 불필요 | 불필요 | pass |
 | 웹 타입체크 | `apps/web` | `npm run typecheck` | 불필요 | 불필요 | 불필요 | 불필요 | 불필요 | pass |
@@ -42,15 +42,15 @@ Vignette 저장소의 모든 검증 수단(백엔드 단위 테스트, 웹 타
 
 ```sh
 # apps/api
-python -m pytest app/ -q              # 앱 단위 테스트 (현재 145 pass)
+python -m pytest app/ -q              # 앱 단위 테스트 (현재 178 pass)
 python -m pytest engine_gateway/ -q   # 게이트웨이 단위 테스트 (현재 11 pass)
 ```
 
 수집만 빠르게 확인하려면:
 
 ```sh
-python -m pytest app/ --collect-only -q            # → "145 tests collected"
-python -m pytest engine_gateway/ --collect-only -q # → "9 tests collected"
+python -m pytest app/ --collect-only -q            # → "178 tests collected"
+python -m pytest engine_gateway/ --collect-only -q # → "11 tests collected"
 ```
 
 > 참고: 실행 중 `PendingDeprecationWarning: Please use 'import python_multipart'`
@@ -81,6 +81,32 @@ python -m pytest engine_gateway/ --collect-only -q # → "9 tests collected"
 
 ---
 
+### 1.5 로컬 DB smoke — 저항엔진 openness 곡선
+
+저항엔진은 단위 테스트와 별도로 실제 API 경로와 Postgres 저장 상태를 함께 확인할 수 있다.
+이 smoke는 dev-login으로 학습자 세션을 만들고, P1 상담 2개에 공감 발화/조언점프 발화를 각각
+5턴씩 넣은 뒤 `app.session_state`, `app.turns`, `app.turn_client_state`를 직접 조회한다.
+
+사전 조건:
+
+- API가 DB 연결 상태로 떠 있어야 한다.
+- `apps/api/.env` 또는 환경변수에 `DATABASE_URL`이 있어야 한다.
+- API는 dev-login과 onboarding 저장이 가능한 dev 런타임이어야 한다.
+
+```sh
+# repo root
+python scripts/smoke-resistance-openness-db.py \
+  --api-base-url http://127.0.0.1:8000 \
+  --timeout 240 \
+  --out docs/ops/resistance-openness-db-smoke-YYYY-MM-DD.json
+```
+
+통과 기준:
+
+- 공감 세션은 5턴 안에 `stage=탐색`으로 열리고 `effective_openness`가 0보다 커진다.
+- 조언점프 세션은 `stage=라포`, `effective_openness=0.0`을 유지한다.
+- DB의 `turn_seq`와 `app.turns` 저장 행 수가 API 턴 수와 일치한다.
+
 ## 2. 웹 타입체크 / 빌드
 
 ### 2.1 대상과 구성