Suggestions

Overview

The Suggestions page provides a collaborative workflow where brokers can propose changes to their own data or county information. Rather than making direct edits, suggestions go through an admin review process, ensuring data quality and preventing unauthorized modifications.

Key Features

Suggestions Table

Each suggestion displays:

• Title: Description of the proposed change and target entity
• Type: Kind of change (Update, Create, Delete)
• Reviewer: Who reviews the suggestion (Admin Review, Auto-Approve)
• Status: Current state with color-coded badges
• Suggested By: The broker or user who submitted
• Date: When the suggestion was submitted

Status Badges

Visual indicators for suggestion state:

• pending - Awaiting admin review (orange)
• approved - Change accepted and applied (green)
• rejected - Change declined (red)

Filter by Status

Dropdown filter to view suggestions by status:

• “All Statuses” shows complete suggestion list
• Filter by specific status to focus on actionable items

Suggestion Detail View

Clicking a suggestion shows:

• Complete proposed changes
• Current vs. proposed values (diff view)
• Entity being modified (broker, county, etc.)
• Reviewer notes and feedback
• Approve/Reject actions

Suggestion Types

Review Workflow

Broker submits suggestion
        ↓
    Status: pending
        ↓
  Admin reviews
        ↓
  ┌─────┴─────┐
  ↓           ↓
approved   rejected
  ↓
Changes applied

Use Cases

Broker Profile Updates

• Update contact information
• Change company description
• Add new specializations

County Information

• Improve county descriptions
• Add local highlights
• Update demographic information

Testing Results

• ✅ All suggestions display in table correctly
• ✅ Status filter dropdown functions properly
• ✅ Status badges show correct colors
• ✅ Entity references link to target records
• ✅ Date formatting displays correctly
• ✅ Suggestion detail view shows diff