CANVAULT

La mia collezione personale di lattine Monster, iniziata il 1° aprile 2018. Chi visita il sito può sfogliarla; solo io, dopo l'accesso, do un voto da 1 a 10 a ogni lattina.

Avvio

npm install
npm run dev

• Sito: http://localhost:5173
• API: http://localhost:3001 (Vite inoltra già /api all'API)

Serve Node 22.13 o successivo, perché il database usa il modulo node:sqlite incluso in Node.

Per la versione di produzione: npm run build && npm start. In questo caso un solo server su http://localhost:3001 serve sia il sito sia l'API.

Account

C'è un solo account, il proprietario, creato al primo avvio con ADMIN_EMAIL e ADMIN_PASSWORD. In locale, se non le imposti, vengono usate le credenziali di sviluppo scritte in server/db.js; in produzione sono obbligatorie (password di almeno 12 caratteri). Si entra da "Area riservata" in fondo alla pagina (/accedi). Non c'è registrazione.

Pubblicazione

Online gira sul server Hetzner come container Docker (Dockerfile, deploy/hetzner/compose.yml), dietro il Caddy già presente sul server. Il container non apre porte pubbliche: Caddy lo raggiunge come canvault:3001 sulla rete Docker eubaro_default. Il database sta nel volume canvault-data, quindi voti e sessioni restano tra un aggiornamento e l'altro.

Per aggiornare il sito dopo un push:

ssh hetzner 'cd /opt/canvault/deploy/hetzner && git pull && docker compose up -d --build'

Le credenziali del proprietario sono in /opt/canvault/deploy/hetzner/.env sul server (non nel repo).

Le foto dei retro vengono da Open Food Facts (CC BY-SA); il credito è nel footer.

Come funziona

Frontend (src/): React 19 e React Router.

• pages/: Home, Collezione (ricerca, filtro per linea, ordinamento), scheda della lattina con il mio voto, la mia Classifica, Accesso.
• lib/: client delle API, contesto di autenticazione, colori di ogni linea.

Backend (server/): Hono su Node.

• Database SQLite in server/data/canvault.db (o in DATA_DIR), sincronizzato con db.json a ogni avvio: le lattine nuove vengono aggiunte, voti e utenti restano.
• Le password sono cifrate con scrypt.
• La sessione usa un cookie httpOnly; sul server è salvato solo l'hash del token.
• Solo il proprietario può votare: un voto per lattina, che può cambiare o togliere.

Metodo	Endpoint
POST	/api/auth/login · /logout	accesso del proprietario
GET	/api/auth/me	utente corrente
GET	/api/cans · /api/cans/:id	lattine con il mio voto
PUT / DELETE	/api/cans/:id/vote	do o tolgo il voto (1–10), solo proprietario

Per ripartire da zero basta cancellare server/data/.