docs(23): capture phase context
This commit is contained in:
@@ -0,0 +1,77 @@
|
||||
# Phase 23: Manual Entry Fallback - 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-06
|
||||
**Phase:** 23-manual-entry-fallback
|
||||
**Areas discussed:** Entry point placement, Form presentation, Post-save catalog prompt, Form fields scope
|
||||
**Mode:** --auto (all decisions auto-selected)
|
||||
|
||||
---
|
||||
|
||||
## Entry Point Placement
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Empty state only | Show "Add Manually" only when no search results match | |
|
||||
| Empty state + persistent link | Show in empty state AND as subtle persistent link below results | ✓ |
|
||||
| FAB menu option | Add a third "Add Manually" option to the FAB mini menu | |
|
||||
|
||||
**User's choice:** [auto] Empty state + persistent link (recommended default)
|
||||
**Notes:** Ensures users can always reach manual entry regardless of search results.
|
||||
|
||||
---
|
||||
|
||||
## Form Presentation
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Inline in overlay | Replace search results with manual entry form inside CatalogSearchOverlay | ✓ |
|
||||
| Separate modal | Open a new modal on top of the overlay | |
|
||||
| Navigate to route | Navigate to a dedicated /items/new route | |
|
||||
|
||||
**User's choice:** [auto] Inline in overlay (recommended default)
|
||||
**Notes:** Keeps user in context. Back arrow returns to search results.
|
||||
|
||||
---
|
||||
|
||||
## Post-Save Catalog Prompt
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Inline success card | Show success + "Submit to Catalog?" button inline in overlay | ✓ |
|
||||
| Toast with action | Show toast notification with "Submit to Catalog?" action button | |
|
||||
| Redirect to item detail | Navigate to new item's detail page with prompt there | |
|
||||
|
||||
**User's choice:** [auto] Inline success card (recommended default)
|
||||
**Notes:** Non-functional button shows "Coming soon" toast. "Add Another" and "Done" buttons below.
|
||||
|
||||
---
|
||||
|
||||
## Form Fields Scope
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Essential fields | Name (required), category, weight, price, notes, purchase price, image, product link | ✓ |
|
||||
| Minimal fields | Name and category only, edit rest on detail page | |
|
||||
| Full ItemForm | Reuse the complete 315-line ItemForm component | |
|
||||
|
||||
**User's choice:** [auto] Essential fields (recommended default)
|
||||
**Notes:** Reuse patterns from ItemForm but keep form focused and compact.
|
||||
|
||||
---
|
||||
|
||||
## Claude's Discretion
|
||||
|
||||
- Form layout proportions and field ordering
|
||||
- Weight/price input formatting
|
||||
- Animation transitions between search and manual entry
|
||||
- Success card visual styling
|
||||
- Whether search query auto-populates item name field
|
||||
|
||||
## Deferred Ideas
|
||||
|
||||
- Actual catalog submission backend — future phase
|
||||
- Bulk manual entry — future phase
|
||||
- Image search / URL paste to auto-populate — future phase
|
||||
Reference in New Issue
Block a user