Lorenzo SanesiandClaude Opus 5.5
b83ce039fb
Deploy stack su Proxmox / deploy (push) Failing after 3s
Monorepo npm con apps/public (Angular SSR), apps/private (Angular SPA), apps/api (Fastify), packages/shared e packages/styles; Medusa 2.21 in medusa/; infrastruttura Docker (Postgres PostGIS+pgvector, Redis, Caddy, backup) e workflow Gitea Actions per il deploy via SSH a ogni push su master. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018jQyT6dR9czzGwqb7FkG6u
1.2 KiB
1.2 KiB
16 — API: storage su disco e documenti
Leggi CLAUDE.md.
Obiettivo
Gestione file su disco VPS con visibilità per ruolo.
Cosa fare
StorageService(interfaccia + implementazione su disco locale, radice daUPLOAD_DIR) così in futuro si può passare a S3/MinIO senza toccare le route.- Due aree:
public/(servita direttamente da Caddy: immagini blog, foto) eprivate/(mai servita da Caddy, solo tramite API). - Upload admin (
@fastify/multipart): whitelist MIME (immagini, PDF, DWG/DXF, ZIP), limite dimensione da env, nome file rigenerato (uuid) e controllo path traversal. - Route:
POST /admin/documents(upload + metadati, visibility),PATCH,DELETE,GET /admin/documents.GET /documents→ elenco dei documenti visibili al ruolo dell'utente (pubblici se anonimo).GET /documents/:id/download→ stream del file solo se il ruolo lo consente.POST /admin/uploads/image→ upload immagine pubblica, restituisce l'URL.
Criteri di accettazione
- Un installatore scarica documenti
installer; un customer riceve 403 sugli stessi. - File con estensione/MIME non consentiti rifiutati; tentativi di path traversal falliscono.
- I file privati non sono raggiungibili via URL statico.
CLAUDE.mdaggiornato.