Şahin ParlakÇocuk cerrahisi asistanı · Klinik yazılım
English

TPN Calculator

Tek çekirdek, her merkezin kendi protokolü

Açık kaynak · MIT · Haziran 2026 · v0.1.0

Yenidoğan ve çocukta parenteral beslenme hesabı uzun, hataya açık ve her merkezde başka. TPN Calculator aritmetiği tek ve test edilmiş bir çekirdekte, her klinik değeri ise merkezin kendi profilinde tutar.

TPN Calculator — güvenlik uyarılarıyla sonuç ekranı
sahinparlak.github.io/tpn-calculator

Canlı dene ↗GitHub ↗

Klinik karar-destek aracı — tıbbi cihaz değildir. Uygulamayla gelen profil kılavuza dayanır, merkezce doğrulanmış değildir.

Her merkezde başka bir hesap

Yenidoğan ve çocuklarda total parenteral beslenme (TPN) yoğun hesap ister, hataya açıktır ve her merkezde başkadır: doz şemaları, sınırlar, ürün konsantrasyonları, birimler değişir. Hesaplayıcıların çoğu tek bir kurumun protokolünü koda gömer.

TPN, geliştiricisinin çocuk cerrahisi asistanı olarak günlük klinik rutininin parçası: daha iyi ve daha güvenli bir aracı hak eden, tekrar eden ve riski yüksek türden bir hesap. Proje bu yüzden alışılmış yolu tersine çevirir: tek bir hastanenin protokolünü koda yazmak yerine saf ve test edilmiş bir hesaplama çekirdeğini merkeze özel bir yapılandırma profiliyle eşleştirir. Her merkezde aynı çekirdek çalışır; yalnızca profil değişir.

TPN Calculator web uygulaması: solda hasta formu (1,5 kg, 5. gün, periferik hat); sağda kırmızı bir uyarı (bağımsız doğrulama olmadan kullanılmamalı, iki sert güvenlik sınırı aşıldı) ve altında toplam hacim, glukoz, aminoasit ve lipid
Web uygulaması, içinde gelen ESPGHAN 2018 referans profili ve uygulamanın kendi örnek hastasıyla (1,5 kg, 5. gün). Periferik hatta iki sert sınır aşılıyor (son dekstroz konsantrasyonu ve osmolarite) ve sonuç kırmızı bir uyarıyla açılıyor: bağımsız doğrulama olmadan kullanılmamalı. Form, yazıldıkça yeniden hesaplıyor.

Çekirdek ve profil

Çekirdek hiçbir klinik sabit bilmez. Bir hasta girdisi ve bir merkez profili alır; bir reçete ve güvenlik uyarıları döndürür. Profil sıvı şemalarını, enerji hedeflerini, glukoz/GIR sınırlarını, aminoasit ve lipid dozlarını, elektrolitleri, katkıları ve güvenlik kurallarını tanımlar (sert kural engeller, yumuşak kural uyarır). Birimler (kcal/kJ, mmol/mEq) uluslararası kullanım için ayarlanabilir.

Çekirdek, @tpn/engine, saf TypeScript ile yazıldı ve hiçbir arayüze bağlı değil; aynı hesap telefon uygulamasında (Expo, iOS ve Android), web uygulamasında (React + Vite, GitHub Pages üzerinde) ve testlerde birebir aynı çalışır. Arayüz katmanlarında klinik mantık yoktur.

Üç telefon ekranı: Before you start, sorumluluk onayı; Result, iki sert güvenlik sınırını listeleyen kırmızı uyarıyla; Profiles, ESPGHAN 2018 referansı etkin
Telefon uygulaması, deponun README’sinden: bir kez onaylanan ve her sonuçta görünür kalan sorumluluk ekranı, sert güvenlik uyarılı bir sonuç, profil yönetimi.

Yazıya geçirilmiş model

Formüller evrenseldir; her sayı profilden gelir. Projenin planı modeli, bir klinisyenin gözden geçirmesi gereken tercihlerle birlikte yazıya geçirir:

  • İlerletme. GIR ve makro besin dozları tek bir kalıbı izler: değer(gün) = min(başlangıç + artış × (gün − 1), en çok). 1. gün başlangıç değerini verir.
  • Hacim dengesi. Toplam sıvı bütçedir. Lipid ayrı bir emülsiyon olarak bundan düşülür, geriye sulu karışım kalır; aminoasit, elektrolitler ve katkılar hacimlerini buradan alır, kalan su dekstrozu taşır ve son dekstroz konsantrasyonunu bu belirler.
  • Glukoz. gram/gün = GIR × ağırlık × 1440 ÷ 1000.
  • Osmolarite. Sulu karışım üzerinden doğrusal bir tahmin; her katsayı profilden gelir, lipid hesaba katılmaz.
  • Kalsiyum–fosfat. Basit çözünürlük çarpımı (Ca × P), profildeki bir eşiğe karşı; bir eğri değil, bir yaklaşım.
  • Güvenlik. Profilin kuralları hesaplanan değerlere uygulanır. Sert bir ihlal programı durdurmaz, uyarı olarak döner; engelleyip engellememeye arayüz karar verir. Yerleşik bir kontrol de bileşenlerin toplam hacmi aşmasını işaretler.

Kendi kaynağını gösteren referans

Uygulama tek bir profille gelir: çocukta parenteral beslenmeye dair 2018 Avrupa kılavuzlarından (ESPGHAN/ESPEN/ESPR/CSPEN) kurulmuş, 1500 g üzeri bir preterm için bir referans. Dozları kılavuzların öneri numaralarına kadar izlenebilir ve uygulama bu numaraları değerlerin yanında gösterir. Kılavuzun tek bir sayı olarak vermediği şeyler (dekstroz sınırları, stok konsantrasyonları, ürün ayrıntıları, osmolarite katsayıları) temsilî diye işaretlidir: her merkez bunları kendi değerleriyle değiştirip doğrulamalıdır. Periferik hattın osmolarite sınırı, 900 mOsm/L, A.S.P.E.N.’e dayanır; profil onu da temsilî değerler arasında sayar.

Dosing — guideline-traceable: GIR 4/2/12 (R 5.4), aminoasit 1,5’ten 3,5 g/kg’a (R 3.1–3.3), lipid 1,0’dan 4,0 g/kg’a (R 4.2–4.3), sıvı 70’ten 150 mL/kg’a (Jochum 2018), enerji hedefi 90–120 (R 2.6), Na/K/Cl 3/2/3 (Tablo 3), Ca/P/Mg 1,6/1,6/0,2 (R 8.9); altta temsilî değerler için bir not
Uygulamadaki referans profil: her doz kaynağıyla yan yana (ESPGHAN 2018 modüllerinin öneri numaraları, sıvılar için Jochum 2018) ve kılavuza ait olmayan değerler için bir not.

Bir merkez referansı uygulamanın içinde kendi protokolüne çevirir: kopyalar, her alanı düzenler, sonucu JSON olarak dışa ya da içe aktarır. Yerleşik referansın kendisi düzenlenemez ve silinemez.

Profil düzenleyici: GIR start 4, GIR advance 2, GIR max 3 kırmızı çerçeveli; altında Maximum GIR must be greater than or equal to the starting GIR uyarısı; Save düğmesi pasif
Profil düzenleyici her değişikliği çekirdeğin kendi doğrulamasından geçirir: başlangıç GIR’ından düşük bir en yüksek GIR yakalanıyor ve düzeltilene kadar profil kaydedilemiyor.

Nasıl denetlendi

  • Çekirdek testleri. İlk sürümde (v0.1.0, 17 Haziran 2026) çekirdeğin 87 testi ve %98 kod kapsamı vardı.
  • Kaynağa bağlanan vakalar. ESPGHAN 2018 referans profiline karşı regresyon testleri (yaşam gününe göre doz seyri, enerji hedefi, hat güvenliği); böylece beklenen her çıktı bir kaynağa kadar izlenebilir.
  • Uygulamalar. Telefon uygulaması için entegrasyon ve ekran testleri (jest-expo).
  • Doğrulama. Düzenlenen ya da içe aktarılan her profil, kullanılmadan önce çekirdeğin validateProfile denetiminden geçer.
  • Sürekli entegrasyon. Her değişiklikte kod ve biçim denetimi ile tip denetimi Node 22’de, derleme ve kapsam ölçümü Node 22 ve 24’te; web uygulaması aynı depodan yeniden derlenip yayımlanır.

Sınırlar

  • Klinik karar destek aracıdır, tıbbi cihaz değildir: hiçbir otorite (FDA, AB MDR, TİTCK) tarafından değerlendirilmemiş, onaylanmamış ya da kayda alınmamıştır. Sorumluluk tümüyle istemi yapan hekimdedir; her sonuç bağımsız olarak doğrulanmalıdır.
  • Uygulamayla gelen profil kılavuza dayanır, merkezce doğrulanmış değildir; merkezce doğrulanmış bir profil henüz yok. Her merkez kendi sayılarını sağlamalı ve doğrulamalıdır.
  • Projenin iş listesine kaydedilmiş modelleme boşlukları: fototerapi ve radyant ısıtıcı düzeltmeleri mutlak mL/kg iken kılavuz yüzde verir; sıvı şemasında doğum ağırlığı bandı yoktur; kılavuz kalsiyum–fosfat riskini bir çarpım eşiğiyle değil, molar Ca:P oranı ve eczanede test edilmiş uyumlulukla anlatır; son dekstroz konsantrasyonu yalnızca sulu faz üzerinden hesaplanır ve ekranda da öyle yazar.
  • Erken geliştirme aşamasında: yalnızca İngilizce; başka diller, bir belge sitesi ve topluluk çalışması bir sonraki aşamada.

Belgeler

Sürüm
v0.1.0 (17 Haziran 2026). Web uygulaması ve CI bu sürümden sonra geldi, henüz numaralı bir sürüme girmedi; ana daldan canlı: sahinparlak.github.io/tpn-calculator
Lisans
MIT
Çekirdek
@tpn/engine — TypeScript, Vitest
Uygulamalar
Telefon: Expo (React Native), iOS ve Android · Web: React + Vite, GitHub Pages
Referans
ESPGHAN/ESPEN/ESPR/CSPEN 2018; güvenlik eşikleri için A.S.P.E.N.
Atıf
Depodaki CITATION.cff

Kaynaklar

Depodaki bütün belgeler İngilizcedir.

Notlar

  • Telefon ekranları deponun README’sindeki kendi görselleri. Web ekranları 17 Kasım 2026’da, deponun ana dalından derlenen web uygulamasından, içinde gelen referans profil ve uygulamanın kendi örnek hastasıyla alındı.
  • Ekranlardaki sayılar, bir örnek hasta için kılavuz referansının çıktısıdır; bir reçete değildir.

Bu sayfa, projenin kendi deposundan ve belgelerinden derlendi; son kontrol 18 Kasım 2026.

← Bütün uygulamalar