Esempio: una Telegram Mini App che ripartisce le spese del gruppo dentro la chat

Questa è la Mini App che prendo quando il gruppo c’è già e il dolore è un foglio. Un viaggio in montagna. Quattro in un affitto. Un piccolo team che ripartisce una cena cliente. Qualcuno paga sempre, qualcuno «lo manda dopo», e quel dopo vive in un Google Sheet che nessuno apre.

Tool come Settler e Fracti hanno già dimostrato la forma: registrare la spesa nel gruppo (testo, voce o foglio), mostrare i saldi in una Mini App, saldare con un tap. Non ricostruirei il loro parser vocale IA il giorno uno. Ricostruirei il ledger e il bottone salda. Quello è il prodotto.

1. Il percorso utente in questo esempio

Lo spazio di lavoro è il gruppo. Nessuno crea un account «Alpi 2026». Aggiungono il bot, aprono la Mini App dal menu - e il ledger è già questa chat.

• Qualcuno aggiunge il bot al gruppo. Il bot chiede di vedere i membri perché la lista della ripartizione siano le persone in chat - non un form di email.
• Olena ha pagato 2400 UAH per il cottage. Apre la Mini App, importo, titolo, chi c’è. MainButton = salva. Haptic al successo. Il bot posta una ricevuta di una riga nel gruppo così gli altri non devono ancora aprire l’app.
• Chiunque apre la Mini App dopo e vede «Andriy deve 600 a Olena». Non una matrice. Un grafo semplificato. Un bottone «salda» per arco.
• Saldare: marca pagato (fiducia), manda una fattura Telegram / Stars, o un trasferimento TON se il gruppo muove già i soldi così. Il bot annuncia «saldato» nel gruppo. L’arco scompare.

2. Perché la Mini App, non solo un bot

Un bot di testo può registrare «/paid 2400 cottage». Non può mostrare una ripartizione giusta con eccezioni, modificare la cena di ieri, né far pagare Andriy a Olena con un tap senza un filo di comandi. La chat resta l’inbox. Il foglio resta l’UI.

• Opzionale: una menzione nel gruppo - «@splitbot ho pagato 50 per la cena» - crea una bozza. Confermare nella Mini App. Così Fracti sembra magia. Così nascono anche righe spazzatura se saltate la conferma.
• `chat_instance` è la chiave primaria. Due gruppi con le stesse persone sono due ledger. Non uniteli perché gli user id si sovrappongono.

3. Cosa costruirei per prima (e cosa no)

Una prima versione è una calcolatrice con una chat. Non è Splitwise con banche e report fiscali.

• Costruire per primi: aggiungi spesa, ripartizione uguale, escludi una persona, semplifica debiti, marca saldato, ricevuta bot nel gruppo, HMAC a ogni scrittura.
• Poi: un binario di saldo che il gruppo usa già. In Ucraina spesso una fattura Mono o «ho inviato, tap per confermare». Stars se gli importi sono piccoli e digitali. TON solo se i wallet sono già nel gruppo.
• Non per primi: OCR di scontrini stropicciati, NLP vocale, template affitto, cinque valute con FX live, un profilo pubblico. È il mese due se il primo ledger viene usato due volte.

4. I due bug che uccidono un’app di ripartizione

La matematica sbagliata e le persone mancanti. Il resto è lucidatura.

• Semplificate i debiti con un passo min-cash-flow, poi un numero per coppia. Se mostrate una matrice NxN grezza, la gente ne fa uno screenshot in un altro foglio.
• Chi lascia il gruppo resta sulle spese vecchie e scompare dalle nuove. Snapshot dei membri su ogni riga. Non ricalcolate la storia contro la lista di stasera.

Una Mini App di ripartizione è un ledger, il gruppo è la stanza

Lo costruirei per un club di viaggi, un coliving, una piccola agency o qualsiasi gruppo Telegram stile WhatsApp che litiga già per i soldi. Foglio Next.js, ledger Postgres con chiave `chat_instance`, un bot che posta solo ricevute e prompt di saldo, un binario di pagamento. Se è il vostro gruppo - scrivete dal form. Scopiamo una prima versione che questo mese registra una cena vera, non un’IA che allucina chi ha mangiato la pizza.