fix

Author: dinizime

CLAUDE.md

@@ -79,6 +79,10 @@ tests/
 - **images** — photo_id → full_webp BLOB + preview_webp BLOB
 - Created with `PRAGMA page_size = 65536` for optimal BLOB streaming
 
+### thumbnails/ (Static project thumbnails)
+- `{slug}.webp` — One thumbnail per project, served via `/api/v1/thumbnails/{slug}.webp`
+- Used by the catalog in ebgeo_web to display project preview images
+
 ### SQLite Optimizations
 - WAL mode on all connections
 - 64 MB cache for index.db, 32 MB per project DB
@@ -99,8 +103,9 @@ tests/
 | Endpoint | Description | Cache |
 |----------|-------------|-------|
 | `/health` | Service status + project count | None |
-| `/api/v1/projects` | List all projects | 1h |
+| `/api/v1/projects` | List all projects (includes `previewThumbnail` URL) | 1h |
 | `/api/v1/projects/:slug` | Single project details | 1h |
+| `/api/v1/thumbnails/:slug.webp` | Static project thumbnail image (WebP) | Static |
 | `/api/v1/photos/:uuid` | Photo metadata + targets (hidden targets filtered unless `?include_hidden=true`) | no-cache (revalidate) |
 | `/api/v1/photos/:uuid/image?quality=full\|preview` | WebP image stream | 1yr immutable + ETag |
 | `/api/v1/photos/by-name/:originalName` | Backward compat lookup | 1h |
@@ -158,7 +163,7 @@ Environment variables (with defaults):
 |----------|---------|-------------|
 | `PORT` | 8081 | HTTP server port |
 | `HOST` | 0.0.0.0 | Bind address |
-| `STREETVIEW_DATA_DIR` | ./data | Root data dir (index.db + projects/) |
+| `STREETVIEW_DATA_DIR` | ./data | Root data dir (index.db + projects/ + thumbnails/) |
 | `LOG_LEVEL` | info | Fastify logger level |
 | `CORS_ORIGIN` | * | CORS allowed origins |
 
@@ -171,6 +176,7 @@ The parent app (`../ebgeo_web`) integrates via REST API calls:
 - **`src/js/store/streetview360.operations.js`** — CRUD for orientations/markers
 - **`src/js/features_tab/streetview360-section.component.js`** — Feature list section
 - **`src/js/street_view_tool/streetview_markers.js`** — Clustered map markers (PMTiles)
+- **`src/js/catalog/catalog.service.js`** — Catalog aggregation (builds absolute thumbnail URLs from `serviceUrl` + `previewThumbnail`)
 
 Events: `STREETVIEW_360_OPENED`, `STREETVIEW_360_CLOSED`, `STREETVIEW_360_PHOTO_CHANGED`, `ORIENTATION_360_SAVED`, `ORIENTATION_360_CLEARED`, `MARKER_360_CLICKED`, `MARKERS_360_CHANGED`
 
@@ -329,9 +335,4 @@ docker-compose up -d
 
 # Local development
 npm run dev
-```
-
-## Projects
-
-15 military sites in southern Brazil:
-Alegrete, Parque Osorio, Uruguaiana, 3o RCMec, CIST, 27o GAC, CI Guarnicao Ijui, EASA, 29o GACap, CI Cruz Alta, SantAna do Livramento, Tubarao, Blumenau, CI General Calazans, Ponta Grossa
+```

Dockerfile

@@ -12,7 +12,7 @@ COPY src/ ./src/
 COPY scripts/ ./scripts/
 COPY public/ ./public/
 
-RUN mkdir -p /data/projects /data/thumbnails/projects
+RUN mkdir -p /data/projects /data/thumbnails
 
 ENV NODE_ENV=production
 ENV PORT=8081

EXPANDING.md

@@ -14,8 +14,9 @@ Fotos 360 (JPG) + Metadados (JSON)
 1. Registrar novo projeto em migrate.js
 2. Executar migracao (JSON+JPG -> SQLite)
 3. Gerar PMTiles para marcadores no mapa
-4. Verificar e testar
-5. Deploy
+4. Adicionar thumbnail do projeto
+5. Verificar e testar
+6. Deploy
 ```
 
 ## Pre-requisitos
@@ -174,7 +175,22 @@ Isso cria `fotos.pmtiles` contendo um ponto para cada foto com:
 
 Requisito: [tippecanoe](https://github.com/felt/tippecanoe) deve estar instalado.
 
-## Passo 5: Verificar
+## Passo 5: Adicionar Thumbnail
+
+Crie uma imagem de thumbnail para o novo projeto no diretorio de thumbnails:
+
+```
+{STREETVIEW_DATA_DIR}/thumbnails/{slug}.webp
+```
+
+- Formato: WebP
+- Nome do arquivo: deve corresponder ao slug do projeto (ex: `nome_do_local.webp`)
+- A imagem sera servida na API em `GET /api/v1/thumbnails/{slug}.webp`
+- Usada pelo catalogo do EBGeo Web como preview do projeto
+
+No Docker, o diretorio e `/data/thumbnails/`. Localmente, depende do `.env` (`STREETVIEW_DATA_DIR`).
+
+## Passo 6: Verificar
 
 ### Verificacao manual
 
@@ -194,6 +210,13 @@ No retorno de `/api/v1/projects/nome_do_local`, verifique:
 - `photoCount` — Numero esperado de fotos
 - `entryPhotoId` — UUID valido
 - `center` — Coordenadas corretas
+- `previewThumbnail` — Path do thumbnail (ex: `/thumbnails/nome_do_local.webp`)
+
+### Testar thumbnail
+
+```bash
+curl -o test_thumb.webp "http://localhost:8081/api/v1/thumbnails/nome_do_local.webp"
+```
 
 ### Testar foto de entrada