YapHub

Appearance

MVP User Stories ​

Complete list of 31 user stories for the YapHub MVP, organized by development phase and sprint.

Overview ​

The MVP consists of 31 user stories distributed across 6 sprints, building on the completed POC foundation. These stories transform the proof-of-concept into a production-ready knowledge management system.

Total Stories: 31 Estimated Duration: 12 weeks (6 sprints) Current Sprint: Sprint 1 (Week 3)

Phase 1: Foundation (Sprint 1 - Week 3-4) ​

Data Model & Infrastructure (7 stories) ​

MSP2-405: US-116 - Refactor Knowledge to Resource Entity

  • Status: To Do
  • Sprint: 1
  • Rename Knowledge entity to Resource for semantic clarity
  • Update all references in codebase

MSP2-406: US-117 - Migrate Existing Data to Resource Schema

  • Status: To Do
  • Sprint: 1
  • Create migration script for existing data
  • Validate data integrity post-migration

MSP2-407: US-118 - Update API Endpoints for Resource Entity

  • Status: To Do
  • Sprint: 1
  • Change /api/knowledge to /api/resources
  • Update Slack bot API calls

MSP2-420: US-131 - Rename Category to ThematicList Entity

  • Status: In Progress
  • Sprint: 1
  • Rename for semantic clarity
  • Update database schema and all references

MSP2-421: US-132 - Create ThematicListManager Service

  • Status: To Do
  • Sprint: 1
  • Centralized service for list operations
  • Support filtering and statistics

MSP2-422: US-133 - Implement Default Tags Feature

  • Status: In Progress
  • Sprint: 1
  • Auto-apply tags when resource added to list
  • Configurable per thematic list

MSP2-52: US-039 - Persistent Backend Service

  • Status: In Progress
  • Sprint: 1
  • Deploy backend to VPS with monitoring
  • Configure auto-restart and health checks

Phase 2: Content & Sync (Sprint 2 - Week 5-6) ​

Content Ingestion (5 stories) ​

MSP2-408: US-119 - Implement ContentIngestionService with Strategy Pattern

  • Status: To Do
  • Sprint: 2
  • Refactor to strategy pattern for different content types
  • Support URL, text, PDF, file share

MSP2-409: US-120 - Add Async Processing via Symfony Messenger

  • Status: To Do
  • Sprint: 2
  • Implement queue system for async processing
  • Configure message handlers and retry logic

MSP2-410: US-121 - Create PHP WebScraperService

  • Status: To Do
  • Sprint: 2
  • PHP version of web scraper for backend
  • Replace Node.js implementation

MSP2-411: US-122 - Implement Tag Normalization Service

  • Status: To Do
  • Sprint: 2
  • Normalize tags (lowercase, trim, deduplication)
  • Merge duplicate tags

MSP2-412: US-123 - Add Tag Autocomplete API

  • Status: To Do
  • Sprint: 2
  • Endpoint for tag autocomplete in UI
  • Fuzzy matching and frequency-based sorting

Notion Sync (3 stories) ​

MSP2-413: US-124 - Enhance Notion Sync with Conflict Resolution

  • Status: To Do
  • Sprint: 2
  • Handle concurrent updates
  • Implement last-write-wins strategy

MSP2-414: US-125 - Add Notion Webhook Support

  • Status: To Do
  • Sprint: 2
  • Real-time sync from Notion to backend
  • Webhook endpoint and validation

MSP2-415: US-126 - Implement Notion Batch Operations

  • Status: To Do
  • Sprint: 2
  • Batch create/update for performance
  • Rate limiting and error handling

Phase 3: AI Foundation (Sprint 3 - Week 7-8) ​

AI Summaries (6 stories) ​

MSP2-416: US-127 - Create AiSummaryService Foundation

  • Status: To Do
  • Sprint: 3
  • Core AI summary service with provider abstraction
  • Support multiple AI providers

MSP2-417: US-128 - Implement AiProviderInterface

  • Status: To Do
  • Sprint: 3
  • Interface for AI provider abstraction
  • OpenAI and OpenRouter implementations

MSP2-418: US-129 - Create SummaryPromptBuilder Service

  • Status: To Do
  • Sprint: 3
  • Build prompts based on target group and content type
  • Template system with variable substitution

MSP2-419: US-130 - Implement Role-Based Summary Generation

  • Status: To Do
  • Sprint: 3
  • Generate summaries for different roles (developer, manager, executive)
  • Role-specific prompt templates

MSP2-423: US-134 - Add Language Detection and Directive

  • Status: To Do
  • Sprint: 3
  • Detect content language
  • Add explicit language directive to prompts

MSP2-424: US-135 - Implement Summary Caching with Redis

  • Status: To Do
  • Sprint: 3
  • Cache summaries in Redis
  • Cache invalidation strategy

Phase 4: AI Enhancement (Sprint 4 - Week 9-10) ​

Summary Management (4 stories) ​

MSP2-425: US-136 - Add Summary Regeneration UI

  • Status: To Do
  • Sprint: 4
  • Regenerate summaries with different parameters
  • History tracking

MSP2-426: US-137 - Implement Manual Summary Editing

  • Status: To Do
  • Sprint: 4
  • Allow users to edit AI-generated summaries
  • Track manual edits vs AI-generated

MSP2-427: US-138 - Add Token Tracking and Cost Allocation

  • Status: To Do
  • Sprint: 4
  • Track token usage per summary
  • Cost calculation and reporting

MSP2-428: US-139 - Create Summary Quality Feedback System

  • Status: To Do
  • Sprint: 4
  • Users can rate summary quality
  • Feedback for prompt improvement

Phase 5: Digests (Sprint 5 - Week 11-12) ​

Digest System (4 stories) ​

MSP2-429: US-140 - Create Digest Entity and Service

  • Status: To Do
  • Sprint: 5
  • Entity for scheduled digests
  • Service for digest generation

MSP2-430: US-141 - Implement Digest Scheduling

  • Status: To Do
  • Sprint: 5
  • Schedule digests (daily, weekly, monthly)
  • Cron job integration

MSP2-431: US-142 - Create Digest Template System

  • Status: To Do
  • Sprint: 5
  • Templates for different digest types
  • Customizable formatting

MSP2-432: US-143 - Add Digest Delivery to Slack

  • Status: To Do
  • Sprint: 5
  • Send digests to Slack channels
  • User preferences for digest subscriptions

Phase 6: Search & Polish (Sprint 6 - Week 13-14) ​

Search & Filtering (2 stories) ​

MSP2-433: US-144 - Implement Advanced Search

  • Status: To Do
  • Sprint: 6
  • Full-text search across resources
  • Filter by tags, lists, date range

MSP2-434: US-145 - Add Saved Searches

  • Status: To Do
  • Sprint: 6
  • Save search queries for reuse
  • Share saved searches with team
  • POC Scope - POC achievements
  • MVP Roadmap - Sprint planning timeline
  • MVP Scope - Detailed requirements and success criteria
  • Jira Tickets - Complete ticket tracking (252 tickets)

Progress Tracking ​

For real-time progress tracking, see:

  • Jira Sprint 1 - Current sprint tickets
  • Weekly Reports - Detailed weekly progress
  • Project Sprints - Sprint planning and retrospectives