MyStoryFlow Architecture Documentation v1.1
Current Version: 1.1 Last Updated: 2025-01-29
Quick Start
New to the project? Start here:
- Read the Quick Reference - One-page summary of key decisions
- Review the v1.1 UX Roadmap - Full implementation plan
- Understand our Competitive Position - Why we’re different
Core Concept: Story = Chapter
The most important architectural decision: A story IS a chapter.
When you add a story to a book, it becomes a chapter. There is no intermediate layer.
Voice/Conversation → Story → Book
↑ ↑ ↑
artifacts the unit ordered
(preserved) of content collectionDocument Index
Active Documents (v1.1)
| Document | Purpose | When to Read |
|---|---|---|
| Quick Reference | One-page decision guide | Before making any changes |
| v1.1 UX Roadmap | Full implementation plan | Planning implementation |
| Implementation Gap Analysis | Current vs target state gaps | Starting implementation |
| Competitor Analysis | Industry research | Understanding positioning |
| Database Schema v1.1 | Database design | Database changes |
Key Decisions Summary
| Decision | Chosen Option | Rationale |
|---|---|---|
| Content Model | Story = Chapter | Industry standard, reduces complexity |
| Naming | ”Story Projects” | Preserves storyteller_name semantics |
| Dialog Library | Radix (not Headless UI) | Already in codebase |
| Editor | TipTap with progressive disclosure | Power + simplicity |
| Artifacts | source_recording_ids[], source_conversation_ids[] | Preserve original voice |
| Book Structure | books.story_ids[] array | Simple ordering |
Implementation Phases
| Phase | Focus | Status |
|---|---|---|
| 1 | Foundation & Navigation | Not Started |
| 2 | Unified Content Creation | Not Started |
| 3 | Story-Centric Data Model | Not Started |
| 4 | Editor Progressive Disclosure | Not Started |
Current Database State
Based on actual database validation (2025-01-29):
| Feature | Status | Notes |
|---|---|---|
books.story_ids UUID[] | EXISTS | Already implemented |
stories.source_conversation_ids UUID[] | EXISTS | Already implemented |
stories.source_recording_ids UUID[] | MISSING | Migration needed |
books.section_breaks JSONB | MISSING | Migration needed |
book_chapters table | Active | To be deprecated |
Version History
| Version | Date | Description |
|---|---|---|
| 1.1.1 | 2025-01-29 | Added implementation gap analysis, current vs target state |
| 1.1 | 2025-01-29 | Story = Chapter model, competitor analysis, schema updates |
| 1.0 | 2025-01-29 | Initial architecture + UX review combined |
Related Documentation
- Authentication: Authentication System Overview
- Cross-App Auth: Cross-App Authentication
- Session Management: Session Management