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.

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

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

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

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

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

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

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

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

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.)

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

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

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

Additional user stories will be developed for later phases as the project evolves.