Add debug More/Clear/Upload tools for paintings and artist portraits.
Extends the debug panel on painting detail and artist bio with a 20-result search picker, local image upload, and clear-to-empty-frame workflow, plus API routes, artist checkup migration, and documentation. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Danila Khodjaef
co-authored by
Cursor
Cursor
parent
b4425445bb
commit
0972b5df99
+166
-3
@@ -93,7 +93,9 @@ Full artist profile for the bio page and 3D gallery entry.
|
||||
"portrait_path": "portraits/Claude_Monet.jpg",
|
||||
"bio_short": "First two sentences from Wikipedia…",
|
||||
"bio_full": "Full Wikipedia lead section…",
|
||||
"wikipedia_title": "Claude Monet"
|
||||
"wikipedia_title": "Claude Monet",
|
||||
"checkup_checked": false,
|
||||
"checkup_fixed": false
|
||||
},
|
||||
"periods": [ { "id": 1, "name": "Milan Period", "start_year": 1482, "end_year": 1499, ... } ],
|
||||
"paintings": [ { "id": 10, "title": "...", "year": 1498, "image_path": "...", "thumbnail_path": "...", "wikipedia_title": "...", "has_influence_links": true, "checkup_checked": false, "checkup_fixed": false, ... } ]
|
||||
@@ -110,6 +112,102 @@ Each painting includes:
|
||||
|
||||
Populate biographies with `npm run fetch-artist-bios` (see [data-and-images.md](data-and-images.md)).
|
||||
|
||||
Artist objects also include `checkup_checked` and `checkup_fixed` (same semantics as paintings; gold portrait border when reviewed). Run `npm run migrate:artist-checkup-flags` on existing databases.
|
||||
|
||||
---
|
||||
|
||||
## `PATCH /api/artists/:id/checkup-flags`
|
||||
|
||||
Update artist portrait review flags. Body: `{ "checked"?: boolean, "fixed"?: boolean }` — at least one field required.
|
||||
|
||||
Same rules as painting checkup flags: setting `fixed: true` also sets `checked: true`.
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{ "checked": true, "fixed": false }
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## `GET /api/artists/:id/debug-portrait-search`
|
||||
|
||||
Portrait image search for debug mode on the artist bio page (Custom Search → Google Arts & Culture → scrape → DuckDuckGo).
|
||||
|
||||
**Response** — same shape as painting debug search (`query`, `imageUrl`, `searchUrl`, `source`, optional `thumbUrl`, `sourceLabel`).
|
||||
|
||||
---
|
||||
|
||||
## `GET /api/artists/:id/debug-portrait-search/more`
|
||||
|
||||
Up to 20 ranked portrait candidates for the **More** picker modal.
|
||||
|
||||
**Query:** `limit` (int, default 20, max 20)
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{
|
||||
"query": "Leonardo da Vinci portrait",
|
||||
"searchUrl": "https://…",
|
||||
"source": "google-custom-search",
|
||||
"results": [
|
||||
{ "imageUrl": "https://…", "thumbUrl": "https://…", "source": "google-custom-search" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## `POST /api/artists/:id/fix-portrait`
|
||||
|
||||
Download a remote URL and replace the artist’s local portrait. Sets `checkup_fixed = true` and `checkup_checked = true`.
|
||||
|
||||
**Body** — same as `POST /api/paintings/:id/fix-image` (`imageUrl` required; optional `searchUrl`, `source`, `thumbUrl`).
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{
|
||||
"portraitPath": "portraits/Leonardo_da_Vinci.jpg",
|
||||
"fixed": true,
|
||||
"checked": true
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## `POST /api/artists/:id/clear-portrait`
|
||||
|
||||
Delete the portrait file from disk, set `portrait_path = NULL`, and set both checkup flags. Used by debug **Clear**; the bio page shows an empty portrait slot (no placeholder).
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{
|
||||
"portraitPath": null,
|
||||
"fixed": true,
|
||||
"checked": true
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## `POST /api/artists/:id/upload-portrait`
|
||||
|
||||
Upload a local image (base64 JSON body). Validates with `sharp`, resizes to portrait dimensions, sets checkup flags.
|
||||
|
||||
**Body**
|
||||
|
||||
```json
|
||||
{
|
||||
"imageData": "<base64>",
|
||||
"mimeType": "image/jpeg"
|
||||
}
|
||||
```
|
||||
|
||||
Max size 15 MB. **Response** — same as `fix-portrait`.
|
||||
|
||||
---
|
||||
|
||||
## `GET /api/artists/:id/navigation`
|
||||
@@ -212,7 +310,7 @@ Returns the image bytes with `Cache-Control: public, max-age=86400`, or `404` if
|
||||
|
||||
## Developer image audit
|
||||
|
||||
Routes for the **Checkup** page and **Debug mode** on painting detail. Register `GET /api/paintings/checkup` **before** `GET /api/paintings/:id` so `"checkup"` is not parsed as a painting id.
|
||||
Routes for the **Checkup** page and **Debug mode** on painting detail and artist bio. Register `GET /api/paintings/checkup` **before** `GET /api/paintings/:id` so `"checkup"` is not parsed as a painting id.
|
||||
|
||||
### `GET /api/paintings/checkup`
|
||||
|
||||
@@ -315,6 +413,61 @@ Only `imageUrl` is required; optional fields improve fetch success for hotlinked
|
||||
|
||||
---
|
||||
|
||||
### `GET /api/paintings/:id/debug-image-search/more`
|
||||
|
||||
Up to 20 ranked painting image candidates for the **More** picker modal.
|
||||
|
||||
**Query:** `limit` (int, default 20, max 20)
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{
|
||||
"query": "Andrei Rublev Trinity painting",
|
||||
"searchUrl": "https://…",
|
||||
"source": "google-arts",
|
||||
"results": [
|
||||
{ "imageUrl": "https://…", "thumbUrl": "https://…", "source": "google-arts" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `POST /api/paintings/:id/clear-image`
|
||||
|
||||
Delete full + thumbnail files from disk, set `image_path` and `thumbnail_path` to `NULL`, and set both checkup flags. Used by debug **Clear**; detail view shows an empty frame (no placeholder, no on-demand refetch).
|
||||
|
||||
**Response**
|
||||
|
||||
```json
|
||||
{
|
||||
"imagePath": null,
|
||||
"thumbnailPath": null,
|
||||
"fixed": true,
|
||||
"checked": true
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `POST /api/paintings/:id/upload-image`
|
||||
|
||||
Upload a local painting image (base64 JSON body). Validates with `sharp`, writes full file, regenerates thumbnail, sets checkup flags.
|
||||
|
||||
**Body**
|
||||
|
||||
```json
|
||||
{
|
||||
"imageData": "<base64>",
|
||||
"mimeType": "image/jpeg"
|
||||
}
|
||||
```
|
||||
|
||||
Max size 15 MB. **Response** — same shape as `fix-image` (`imagePath`, `thumbnailPath`, `fixed`, `checked`).
|
||||
|
||||
---
|
||||
|
||||
### `GET /api/debug/image-proxy`
|
||||
|
||||
Proxy a remote image URL for debug preview (avoids hotlink / CORS blocks in the browser).
|
||||
@@ -341,9 +494,19 @@ The React client wraps these endpoints in `client/src/api/client.ts`:
|
||||
| `imageUrl(path)` | `/images/<path>` or placeholder |
|
||||
| `galleryImageUrl(painting)` | Local thumb/full only (3D) |
|
||||
| `galleryImageUrlWithRevision(painting, revision)` | Local URL with `?v=` cache buster after fix |
|
||||
| `paintingImageUrl(painting)` | Local file or on-demand API |
|
||||
| `paintingImageUrl(painting)` | Local file, on-demand API, or `null` when cleared (`checkup_fixed` + no paths) |
|
||||
| `portraitUrl(path, revision?)` | `/images/<path>` with optional `?v=` cache buster |
|
||||
| `api.getPaintingCheckup()` | `GET /api/paintings/checkup` |
|
||||
| `api.updatePaintingCheckupFlags(id, flags)` | `PATCH /api/paintings/:id/checkup-flags` |
|
||||
| `api.getPaintingDebugImageSearch(id)` | `GET /api/paintings/:id/debug-image-search` |
|
||||
| `api.getPaintingDebugImageSearchMore(id, limit?)` | `GET /api/paintings/:id/debug-image-search/more` |
|
||||
| `api.fixPaintingImage(id, imageUrl, context?)` | `POST /api/paintings/:id/fix-image` |
|
||||
| `api.clearPaintingImage(id)` | `POST /api/paintings/:id/clear-image` |
|
||||
| `api.uploadPaintingImage(id, file)` | `POST /api/paintings/:id/upload-image` |
|
||||
| `api.updateArtistCheckupFlags(id, flags)` | `PATCH /api/artists/:id/checkup-flags` |
|
||||
| `api.getArtistDebugPortraitSearch(id)` | `GET /api/artists/:id/debug-portrait-search` |
|
||||
| `api.getArtistDebugPortraitSearchMore(id, limit?)` | `GET /api/artists/:id/debug-portrait-search/more` |
|
||||
| `api.fixArtistPortrait(id, imageUrl, context?)` | `POST /api/artists/:id/fix-portrait` |
|
||||
| `api.clearArtistPortrait(id)` | `POST /api/artists/:id/clear-portrait` |
|
||||
| `api.uploadArtistPortrait(id, file)` | `POST /api/artists/:id/upload-portrait` |
|
||||
| `debugImageProxyUrl(imageUrl, context?)` | `GET /api/debug/image-proxy?url=…` |
|
||||
|
||||
Reference in New Issue
Block a user