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.
Il contenuto astrologico è per la riflessione e l'intrattenimento. Le funzionalità di Cosmic Story v2 descritte qui sono in sviluppo; la disponibilità può cambiare senza preavviso.