Proof client shoots and hand off the delivery album in one place

Build me a proofing and delivery desk for client photo shoots, so picking selects stops happening over email threads and shared drive links. Two kinds of people use it: photographers and editors who review frames, and whoever runs delivery for the studio.

Important constraint to design around. This Google Photos connection is app created data only. It reads and edits only albums and media items that were created through this platform's Google credential, so the shoot albums this app lists are ones that arrived by upload or by an intake automation running on this same connection. It cannot browse a pre-existing personal Google Photos library, so do not build any view or copy that promises that.

The home view is a grid of shoot cards, one per album, from List Albums, with Get Album for per album detail like the cover photo and the media item count. Each card shows the shoot title, a thumbnail, the frame count, how many frames each reviewer still has left to review, and a delivery status. Delivery status is read back from Airtable with List Records against a delivery log table, so a card either says delivered on a date with a link to the client album, or not delivered yet.

Opening a shoot goes to a large thumbnail review grid. Load the frames with Search Media Items scoped to that album id, paging through with the page token. Thumbnails need to be big enough to actually judge a frame on. On each frame the reviewer marks keep or cut and can leave a short note, for example crop tighter or eyes closed. Keyboard shortcuts for keep, cut and next frame make a long shoot bearable. Google Photos baseUrl values expire, so refetch media item data when the grid loads rather than storing thumbnail urls, and append a sizing parameter such as =w600 for the grid and a larger one for the single frame view.

Every reviewer's keeps, cuts and notes are stored per user inside the app, keyed by user and media item id. A photographer and an editor both passing over the same shoot must never overwrite one another, and each should see their own marks when they open the grid. The shoot header shows how many frames each person has left to review, so it is obvious when a second pass is still outstanding. On the single frame view show both reviewers' notes together, so disagreements are visible rather than buried.

When reviewers disagree on a frame, default the delivery set to the frames that every reviewer who has passed marked keep, and let the person preparing delivery switch to include anything at least one of them kept. Show the resulting count on the button so it is clear what is about to be delivered.

A Prepare delivery button on a shoot runs a background agent, taking the agreed selection set as its input. The agent creates a clean client album with Create Album, adds the selected frames to it with Add Media Items to Album, writes a short intro paragraph into the album as a text enrichment with Add Enrichment to Album, writes a caption onto each select with Update Media Item, and sets a hero cover with Update Album choosing the strongest frame. Copying here means adding the same app created media items to a second album, not duplicating files, so no extra storage is used and the frames stay linked to the original shoot. Albums cap at 20,000 items, so if a delivery set ever exceeded that, split into a second album rather than failing.

The agent then drafts the client handoff email with Gmail's Create a Draft, referencing the shoot, the number of delivered frames and the client album link. Leave it as a draft and do not send it, because nobody wants an agent emailing a client unreviewed. Surface the draft link in the app so a person can open, read and send it from Gmail themselves. Finally the agent logs the delivery to Airtable with Create Records: shoot name, client album link, frame count, who reviewed, delivery date and the draft link. That row is exactly what the shoot cards read back later with List Records.

While the agent runs, show progress on the shoot card, and when it finishes show where everything landed: the new client album, how many captions were written, the Gmail draft link and the Airtable row. If a reviewer has not finished their pass yet, warn before preparing delivery, since the whole point is that both passes are in before anything goes to the client.