[JOY (JOY)]

Promote dev to main.

• docs(web): openapi min rating and rating sort read the shown rating #1591 docs(web): openapi min rating and rating sort read the shown rating
• chore(db): mirror the search trigram and rating score migrations #1594 chore(db): mirror the search trigram and rating score migrations

Merge with a merge commit, never squash (Docs/Resources/RELEASE.md).

---

📌 TL;DR

This PR optimizes the rate.search_master_products database function by adding a trigram index for full-text search and implementing a numeric guard to prevent crashes from malformed spec data. It also aligns the rating filter and sort logic with the exact rating score displayed on the frontend, ensuring consistency between search results and product pages.

🎯 Type of Change

• 🚀 New feature
• 🐛 Bugfix
• 🧹 Refactor
• ⚡ Performance
• 📚 Documentation
• ⚙️ CI / Configuration

🔍 Changes Walkthrough

File	Summary of Changes
apps/web/src/server/rate/openapi.ts	Updated OpenAPI documentation for minRating and sort query parameters to accurately reflect the new rating logic (using rating_score_5 and one-decimal precision) and the specific behavior of the rating_desc sort order.
supabase/migrations/20261104120000_rate_search_master_products_trgm_index_and_numeric_guard.sql	Performance & Stability: 1. Creates a new GIN trigram index (idx_master_products_search_full_trgm) covering all 7 searchable text fields to enable index-based text search. 2. Rewrites rate.search_master_products in plpgsql with force_custom_plan to allow the planner to simplify OR conditions and utilize the new index. 3. Adds a numeric guard for refresh rate, fast charging, and screen size filters to prevent SQL errors when casting malformed spec strings (e.g., "120.5.6") to NUMERIC.
supabase/migrations/20261104140000_rate_search_master_products_rating_score.sql	Consistency & Logic: 1. Updates rate.search_master_products to use a unified "shown rating" calculation (rating_score > 0, else weighted user rating, else average rating) for both filtering and sorting. 2. Ensures the minRating filter compares against the rating rounded to one decimal place (matching the UI display). 3. Ensures rating_desc sorting uses the unrounded "shown rating" value, placing unrated products last.

📊 Architectural Flow

flowchart TD
    subgraph Client
        A[API Request] -->|Query Params: search, minRating, sort| B[OpenAPI Spec]
    end

    subgraph Database
        B --> C{rate.search_master_products}
        
        subgraph Search Logic
            C --> D[Text Search]
            D -->|Uses| E[(idx_master_products_search_full_trgm)]
            D -->|Guard| F[ILIKE Match]
        end
        
        subgraph Rating Logic
            C --> G[Calculate Shown Rating]
            G -->|Priority 1| H[rating_score]
            G -->|Priority 2| I[user_rating_weighted]
            G -->|Priority 3| J[average_rating]
            
            G --> K[Filter: minRating]
            K -->|Compares| L[Round to 1 decimal]
            
            G --> M[Sort: rating_desc]
            M -->|Uses| N[Unrounded Value]
        end
        
        subgraph Spec Parsing
            C --> O[Parse Specs]
            O -->|Guard| P[Valid Numeric Cast]
            O -->|Invalid| Q[Treat as Unknown/0]
        end
        
        C --> R[Return Results]
    end
    
    R --> S[Frontend Display]
    S -->|Matches| T[Product Page Rating]

Loading

[claude]

⚠️ Code review skipped — your organization has no extra usage available to pay for this review.

If your organization's extra usage balance is empty, an organization admin can add extra usage credits at claude.ai/admin-settings/usage. If its monthly spend limit was reached, an admin can raise it on the same page. If neither applies, contact Anthropic support.

Once extra usage is available, someone with write access to this repository can comment @claude review on this pull request to trigger a review.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
rate	Ready	Preview	Nov 3, 2026 3:24am UTC

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: d4804639-dd95-4cea-be49-f1feca6066e7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

CodeRabbit Verify

• Run CodeRabbit Verify to test the changes in this pull request.

[dos]

⏱️ Code Review completed (3 eligible files · 19,462 chars · 3 model call(s) · 1 PR unit(s))

Whole diff with bounded context at base b1dfdab / head 7201101.

✅ CLEAN_PASS: Complete diff reviewed

Context investigation was bounded to the explicitly requested snapshot paths.