Reparto e assistenza

Costruire lo strumento di pianificazione del reparto

Un planning condiviso su una sola pagina web: settimana tipo, una scheda per attività, vista mensile, sincronizzazione per tutta l'équipe, pubblicato online. Costruito con Claude, passo dopo passo.

Claude CodeCoworkGitHubda 2 a 3 sessioni, poi una versione al mese

Costruire il planning dialogando: conversazione, anteprima della versione, contatori per persona.
Costruire il planning dialogando: conversazione, anteprima della versione, contatori per persona.

Schermata di uno strumento reale · dati fittizi, nomi sfocati · interfaccia in inglese

Architettura dello strumento di pianificazione

Figura. Un unico file, una scheda per attività, un database condiviso e una catena di pubblicazione versionata.

Il problema

Il planning di un reparto di cardiologia coinvolge decine di persone (medici strutturati, fellow clinici, specializzandi, tirocinanti) e attività molto diverse: ecocardiografia per sala, ambulatori, prove da sforzo, risonanza magnetica, guardie, riunioni di reparto, didattica. Spesso vive in un foglio di calcolo che solo una persona sa modificare, e ogni assenza scatena una catena di mail.

Metodo passo per passo

  1. Scrivere le specifiche prima del codice: l’elenco del personale (con la sua categoria), le attività, le mezze giornate, chi può modificare che cosa. Claude le redige a partire dai vostri appunti e dal foglio di calcolo esistente, ed elenca le ambiguità da risolvere.
  2. Una settimana tipo, poi le settimane reali: una scheda «Globale» descrive la settimana standard di ciascuno; le settimane reali ne derivano e non modificano mai il modello.
  3. Presenze ricorrenti per settimane pari o dispari: una presenza può ripetersi solo nelle settimane pari o in quelle dispari, tra una data di inizio e una data di fine. Le settimane reali la calcolano; non la si ricopia mai a mano.
  4. Una scheda per attività: Ecocardiografia (per sala e mezza giornata), Ambulatorio, Prove da sforzo, Risonanza magnetica, Guardie, Riunioni di reparto, Facoltà, Assenze, e una vista mensile che mostra tutti. Quando una cella è piena, una riga «presenti anche» mostra chi supera la sua capienza: senza di essa, alcuni nomi sparivano senza preavviso.
  5. Un unico file HTML, senza server da mantenere: Claude lo costruisce, voi lo aprite nel browser per provarlo.
  6. Un database condiviso perché tutta l’équipe veda gli stessi dati in tempo reale, protetto da una password di équipe. Il file non deve mai contenere una copia congelata dei dati: un computer nuovo mostrerebbe uno stato obsoleto senza avvisare. Un banner rosso «non connesso» segnala un computer che non vede i dati reali. Quando due persone modificano nello stesso momento, le modifiche vengono fuse per identità (chi è assegnato), mai per posizione nell’elenco: altrimenti l’una cancella l’altra.
  7. Applicare le regole con migrazioni versionate: ogni cambiamento di regola (nuova presenza ricorrente, attività rinominata) è una migrazione numerata, applicata una sola volta, e solo dopo la prima sincronizzazione riuscita con il database. Applicata troppo presto, scriverebbe su dati vuoti o verrebbe sovrascritta.
  8. Pubblicare online: il file vive in un repository GitHub. Ogni modifica passa da un ramo, poi da una richiesta di fusione che il responsabile fonde personalmente; un hosting statico pubblica poi automaticamente il ramo principale. Due serie di test (logica dei dati, gesti nel browser) devono essere superate prima di ogni fusione.
  9. Versionarlo: ogni rilascio porta un numero (v38, v39…) visibile nel titolo della pagina; la vecchia versione viene archiviata, mai sovrascritta.
  10. Trasformarlo in una skill: tutte le lezioni apprese (bug, procedura, verifiche) vengono condensate in una skill orchestratrice «planning», per non doverle reimparare a ogni conversazione.

Risultato

Uno strumento di pianificazione online, condiviso e versionato, e una skill che sa diagnosticarlo, correggerlo e consegnarlo.

Salvaguardie

  • Il planning in produzione non viene mai modificato direttamente dall’IA: l’IA prepara un ramo e una richiesta di fusione, voi la fondete. Nulla viene pubblicato senza approvazione, e le correzioni sono raggruppate in un’unica versione.
  • Nessun dato dei pazienti nel planning. I recapiti del personale restano nella rubrica, non nel file pubblicato.
  • La password di équipe non compare né nelle conversazioni condivise né nei documenti fatti circolare.
  • Distribuito non vuol dire testato: nessun link viene dato senza essere stato aperto; altrimenti porta la dicitura «non verificato».
  • Il planning non alimenta mai l’agenda personale: sono due fonti separate.

Prompt di partenza

Ecco il nostro foglio di calcolo del planning e l’elenco del personale. Scrivi le specifiche di uno strumento di pianificazione su una sola pagina web: settimana tipo, una scheda per attività, vista mensile, assenze. Elenca ciò che è ambiguo prima di scrivere qualsiasi codice.

← Torna al trittico