풀스택 데모 제작·완료 검토
SONAX CARE 제작 회고를 반영한 feature-verification의 실행 순서다. 기존 5종 검증을
SONAX CARE 제작 회고를 반영한 feature-verification의 실행 순서다. 기존 5종 검증을 대체하지 않으며 테스트·골든 개수만으로 원본 일치나 공개 배포를 판정하지 않는다.
단계 순서#
- platform_preflight: 공급 ref·생성·의존성·DB·CI·게시 경로를 먼저 확인한다. 공통 도구 결함은 공급 저장소에서 고치고 제품 구현과 별도 변경으로 추적한다.
- reference_review: 사용자가 지정한 원본 URL/리비전과 대표 화면을 고정한다. 모바일·태블릿·데스크톱에서 같은 데이터/상태의 원본과 실제 렌더를 나란히 비교한다. 내비게이션, 구획 순서, 폼, 요약, 표 밀도와 주요 동작을 확인한다. 참조가 없으면 그 사실과 기준으로 사용할 요구사항을 기록한다. 확인하지 않은 원본을 비교했다고 쓰지 않는다.
- vertical_slice: 한 개의 핵심 업무를 실제 서버까지 연결한다. 예: 예약 생성 → 서명 접수 → 점주 완료 → 같은 데이터 재조회. localOnly와 server 증거를 분리한다.
- runtime_transitions: 아래 연속 동작을 실제 마운트/라우터/브라우저에서 검증한다.
- golden_baseline: 대표 화면의 실제 비교가 끝난 뒤 기준 이미지를 확정한다. 전체 기능·다국어·테마·글자 배율로 확장하고 같은 CI 렌더러에서 compare한다.
- public_verification: 실제 게시 URL·소스 리비전·API·포털 진입을 확인한다. 첫 로딩, 직접 접근, 새로고침과 핵심 업무 흐름을 확인한 뒤 완료로 보고한다.
제품 구현 중 공통 기반이 바뀌면 영향받은 단계부터 다시 확인한다. 이미 검증한 같은 트리의 증거는 기존 ci-receipts 규약으로 재사용하고 불필요한 전체 재실행은 하지 않는다.
runtime_transitions — 첫 진입 다음 행동#
| 위험 | 필요한 실제 단언 |
|---|---|
| 같은 문서의 항목 A → B | 라우트/토큰 변경 후 B 데이터, 로딩 종료, 이전 취소 확인·컨트롤러 미재사용 |
| 취소 → 재예약 | 취소 상태와 서버 수용량 해제, 새 예약 성공, 이전 요청이 새 화면을 덮지 않음 |
| 처음 불러오는 언어 + 테마 동시 변경 | 지연 로딩 중복·요청 순서 역전에도 마지막 선택의 실제 문구/lang/dir/테마 적용 |
| 로딩 실패 → 재시도 | 실패가 캐시에 고착되지 않고 다음 성공 요청이 실제 화면을 갱신 |
| 새로고침·뒤로가기·세션 만료 | 상태 복원 또는 명시적 재로그인, 역할/매장 경계 보존, 무한 로딩 없음 |
모든 앱에 예약을 억지로 만들지 않는다. 같은 위험을 가진 제품 동작으로 매핑하고 해당 없는 행은 소스 근거와 이유를 기록한다. 각 적용 행에 테스트 경로, 실행 명령, 실제 결과/로그를 연결한다. 단순 첫 화면 캡처·메서드 호출 횟수는 이 증거가 아니다.
서로 바꿔 쓸 수 없는 증거#
- reference_review: 원본과 실제 렌더의 비교 및 남은 차이. Figma 연결 인스턴스 검사는 보조 증거다.
- golden_compare: 확정 기준 대비 회귀. capture/update 성공이나 816장 같은 개수는 디자인 정답의 증거가 아니다.
- runtime_transitions: 사용자가 연속으로 행동했을 때의 상태·서버 결과.
- public_verification: 배포된 리비전에서의 실제 동작. 로컬/PR 빌드 성공을 게시 성공으로 바꾸지 않는다.
각 증거는 source revision, command/review method, environment, artifact URL/path, result(PASS/FAIL/BLOCKED/근거 있는 N/A), remaining differences를 기록한다. 골든 갱신은 비교 실패를 지우기 위한 자동 조치가 아니다. 실제 변경을 검토한 뒤 갱신한다.
시간 보고#
first_verification, reused_verification, deployment, public_smoke를 별도 측정한다.
각 측정은 run URL, source/tree revision, 시작/종료 UTC, 초 단위 경과와 실행 범위를 남긴다.
첫 검증은 해당 리비전의 전체 검증, 재사용은 기존 성공 기록 조회/재사용이다. 배포 시간에
스모크가 포함되면 범위를 명시하고 겹치는 시간을 합산하지 않는다. 미측정은 null이며 0이 아니다.
재사용 16초를 최초 검증 또는 전체 제작·배포 시간으로 보고하지 않는다.
공급 템플릿: coco-de/bricks docs/templates/demo-delivery-review.md.
계획 출력: coco-de/co-bricks delivery_review(계획이지 PASS가 아님).
최종 대장: coco-de/cocode docs/demo-evidence/README.md.