백엔드
상태 전이마다 테스트가 없으면, 운영 가이드가 빌드되지 않습니다
두줄요약
상태 전이·운영 안내·테스트 참조를 YAML 선언으로 통합하고 CI에서 검증했습니다. 테스트 없는 전이와 잘못된 참조를 빌드 단계에서 차단해 가이드 신뢰성을 높였습니다.
문제 상황
- 운영 가이드만으로 완료한 업무가 25개 중 6개에 그친 가이드·실제 동작 간 불일치
- CI 대상에서 빠진 E2E 테스트와 화면 동작을 우회한 테스트 코드로 결함 미탐지
- 상태·금액 검증이 부족한 테스트와 수동 관리 문서의 최신성 저하
해결 방법
- 엔티티별 YAML에 상태, 정상·금지 전이, 화면 액션, 코드 위치, 테스트 참조를 단일 선언으로 관리
- 전이별 테스트 누락과 소스에 없는 테스트 참조를 생성기에서 검증해 오류 발생 시 문서 생성 중단
- 알려진 결함을 선언에 기록하고 운영 가이드에 현재 동작과 확인 절차로 노출
구조와 흐름
- 백엔드 PR의 CI에서 YAML 선언과 테스트를 검사하고 운영 가이드·상태 다이어그램 생성
- 운영자용 출력에는 상태, 버튼 경로, 확인 지점, 화면 캡처만 제공하고 테스트 참조는 생성 검증용으로 분리
- Mermaid와 ELK 기반 다이어그램 자동 생성, 생성기 별도 모듈화
성능/운영 포인트
- 테스트 이름 변경·삭제 또는 테스트 없는 전이 추가 시 CI 실패로 PR 병합 차단
- 선언 작성 과정에서 구독·청구서·견적의 미검증 전이와 금지 전이 테스트 보강
- 재검토에서 기존에 막혔던 업무 해소, 수동 색인의 비검증 참조 불일치 확인
