Files
GearBox/.planning/phases/29-image-presentation/29-DISCUSSION-LOG.md

95 lines
2.8 KiB
Markdown

# Phase 29: Image Presentation - 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-12
**Phase:** 29-image-presentation
**Areas discussed:** Fit strategy & fill treatment, Aspect ratio policy, Scope of changes, User crop positioning
---
## Fit Strategy & Fill Treatment
| Option | Description | Selected |
|--------|-------------|----------|
| Blurred background | Scale to fit, fill with blurred zoomed version of same image | |
| Solid background | Scale to fit, fill with solid color (white/gray) | |
| Adaptive background | Extract dominant color from image, use as fill | ✓ |
**User's choice:** Adaptive background
| Option | Description | Selected |
|--------|-------------|----------|
| Client-side on load | Canvas pixel sampling when image loads | |
| Server-side on upload | Extract once on upload, store in DB | ✓ |
| You decide | Claude picks | |
**User's choice:** Server-side on upload
---
## Aspect Ratio Policy
| Option | Description | Selected |
|--------|-------------|----------|
| Keep different ratios | 4:3 for cards, 16:9 for detail heroes | |
| Unify to 4:3 | Same everywhere | |
| Unify to 16:9 | Wider everywhere | |
| You decide | Claude picks based on gear images | ✓ |
**User's choice:** You decide (Claude's discretion)
---
## Scope of Changes
| Option | Description | Selected |
|--------|-------------|----------|
| Everywhere images appear | All 15+ surfaces — full consistency | ✓ |
| Cards and detail pages only | Main surfaces, skip comparison/upload | |
| You decide | Claude picks | |
**User's choice:** Everywhere images appear
---
## User Crop Positioning
| Option | Description | Selected |
|--------|-------------|----------|
| Focal point picker | Click to set focal point, x/y coordinates | |
| Zoom + pan editor | Zoom in/out and drag to position | ✓ |
| No user control | Skip for now, add later | |
**User's choice:** Zoom + pan editor
| Option | Description | Selected |
|--------|-------------|----------|
| On upload preview | Editor during upload only | |
| On item edit/detail | Editor from item detail page | |
| Both | Available during upload AND from item detail | ✓ |
**User's choice:** Both
| Option | Description | Selected |
|--------|-------------|----------|
| Per-image (one crop for all views) | Same framing everywhere | ✓ |
| Per-context | Different crop for card vs detail | |
**User's choice:** Per-image
---
## Claude's Discretion
- Aspect ratio policy (unify or keep different)
- Zoom+pan editor implementation (library vs custom)
- Dominant color extraction library
- DB schema design for crop and color fields
- Backfill migration strategy
## Deferred Ideas
None — discussion stayed within phase scope