This document outlines the core user stories for the IdeaScore application, organized by development phase. These stories define the functionality from the user's perspective and will guide our implementation.
Phase 1: Core Data Model & Basic UI
User Story 1.1: Adding a New Idea
As a user, I want to add a new idea with a title and description So that I can keep track of my project ideas Acceptance Criteria:
I can access an "Add Idea" form from the main page
I can enter a title (required) and description (optional)
I receive confirmation when my idea is successfully saved
I am notified if there are validation errors
My idea appears in the list after submission
User Story 1.2: Scoring Ideas
As a user, I want to assign effort and payoff scores to my ideas So that I can evaluate and prioritize them effectively Acceptance Criteria:
I can assign an effort score (1-10) to each idea
I can assign a payoff score (1-10) to each idea
The system calculates a ratio (payoff/effort) automatically
I receive clear visual feedback on the scale (1=low, 10=high)
I can update these scores at any time
User Story 1.3: Viewing My Ideas
As a user, I want to view a list of all my ideas So that I can browse and review them Acceptance Criteria:
I can see all my ideas in a list format
Each idea displays its title, creation date, and scores
I can see the calculated payoff-to-effort ratio
The list has good readability with sufficient spacing
An empty state is shown when I have no ideas
User Story 1.4: Sorting Ideas
As a user, I want to sort my ideas by different criteria So that I can view them in a way that's most useful to me Acceptance Criteria:
I can sort by date added (newest/oldest first)
I can sort by payoff score (high/low)
I can sort by effort score (high/low)
I can sort by ratio (high/low)
The current sort method is visually indicated
Phase 2: Enhanced UI & Basic Features
User Story 2.1: Editing Ideas
As a user, I want to edit my existing ideas So that I can update information as my thinking evolves Acceptance Criteria:
I can select an idea to edit
The edit form is pre-populated with existing data
I can modify any field (title, description, scores)
I can cancel edits without saving
Changes are reflected immediately after saving
User Story 2.2: Deleting Ideas
As a user, I want to remove ideas I no longer need So that my idea list stays relevant and manageable Acceptance Criteria:
I can delete an idea from the list or detail view
I am asked to confirm before deletion
I receive confirmation after successful deletion
The idea disappears from my list immediately
I can't accidentally delete multiple ideas at once
User Story 2.3: Dashboard Overview
As a user, I want a dashboard view of my ideas So that I can quickly see insights and top ideas Acceptance Criteria:
I can see summary statistics (total ideas, average scores)
I can see my top 5 ideas by ratio
I can see recently added ideas
I can navigate to full lists from the dashboard
The dashboard loads as the default landing page
Phase 3: Tagging System
User Story 3.1: Adding Tags to Ideas
As a user, I want to add tags to my ideas So that I can categorize and filter them effectively Acceptance Criteria:
I can add multiple tags to any idea
I can create new tags or select from existing ones
I can see all tags applied to an idea
I receive autocomplete suggestions while typing
Tags are visually distinct and readable
User Story 3.2: Filtering by Tags
As a user, I want to filter my ideas by tags So that I can focus on specific categories Acceptance Criteria:
I can select one or more tags to filter by
The idea list updates to show only matching ideas
I can see which filters are currently active
I can clear all filters with one action
I can combine tag filters with other filters (score ranges, etc.)
Phase 4: Visualization
User Story 4.1: Viewing the Bubble Chart
As a user, I want to see my ideas in a bubble chart So that I can visually understand the effort/payoff relationship Acceptance Criteria:
Ideas appear as bubbles positioned by effort (x-axis) and payoff (y-axis)
Bubble size represents another metric (e.g., recency)
I can hover over bubbles to see idea details
I can click a bubble to go to the idea detail view
The chart is responsive and works on different screen sizes
Phase 5: Advanced Features - Part 1
User Story 5.1: Tracking Idea Status
As a user, I want to track the status of my ideas So that I can monitor their progress from concept to completion Acceptance Criteria:
I can set an idea's status (new, in-progress, completed, abandoned)
Status is visually indicated in the idea list and detail view
I can filter ideas by status
I receive a summary of ideas by status
Status changes are tracked with timestamps
User Story 5.2: Retroactive Scoring
As a user, I want to score completed ideas based on actual effort and payoff So that I can compare my estimates with reality Acceptance Criteria:
I can enter actual effort and payoff scores for completed ideas
I can see a comparison between estimated and actual scores
I receive insights about my estimation accuracy
I can track my estimation improvement over time
I can add notes about what I learned from the project
Future Phases
Additional user stories will be developed for later phases as the project evolves.