개발–검증 연동 절차 (Dev × Validation)
쏠쏠 크리에이터 LMS의 모든 개발은 docs/validation/ 검증 패키지를 정본(SoT) 으로 삼아 "제대로 개발되고 있는지"를 화면ID 단위로 확인한다. 본 문서는 그 상시 절차다. (기획·운영팀 학습 결과 통합 — 기획-lead·운영-lead 브리핑 기반)
0. 원칙 (불변)
- 검증 폴더는 읽기 전용 정본:
docs/validation/의 어떤 파일도 개발 중 수정·생성·삭제하지 않는다. 내용 변경이 필요하면 기획-lead/총괄 승인 후 별도 절차로만 처리한다. - 화면ID = 추적키: 모든 작업은 대상 화면ID(예:
S-FR01-…,…-AD01-…,…-BR01-…)를 명시한다. 화면설계서 ↔ 정책 ↔ 체크리스트가 동일 ID로 1:1 매핑(누락 0)되어야 한다. - 권위(authority) 분리 — 충돌 시 우선순위:
05_정책설계서.md확정 6건 (충돌 최종값, 최우선)- 구조·상태·IA·라우팅 = 화면설계서
00~03 - 동작·규칙 =
04_정책요약.md(+ 05) - 정확한 문구·최종 비주얼 = 참조 캡처 PNG(
_exports/png/…) - 토큰값(색/간격/타이포) = 스타일가이드
[추정](OCR 본문)은 권위가 아니다 — 문구·정책을 단정하지 말고 PNG 원본/05로 확정한다.
05 확정 6건 (개발 판정 최종 기준 — 위반 시 결함)
- 닉네임 전 영역 2~15자 단일 규칙
- 무료체험 미운영 (가입=Free 즉시부여 / 유료=즉시결제, 14일 체험 UI 없음이 정상)
- 강사/서브강사 = 메뉴 화이트리스트 RBAC (관리자=전체 / 강사=본인범위 / 서브강사=강사−운영·정산·사용자관리)
- 유효시간: 가입코드 10분 / 비번재설정 30분 / 초대 48시간
- 비밀번호 문구: "영문·숫자·특수문자 3종 조합 8~16자" 통일
- 쿠폰 정액 only (Front 정률 표기 숨김)
검증 제외(있으면 오히려 결함/대상 아님)
- BR01 프로덕트(미설계)·데모보기·주요기능(실사이트 대체), 외부 IdP 로그인,
Front
마이페이지>설정>알림(폐기 화면).
1. 절차 (개발 사이클에 삽입)
| 단계 | 주체 | 할 일 | 산출/게이트 |
|---|---|---|---|
| ① 착수 전 | 기획-lead · 담당 개발자 | 대상 화면ID 확정 → 해당 화면설계서(01~03)·정책(04/05)·참조 PNG·체크리스트 항목 확인. 미정 정책(M-3 등)은 결정책임자에 선확인. | 작업 단위에 화면ID 목록 + 참조 경로 명시 |
| ② 구현 | frontend / admin / api / dba | 9개 검증축을 구현 기준으로: 존재·IA/라우팅·상태(빈/로딩/에러/예외)·공통컴포넌트·마스킹·카피·디자인토큰·반응형(1440×900·390×844)·인터랙션. 스키마는 dba 경유. | 행복경로 + 비행복 상태까지 구현 |
| ③ 셀프검증 | 담당 개발자 | 본인 화면ID 체크리스트 자가 점검(⭕/🔺/❌), 05 6건·검증제외 위반 여부 확인. | 셀프 체크 결과 |
| ④ 게이트 검증 | qa · security-reviewer · privacy-officer | qa=동작·회귀·반응형·카피(PNG 대조) / security=권한(RBAC)·시크릿 / privacy=마스킹·약관 버전·PII·비가역 게이트. | 축별 ⭕/🔺/❌ + 결함표(화면ID·심각도·증거경로·제안) |
| ⑤ 판정·컨펌 | 개발-lead · 품질·보안-lead | 기술·품질 게이트 컨펌. 종료조건 = ❌(심각도 '상') 0건 + 팀장 컨펌. 결함은 담당에 회신·재작업. | 통과/재작업 결정 |
| ⑥ 배포 | 운영-lead · deployer | 검증 게이트 통과가 선행 조건. 통과 시 CLAUDE.md "배포 일괄 절차"(커밋·푸시·배포·이력) 실행. | 배포 + 작업이력 |
비가역 행위 게이트(계정삭제·즉시환불·실결제 최종승인·데이터 영구삭제)는 절차와 무관하게 항상 사용자/운영자 확인 전제 — 자동 진행 금지.
2. 역할 (에이전트 매핑)
- 개발:
frontend-developer(FR01)·admin-developer(AD01)·api-developer(API)·dba(스키마) — 화면ID 기준 구현 + 셀프검증. 디자인 일관성은uiux-lead/ux-designer표준 준수. - 검증 게이트:
qa(동작·회귀·카피)·security-reviewer(권한·시크릿)·privacy-officer(마스킹·PII·약관). - 조율·판정:
기획-lead(화면ID/정책 정합)·개발-lead(기술 게이트)·품질·보안-lead(품질 게이트 컨펌)·운영-lead(배포·릴리스 게이트). - 총괄(
chief): 검증 라운드 운영·최종 판정·통합 보고. (참모chief-of-staff미가용 → 취합은 총괄이 직접.)
3. 산출물·기록 위치
- 작업 단위마다: 대상 화면ID 목록 + 축별 검증 결과(⭕/🔺/❌) + 결함표.
- 검증 결과·결함표는
docs/validation/밖(예:docs/dev-validation/또는 PR/작업이력)에 기록한다. 검증 정본은 불변.
4. 선결 조건 (착수 전 확보 — 현재 미비)
- 퍼블 결과물 접근 경로(폴더/URL) — 검증·대조의 입력물. 미확보 시 검증 착수 블로커.
- 스타일가이드 문서(토큰값) — 디자인축 픽셀 판정 기준.
두 입력물은 검증 라운드 착수 전 운영-lead가 확보·요청한다.