Feature 041: supply title/description at upload time; return expected_id in response

[Copilot]

Callers currently must make a second API call to set title/description after upload. This wires those fields directly into the upload request and returns an expected_id so clients know the photo's ID before async processing completes.

HTTP layer

• UploadPhotoRequest: adds title (max 100) and description (max 1 000) optional fields with TitleRule/DescriptionRule validation
• UploadMetaResource: gains ?string $expected_id, ?string $title, ?string $description
• PhotoController::upload(): generates a 24-char Base64url expected_id on the final non-zip chunk (same algorithm as generateKey()); forwards all three fields into ProcessImageJob

DTO chain

ImportParam → InitDTO → StandaloneDTO each gain ?string $title, ?string $description, ?string $preallocated_id (nullable, default null; backward-compatible).

Pipeline

• New ApplyUserProvidedMetadata pipe inserted before HydrateMetadata — assigns caller-supplied title/description to the photo so EXIF cannot overwrite them
• AutoRenamer: returns early when $state->title !== null

ID pre-allocation

• Photo::preallocateId(string $id) stores the caller-chosen ID
• HasRandomIDAndLegacyTimeBasedID::generateKey() consumes it on first insert then clears it; falls back to a fresh random ID on DB collision (so expected_id is best-effort, not guaranteed)

Tests

UploadWithMetadataTest (9 tests, 466 assertions) covering title/description override, EXIF fallback, expected_id match, duplicate 409 (skip_duplicates=true), zip null expected_id, validation limits, and AutoRenamer skip.

Note on duplicate 409: ThrowSkipDuplicate throws PhotoSkippedException (HTTP 409) only when skip_duplicates = true. With the default skip_duplicates = false the duplicate is re-linked without error (HTTP 201).

[codecov]

Codecov Report

❌ Patch coverage is 96.66667% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.28%. Comparing base (46c372d) to head (8276d55).
⚠️ Report is 3 commits behind head on master.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.