User Stories: Personal Journaling¶

Overview¶

Stories covering daily entries, guided flows, structured metric capture, reflection insights, and offline-first sync.

Stories¶

US-JRN-001: Create Journal Entries¶

As a Mindful Planner, I want to write free-form journal entries with timestamps, so that I can capture thoughts and experiences as they happen.

Acceptance Criteria:

• Create entries with text content and an occurred_at timestamp
• Support multiple entry items (notes, ratings, measurements) in a single entry
• View entries in reverse chronological order

US-JRN-002: Use Guided Flows¶

As a Mindful Planner, I want to use guided journaling flows with structured prompts, so that I can build consistent habits without deciding what to write about each day.

Acceptance Criteria:

• Create flows with ordered prompts of different types (text, rating, choice)
• Start a flow and step through prompts sequentially
• Responses are saved as structured entry items

US-JRN-003: Track Custom Metrics¶

As a Mindful Planner, I want to define and track custom metrics (mood, sleep, energy, exercise), so that I can quantify habits and spot trends over time.

Acceptance Criteria:

• Define metrics with name, type (numeric, rating, enum), and scale
• Log metric values as part of journal entries
• View metric history as a time series

US-JRN-004: View Insights and Trends¶

As a Mindful Planner, I want to see visualizations of my journaling data over time, so that I can identify patterns in my mood, habits, and well-being.

Acceptance Criteria:

• View daily rollups of numeric and rating metrics
• See trends over configurable time ranges (week, month, quarter)
• Visualize categorical data as frequency distributions

US-JRN-005: Manage Multiple Journals¶

As a Mindful Planner, I want to organize entries across multiple journals (personal, work, health), so that I can keep different areas of my life separate.

Acceptance Criteria:

• Create multiple journals within a space
• Each journal has its own metric definitions
• Filter entries by journal

US-JRN-006: Sync Entries Offline¶

As a Mindful Planner, I want to write journal entries while offline and sync them when I'm back online, so that I can journal anywhere without internet dependency.

Acceptance Criteria:

• Create entries locally when offline
• Sync entries via idempotent UUID-based upserts when connectivity returns
• Handle conflicts via optimistic concurrency (revision field)

US-JRN-007: Control Entry Privacy¶

As a Mindful Planner, I want to mark journal entries as private or space-visible, so that I control who can see sensitive reflections.

Acceptance Criteria:

• Set journal visibility to private_to_user or space_visible
• Private entries are only visible to the author
• Space-visible entries are accessible to all space members