Architettura e capacità in breve
Una clinica vende tempo, lo eroga, lo documenta e si fa pagare. Questa pagina mostra come la piattaforma faccia ciascuna di queste cose, quali siano i pezzi e come si colleghino — e che cosa ciò vi frutti sul piano commerciale e operativo. Scritta per chi ha quindici minuti, non un terminale.
Le persone toccano il livello più alto. Tutto ciò che fanno passa da una sola passerella, che è l'unica cosa a custodire segreti. La passerella interroga il nucleo gestionale, dove vivono le regole e le registrazioni. Il nucleo tiene i propri dati e si rivolge al mondo esterno. Nulla salta un livello — ed è per questo che cambiare un fornitore di pagamenti o di IA non arriva mai all'app, e perché l'app non può mai raggiungere il database.
/my — sedute, ordini, fatture, chat, documenti./my/expert — disponibilità, sedute, relazioni, compensi./my/admin — il cruscotto quotidiano di salute e 17 report.Ogni livello può essere sostituito senza toccare quelli sopra. Il fornitore di pagamenti è un'impostazione, non una riscrittura. Il fornitore di IA è un'impostazione. Un secondo marchio può girare sullo stesso nucleo. E poiché l'app non custodisce mai un segreto e non vede mai il database, un telefono perso è un fastidio e non un incidente.
La cosa più utile da capire dell'architettura è un percorso attraverso di essa. Tutto il resto di questa pagina è una variazione su questi sei passi.
Un paziente tocca uno slot libero. L'app invia una sola richiesta autenticata alla passerella e non sa nient'altro del parco.
Token valido, limite di frequenza libero, richiesta ben formata. Qualunque cosa malformata è rifiutata qui, prima che raggiunga il nucleo gestionale.
Quello slot è davvero libero? Orari settimanali, eccezioni, prenotazioni esistenti, disponibilità della stanza, preavviso, orizzonte di prenotazione — devono passare tutti e sei.
A un credito di seduta viene attaccato un orario. La quota del professionista è calcolata dalle condizioni in vigore in quel preciso momento — e congelata.
Un evento si dirama verso notifiche, email, posta in arrivo nell'app e WhatsApp, secondo le preferenze di ciascuno e nella sua lingua.
L'ordine, la fattura, la pipeline del professionista e i report dell'amministrazione si muovono insieme, perché leggono la stessa riga.
Sei verifiche di disponibilità girano nel nucleo, non nell'app e non in un foglio di calcolo. È per questo che la piattaforma non prenota due volte una stanza, non vende due volte uno slot, e sa rispondere a « perché oggi nessuno riesce a prenotarmi? » con un motivo preciso invece che con un'alzata di spalle.
Una persona è un paziente, un professionista, un amministratore — o tutti e tre insieme. La piattaforma le dà un solo accesso e le mostra le aree che il suo ruolo sblocca. Quella singola scelta elimina un'intera categoria di costi di assistenza legati all'inserimento, ai reimpostamenti di password e al « ma in quale sistema era? ».
Completa da sola — nessuno ha bisogno del sito per usare la piattaforma. Costruita una volta in Flutter, pubblicata su entrambi gli store, localizzata in 23 lingue comprese quelle che si scrivono da destra a sinistra.
Gli stessi dati con più spazio per respirare. Tre portali da un solo accesso, ciascuno che mostra solo ciò a cui quel ruolo ha diritto.
Il sistema gestionale completo sottostante, per il lavoro che è configurazione anziché operatività — e per l'amministrazione, che merita un vero sistema contabile.
Il nucleo non è un monolito. È un insieme di moduli che possiedono ciascuno una parte dell'attività, e dipendono l'uno dall'altro in un ordine dichiarato. È ciò che permette a una clinica di attivare solo ciò che le serve — e ciò che permette allo stesso nucleo di servire uno studio di coaching, una clinica e un servizio sanitario regolamentato senza una biforcazione.
Vendere ed erogare tempo
bookingCalendari, pianificatori, stanze, sedi e il motore delle disponibilità.sale_meetingSedute vendute come crediti, scale di disdetta, contratti di servizio dei pacchetti.clinic_platformIl livello di piattaforma: profili dei professionisti, servizi, contenuti, notifiche.Farsi pagare, e pagare
expert_payCondizioni di ingaggio come storico datato di contratti; cicli di pagamento costruiti dalle sedute tenute.clinic_reportsI diciassette report di allineamento e di prestazione.Contabilità · Vendite · Risorse umaneApplicazioni gestionali standard, che agiscono sugli stessi clienti e sugli stessi ordini.La parte che deve reggere
secure_document_base _cryptoCifratura a busta, custodia delle chiavi, rotazione e crypto-cancellazione. Otto moduli.clinical_dms _eu _uk _usRelazioni di cura, registro delle comunicazioni e diritti degli interessati — con un pacchetto per giurisdizione.session_reportsRelazioni di seduta depositate sulla seduta, riguardanti il paziente, nell'archivio sicuro.Firma e ciclo di vita dei contratti
esign_base + altri 8Firma elettronica auto-ospitata con una pista di audit a prova di manomissione. Nessun fornitore di firma di terze parti.contract_*Ventitré moduli: negoziazione, approvazione, modifica, obbligazioni, fatturazione, reportistica legale.Dove l'IA può toccare l'attività
ai_bridgeCollega il nucleo a qualunque LLM per analisi guidata da prompt, chiamata di strumenti e azioni automatiche — indipendente dal fornitore.Servizio IA della passerellaIl compagno rivolto al paziente: risposte trasmesse via WebSocket, senza mai toccare direttamente le registrazioni.Chi è chi, e chi può vedere che cosa
user_extentionUn solo account che porta insieme i ruoli di paziente, professionista e amministratore.Verifica di età e identitàPrima il controllo facciale automatico, poi la coda di revisione documentale, cifrata e cancellata in automatico dopo.È lo schema più importante della pagina. Un servizio viene venduto, diventa un credito, il credito diventa una prenotazione, la prenotazione diventa presenza, e la presenza è ciò che libera il denaro — verso l'attività e verso il professionista. Spezzate un anello e il sintomo compare in tutt'altro posto.
« Il credito è ciò che possiedi. La prenotazione è quando lo spendi. »
Acquistare e prenotare sono passi deliberatamente distinti. È ciò che permette a un paziente di comprare oggi un pacchetto e collocare gli appuntamenti nei mesi seguenti — ed è perché una seduta disdetta non è una seduta persa: disdire stacca l'orario e restituisce il credito.Relazioni, compensi ai professionisti e ricavo maturato aspettano tutti che la seduta sia chiusa come tenuta o come mancata presentazione. Una seduta erogata ma mai chiusa è sbagliata ovunque allo stesso tempo — ed è per questo che sedute bloccate è il report che un amministratore lavora per primo, tutti i santi giorni.
La quota del professionista è calcolata dalle condizioni in vigore al momento della prenotazione e lì fissata. Cambiate le condizioni il mese prossimo e il lavoro già svolto mantiene il suo prezzo. Ogni riga di compenso registra la versione di contratto che l'ha valorizzata, così una domanda su un pagamento di otto mesi fa ha una risposta.
La politica di disdetta decide che cosa si addebita ai pazienti, che cosa si paga ai professionisti, quanto vivono i crediti e con quanto anticipo si può prenotare. È attaccata ai prodotti, così servizi diversi possono comportarsi diversamente — e cambiarla non rivaluta mai la storia.
Le registrazioni cliniche e professionali non sono righe ordinarie di una tabella. Sono tenute come documenti sicuri, con cinque proprietà che valgono a prescindere da chi chieda — compreso chi possiede la società.
Ogni versione ha la propria chiave, sotto cifratura a busta. Nessuno legge le registrazioni dal database, e un backup del database da solo non è una comunicazione di dati.
L'accesso richiede una regola che lo permetta. Essere amministratore non concede nulla di per sé — l'accesso segue l'équipe di cura del paziente, non l'organigramma. Non esiste alcuna deroga generale.
Le aperture oltre alle modifiche, in un registro che nessuno può modificare né cancellare. Se un paziente, un'autorità o il vostro ufficio legale chiedono chi abbia visto una registrazione, l'elenco è completo.
Una correzione è depositata come nuova versione; l'originale non viene mai sovrascritto. Una registrazione modificabile non vale nulla come prova, e un giorno la vostra potrebbe dover valere qualcosa.
Alla scadenza della conservazione si distrugge la chiave anziché la riga. Il contenuto sparisce; resta la prova che è esistito ed è stato distrutto come si deve — che è ciò che un auditor vuole davvero.
Le registrazioni cliniche arrivano con i pacchetti UE, Regno Unito e Stati Uniti sullo stesso nucleo — gestione della cancellazione e del registro dei trattamenti, regole di diniego, registri delle comunicazioni — così una sola installazione può servire più di un regime giuridico.
Esiste una via di accesso di emergenza per l'urgenza vera, e usarla è un evento registrato che viene riesaminato dopo. È l'intero progetto in una frase: l'accesso è disponibile quando qualcuno ne ha davvero bisogno, e non è mai silenzioso. È molto più facile da mettere davanti a un responsabile della protezione dei dati di una matrice di permessi e una promessa.
La stessa piattaforma si vende in tre modi, perché a firmare sono tre persone diverse. Qui sotto c'è ciò che ognuna ottiene, nelle parole che usano loro anziché nelle nostre.
La maggior parte dei software per cliniche prenota appuntamenti e si ferma lì. Questo fa girare l'intera catena — vende il tempo, lo eroga, lo documenta, paga il professionista e dimostra che cosa è successo — così che i numeri della clinica, i suoi pagamenti e il suo fascicolo di conformità leggano tutti la stessa riga.
La piattaforma ha un'opinione precisa sulla gestione: non vi consegna un muro di grafici. Vi consegna diciassette elenchi che dovrebbero essere vuoti, in un ordine, su un ritmo. Un report vuoto è il buon risultato — quindi il mestiere è trovare gli elenchi che vuoti non sono.
Undici chiedono se la registrazione corrisponda alla realtà. Quattro confrontano come le persone svolgono il lavoro. Ciascuno è definito da ciò che mette una riga nell'elenco, e ciascuno è pensato per essere lavorato finché non è vuoto.
Lavorato finché non è vuoto
Condotta, conformità e conservazione
Da leggere con le regole di equità
Misurato per opportunità, contesto sempre mostrato, tassi sotto le cinque sedute soppressi, ciò che una persona controlla separato da ciò che controllate voi, ogni cifra a un clic dalle sedute che ci stanno dietro, e nessuna classifica sulla pagina personale di nessuno. Un numero che nessuno può difendere è peggio di nessun numero.
Il parco è fatto di quattro processi e una manciata di servizi a contratto. Ogni dipendenza esterna sta dietro un'interfaccia con una simulazione dall'altra parte di un interruttore — ed è così che l'app si può dimostrare, collaudare e sviluppare senza un solo account fornitore attivo.
Un solo file di composizione avvia l'intero stack. In quell'elenco non c'è alcun ambiente di esecuzione proprietario né alcuna licenza per core.
Dati, pagamenti, IA e notifiche si risolvono ciascuno in un fornitore reale o in una simulazione, scelta da un'unica impostazione. Le conseguenze sono commerciali, non solo tecniche:
Tutti nella passerella. L'app mobile viene distribuita solo con chiavi pubbliche; il browser riceve URL firmati che scadono anziché credenziali; il database non è mai raggiungibile da un client.
In pratica: un'app si può decompilare e non si perde nulla, e una chiave ruotata ha effetto per tutti gli utenti insieme senza una nuova versione dell'app.
| Capacità | Gira contro | Ripiega su | Che cosa si rompe senza |
|---|---|---|---|
| Dati gestionali | odoo — JSON-RPC tramite un account di servizio | mock | Tutto. Questo è il sistema di registrazione |
| Pagamenti | stripe · paypal | mock, oppure bonifico manuale con prova caricata | Il pagamento con carta. Gli ordini funzionano comunque con revisione e conferma |
| IA | openai · gemini | mock | Il compagno e l'analisi IA. Nulla di clinico né di finanziario |
| Notifiche push | Firebase (FCM e APNS) | email, posta in arrivo nell'app | Gli avvisi immediati. I promemoria raggiungono comunque le persone via email |
| SMTP | posta in arrivo nell'app | Conferme e fatture per posta elettronica | |
| WhatsApp Cloud API | notifiche, email | Un canale di promemoria su quattro | |
| Media e allegati | Archiviazione a oggetti compatibile S3 | archiviazione locale | I caricamenti su larga scala. Le registrazioni in sé stanno nel nucleo |
| Voce e video | WebRTC, segnalato dalla passerella | chat, telefono | Le chiamate in app. Le sedute in sede e telefoniche non sono toccate |
Nessun singolo fornitore esterno può impedire alla clinica di vendere, erogare e documentare una seduta. È la proprietà che vale la pena proteggere man mano che il parco cresce, ed è il motivo per cui ognuno di questi sta dietro un'interfaccia anziché essere chiamato direttamente dal codice che conta.
Dopo questa vengono due tipi di pagina. Gli schemi prendono un singolo posto nell'attività e rispondono alle stesse quattro domande — che cosa vede, che cosa controlla, come lo rende più rapido, e che cosa fa per l'attività. Le guide poi insegnano ogni schermata, passo per passo, in nove lingue.
Sette fasi in corsie, tutti e quattro i punti di vista insieme, e il bivio fra una seduta online e una nella vostra sede.
La stessa attività dalla sedia dell'amministrazione, del paziente, del professionista e della contabilità.
La routine quotidiana, tutti e diciassette i report, le politiche, i compensi, la conformità e l'indice del back office.
Disponibilità, sedute, relazioni, pazienti, compensi, pagamenti e reputazione — sul web e su un telefono.
Trovare un professionista, acquistare, prenotare, partecipare, pagare, e le registrazioni tenute su di sé.
Il cruscotto amministrativo: cassa, crediti, costo di erogazione, previsione, perdite e la chiusura di fine mese.