Fixi — diagnosi elettrodomestici via AI

Il tuo elettrodomestico si rompe. Invece di chiamare un tecnico a 70 € di sola uscita, fai una videochiamata da 9,90 € con un'AI che guarda attraverso la camera del telefono, ti chiede le cose giuste e ti dice cos'è rotto.

Se poi serve un tecnico, Fixi te lo trova — e i 9,90 € già pagati diventano uno sconto sulla riparazione.

In linea su fixiai.it e su Google Play come app Android.

---

Cosa fa, in concreto

1. La videodiagnosi — 9,90 €

/diagnosi → scegli l'elettrodomestico e descrivi il problema
          → paghi 9,90 € (Stripe)
          → si apre la camera
          → ogni 4 secondi un fotogramma va a Claude Vision
          → l'AI chiede, tu rispondi, si arriva alla diagnosi
          → referto: guasto, gravità, soluzione, costo previsto
          → il referto te lo porti via in PDF o via email

Sette elettrodomestici: lavatrice, lavastoviglie, asciugatrice, frigorifero, forno, piano cottura, condizionatore.

I fotogrammi non vengono mai salvati: passano in memoria e si scartano.

2. Il mercato delle riparazioni

dal referto → "trova un tecnico"
            → i tecnici della zona ricevono un'email; il primo che accetta vince
            → il tecnico manda un preventivo (poniamo 120 €)
            → il cliente vede 120,00 − 9,90 di credito = 110,10 da pagare
            → paga, il tecnico lavora, segna "finito"
            → partono 108 € al tecnico; Fixi trattiene 12 €

La commissione è il 10% del totale, non del saldo. E il bonifico parte solo a lavoro finito: fino a quel momento i soldi restano fermi su Fixi, ed è l'unica cosa che permette di rimborsare un intervento mai fatto.

3. Le guide

70 guide ai sintomi più comuni (/guida/lavatrice/non-scarica e compagnia), generate dai dati in lib/guide.js. Sono il canale per farsi trovare su Google senza pagare pubblicità.

---

Sette lingue

Italiano, inglese, spagnolo, francese, tedesco, portoghese, rumeno — sito, diagnosi, email e referto.

Le parole stanno fuori dal codice, in testi/<lingua>.js. L'italiano è l'originale e si scrive a mano; le altre sei si rigenerano:

node scripts/traduci.mjs --prova  # cosa tradurrebbe e quanto costa, senza chiamare l'API
node scripts/traduci.mjs          # solo le frasi cambiate, in tutte le lingue
node scripts/traduci.mjs de       # solo le frasi cambiate, in una lingua

Lo script si ricorda com'era ogni frase italiana l'ultima volta che è stata tradotta (testi/.impronte.json) e ritraduce solo quelle cambiate. Cambiare cinque frasi costa qualche migliaio di token; ritradurre tutto da capo (--tutte) circa 330 mila, e quasi mai serve.

Prezzi e codici postali seguono il paese, non solo la lingua (lib/mercati.js, lib/prezzi.js).

Sette frasi per lingua parlano di corrente, acqua e gas a qualcuno che ha l'elettrodomestico davanti e le mani libere. Quelle si ricontrollano traducendole all'indietro in italiano:

node scripts/ricontrolla-sicurezza.mjs

---

Partire da zero

npm install
cp .env.example .env.local     # poi compila i valori
npm run dev

Apri http://localhost:3000

Su Supabase vanno eseguite le migrazioni in migrazioni/ (SQL editor, incolla e lancia). Creano le tabelle e attivano le RLS.

Per provare davvero usa npm run build && npm start. In npm run dev diverse pagine restano ferme su "Caricamento...".

Per provare i pagamenti serve la modalità test di Stripe (carta 4242 4242 4242 4242) e, per i webhook, Stripe CLI:

stripe listen --api-key <sk_test> --forward-to http://localhost:3000/api/stripe-webhook

Stampa un whsec_ da mettere in .env.local.

---

Prove

npm test                          # tutte
node --test test/soldi.test.mjs   # una sola

109 prove sul test runner di Node, senza dipendenze aggiunte. Coprono i conti, gli stati, il credito, il bonifico, le metriche, la scelta delle frasi da ritradurre, e un giro completo dall'inizio alla fine (test/e2e.test.mjs).

Attenzione a cosa non coprono: le regole sui soldi sì, cosa fa una pagina quando si preme un pulsante no. Un percorso che passa da una schermata va percorso nel browser.

---

Com'è fatto

Next.js (pages router) — sito e API nello stesso progetto. Claude Opus 5 con visione per la diagnosi. Stripe per i pagamenti e Connect per i bonifici ai tecnici. Supabase per i dati. Resend per le email. Capacitor per le app: è un guscio nativo che carica il sito, quindi una correzione al sito arriva sui telefoni senza ricompilare niente. L'app Android è sul Play Store; quella iPhone è in preparazione, e si compila in cloud con Codemagic (codemagic.yaml) perché serve un Mac.

pages/          le schermate e le API
lib/            i conti, gli stati, le lingue, le guide — provabile senza rete
testi/          le parole, una lingua per file
test/           le prove
migrazioni/     SQL da eseguire a mano su Supabase
components/     i pochi pezzi condivisi
android/        il progetto Capacitor per Android
ios/            il progetto Capacitor per iPhone

Il ragionamento sui soldi vive tutto in lib/, senza rete e senza database: le rotte in pages/api/ controllano chi sta chiamando e poi delegano. È quello che rende provabile un mercato che muove denaro vero.

Chi ci lavora con Claude Code trovi in CLAUDE.md le regole che questo progetto ha imparato a sue spese.

---

Non c'è il login

E non è una mancanza: non esiste un account utente. Tutto gira su collegamenti con un segreto dentro — il tecnico ha il suo, il cliente ha il suo, ogni lavoro ha il suo. Meno password da dimenticare, meno password da rubare.

---

Cosa manca

• Tecnici veri. Il meccanismo c'è, le persone no: oggi è il vero collo di bottiglia.
• Lo storico delle diagnosi. Chi chiude la pagina senza salvare il referto ha pagato e non gli resta niente. Il dato però esiste già.
• Un sistema di analisi. Oggi c'è solo un diario di bordo per il debug.