Γηροκομείο Ζωσιμάδων Ιωαννίνων: Healthcare Ops Stack

Το ίδρυμα

Το Γηροκομείο Ζωσιμάδων Ιωαννίνων φρόντιζε τους ενοίκους του με χαρτί: φάκελοι σε ντουλάπια, φαρμακευτικά σχήματα σε τετράδια, αποθήκη που μετριόταν με το μάτι. Μου ζητήθηκε να περάσει το ίδρυμα σε υπολογιστή χωρίς να αλλάξει ο τρόπος που δουλεύει το προσωπικό στη βάρδια. Έφτιαξα τρία συστήματα που τρέχουν σήμερα καθημερινά εκεί, και συνεχίζω να τα συντηρώ.

Το γηροκομείο τρέχει σήμερα την έκδοση του Ιουνίου 2026. Η νέα έκδοση είναι έτοιμη να εγκατασταθεί και φέρνει τις μεγαλύτερες αλλαγές: νέα χορήγηση φαρμάκων, τους ρόλους του προσωπικού ενός γηροκομείου και νέα διαδικασία εγκατάστασης. Η αναβάθμιση δοκιμάστηκε πρώτα σε αντίγραφο των δεδομένων του ιδρύματος. Παρακάτω γράφω τι τρέχει σήμερα και τι έρχεται με τη νέα έκδοση.

Τα στιγμιότυπα της κλινικής πλατφόρμας είναι από τοπική εγκατάσταση της νέας έκδοσης, με επινοημένους κατοίκους και προσωπικό. Κανένα όνομα και κανένα στοιχείο σε αυτές τις οθόνες δεν ανήκει σε πραγματικό πρόσωπο.

Η βάρδια ξεκινά από μία οθόνη

Σήμερα ο πίνακας ελέγχου δείχνει την πληρότητα των κλινών, τις αιτήσεις εισαγωγής σε αναμονή, τη βάρδια της ημέρας και την κίνηση των τελευταίων 48 ωρών. Στη νέα έκδοση δείχνει πρώτα ό,τι δεν πρέπει να περιμένει: αιτήσεις εισαγωγής σε αναμονή, έγγραφα προσωπικού που έληξαν ή λήγουν, φάρμακα της αποθήκης που λήγουν. Από κάτω βρίσκονται οι δόσεις της ημέρας, η καθεμία με το δικό της κουμπί χορήγησης, οι υπεύθυνοι της βάρδιας και το φαρμακείο που εφημερεύει για το ίδρυμα.

Ο φάκελος του κατοίκου, με την ασφάλεια πάντα στην κορυφή

Πώς λειτουργεί

• Backend: Bun και Elysia σε αυστηρό TypeScript, πάνω σε μία κοινή data source: 14 domain modules σήμερα και 21 στη νέα έκδοση (κάτοικοι, εισαγωγή, ιατρικός φάκελος, φαρμακευτική αγωγή, φαρμακείο, προσωπικό, χρεώσεις, εξιτήριο, παράπονα, επισκέπτες, έκτακτα συμβάντα, αιτήματα πρόσβασης σε δεδομένα, διατήρηση δεδομένων και άλλα).
• Δεδομένα: PostgreSQL 18 με TypeORM, Redis 7 για cache, και αποθήκευση αρχείων στο MinIO μέσω του S3 API του. Η νέα έκδοση φέρνει 88 migrations αντί για 9, περίπου 160 entities αντί για 66, και το Silo στη θέση του MinIO.
• Πρόσβαση: Better Auth, έλεγχος ρόλου στις διαδρομές του API και υποχρεωτικό TOTP για διαχειριστές, γιατρούς και νοσηλευτές. Η νέα έκδοση έχει 13 ρόλους, TOTP και για την προϊσταμένη νοσηλευτικής και τον ελεγκτή, και πίνακα δικαιωμάτων για 858 διαδρομές του API που ελέγχεται από test σε κάθε αλλαγή.
• Ακεραιότητα: κάθε ανεβασμένο αρχείο κρατά SHA-256 checksum, ώστε μια αλλοίωση να μπορεί να εντοπιστεί.
• Frontend: React 19 με TanStack Router και Query, με τα ελληνικά ως βασική γλώσσα και πλήρη αγγλικά: 10 ενότητες στο μενού και 51 οθόνες σήμερα, 12 και 93 στη νέα έκδοση.

Κάθε δόση, μία φορά, με ώρα και υπεύθυνο

Η χορήγηση φαρμάκων είναι η μεγαλύτερη αλλαγή της νέας έκδοσης. Εκεί οργανώνεται σε γύρους ανά ώρα και κάτοικο. Δίπλα σε κάθε δόση φαίνονται οι αλλεργίες, οι κίνδυνοι και η δίαιτα του κατοίκου, και κάθε δόση καταγράφεται μία φορά, με ώρα και υπεύθυνο. Ό,τι δεν δόθηκε, από άρνηση, αναστολή ή παράλειψη, πηγαίνει στη λίστα που παρακολουθεί ο γιατρός.

Πώς λειτουργεί

• Δόσεις: δημιουργούνται αυτόματα από τις εντολές του γιατρού, για σήμερα και αύριο.
• Προθεσμίες: μια δόση σε εκκρεμότητα γίνεται εκπρόθεσμη μετά από 30 λεπτά και κλείνει ως παράλειψη μετά από 2 ώρες.
• Διπλός έλεγχος: τα φάρμακα υψηλού κινδύνου και τα ελεγχόμενα ζητούν δεύτερο ελεγκτή ή γραπτή αιτιολογία.
• Παρακολούθηση: κάθε άρνηση, αναστολή ή παράλειψη μπαίνει στη λίστα του γιατρού, και η μηνιαία καρτέλα κρατά τα αρχικά όποιου έδωσε κάθε δόση.

Διαγνώσεις και φαρμακείο, στα ελληνικά

Σχέδια φροντίδας που δεν ξεχνιούνται

Κάθε σχέδιο φροντίδας έχει ημερομηνία επόμενης αναθεώρησης, και η λίστα ταξινομείται με αυτήν: ό,τι έχει καθυστερήσει εμφανίζεται πρώτο. Στη νέα έκδοση, με τον ίδιο τρόπο δουλεύουν και οι επαναξιολογήσεις κινδύνου (Braden, MMSE, Barthel) και τα έγγραφα του προσωπικού που λήγουν.

Πώς λειτουργεί

• Αυτοματισμοί: προγραμματισμένες εργασίες από 10 job modules σήμερα, ανάμεσά τους ο έλεγχος ακεραιότητας του ημερολογίου ενεργειών και τα αντίγραφα ασφαλείας. Η νέα έκδοση έχει 41 εργασίες από 25 job modules, μαζί με τις τρεις αναφορές παράδοσης βάρδιας στις 06:45, 14:45 και 22:45.
• Υπενθυμίσεις: οι αναθεωρήσεις των σχεδίων φροντίδας και οι λήξεις εγγράφων των κατοίκων φτάνουν στο προσωπικό ως ειδοποιήσεις, αντί να περιμένουν να τις θυμηθεί κάποιος. Η νέα έκδοση προσθέτει τις επαναξιολογήσεις και τα έγγραφα του προσωπικού.

Η αποθήκη ξέρει τι έχει και πότε λήγει

Πώς λειτουργεί

• Backend: Hono με Drizzle ORM και Better Auth πάνω σε PostgreSQL 18, μέσα σε Turborepo workspace.
• Συμβόλαιο API: κοινό package με Zod schemas ανάμεσα σε backend και frontend, που δίνει type-safe κλήσεις χωρίς code generation.
• Frontend: Vite, React, TanStack Router και Query, Tailwind.
• Έλεγχοι: 208 αυτόματα tests σε 33 αρχεία στο backend, με Vitest και ESLint στο CI και εικόνες container σε κάθε push.

Καταμέτρηση με το κινητό, ακόμα και χωρίς δίκτυο

Η απογραφή γίνεται με ένα Android κινητό μέσα στην αποθήκη: σάρωση, ποσότητα, επόμενο είδος. Το Wi-Fi εκεί είναι αδύναμο, οπότε η εφαρμογή δεν περιμένει το δίκτυο. Γράφει τοπικά και στέλνει μαζικά όταν επανέλθει η σύνδεση, ώστε μια ολόκληρη βάρδια να μη χάνεται επειδή έπεσε η γραμμή.

Πώς λειτουργεί

• Πλατφόρμα: Expo και React Native, με εσωτερικό Android build μέσω EAS.
• Ροές: αναζήτηση είδους, λήξεις, καταμετρήσεις, παραλαβές, γρήγορη παραλαβή, λίστες συλλογής, περιβαλλοντικές μετρήσεις και ουρά αποστολής.
• Offline: κάθε αίτημα κόβεται στα 3 δευτερόλεπτα και πέφτει σε τοπική SQLite, και οι σαρώσεις φεύγουν σε παρτίδες από την ουρά.
• Ταυτοποίηση: bearer token αποθηκευμένο στο secure store της συσκευής.

Δύο συστήματα, ένας υπολογιστής στο ίδρυμα

Το γηροκομείο δεν έχει τμήμα πληροφορικής. Και τα δύο συστήματα τρέχουν στον ίδιο υπολογιστή μέσα στο κτίριο, πίσω από έναν κοινό proxy που ξεχωρίζει ποιο ανοίγει ο καθένας, με πιστοποιητικά που οι browsers του ιδρύματος δέχονται χωρίς προειδοποιήσεις.

Πώς λειτουργεί

• Δικτύωση: κάθε stack σε containers Docker, με μόνο τον proxy ανοιχτό προς τον host, ώστε τα backends να μην εκτίθενται.
• Proxy: ένας nginx μπροστά από τα δύο frontends, με πιστοποιητικά mkcert για εσωτερικό HTTPS.
• Αναβάθμιση βάσης: μετάβαση από PostgreSQL 16 σε 18 τον Μάιο του 2026, δοκιμασμένη πρώτα από άκρη σε άκρη σε δοκιμαστικό μηχάνημα, με σύγκριση του πλήθους εγγραφών πριν και μετά. Τα migrations τρέχουν με advisory lock κατά των παράλληλων εκτελέσεων, έλεγχο checksum και snapshot της βάσης πριν από κάθε deploy.
• Δικλείδα: η νέα διαδικασία εγκατάστασης, που θα χρησιμοποιηθεί πρώτη φορά για τη νέα έκδοση, επαναφέρει μόνη της την προηγούμενη όταν αποτύχει ο health check μετά από deploy.
• Έλεγχοι: 342 αρχεία tests στη νέα έκδοση της κλινικής πλατφόρμας, έναντι 125 σε αυτή που τρέχει σήμερα: unit tests, integration tests πάνω σε πραγματική PostgreSQL, tests για τα migrations και σενάρια Playwright από άκρη σε άκρη.

Σύνδεσμοι

• Εσωτερική εγκατάσταση (στο γηροκομείο). Δεν υπάρχει δημόσιο URL.
• Repos: jimrarras/healthcare (monorepo), jimrarras/ims (monorepo)

Παρόμοια έργα

• Π.Γ.Ν.Ι. StorageManagement: άλλη εθελοντική civic-tech εργασία για ελληνικό νοσοκομείο, αλλά desktop εφαρμογή αντί για πλατφόρμα λειτουργιών
• Migraine Tracker: άλλο λογισμικό υγείας, αλλά mobile και FHIR αντί για λειτουργίες ιδρύματος