docs(37): capture phase context
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user