Step 1 — Poster Rates Contractor
Feedback Prompt Poster
Kitchen Sink Replacement
Completed Feb 20, 2026 · Mike’s Plumbing
How was your experience?
You’re helping other homeowners find amazing contractors — and helping great pros get the recognition they deserve!
4 out of 5 — Great!
How would you sum it up?
Excellent
Good
Fair
Poor
PosterFeedbackPrompt screen
useFeedback(jobId) · onSelectRating callback
Detailed Review Poster
Rate Each Category
Written Review
Mike and his team did an outstanding job on our kitchen sink. They arrived on time, kept the workspace clean, and the final result exceeded our expectations. Highly recommend!
178 / 1,000
Add Photos
Would you hire again?
Visible on contractor profile
Add a Tip
Optional
PosterDetailedReview screen
submitReview mutation · uploadPhotos · createTip
Step 2 — Contractor Rates Homeowner
Contractor Feedback Contractor
Kitchen Sink Replacement
Completed Feb 20, 2026 · Sarah Johnson
How was this homeowner?
Your honest feedback helps fellow contractors know what to expect — and it stays completely anonymous.
5 out of 5 — Outstanding!
What stood out?
Communication
Preparedness
Payment Speed
Respect
Clean Workspace
Flexible Schedule
Additional Notes (optional)
Add private notes about this homeowner...
ContractorFeedbackPrompt screen
submitPosterReview mutation · onChipToggle callback
NPS Survey Shared
How likely are you to recommend 3Bids?
On a scale of 0 to 10
0
1
2
3
4
5
6
7
8
9
10
Not Likely
Neutral
Very Likely
You’re a Promoter!
What do you love most about 3Bids?
Transparency
Quality Contractors
Secure Payments
Support
Speed
Anything else? (optional)
Tell us more about your experience...
NPSSurveyScreen screen
useNPS(userId) · submitNPS mutation · follow-up varies by score
Step 3 — Admin Survey & Analytics
Survey Builder Admin
Target Audience
All Users
Posters
Contractors
Questions (4)
Draft
Overall satisfaction with your experience?
Star Rating (1-5)
How easy was the bidding process?
Scale (1-10)
Which features did you use most?
Multiple Choice
What could we improve about 3Bids?
Open Text
Add Question
Stars
Scale
Multiple Choice
Open Text
Preview Mode
See how respondents will view this survey
SurveyBuilder screen
useSurveys() · createSurvey / updateSurvey mutations · drag-to-reorder
Feedback Analytics Admin
4.6
Avg Rating
+72
NPS Score
84%
Response Rate
Ratings Over Time
30 days
Average rating trend — 4.3 → 4.6
NPS Score Trend
Improving
NPS moving average — +58 → +72
Top Keywords
Professional
Affordable
On Time
Friendly
Clean Work
Responsive
Thorough
Reliable
Honest
Quality
Helpful
Expert
Category Breakdown
Response Rates
Poster Feedback
87% completion rate · 142 responses
Contractor Feedback
79% completion rate · 118 responses
NPS Surveys
68% completion rate · 94 responses
FeedbackAnalytics screen
useFeedbackAnalytics() · aggregateRatings / getNPSTrend queries
Step 4 — Detail View & Completion
Feedback Detail Admin
SJ
Sarah Johnson
Homeowner · Member since Jan 2025
Kitchen Sink Replacement
Job #3847 · $420.00 · Completed Feb 20
Ratings
4.5
Written Review
Mike and his team did an outstanding job on our kitchen sink. They arrived on time, kept the workspace clean, and the final result exceeded our expectations. Would definitely hire again for future projects!
Admin Actions
Flag for Review
Respond Publicly
Remove Feedback
Submitted
Feb 21, 2026 at 2:34 PM
Would Hire Again
Yes
Tip Included
$20.00
Emotion
Excellent
FeedbackDetail screen
getFeedbackDetail query · flagFeedback / respondPublicly mutations
Thank You Shared
FeedbackThankYou screen
useFeedbackMilestones() · shareReview action · navigateHome
Data Architecture — Customer Feedback & Surveys
Schema: feedback
_id— Convex document IDjobId—v.id("jobs")reviewerId—v.id("users")revieweeId—v.id("users")reviewerRole— "poster" | "contractor"overallRating— 1-5 stars (overall average)categoryRatings—{ quality, communication, timeliness, value }emotionTag— "excellent" | "good" | "fair" | "poor"text— Written review (max 1,000 chars)photos— Array of storage IDswouldHireAgain— Boolean (poster only)tipAmount— Optional tip in centscontractorTags— Array of category chips (contractor only)isFlagged— Boolean, admin flaggedpublicResponse— Admin response text_creationTime— Auto timestamp
Schema: surveys & npsResponses
- surveys
_id— Convex document IDtitle— Survey namestatus— "draft" | "published" | "archived"targetAudience— "all" | "posters" | "contractors"questions— Array of{ type, title, options? }createdBy—v.id("adminUsers")_creationTime— Auto timestamp- npsResponses
_id— Convex document IDuserId—v.id("users")score— 0-10 NPS scorecategory— "detractor" | "passive" | "promoter"followUpTags— Array of selected chipscomment— Optional freeform text_creationTime— Auto timestamp
Queries
getFeedbackForJob— Both sides’ feedback for a specific jobgetFeedbackDetail— Single feedback with full data + job contextaggregateRatings— Category averages over configurable time rangegetNPSTrend— NPS score moving average by periodgetFeedbackAnalytics— Response rates, sentiment keywords, category breakdownlistSurveys— Admin survey list with status filtersgetSurveyResponses— Aggregated results for a published survey
Mutations
submitPosterFeedback— Poster review with categories, text, photos, tipsubmitContractorFeedback— Contractor rating with tags and notessubmitNPS— NPS score + follow-up tags + commentcreateSurvey— Admin creates survey with questions arrayupdateSurvey— Edit questions, reorder, publishflagFeedback— Admin flags feedback for reviewrespondPublicly— Admin posts public response to feedbackremoveFeedback— Admin soft-delete (retains data)
Hooks & Components
useFeedback(jobId)— Feedback state for a specific job (both sides)useNPS(userId)— NPS survey state & submissionuseSurveys()— Admin survey CRUD operationsuseFeedbackAnalytics()— Analytics aggregations & trendsuseFeedbackMilestones()— Badge progress & reward trackingPosterFeedbackPrompt— app/(poster)/feedback/rate.tsxPosterDetailedReview— app/(poster)/feedback/details.tsxContractorFeedbackPrompt— app/(contractor)/feedback/rate.tsxNPSSurveyScreen— app/feedback/nps.tsx (shared route)SurveyBuilder— app/(admin)/surveys/builder.tsxFeedbackAnalytics— app/(admin)/feedback/analytics.tsxFeedbackDetail— app/(admin)/feedback/[id].tsxFeedbackThankYou— app/feedback/thank-you.tsx
Automations
onJobCompleted— Trigger feedback prompt 2h after completiononFeedbackSubmitted— Queue NPS survey 24h after feedbackonNPSDetractor— Alert ops_alerts Slack channel for scores ≤6onMilestoneReached— Award badge & send congratulations email
