shuim
9fab4018d4
하네스 규칙 검사 전역 위반 117→0, 회차별 검증(code-verifier opus 4도메인)으로 Critical/High 해소. 주문·리스크 - MDD 강제축소 반복 매도(종목별 완료 집합·재시도 상한·날짜 롤오버·잔고 오류 보류·epoch·장외 미주문) - KIS 거부 FAILED 기록, 결과 불명(전송 후) 재전송 금지·PENDING, 미전송 실패만 재시도(msg_cd 분류) - 국내 전량·손실 매도 시장가, 부분 익절 직전 현재가, 지정가만 미체결 취소(cancel_order_v2: TR 0013U·조직번호) + 0체결 롤백 - 누적 4%·현금·레버리지(신규분 포함)·사이클 내 매수 누적, 수동매수 공용 가드(buy_guards), 수동매도 DT 차감·락 - 가드 우회 엔드포인트 차단(/recommendations/auto-trade 위임, US /execute 매수 410·매도 가드) - 매수 슬롯=성공 매수, 평가 상한·회전, 업무거부/계좌 쿨다운, 프로세스 내 in-flight 주문 중복 차단 데이트레이딩 - 진입·청산 shield, 청산 진행 중 표식(소유 토큰), 2단계 청산 체크, 결과 불명 → 보유 감소 판정·비DT 차감 상한 - 전일 포지션 재시도(일시 실패 미산정), 분할매도 영속, ORB 구간 손절, /cycle 락, 사이클 내 현금 차감, 체결 수량 보정 스윙 - 손절 공백(판정 예외 시 하드 바닥), 단일 손절 소스·범위 검증, 매도 직전 KIS 잔고 상한(min(주문가능,보유)−DT) - 결과 불명 체결 대조·장부 반영, 대체가(나이·진입 이후·ATR 캐시), 분할 단계 기록, 국면 실패 fail-closed - 듀얼 플레이북·서킷브레이커 게이트, 평균회귀 우선·듀얼 독립, 시간손절 거래일 - 거래 확대(사용자 결정, 백테스트 미검증): RSI 46/35 정본 경로, 모멘텀 v2 ON, SIDEWAYS ADX AND, 트레일링 1차 익절 후, 20일 시간손절 ON 인프라·보안 - 계좌·손익 GET 인증, 세션 is_active·관리자 경로, 서명키 파생, realip, WS 토큰 마스킹 - KIS 토큰 즉시 실패(sleep 제거)·무효 시 캐시 삭제, 주문 5xx+JSON 본문 반환 - db_worker 종료 drain(멱등 재실행·커밋 불명 격리·예산·밴 커밋), stop_grace 40s, Redis 타임아웃·volatile-lru, /health DLQ·캐시 - KRX 휴장일, py3.11 비호환 f-string 수정 + Jenkins 이미지 내 compileall·헬스 실패 시 빌드 실패 하네스: rules_check 에 PEP 701 f-string 검사, 마커(allow-*), deploy 스모크 401 기준 CLAUDE.md: 실제 동작·플래그·백로그(§8.5-27~38) 갱신 backend 1451 passed / hooks 112 passed / tsc ok / py3.9 compile 0 errors Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
52 lines
4.3 KiB
Markdown
52 lines
4.3 KiB
Markdown
---
|
|
name: deploy
|
|
description: |
|
|
auto-stock 운영 배포(dev → main → Jenkins → NAS) 절차. 사용자가 "배포해", "main 에 올려",
|
|
"릴리스", "운영 반영"을 요청하거나 배포 후 재기동/스모크 확인이 필요할 때 사용.
|
|
사용법: /deploy [-m "병합 메시지"] [--watch-only] [--no-test]
|
|
---
|
|
|
|
# 배포 (deploy)
|
|
|
|
수동 절차를 `.claude/scripts/deploy.sh` 로 코드화했다. **직접 `git push origin main` / `HEAD:main` 을 치지 말고 이 스크립트를 쓴다**
|
|
(작업 브랜치 dev 를 바꾸지 않고, 임시 worktree 에서 병합하며, 재기동 감시·스모크까지 한 번에 한다).
|
|
|
|
## 배포 전 체크 (사람이 아니라 스크립트가 강제하는 것 + 에이전트가 확인할 것)
|
|
1. **검증 게이트**: 변경은 code-verifier/유닛 스위트 통과 상태여야 한다. 스크립트가 깨끗한 worktree 의 HEAD 기준으로
|
|
`pytest tests/ --ignore=tests/integration` 를 다시 돌리며, 실패하면 중단한다. `--no-test` 는 금지는 아니지만 경고 대상이다 — 정당한 사유(문서만 변경 등)가 있을 때만.
|
|
2. **작업트리**: `.claude/settings.local.json` 외 미커밋 변경이 있으면 중단. 먼저 커밋(커밋 게이트가 backend 변경 시 테스트를 돌린다).
|
|
3. **브랜치**: dev 에서만 실행. 새 브랜치 생성 금지.
|
|
4. **alembic 마이그레이션 포함 여부**: 스크립트가 `backend/alembic/versions` 변경을 감지하면 경고한다. 포함 시 Jenkins 로그에서
|
|
`alembic upgrade head` 가 **앱 기동보다 먼저** 성공했는지 반드시 확인하도록 사용자에게 안내한다(CLAUDE.md §1 배포 순서, 전략 파라미터 마이그레이션 0012 계열 포함).
|
|
5. **장중 여부**: 평일 08:30~15:40 KST 는 재기동이 매매(DT 포지션, 스케줄러, KIS 토큰)에 영향을 준다. bash_guard 가 `ask` 로 사용자 확인을 받는다. 장외(15:40 이후·주말)를 권장.
|
|
6. 운영 서버·KIS 를 직접 호출하지 않는다. 스모크는 키 없는 GET 4개뿐이다(공개 1 + 인증 필요 3 — 401 이어야 정상).
|
|
|
|
## 사용
|
|
```bash
|
|
# 전체 배포 (기본 병합 메시지)
|
|
bash .claude/scripts/deploy.sh
|
|
# 병합 메시지 지정
|
|
bash .claude/scripts/deploy.sh -m "Merge dev: DT 시간손절 밴 제외 수정"
|
|
# 이미 푸시된 배포의 재기동 감시 + 스모크만
|
|
bash .claude/scripts/deploy.sh --watch-only
|
|
# 테스트까지만 (푸시 없음) — 사전 점검용
|
|
bash .claude/scripts/deploy.sh --dry-run
|
|
# 스모크만
|
|
bash .claude/scripts/prod_smoke.sh
|
|
```
|
|
단계: (a) 작업트리 확인 → (b) worktree 유닛 스위트 → (c) `git push origin dev` → (d) 임시 worktree 에서 `origin/main` 에
|
|
`--no-ff` 병합 후 `git push origin HEAD:main` → (e) `/api/v1/journals/stats` 응답 단절 → 복귀(200 또는 401 을 "기동됨"으로 판정) 재기동 감시(최대 15분, 15초 간격)
|
|
→ (f) 스모크: 공개 `market/indices` 는 200+JSON, 인증 필요 `journals/stats`·`analysis/performance`·`market-intelligence/dashboard` 는 키 없이 **401**(200 이면 LEAK 로 FAIL). 병합 커밋 끝에 `Co-Authored-By: Claude Opus 5.5` 트레일러가 붙는다.
|
|
|
|
## 배포 후 확인 포인트
|
|
- 감시 결과: "재기동 완료" 여야 한다. "재기동 미감지"는 빌드 지연/변경 없음 — Jenkins 로그 확인. 계속 무응답이면 배포 실패 의심.
|
|
- 스모크: indices `OK`(200+JSON), 인증 엔드포인트 3개 `OK`(401). `LEAK` 는 인증이 빠진 구버전/회귀.
|
|
- compose 설정(stop_grace_period 등)이 바뀐 배포는 컨테이너 재생성(`up -d --build`)이 필요하다 — Jenkins 파이프라인이 수행하는지 확인.
|
|
- 마이그레이션 포함 시: Jenkins 로그의 alembic 단계, 그리고 `alembic_version` 이 새 head 인지.
|
|
- 장중 배포였다면: DT 포지션 복원(`restore_from_db`)·스케줄러 기동 로그, MDD 갱신 health 확인. 토큰 충돌 징후(KIS 인증 오류)가 없는지.
|
|
- 병합 충돌로 중단되면 main 은 건드려지지 않는다. dev 에 origin/main 을 병합해 해결 후 재시도.
|
|
|
|
## 하지 말 것
|
|
- 훅 비활성화/우회, `git push --force` to main, 로컬 `docker compose up`, 로컬에서 운영 DB 대상 alembic (bash_guard 가 deny).
|
|
- 사용자 승인 없이 배포 실행: main 푸시는 항상 사용자 확인(ask)을 거친다.
|