Piattaforma ITI TECHNOLOGY: monorepo, Medusa, API, sito, area riservata e deploy

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

prompts/20-api-installatori.md

@@ -0,0 +1,17 @@
+# 20 — API: installatori e PostGIS
+
+Leggi `CLAUDE.md`.
+
+## Obiettivo
+Profilo installatore, approvazione e ricerca per zona.
+
+## Cosa fare
+- Installatore: `GET/PUT /installer/profile` (indirizzo, coordinate, raggio di servizio, certificazioni). Geocoding: per ora l'utente inserisce l'indirizzo e le coordinate arrivano da un selettore su mappa nel frontend (niente servizio di geocoding a pagamento); valida lat/lng.
+- Admin: `GET /admin/installers?status=`, `POST /admin/installers/:id/approve` (cambia ruolo/stato, chiama `syncInstallerGroup` per il customer group Medusa, email di conferma), `POST /admin/installers/:id/reject`.
+- Admin: `GET /admin/installers/nearby?lat=&lng=` → installatori approvati il cui raggio di servizio copre il punto, ordinati per distanza (`ST_DWithin` + `ST_Distance` su geography).
+- Utility per trovare la provincia di una `quote_request` → installatori vicini (verrà usata dall'admin per assegnare lavori).
+
+## Criteri di accettazione
+- Test con 3 installatori a distanze diverse: la query restituisce solo quelli entro raggio, in ordine di distanza.
+- Un installatore `pending` non accede ai documenti `installer` né ai prezzi riservati; dopo l'approvazione sì.
+- `CLAUDE.md` aggiornato.