docs(readme): replace minimal architecture diagram with comprehensive version

Full architecture diagram now shows:
- IIIF server connections (info.json, tiles, derivatives, full images)
- Frontend internals (OpenSeadragon, region overlays, pages)
- Backend internals (ingestion, AI pipeline, response parser, master writer)
- AI providers (auto-detected, multi-provider)
- Export generators (IIIF 3.0, METS, ALTO, ZIP)
- Local storage (JSON only, no images)
- Complete 8-step pipeline flow per page (ingest → detect → fetch →
AI → parse → scale → write → review → export)

https://claude.ai/code/session_01UB4he7RdRPHLvNjky4X8Sw

README.md

@@ -33,25 +33,95 @@ IIIF Studio ingests images from any [IIIF](https://iiif.io/)-compliant server, a
 ## Architecture
 
 ```
-┌──────────────────────────────┐
-│   IIIF Image Servers         │  Gallica, BnF, Bodleian, ...
-│   (origin — images stay here)│
-└──────────────┬───────────────┘
-               │ IIIF Image API
-    ┌──────────┼──────────┐
-    │          │          │
-┌───▼───┐ ┌───▼───┐ ┌───▼───┐
-│Backend│ │Viewer │ │Tiled  │
-│  (AI) │ │display│ │ zoom  │
-│ bytes │ │       │ │       │
-│in RAM │ │       │ │       │
-└───┬───┘ └───────┘ └───────┘
-    │
-┌───▼─────────────────────┐
-│ Local storage            │  JSON only (~5 KB/page)
-│ master.json + ai_raw.json│  No images on disk
-│ + SQLite metadata        │
-└──────────────────────────┘
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                          IIIF IMAGE SERVERS                                     │
+│                  Gallica · BnF · Bodleian · Europeana · ...                     │
+│                  (origin — images are never copied)                             │
+└──────────┬────────────────────┬─────────────────────────────┬───────────────────┘
+           │                    │                             │
+           │ info.json          │ /full/!1500,1500/           │ /full/max/
+           │ + tiles            │ 0/default.jpg               │ 0/default.jpg
+           │                    │ (1500px for AI)             │
+           │                    │                             │
+┌──────────▼──────────┐ ┌──────▼───────────┐ ┌──────────────▼──────────────────┐
+│                     │ │                  │ │                                 │
+│   FRONTEND (SPA)    │ │  BACKEND (API)   │ │    EXPORT GENERATORS            │
+│   React + Vite      │ │  FastAPI         │ │                                 │
+│                     │ │                  │ │  IIIF Manifest 3.0              │
+│ ┌─────────────────┐ │ │ ┌──────────────┐ │ │  (with Image Service refs)      │
+│ │  OpenSeadragon   │ │ │ │  Ingestion   │ │ │                                 │
+│ │  IIIF tiled zoom │ │ │ │              │ │ │  METS XML                       │
+│ │  (info.json →    │ │ │ │ manifest URL │ │ │  (IIIF URLs, not file paths)    │
+│ │   deep zoom)     │ │ │ │ → detect svc │ │ │                                 │
+│ └────────┬─────────┘ │ │ │ → store meta │ │ │  ALTO XML                       │
+│          │           │ │ └──────┬───────┘ │ │  (text geometry per page)        │
+│ ┌────────▼─────────┐ │ │       │         │ │                                 │
+│ │ Region overlays  │ │ │ ┌─────▼────────┐│ │  ZIP bundle                     │
+│ │ (bbox from       │ │ │ │  AI Pipeline ││ │  (manifest + METS + ALTO)       │
+│ │  master.json,    │ │ │ │             ││ └─────────────────────────────────┘
+│ │  scaled to       │ │ │ │ fetch 1500px││
+│ │  canvas coords)  │ │ │ │ in memory   ││        ┌──────────────────────┐
+│ └──────────────────┘ │ │ │      │      ││        │                      │
+│                     │ │ │      ▼      ││        │   AI PROVIDERS        │
+│ ┌──────────────────┐ │ │ │ send bytes  │├───────►│                      │
+│ │  Pages           │ │ │ │ to AI       ││        │ Google Gemini        │
+│ │  Home · Reader   │ │ │ │      ���      ││◄───────│ Vertex AI            │
+│ │  Editor · Admin  │ │ │ │      ▼      ││  JSON  │ Mistral AI           │
+│ └────────┬─────────┘ │ │ │ discard img ││        │                      │
+│          │           │ │ │ keep JSON   ││        │ (auto-detected from  │
+│          │ REST API  │ │ │ scale bbox  ││        │  environment vars)   │
+│          │ /api/v1/* │ │ └─────┬───────┘│        └──────────────────────┘
+└──────────┼───────────┘ │       │         │
+           │             │ ┌─────▼────────┐│
+           │             │ │  Response    ││
+           │             │ │  Parser     ││
+           └─────────────┤ │             ││
+                         │ │ raw JSON    ││
+                         │ │ → layout    ││
+                         │ │ → OCR       ││
+                         │ │ → regions   ││
+                         │ └─────┬───────┘│
+                         │       │         │
+                         │ ┌─────▼────────┐│
+                         │ │  Master      ││
+                         │ │  Writer      ││
+                         │ │             ││
+                         │ │ ai_raw.json ││    ┌───────────────────────────────┐
+                         │ │ master.json ││    │                               │
+                         │ └─────┬───────┘│    │   LOCAL STORAGE               │
+                         │       │         │    │                               │
+                         └───────┼─────────┘    │   SQLite (corpus, pages,     │
+                                 │              │   manuscripts, jobs, models)  │
+                                 └──────────────►                               │
+                                                │   data/corpora/{slug}/pages/  │
+                                                │     {folio}/master.json       │
+                                                │     {folio}/ai_raw.json       │
+                                                │     {folio}/alto.xml          │
+                                                │                               │
+                                                │   ~5 KB per page (JSON only)  │
+                                                │   NO image binaries           │
+                                                └───────────────────────────────┘
+
+PIPELINE FLOW (per page):
+
+  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+  │ 1.INGEST │───►│ 2.DETECT │───►│ 3.FETCH  │───►│ 4.AI     │───►│ 5.PARSE  │
+  │          │    │          │    │          │    │          │    │          │
+  │ manifest │    │ IIIF svc │    │ 1500px   │    │ send     │    │ layout   │
+  │ URL      │    │ URL +    │    │ JPEG in  │    │ image +  │    │ regions  │
+  │          │    │ canvas   │    │ memory   │    │ prompt   │    │ OCR      │
+  │          │    │ dims     │    │ (discard │    │ to       │    │ bbox     │
+  │          │    │          │    │  after)  │    │ provider │    │          │
+  └──────────┘    └──────────┘    └──────────┘    └──────────┘    └────┬─────┘
+                                                                       │
+  ┌──────────┐    ┌──────────┐    ┌──────────┐                   ┌────▼─────┐
+  │ 8.EXPORT │◄───│ 7.REVIEW │◄───│ 6.WRITE  │◄──────────────────│ 5b.SCALE │
+  │          │    │          │    │          │                   │          │
+  │ IIIF 3.0 │    │ human    │    │ ai_raw + │                   │ bbox     │
+  │ ALTO XML │    │ correct  │    │ master   │                   │ deriv →  │
+  │ METS XML │    │ validate │    │ .json    │                   │ canvas   │
+  │ ZIP      │    │ version  │    │ + ALTO   │                   │ coords   │
+  └──────────┘    └──────────┘    └──────────┘                   └──────────┘
 ```
 
 ### Tech stack