V-Model spec
119 requirements, zero gaps. Each requirement traces forward to a test case and backward to a user story.
How well it works — the engineering proof.
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.
- 119 traceable requirements — zero gaps in the V-Model.
- Performance targets: 30 s chapter generation (p95), 500 ms p99 GET latency, 3 s frontend TTI on 4G.
- 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.
- Accessibility: prefers-reduced-motion respected globally; VoiceOver and TalkBack labels on every interactive element.
Specification rigor
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.
20 user stories
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.
15 functional requirements
Album cap, chapter rate limit, resonance dimension count, paywall pacing rules, offline behaviour — each numbered and tested.
12 non-functional categories
Performance, security, testing, privacy, availability, accessibility — each with a measurement contract showing how it's verified.
Performance targets
Not promises — written targets with a measurement method for each.
Chapter generation
30 seconds or better for 95% of requests. Measured against BullMQ job duration distribution.
API latency
p99 GET /people, /journal, /inbox under 500 milliseconds at 1,000 concurrent users. Measured via k6 load test.
Frontend TTI
Time-to-interactive of 3 seconds or better on simulated 4G. Measured via Lighthouse CI.
Test-coverage targets
Statement coverage thresholds enforced by `pnpm test:cov` gates.
Backend services
85% statement coverage target on services; 80% on controllers. Verified via Vitest coverage reports.
Frontend stores + composables
85% on composables; 90% on Pinia stores. Same Vitest gate, same reports.
Security posture
Real measures, named explicitly.
Encryption at rest
Journal and chapter bodies stored AES-256 encrypted with platform-managed keys. No plaintext bodies on disk.
TLS in transit
All API traffic over TLS 1.2 or newer. HTTP redirects to HTTPS at the edge.
JWT lifetimes
Access tokens expire after 1 hour; refresh tokens after 30 days. Token rotation on refresh.
Soft delete + PII hard-delete
Soft-delete first, with a 30-day window before hard-delete of personally identifiable information.
Accessibility baseline
Not aspiration — a baseline enforced in code review.
prefers-reduced-motion
When set at the OS level, all GSAP animations become opacity-only fades. No parallax, no transforms, no scroll-driven motion.
VoiceOver + TalkBack labels
Every interactive element has an ARIA label. Verified manually on iOS VoiceOver and Android TalkBack before release.
Are these targets, or current measured numbers?
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.
Why is 85% the backend coverage target rather than 100%?
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.
What does 'crisis-aware bypass' actually mean — is this a clinical safety claim?
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.
Try My Zodiac AI today
While Soulwise opens its waves, our flagship astrology app is already in your hands.
Astrology content is for reflection and entertainment. Cosmic Story v2 features described here are in development; availability is subject to change without notice.