V-모델 명세
119개의 요구사항, 누락 제로. 각 요구사항은 앞으로는 테스트 케이스로, 뒤로는 사용자 스토리로 추적돼요.
얼마나 잘 작동하는가 — 엔지니어링 측면의 증거예요.
Cosmic Story v2은 V-모델 방법론으로 명세화됐어요. 모든 요구사항에는 번호가, 모든 NFR에는 측정 계약이, 모든 테스트 대상에는 커버리지 임계값이 있어요.
- 119개의 추적 가능한 요구사항 — V-모델에서 누락 제로.
- 성능 목표: 챕터 생성 30초(p95), p99 GET 지연 500ms, 4G에서 프런트엔드 TTI 3초.
- 보안: 저장 시 AES-256, 전송 시 TLS 1.2+, JWT는 액세스 1시간 / 리프레시 30일, 30일 후 PII 영구 삭제를 동반하는 소프트 삭제.
- 접근성: prefers-reduced-motion을 전역에서 준수하며, 모든 상호작용 요소에 VoiceOver와 TalkBack 레이블을 적용했어요.
명세의 엄밀함
Cosmic Story v2은 V-모델 명세와 함께 제공돼요 — 모든 수준(시스템, 아키텍처, 모듈, 유닛)에 대응하는 테스트 계획이 있고, 각 쌍 사이에 추적 체크포인트가 있어요.
20개의 사용자 스토리
각각에는 명확한 수용 기준이 있어요. 9개의 'Must Have' 스토리는 출시를 막고, 6개의 'Should Have'는 반복 개선에 반영되며, 5개의 'Could Have'는 2단계예요.
15개의 기능 요구사항
앨범 상한, 챕터 속도 제한, 공명 차원 수, 페이월 진행 규칙, 오프라인 동작 — 각각 번호가 매겨지고 테스트됐어요.
12개의 비기능 카테고리
성능, 보안, 테스트, 개인정보 보호, 가용성, 접근성 — 각 항목마다 검증 방법을 보여 주는 측정 계약이 마련되어 있어요.
성능 목표
약속이 아니라, 각 항목마다 측정 방법을 명시한 문서화된 목표예요.
챕터 생성
요청의 95%에서 30초 이내. BullMQ 작업 소요 시간 분포를 기준으로 측정해요.
API 지연 시간
동시 사용자 1,000명 환경에서 p99 GET /people, /journal, /inbox가 500밀리초 이내. k6 부하 테스트로 측정해요.
프런트엔드 TTI
시뮬레이션된 4G 환경에서 상호작용 가능 시간(TTI) 3초 이내. Lighthouse CI로 측정해요.
테스트 커버리지 목표
`pnpm test:cov` 게이트로 적용되는 구문 커버리지 기준이에요.
백엔드 서비스
서비스 구문 커버리지 목표 85%, 컨트롤러는 80%입니다. Vitest 커버리지 리포트로 검증합니다.
프론트엔드 스토어 + 컴포저블
컴포저블은 85%, Pinia 스토어는 90%입니다. 동일한 Vitest 게이트, 동일한 리포트를 사용합니다.
보안 태세
실제 조치를 명확히 명시했습니다.
저장 데이터 암호화
저널과 챕터 본문은 플랫폼이 관리하는 키로 AES-256 암호화되어 저장됩니다. 디스크에 평문 본문은 저장되지 않습니다.
전송 중 TLS
모든 API 트래픽은 TLS 1.2 이상으로 전송됩니다. HTTP는 엣지에서 HTTPS로 리디렉션됩니다.
JWT 수명
액세스 토큰은 1시간 후, 리프레시 토큰은 30일 후 만료됩니다. 갱신 시 토큰이 회전됩니다.
소프트 삭제 + 개인식별정보 완전 삭제
먼저 소프트 삭제를 진행하고, 30일의 유예 기간이 지난 뒤 개인식별정보를 완전히 삭제해요.
접근성 기준선
이상이 아니라, 코드 리뷰에서 실제로 적용되는 기준선이에요.
prefers-reduced-motion
OS 수준에서 설정하면 모든 GSAP 애니메이션이 불투명도만 변하는 페이드로 바뀌어요. 패럴랙스도, 변형도, 스크롤로 움직이는 효과도 없어요.
VoiceOver + TalkBack 레이블
모든 상호작용 요소에 ARIA 레이블이 있어요. 출시 전 iOS VoiceOver와 Android TalkBack에서 수동으로 검증해요.
이건 목표치인가요, 아니면 현재 측정된 수치인가요?
측정 계약이 포함된 목표치예요. Cosmic Story v2은 현재 활발히 개발 중이며, 여기 나온 수치는 출시를 통제하는 V-Model NFR 표에서 가져온 거예요. '측정 방법' 열을 보면 어떤 도구가 검증 신호를 만들어 내는지 정확히 알 수 있어요.
백엔드 커버리지 목표가 왜 100%가 아니라 85%인가요?
100% 커버리지는 허울뿐인 지표이기 때문입니다. 일정 수준을 넘어서면 사소한 코드만 검증하면서 정작 중요한 리뷰의 집중력을 빼앗아요. 85% 구문 커버리지에 더해 부족한 부분은 수동 커버리지 리뷰로 보완하는 방식으로, 기계적으로 검증 가능한 엄밀함과 엔지니어링 판단 사이의 균형을 맞추고 있어요.
'위기 인지 우회'란 실제로 무엇을 뜻하나요? 임상적 안전성을 보장한다는 의미인가요?
아니요. 이는 하나의 메커니즘이에요. 위기 분류기가 표시한 메시지는 무료 일일 메시지 한도에서 제외됩니다. 저희는 임상적 결과를 약속하지 않아요. 다만 가장 힘든 순간에 문을 잠그지 않을 뿐이에요. 실제 위기 상황에 필요한 도움은 지역 서비스에 연락해 주세요. Cosmic Story v2는 치료 제품이 아닙니다.
오늘 My Zodiac AI를 만나보세요
Soulwise가 물결을 열어가는 지금, 우리의 대표 점성술 앱은 이미 여러분의 손안에 있어요.
점성술 콘텐츠는 성찰과 즐거움을 위한 것입니다. 여기서 설명하는 Cosmic Story v2 기능은 개발 중이며, 제공 여부는 예고 없이 변경될 수 있습니다.