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.


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.
Ç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.
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.
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.
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
validateProfiledenetiminden 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
- Depo: github.com/sahinparlak/tpn-calculator
- Sorumluluk reddi ve kullanım koşulları: DISCLAIMER.md
- Plan ve hesaplama modeli: docs/PLAN.md
- Profil yazma kılavuzu: docs/PROFILE.md
- Bilimsel dayanak ve kaynaklar: docs/REFERENCES.md
- Referans profildeki her değerin kaynağı: profiles/espghan-2018-reference.sources.md
- Modelleme boşlukları: docs/BACKLOG.md
- Sürüm notları: CHANGELOG.md
- ESPGHAN, yayımlanmış kılavuzlar: espghan.info/published-guidelines
- A.S.P.E.N., preterm bebeklerde parenteral beslenme kılavuzu (Robinson ve ark., JPEN, 2023): DOI 10.1002/jpen.2550
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.