docs(29): add execution summaries for plans 03 and 04

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-12 20:09:30 +02:00
parent 6509b33501
commit dd3cee1a64
2 changed files with 93 additions and 0 deletions

View File

@@ -0,0 +1,49 @@
---
phase: 29
plan: 03
subsystem: fullstack
tags: [crop-editor, react-easy-crop, ui]
key-files:
created:
- src/client/components/ImageCropEditor.tsx
modified:
- src/client/components/ImageUpload.tsx
- src/client/routes/items/$itemId.tsx
- src/client/routes/threads/$threadId/candidates/$candidateId.tsx
- package.json
metrics:
tasks: 6
commits: 4
files-changed: 6
---
# Plan 29-03 Summary: Zoom+Pan Image Framing Editor
## What was built
- Installed react-easy-crop library
- Created ImageCropEditor component with zoom slider (1x-3x), save/cancel buttons, dominant color background
- Integrated crop editor into ImageUpload (shows after upload when onCropChange provided)
- Added "Adjust framing" button to item detail page with inline crop editor
- Added "Adjust framing" button to candidate detail page with inline crop editor
- Global item detail skipped (no update endpoint exists for global items)
## Commits
| Task | Commit | Description |
|------|--------|-------------|
| 1 | 6f4fd78 | Install react-easy-crop |
| 2 | 23f62fd | Create ImageCropEditor component |
| 3 | 78a097c | Integrate crop editor into ImageUpload |
| 4-6 | a18b9d3 | Add crop editor to item and candidate detail pages |
## Deviations
- Task 5 (global item detail): Skipped "Adjust framing" button because no PUT endpoint exists for global items. Crop fields are in the schema but cannot be updated from the frontend for global items.
## Self-Check: PASSED
- react-easy-crop installed: YES
- ImageCropEditor exists: YES
- ImageUpload has crop editor: YES
- Item detail has "Adjust framing": YES
- Candidate detail has "Adjust framing": YES
- Build passes: YES
- Lint passes: YES

View File

@@ -0,0 +1,44 @@
---
phase: 29
plan: 04
subsystem: backend
tags: [migration, backfill, sharp]
key-files:
created:
- scripts/backfill-dominant-colors.ts
modified:
- package.json
metrics:
tasks: 2
commits: 1
files-changed: 2
---
# Plan 29-04 Summary: Backfill Migration Script
## What was built
- Created `scripts/backfill-dominant-colors.ts` backfill script
- Processes items, globalItems (source URLs + image URLs), and threadCandidates
- Extracts dominant color via Sharp 1x1 resize
- Idempotent: skips records with existing dominantColor
- Batch processing with 10 concurrent requests
- Progress logging per table
- Added `backfill:colors` npm script
## Commits
| Task | Commit | Description |
|------|--------|-------------|
| 1-2 | 6509b33 | Create backfill script and npm shortcut |
## Deviations
None.
## Self-Check: PASSED
- Script exists: YES
- Processes all 3 tables: YES
- Idempotent (isNull check): YES
- Batch size 10: YES
- Progress logging: YES
- npm script exists: YES
- Lint passes: YES