shop comments - BevvyTech/BrewskiDocs GitHub Wiki

Shop – Comments

  • Route: /shop/comments
  • Purpose: Provides marketplace staff with tooling to review customer comments across beers (and future marketplace entities), including AI moderation outcomes, customer eligibility, and community reports.
  • Primary Data:
    • Paginated moderation queue sourced from /marketplace/comments/review with subject metadata, rating, attachments, reports, and AI screening status.
    • Customer moderation state (canComment, block reason) and vote/report summaries for context.
  • Key Actions:
    • Filter queue by status (pending/approved/rejected) and subject type.
    • Inspect comments via the detail dialog (full body, attachments, report list).
    • Approve or reject comments, logging optional moderator notes or mandatory rejection reasons.
    • Block commenters with a recorded justification; refreshes the listing after each action.
  • Notable Details:
    • Pending reviews remain internal-only and are highlighted with a status chip.
    • Dialog layouts observe the 44 px spacing guidance above/below form fields.
    • All user-facing copy is localised across EN, DE, ES, FR, and CS message packs.
    • The moderation grid uses the shared pagination footer, so the 10/25/50/100 selector taps the global cookie preference and the chevrons + page dropdown reflect the API’s page/total values for the queue.
⚠️ **GitHub.com Fallback** ⚠️