docs(37): capture phase context

This commit is contained in:
2026-04-19 20:57:32 +02:00
parent 868aed4f10
commit 298da6da85
2 changed files with 191 additions and 0 deletions

View File

@@ -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)