회기 무발화 0턴 분리, 자기예측 락 불변식 및 TDD 회귀 검증 완료
Some checks failed
API contract / OpenAPI type drift (push) Failing after 3m27s

This commit is contained in:
Yun Chan 2026-09-08 23:28:06 +09:00
parent a479db7a5a
commit a0311c5957
100 changed files with 4884 additions and 11210 deletions

View file

@ -143,7 +143,7 @@ DB·엔진 없이도 UI/로그인/페르소나/세션 생성까지는 동작한
## 1. 사전 준비
- **Python 3.11** (운영 스크립트가 Python 3.11 기준). 가상환경 권장.
- **Python 3.11** (운영 스크립트가 Python 3.11 기준). Windows의 기본 `python`이 다른 버전을 가리키거나 pytest가 없을 수 있으므로 `py -3.11`을 우선 쓴다. 가상환경 권장.
- **Node.js 22 + npm** — CI와 같은 기준. newer LTS는 별도 재검증 전까지 기준선으로 쓰지 않는다.
- (선택) **Docker Desktop**`infra/docker-compose.yml` 전체 스택을 띄울 때만.
- (선택) **`claude` CLI** — `claude_cli` 실행. 설치 후 로그인되어 있어야 한다.
@ -155,7 +155,7 @@ DB·엔진 없이도 UI/로그인/페르소나/세션 생성까지는 동작한
```powershell
# 저장소 루트에서
python -m venv .venv
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1 # PowerShell 활성화
python -m pip install -r apps\api\requirements.txt
```
@ -676,8 +676,8 @@ RAG 임베딩/리랭커 의존성은 기본 이미지에 설치하지 않는다.
```powershell
# 백엔드 (apps/api)
cd apps\api
python -m pytest app/ -q # 2026-08-28 전체 실행 1002 passed
python -m pytest engine_gateway\ -q # 2026-08-28 전체 실행 68 passed
py -3.11 -m pytest app/ -q # 2026-08-28 전체 실행 1002 passed
py -3.11 -m pytest engine_gateway\ -q # 2026-08-28 전체 실행 68 passed
# 웹 (apps/web)
cd apps\web