Scoping

Scoping decisions for the Item Image Upload project. Each row corresponds to a scenario from the use case specifications. The In Scope column reflects decisions made during use case definition and Round 1 feedback review.

Id	Summary	In Scope	Notes	Decision
`GEN::MEDIA::0001::0001.UC`	Set image via unified input surface — file pick, drag-and-drop, clipboard paste, URL entry, camera capture. Covers first-time set and replacement.	Yes		—
`GEN::MEDIA::0001::0002.FS` — File/drag-and-drop	File selection and drag-and-drop routed through managed upload path.	Yes		—
`GEN::MEDIA::0001::0002.FS` — Clipboard paste	Clipboard paste with per-source-app handling (image blob, HTML with embedded URL, unrecognized format).	Yes	All clipboard paste scenarios in scope. HTML-with-embedded-URL: SPA extracts URL, fetches image, routes through managed upload path (resolved by TD-01/SD-01).	SD-14, TD-01
`GEN::MEDIA::0001::0002.FS` — URL text entry	HTTPS URL entry with validation and reachability check. SPA fetches image, routes through managed upload path.	Yes	Fetch-and-store resolved (SPA-side) per TD-01. All persisted URLs originate from managed storage.	SD-01, TD-01
`GEN::MEDIA::0001::0002.FS` — Camera capture	Dedicated “Take photo” affordance on mobile; desktop via OS file dialog.	Partial	Camera capture as named input method is in scope. Detailed mobile interaction design (tap targets, viewfinder, orientation) is deferred.	SD-08, SD-16
`GEN::MEDIA::0001::0003.FS` — Accepted formats	JPEG, PNG, WebP, HEIC/HEIF accepted. SVG rejected.	Yes	HEIC browser support confirmation required before implementation.	SD-09
`GEN::MEDIA::0001::0003.FS` — Auto-compression	System auto-compresses oversized files before rejecting (85% JPEG, max 2048px).	Yes	Inclusion to be confirmed during project planning depending on implementation effort and impact on launch timeline. May be deferred to a follow-up release.	SD-10
`GEN::MEDIA::0001::0004.FS`	URL scheme validation (HTTPS-only) and reachability check.	Yes		—
`GEN::MEDIA::0001::0005.FS` — Preview and crop	Preview with locked aspect ratio (1:1 for Items), comparison layout, drop zone affordances, interaction states.	Yes		SD-06, SD-11
`GEN::MEDIA::0001::0005.FS` — Basic edit operations	Crop, Zoom, Rotate, Pan, Reset.	Yes		SD-12
`GEN::MEDIA::0001::0005.FS` — Remove background	Optional toggle to strip background and output transparent PNG.	No	Documented as future enhancement. Not in V1 scope. The use case spec (`0005.FS`) still lists “Remove background” among the edit operations — it should be read as a future capability, not a V1 deliverable.	SD-02
`GEN::MEDIA::0001::0006.FS` — Confirm and persist	Upload via presigned URL workflow, CDN URL stored on entity. Copyright acknowledgment before upload.	Yes	Copyright acknowledgment is inline text in the confirm dialog footer — no checkbox or blocking gate (FD-18, supersedes SD-07’s original “mandatory checkbox/click” wording).	SD-07, FD-18
`GEN::MEDIA::0001::0006.FS` — Fetch-and-store external URLs	Fetch external URL images SPA-side at ingest time, store on CDN. Single rendering path.	Yes	Resolved per TD-01. SPA fetches, edits, uploads. All persisted URLs originate from managed storage.	SD-01, TD-01
`GEN::MEDIA::0002::0001.UC`	Remove entity image — clear reference, revert to placeholder, retain in version history.	Yes		—
`REF::ITM::0003::0010.UC`	Set item image during creation — delegates to `GEN::MEDIA::0001`.	Yes		—
`REF::ITM::0004::0006.UC`	Change or remove item image — delegates to `GEN::MEDIA::0001`/`0002`.	Yes		—
`REF::ITM::0006::0005.FS`	Image column in bulk CSV import/export — HTTPS URLs only, no reachability check during import.	No	Deferred to separate session.	SD-03
Cross-cutting: Permissions	All users can set/remove images; fine-grained roles deferred.	Yes	Documenting existing system behavior.	SD-13
Cross-cutting: Concurrency	Last-user-wins; bitemporal audit trail.	Yes	Documenting existing system behavior.	SD-13
Cross-cutting: Retention policy	Quantify storage growth and define cleanup for superseded images.	No	Postponed. GitHub ticket to be created during project implementation.	SD-04
Cross-cutting: Cross-tenant sharing	Constraints for sharing images between tenants (authenticated access, tenant-initiated, copyright acknowledgment).	No	Out of scope for this version. Legal resolution required before any future implementation.	SD-05
`GEN::MEDIA::0001::0007.FS`	Grid inline edit — modal overlay with full image editor triggered from image cell edit.	Yes		SD-15
`GEN::MEDIA::0003::0001.UC`	View image thumbnail in grid — scaled thumbnail, placeholder for no image.	Yes		SD-15
`GEN::MEDIA::0003::0002.FS`	Image quick inspection — hover (~500ms) shows larger preview popover; no action icons. Revised from original single-click-to-modal during usability testing. `ImageInspectorOverlay` retained for non-grid contexts.	Yes	Interaction model revised post-project (CD-08 revision).	SD-15, CD-08
`GEN::MEDIA::0003::0003.FS`	Thumbnail fallback — placeholder with error badge for unreachable images; silent inline fallback.	Yes		SD-15
Mobile camera capture UX	Tap targets, viewfinder framing, orientation handling.	No	Deferred to future mobile UX session.	SD-16
Copyright acknowledgment server-side logging	Backend logging of copyright acknowledgment with timestamp and user identity.	No	SPA-only acknowledgment is sufficient for V1. Server-side logging deferred to future enhancement if needed.	TD-04, Audit #2
Crop optionality per entity type	`ImageFieldConfig` flag to disable crop functionality for entity types that don’t need it.	No	Crop is always enabled in V1. Optionality deferred to first entity type that requires it.	Audit #9
Minimum dimension configurability	Configurable minimum image dimensions per entity type via `ImageFieldConfig`.	No	V1 uses hardcoded reasonable defaults. Per-entity-type configurability deferred.	GEN::MEDIA::FR-0007, Audit #6
Accessibility (WCAG)	Keyboard navigation, focus management, screen reader support, and alt-text for image upload components.	No	Requirements documented (NFR-022 through NFR-025) for future implementation. Not in V1 scope.	Audit #19