`specs/photo-suggestions.md`

130 lines
# Photo suggestions — page by page

> **Status of `steve-personal` (steveabramsdesigns@gmail.com) Google Drive:** the Claude.ai Google Drive MCP connector is installed but **not yet authenticated**. The connector requires the user to run `/mcp` and complete OAuth — once done, the assistant can list assets in Drive by name and tag the right file per slot. Until then, this file specifies the **brief** for each slot so any photo lookup (manual or automated) can match against the same criteria.

> **Photography principles for SDCC (apply globally):**
> - Real borrowers, not stock. Every face on the site is someone whose story we have written permission to use.
> - Natural light, no studio backdrops.
> - Show 45+ subjects in proportion to the audience (~70% of imagery).
> - Show racial/gender diversity — Black women carry $20K+ more debt than white men; the imagery should not erase that.
> - Workplace dignity — teachers, nurses, public servants, postal workers, social workers — never shame imagery.
> - Avoid cap-and-gown shots (the loans hurt long after the gown comes off).

---

## Home — `/`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Portrait of a 50–65 borrower at kitchen table reviewing paperwork in natural light. Direct, calm gaze. | `kitchen`, `paperwork`, `borrower`, `portrait`, `natural-light` |
| Stats band background | Wide-angle of an SDCC town hall or State of Student Debt Summit audience | `summit`, `town-hall`, `audience-2024`, `audience-2025` |
| "What we're working on" cards (×3) | One borrower at workplace per card: teacher in classroom · nurse on ward · postal worker on route. No staged smiles. | `teacher`, `nurse`, `postal`, `workplace` |
| Funder strip | Skip — text only. (Photos here read as advertorial.) | — |
| Footer | Most recent SDCC team photo (must be ≤ 12 months old; if not, replace the photo with a phone number) | `team`, `staff`, `2025`, `2026` |

---

## Stories — `/stories`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Wide shot of a 2024 demonstration — banners, faces, daylight | `demonstration`, `rally`, `protest`, `banners` |
| Per-story portrait | One unposed photo per story, where the borrower has consented | `consented-portraits/[name]` |
| Section divider | Crowd hands-up at a town hall | `hands`, `pledge`, `town-hall` |

---

## Resources — `/resources`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Hand on phone reading a `Studentaid.gov` letter — anonymous (over-shoulder shot, no face) | `letter`, `phone`, `mail`, `over-shoulder` |
| Each guide card | A small icon — not a photo. Photos in resource cards reduce scannability for 45+ readers. | — |

---

## News — `/news`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | SDCC team at a press conference / capitol step — recognizable spokesperson | `press-conference`, `capitol`, `Sabrina`, `Natalia` |
| Per-post thumbnail | News-style: location, building, or supporting graphic. Avoid clip-art. | varies per post |

---

## Calculators — `/calculators`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Hands on a calculator and laptop — soft, not financial-services-corporate | `calculator`, `laptop`, `hands`, `desk` |
| Per-calculator card | Numbered icon only (01–08), not photos | — |

---

## PSLF JSON Inspector — `/pslf-json`

No photos. The page IS the schema. Visual treatment is monospace JSON on dark background — that's the message. Adding photos here would weaken the "open, evidence-based, replicable" signal.

---

## Cy Pres Award — `/cy-pres`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Federal courthouse exterior or judge's bench (architectural, not staged) | `courthouse`, `bench`, `gavel-no`, `judicial` |
| "Why we qualify" card | Group of borrowers at a State of Student Debt Summit | `summit`, `audience` |
| "Past awards" placeholder | Replace with each award's announcement when received; until then, no photo, just text | — |

---

## Book a Call — `/book-a-call`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero portrait + video thumbnail | Sabrina Calazans (ED) or Natalia Abrams (President & Founder) — direct gaze, slight smile, neutral background. **Pair with the 2-minute explainer video** (see new-pages spec). | `Sabrina`, `Natalia`, `headshot`, `2025`, `2026` |
| "What we're good at" 6 numbered cards | Tiny icon per card, not photos | — |
| "What borrowers say" testimonial cards | Real headshot + name, where consented; otherwise initial only | `testimonial`, `consented` |

---

## Free the Degree — `/free-the-degree`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Group of college students protesting tuition or wages | `students`, `protest`, `tuition`, `young` |
| Stat band | Stylized infographic — no photo | — |

---

## About — `/about`

| Slot | Brief | Drive search terms |
|---|---|---|
| Each team headshot | Latest professional headshot — natural light, neutral background | `headshot/[name]` |

---

## Contact — `/contact`

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Phone in foreground, daytime light. Subtitle: phone number large. | `phone`, `daylight` |

---

## May Day pages (themes 31–45)

| Slot | Brief | Drive search terms |
|---|---|---|
| Hero | Historic labor demonstration (public-domain) OR an SDCC rally with red carnations | `mayday`, `carnation`, `union`, `picket`, `1886` |
| Section dividers | Vintage IWW / labor poster reproductions (public domain only) | `iww`, `union-poster-public-domain` |

---

## Photo asset workflow once Drive MCP is authenticated

1. Run `/mcp` → select "claude.ai Google Drive" → complete OAuth in browser.
2. Re-invoke this assistant with: "Run the photo-suggestions matcher against steve-personal Drive."
3. The assistant will, per slot above, search Drive for the listed terms, return the top 3 candidates per slot, and attach Drive file IDs / preview URLs to a refreshed `photo-suggestions-MATCHED.md`.
4. Steve approves by initialing each row; approved rows go into the design system as named asset slots (`hero/home`, `stats/summit-2024`, etc).