Skip to content

chore(release): AI PR 자동 검증 체계 완성 - #67

Merged
hywznn merged 2 commits into
mainfrom
develop
Aug 18, 2026
Merged

chore(release): AI PR 자동 검증 체계 완성#67
hywznn merged 2 commits into
mainfrom
develop

Conversation

@hywznn

@hywznn hywznn commented Aug 18, 2026

Copy link
Copy Markdown
Member

Closes #34

변경 이유

기존 AI 저장소는 main 배포 Workflow만 있어 PR 단계에서 앱 회귀, 선택 의존성 누락, 운영체제 차이를 구분하기 어려웠습니다. 프로젝트 마무리 단계에서 핵심 앱 품질과 환경 전용 검증을 자동으로 확인할 수 있도록 PR CI를 완성합니다.

변경 내용

핵심 앱 검증

  • develop·main 대상 PR에서 Python 3.12와 고정 uv 버전 사용
  • uv sync --frozen --extra dev 기반 재현 가능한 설치
  • app + tests Ruff 검사
  • 외부 Provider가 필요 없는 핵심 pytest 실행
  • 같은 PR의 이전 실행을 취소하는 concurrency 적용

환경별 계약 분리

  • Qdrant 선택 의존성 설치와 관련 계약 테스트를 별도 Ubuntu Job으로 실행
  • PowerShell OCR 스크립트 계약을 별도 Windows Job으로 실행
  • Qdrant·Windows OCR marker를 등록해 core 실패와 환경 차이를 분리

CI 환경 격리

  • FOWOCO_ENV_FILE=/dev/null로 개발자의 로컬 .env가 CI 결과에 섞이지 않도록 처리
  • Intent·A.X·CLOVA OCR·모델 Warmup을 core CI에서 비활성화
  • 기존 Ruff E501 두 곳을 정리해 앱 검사 기준선 오류 0건 유지

검증 결과

  • 핵심 테스트: 655 passed, 3 skipped, 16 deselected
  • Qdrant 계약: 8 passed
  • PowerShell OCR 계약: 2 passed
  • uv run ruff check app tests: 통과
  • Workflow YAML 구문 검사: 통과
  • GitHub Actions Core pytest · App Ruff: 성공
  • GitHub Actions Qdrant contract: 성공
  • GitHub Actions Windows OCR script contract: 성공

배포 및 호환성

  • 런타임 API, Agent 출력 계약, 모델 선택 로직은 변경하지 않습니다.
  • FOWOCO_ENV_FILE을 설정하지 않으면 기존처럼 .env를 읽습니다.
  • Kubernetes는 기존 ai-env Secret의 FOWOCO_* 환경변수를 그대로 사용합니다.
  • /dev/null 설정은 PR CI Workflow에만 적용됩니다.
  • main 병합 후 기존 배포 Workflow가 동일한 방식으로 이미지 빌드와 Rollout을 수행합니다.

이번 PR에서 분리한 범위

  • BERT·A.X·LLM 실모델 Smoke Test는 Token·모델 캐시가 필요한 Staging/수동 검증으로 유지합니다.
  • 내장 hwp-editor와 운영 스크립트의 기존 Ruff 부채는 앱 PR 판정에서 제외합니다.
  • Required Check 강제 여부는 저장소 보호 규칙 정책으로 관리하며 코드 범위에는 포함하지 않습니다.

개인정보·보안

  • 실제 개인정보, 원본 신분서류, Token, Secret을 포함하지 않았습니다.
  • 외부 LLM·OCR·Intent Provider를 PR CI에서 호출하지 않습니다.
  • AI 결과를 자동 승인·법적 결론·기관 제출 완료로 표현하지 않습니다.

리뷰 포인트

  1. core, Qdrant, Windows OCR의 책임이 Check 이름으로 명확히 분리되는지
  2. 로컬 .env 격리가 실제 배포 환경변수 주입에 영향을 주지 않는지
  3. develop → main 변경 범위가 CI 관련 9개 파일로 한정되는지

hywznn and others added 2 commits August 18, 2026 17:36
@hywznn hywznn changed the title Develop chore(release): AI PR 자동 검증 체계 완성 Aug 18, 2026
@hywznn
hywznn merged commit 57aa2d5 into main Aug 18, 2026
3 checks passed
@hywznn
hywznn deleted the develop branch August 19, 2026 06:27
@hywznn
hywznn restored the develop branch August 19, 2026 06:27
@hywznn
hywznn deleted the develop branch August 20, 2026 06:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore(ci): develop PR pytest·Ruff 자동 검증 추가

1 participant