jarca-ledger-mcp/docs/batches/bat-006_20260630_pytest-apptest-smoke-ci-automation/index.md

BAT-006 pytest/AppTest/Smoke CI 자동화

• Profile: standard
• Status: release-candidate
• Included REQ: REQ-006
• Discovery: dcy-006
• Owner: 렛저장인
• Date (KST): 2026-06-30

목표

REQ-006에 따라 GitHub Actions 기반 CI 계약을 신설하고, push/PR에서 pytest 회귀 스위트, Streamlit AppTest, 대시보드 HTTP smoke, DB safety smoke를 synthetic fixture/임시 검증 DB로 자동 실행하는 필수 게이트를 구성한다.

산출물

• .github/workflows/ 아래 GitHub Actions workflow
• CI 전용 얇은 smoke wrapper entrypoint: HTTP smoke와 DB safety smoke의 결정적 실행/종료코드/로그/정리 책임
• synthetic fixture DB 준비 흐름과 운영 DB 접근 차단 정책
• pytest/AppTest/HTTP/DB safety smoke CI job 구성
• docs/project-structure.md, docs/runtime-flows.md, 필요 시 docs/runbooks/의 CI 게이트/로컬 browser evidence 경계 문서화
• BAT-006 planning/design/implementation/verification 문서와 CI evidence

범위 제한

browser-screenshot/visual regression의 CI 필수 게이트화, CD/서비스 배포 자동화, 테스트 커버리지 퍼센트 강제, 성능 벤치마크 게이트, 운영 DB 또는 실거래/실계좌 데이터의 CI 반입은 포함하지 않는다.

문서

• planning.md: delivery plan, dependencies, design gate, risks
• design.md: CI architecture, job boundaries, wrapper policy, evidence boundaries
• implementation.md: 실제 변경 파일과 로컬 실행 로그 기록
• verification.md: REQ-006 AC별 검증 evidence 및 QC handoff 기록