Files
GearBox/.planning/phases/37-admin-global-item-management/37-DISCUSSION-LOG.md

2.7 KiB

Phase 37: Admin — Global Item Management - Discussion Log

Audit trail only. Do not use as input to planning, research, or execution agents. Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.

Date: 2026-04-19 Phase: 37 — Admin — Global Item Management Areas discussed: List view style, Edit workflow, Brand/manufacturer field, Delete confirmation


List view style

Option Description Selected
Data table Dense rows with columns for brand, model, category, weight, price, tags, owner count. Sortable, scannable, admin-appropriate.
Card grid Consistent with public catalog. Reuses GearImage/card patterns but wastes space for data management.
List rows (compact) Single-line rows with brand/model + a few stats. Middle ground.

User's choice: Data table

Table columns selected: Brand + Model, Category + Weight + Price, Tags, Owner count

Pagination: Server-side infinite scroll — load next page on scroll, not explicit next/prev buttons


Edit workflow

Option Description Selected
Dedicated edit page /admin/items/$id Full-page form, bookmarkable, consistent with detail page pattern.
Slide-over drawer Slides in over list, keeps list context. Requires new drawer component.

User's choice: Dedicated edit page

Delete location: Edit page only (not on list)


Brand/manufacturer field

Option Description Selected
Dropdown of existing manufacturers Admin picks from list fetched from /api/manufacturers. Safe, no duplicates.
Free-text with auto-match Admin types brand; matched or created on save. Risks duplicates.

User's choice: Dropdown of existing manufacturers


Delete confirmation

Option Description Selected
Impact-aware Show item name + owner count: "3 users have this in their collection. This cannot be undone."
Simple confirmation "Are you sure? This cannot be undone." No extra data.

User's choice: Impact-aware confirmation with owner count


Claude's Discretion

  • Column sort order and default sort
  • Tags column display (chips vs count badge)
  • Edit form field layout (single vs two-column)
  • IntersectionObserver implementation for infinite scroll trigger
  • Delete button styling and position on edit page

Deferred Ideas

  • Manufacturer creation from within admin panel (out of scope for this phase)
  • Bulk delete / bulk edit from the list
  • Column sorting (not in success criteria; Claude's discretion)