Koopo

Koopo Stories: 17-Phase Development Roadmap

Here is the official project roadmap for the Stories feature, aligned to commits and enhanced with social engagement features.

📊 Current Status

Overall Progress: 76% (13/17 phases complete)

Latest Commit: 009 - Phase 11 Complete (Interactive Features)

Next Up: Phase 14 - Performance & Optimization

Phase 0 – Foundation & Stability ✅ COMPLETE

1. Plugin bootstrap stability
2. Admin menu architecture
3. Widget rendering correctness
4. Load order safety
5. No stray output / fatals

👉 Commits: 001–003 ✅ Almost complete

Phase 1 – Stories Core Data Model ✅ COMPLETE

6. Story CPT (koopo_story)
7. Story Item CPT (koopo_story_item)
8. Meta schema + expiration model
9. Ownership + permissions rules

👉 Commits: 001–003 ✅ All CPTs, meta, and permissions implemented

Phase 2 – Seen / View Tracking ✅ COMPLETE

10. Custom DB table (story_views)
11. Insert + lookup logic
12. Unseen detection logic

👉 Commits: 001–003 ✅ Custom table with view tracking complete

Phase 3 – REST API (API-First) ✅ COMPLETE

13. Feed endpoint
14. Story detail endpoint
15. Seen endpoint
16. Upload endpoint
17. Permission callbacks

👉 Commits: 001–003 ✅ All 4 REST endpoints implemented

Phase 4 – Web UI: Stories Tray ✅ COMPLETE

18. Tray renderer
19. Unseen ring logic
20. Ordering (unseen / recent)
21. Widget + shortcode integration

👉 Commits: 001–003 ✅ Tray, widget, and shortcode complete

Phase 5 – Web UI: Viewer ✅ COMPLETE

22. Fullscreen modal
23. Progress bars
24. Tap / swipe navigation
25. Autoplay rules

👉 Commits: 001–003 ✅ Fullscreen viewer with navigation complete

Phase 6 – Uploader UX ✅ COMPLETE

26. Preview before upload
27. Rate limiting
28. Validation
29. Error handling

👉 Commits: 001–003 ✅ Upload composer with preview complete

Phase 7 – Cleanup & Expiration ✅ COMPLETE

30. Cron cleanup
31. Manual admin cleanup
32. Orphan detection

👉 Commits: 001–003 ✅ Automated cron cleanup implemented

Phase 8 – Widget Enhancements ✅ COMPLETE

33. Layout modes
34. Per-widget overrides
35. Sidebar UX polish

👉 Commits: 001–003 ✅ Horizontal/vertical layouts complete

Phase 9 – User Privacy & Granular Controls ✅ COMPLETE

36. Per-story privacy settings (public, friends only, close friends) ✅
37. Story archive (save stories beyond 24h for logged-in user) ⏸️ Deferred
38. Hide story from specific users ⏸️ Deferred
39. Close friends list integration ✅

👉 Commit: 005 ✅ Privacy controls implemented

• Privacy selector in upload UI (3 levels: public, friends, close friends)
• Database-backed close friends lists
• Privacy-aware permissions system
• REST API for close friends management
• User-facing close friends manager UI (shortcode)
• Privacy indicators on story bubbles

Phase 10 – Engagement: Reactions & Replies ✅ COMPLETE

40. Like/reaction system (emoji picker) ✅
41. Story replies (DM or comment system) ✅
42. Reaction counts display ✅
43. Reply notifications (BuddyBoss notifications integration) ✅

👉 Commits: 005, 006 ✅ Full engagement implementation (backend + frontend)

• Reactions database with 7 emoji types
• Replies database with DM/public modes
• 6 REST API endpoints for reactions & replies
• BuddyBoss notifications integration
• Privacy-aware reply visibility
• Frontend UI: Emoji picker modal, reply textarea modal
• UX: Reaction and reply buttons in story viewer
• Buttons hidden for own stories

Phase 11 – Interactive Features ✅ COMPLETE

44. ✅ Stickers database with position tracking
45. ✅ Mention sticker (@username validation)
46. ✅ Link sticker (URL + title)
47. ✅ Location sticker (name, coordinates, address)
48. ✅ Poll sticker (question + up to 4 options)
49. ✅ Poll voting system with real-time counts
50. ✅ REST API endpoints for sticker CRUD
51. ✅ Sticker UI in story composer
52. ✅ Sticker display in story viewer
53. ✅ @mention autocomplete with BuddyBoss integration

👉 Commits: 008-009 ✅ Full implementation complete

Backend:

• koopo_story_stickers table with position tracking
• koopo_story_poll_votes table for voting
• Support for 4 sticker types: mention, link, location, poll
• REST endpoints: add sticker, delete sticker, vote on poll
• Type-specific validation and sanitization

Frontend:

• Sticker toolbar in story composer with 4 sticker buttons
• Modal forms for adding each sticker type
• Draggable sticker positioning in composer preview
• Real-time sticker rendering in story viewer
• Interactive poll voting with live vote counts
• @mention autocomplete with avatar suggestions from BuddyBoss
• Click handlers: profile links for mentions, external links, Google Maps for locations

Phase 12 – Analytics & Insights ✅ COMPLETE

48. View counts per story ✅
49. Viewer list ("Seen by" feature) ✅
50. Per-user "seen" state tracking ✅
51. Story insights dashboard (who viewed, when) ✅

👉 Commit: 006 ✅ Full analytics implementation

• View counts integrated in get_story endpoint
• /stories/{id}/viewers REST endpoint for viewer list
• /stories/{id}/analytics REST endpoint for comprehensive insights
• Viewer list UI modal with avatars and timestamps
• View count badge in story viewer (author-only)
• Analytics include views, reactions, and replies
• Privacy-aware (only story author can see analytics)

Phase 13 – Moderation ✅ COMPLETE

52. Reporting ✅
53. Admin review dashboard ✅
54. Auto-hide thresholds ✅
55. Flagged content queue ✅

👉 Commit: 007 ✅ Full moderation system implemented

• Reports database with status tracking
• User reporting UI with 7 report reasons
• ⚠ Report button in story viewer
• REST API for reporting and moderation
• Admin moderation dashboard with stats
• Auto-hide stories after threshold (configurable, default: 5)
• Dismiss or delete reported stories
• Audit trail with reviewer tracking
• Can't report own stories
• One report per user per story

Phase 14 – Performance

56. Caching (transients for feeds)
57. Query optimization
58. Lazy loading for media
59. CDN integration for attachments

👉 Commit: 032

Phase 15 – React Native Readiness

60. Auth abstraction
61. Mobile-friendly payloads
62. API versioning
63. Push notification hooks

👉 Commit: 033

Phase 16 – Final Polish

64. Accessibility (ARIA labels, keyboard nav)
65. Animations & transitions
66. Edge cases & error handling
67. Internationalization (i18n)

👉 Commit: 034

Phase 17 – Hardening & Release

68. Security review
69. Back-compat testing
70. Release notes
71. Documentation

👉 Commit: 035 (v1.0)

Process change (important)

Starting Commit 004, every commit will include:

• ✅ Phase number(s) in the commit notes
• ✅ Which checklist items were completed
• ✅ Which phase is next

Example:

Commit 004: Phase 0 enhancements
- Added BuddyBoss profile URL linking
- Fixed current user avatar display
Phase 0 complete, moving to Phase 9

📋 Feature Comparison: Planned vs. Industry Standard

🎯 Development Priorities

Immediate (Next 2 weeks)

1. Phase 9: Privacy controls (essential for user trust)
2. Phase 10: Reactions & replies (drives engagement)

Short-term (1 month)

3. Phase 12: Analytics/insights (user value)
4. Phase 13: Moderation tools (platform safety)

Medium-term (2-3 months)

5. Phase 11: Interactive stickers
6. Phase 14: Performance optimization
7. Phase 15: Mobile API readiness

Long-term (3+ months)

8. Phase 16: Polish & accessibility
9. Phase 17: Security audit & v1.0 release

📝 Notes

• Privacy features (Phase 9) are critical before public launch
• Engagement features (Phase 10) should come before analytics
• Performance optimization (Phase 14) can run parallel with feature development
• All phases maintain backward compatibility with existing stories