NEEDS_REVIEW_V-Model spec
NEEDS_REVIEW_119 requirements, zero gaps. Each requirement traces forward to a test case and backward to a user story.
NEEDS_REVIEW_How well it works — the engineering proof.
NEEDS_REVIEW_Cosmic Story v2 was specified using the V-Model methodology. Every requirement has a number, every NFR has a measurement contract, every test target has a coverage threshold.
- NEEDS_REVIEW_119 traceable requirements — zero gaps in the V-Model.
- NEEDS_REVIEW_Performance targets: 30 s chapter generation (p95), 500 ms p99 GET latency, 3 s frontend TTI on 4G.
- NEEDS_REVIEW_Security: AES-256 at rest, TLS 1.2+ in transit, JWT with 1 h access / 30 d refresh, soft-delete with 30 d PII hard-delete.
- NEEDS_REVIEW_Accessibility: prefers-reduced-motion respected globally; VoiceOver and TalkBack labels on every interactive element.
NEEDS_REVIEW_Specification rigor
NEEDS_REVIEW_Cosmic Story v2 ships with a V-Model spec — every level (system, architecture, module, unit) has corresponding test plans, with trace checkpoints between each pair.
NEEDS_REVIEW_20 user stories
NEEDS_REVIEW_Each one has explicit acceptance criteria. The 9 'Must Have' stories block release; the 6 'Should Have' inform iteration; the 5 'Could Have' are phase 2.
NEEDS_REVIEW_15 functional requirements
NEEDS_REVIEW_Album cap, chapter rate limit, resonance dimension count, paywall pacing rules, offline behaviour — each numbered and tested.
NEEDS_REVIEW_12 non-functional categories
NEEDS_REVIEW_Performance, security, testing, privacy, availability, accessibility — each with a measurement contract showing how it's verified.
NEEDS_REVIEW_Performance targets
NEEDS_REVIEW_Not promises — written targets with a measurement method for each.
NEEDS_REVIEW_Chapter generation
NEEDS_REVIEW_30 seconds or better for 95% of requests. Measured against BullMQ job duration distribution.
NEEDS_REVIEW_API latency
NEEDS_REVIEW_p99 GET /people, /journal, /inbox under 500 milliseconds at 1,000 concurrent users. Measured via k6 load test.
NEEDS_REVIEW_Frontend TTI
NEEDS_REVIEW_Time-to-interactive of 3 seconds or better on simulated 4G. Measured via Lighthouse CI.
NEEDS_REVIEW_Test-coverage targets
NEEDS_REVIEW_Statement coverage thresholds enforced by `pnpm test:cov` gates.
NEEDS_REVIEW_Backend services
NEEDS_REVIEW_85% statement coverage target on services; 80% on controllers. Verified via Vitest coverage reports.
NEEDS_REVIEW_Frontend stores + composables
NEEDS_REVIEW_85% on composables; 90% on Pinia stores. Same Vitest gate, same reports.
NEEDS_REVIEW_Security posture
NEEDS_REVIEW_Real measures, named explicitly.
NEEDS_REVIEW_Encryption at rest
NEEDS_REVIEW_Journal and chapter bodies stored AES-256 encrypted with platform-managed keys. No plaintext bodies on disk.
NEEDS_REVIEW_TLS in transit
NEEDS_REVIEW_All API traffic over TLS 1.2 or newer. HTTP redirects to HTTPS at the edge.
NEEDS_REVIEW_JWT lifetimes
NEEDS_REVIEW_Access tokens expire after 1 hour; refresh tokens after 30 days. Token rotation on refresh.
NEEDS_REVIEW_Soft delete + PII hard-delete
NEEDS_REVIEW_Soft-delete first, with a 30-day window before hard-delete of personally identifiable information.
NEEDS_REVIEW_Accessibility baseline
NEEDS_REVIEW_Not aspiration — a baseline enforced in code review.
NEEDS_REVIEW_prefers-reduced-motion
NEEDS_REVIEW_When set at the OS level, all GSAP animations become opacity-only fades. No parallax, no transforms, no scroll-driven motion.
NEEDS_REVIEW_VoiceOver + TalkBack labels
NEEDS_REVIEW_Every interactive element has an ARIA label. Verified manually on iOS VoiceOver and Android TalkBack before release.
NEEDS_REVIEW_Are these targets, or current measured numbers?
NEEDS_REVIEW_Targets, with measurement contracts. Cosmic Story v2 is in active development; the numbers here come from the V-Model NFR table that gates release. The 'how it's measured' column tells you exactly which tool produces the verification signal.
NEEDS_REVIEW_Why is 85% the backend coverage target rather than 100%?
NEEDS_REVIEW_Because 100% coverage is a vanity metric — past a certain point it tests trivial code at the cost of real review attention. 85% statement coverage with a manual coverage-review on the gap is how we balance machine-verifiable rigor with engineering judgment.
NEEDS_REVIEW_What does 'crisis-aware bypass' actually mean — is this a clinical safety claim?
NEEDS_REVIEW_No. It is a mechanism: messages flagged by a crisis classifier are exempt from the free daily message cap. We don't promise clinical outcomes; we just don't lock the door at the worst possible moment. For real crisis resources, please contact a local service — Cosmic Story v2 is not a therapy product.
[NEEDS_REVIEW] Try My Zodiac AI today
[NEEDS_REVIEW] While Soulwise opens its waves, our flagship astrology app is already in your hands.
ज्योतिषीय सामग्री चिंतन और मनोरंजन के लिए है। यहां वर्णित Cosmic Story v2 की सुविधाएं विकास में हैं; उपलब्धता बिना सूचना के बदल सकती है।