Verge — Customer Feedback Platform

Verge הוא SaaS לניהול פידבק מלקוחות, חי ופעיל ב-zbang-api.

מערכת רב-יכולתית עם 7 יכולות נפרדות:

1. 🗂 Boards management — 4 boards מבודלים (Product, Bugs, Integrations, Design) עם color/icon/slug ייעודיים
2. 📝 Posts feed — 15 posts מתוייגים עם status (open/under-review/planned/in-progress/shipped), tags, ETA, pinned, אופציות סינון לפי board+status+search+sort (votes/trending/recent)
3. 👍 1-click voting — מערכת הצבעה idempotent עם UNIQUE constraint על (post_id, voter_handle); toggle clean (vote/unvote), recompute אוטומטי של vote_count
4. 💬 Threaded comments — 9 comments עם is_team flag (תגובות צוות נפרדות ויזואלית), parent_id self-ref ל-threading
5. 🚏 Public roadmap — Kanban view שאוסף posts ל-4 עמודות (Under review, Planned, In progress, Shipped) ממוין לפי vote_count
6. 🔔 Per-post subscribers — מנויים על post ספציפי או על board שלם, dedupe-aware (UniqueConstraint על email+post_id+board_id)
7. ⚙️ Workspace settings — workspace identity, accent colors, moderation flags, anonymous voting toggle, auto-notify, posts-per-page

ניתן לקנפג: workspace name, tagline, primary/accent colors, moderation_required, require_email, allow_anonymous, auto_notify, posts_per_page, custom_domain

תוצאות אמיתיות בסקרין (live data):

• 4 boards (Product, Bugs, Integrations, Design) עם 9 categories ייעודיים
• 15 posts, 326 votes (avg 21.7/post), 9 comments
• 6 subscribers על posts/boards
• e2e אומת end-to-end: יצירת post → 3 voters הצביעו → 1 unvoted (idempotent toggle) → 2 comments (customer + team) → 1 subscriber → status change ל-planned עם ETA 2026-Q3
• Roadmap: 5 planned · 3 in-progress · 2 shipped · 2 under-review

ארכיטקטורה:

• Backend: FastAPI עם 21 endpoints חשופים ב-/api/verge/* (boards CRUD, categories list, posts CRUD + filtering, votes toggle + list, comments + threading, subscribers + dedupe, roadmap aggregation, stats, settings, seed)
• Database: 7 טבלאות PostgreSQL: verge_boards, verge_categories, verge_posts, verge_votes, verge_comments, verge_subscribers, verge_settings — עם FK cascades ו-UniqueConstraints למניעת duplicate votes/subs
• Vote engine: idempotent — אותו voter_handle לא יכול להצביע פעמיים, toggle מנקה
• Roadmap engine: aggregator שמקבץ posts לסטטוסים ומחזיר ordering לפי vote_count
• Frontend: SPA וניל JS עם 6 tabs (Overview, Boards, Feed, Roadmap, Subscribers, Settings) — SVG charts (timeline bars + donut), drawer-based post deep-dive עם comments thread, real form CRUD (new post / new board / settings), localStorage voter handle persistence, responsive (1100/720 breakpoints)
• 4 codex images: glassmorphic speech-bubble logo עם chevron + orbiting reactions, atmospheric floating-bubbles hero, 3D laptop roadmap mockup, friendly cosmic mascot empty state