COS Laboratories — Bioactive Systems

Kullanım Kılavuzu · Demo Sürümü

COS Medical
Biological Optimization Platform

Kişiye özel biyoaktif/kozmetik formül üretim platformu. Doktorun hastadan veri topladığı, bir motorun formül önerdiği, doktorun onayladığı, üretim hattının baştan sona izlendiği, her kararın kaydedildiği ve aylar sonra birebir geri sarılabildiği bir sistem.

Bu belge sistemi hiç görmemiş birinin baştan sona kullanabilmesi için hazırlanmıştır. · Faz 1 — Demo

📑 İçindekiler

1 Bu Sistem Nedir, Ne Değildir?

COS Medical, her hasta için kişiye özel bir formül (biyoaktif/kozmetik ürün) hazırlama sürecinin tamamını yöneten bir platformdur. Sadece bir "reçete defteri" değildir — formülün önerilmesinden üretilip hastaya teslim edilmesine kadar olan bütün adımları takip eder.

Bu sistem ŞUDUR ✅Bu sistem ŞU DEĞİLDİR ❌
Doktorun karar verdiği bir karar destek aracıDoktorun yerine karar veren bir yapay zeka
Bir üretim hattı takip sistemi (kuyruk → üretim → kalite → teslim)Basit bir reçete yazma uygulaması
Her adımın kaydedildiği izlenebilir bir sistemGeçmişi silinebilen / değiştirilebilen bir kayıt defteri
Temiz, kaynağı ayrı tutulan veri toplayan bir altyapıHer veriyi tek torbaya atan bir form
En önemli cümleYapay zeka/motor sadece öneri sunar. Son kararı her zaman doktor verir. Bu kural sistemin her ekranına işlenmiştir.

2 4 Değişmez Prensip

Tüm sistem bu dört kurala göre tasarlandı. Her ekran bunlardan birini hayata geçirir.

1
Yapay zeka asla karar verici değildir
Tüm motor çıktısı yalnızca öneri statüsündedir. Bir formülü "onaylama" yetkisi yalnızca doktordadır. Sistem, motorun bir formülü kendiliğinden onaylamasına teknik olarak izin vermez.
2
Veri kaynakları ayrı kalır
Hastanın öznel beyanı, doktorun klinik bulgusu, laboratuvar sonucu ve tedavi sonrası sonuçlar ayrı ayrı saklanır, birbirine karıştırılmaz. Hangi bilginin nereden geldiği asla kaybolmaz.
3
Tam izlenebilirlik
Her önemli karar ve durum değişikliği Karar Günlüğü'ne işlenir: kim, ne zaman, neyi, neden yaptı. Bu kayıtlar değiştirilemez ve silinemez.
4
Tekrar üretilebilirlik
Bir formül onaylandığı anda; o anki tüm kurallar, kullanılan veriler ve ayarlar kilitlenir (snapshot). Aylar sonra "o gün, o şartlarda bu formül neden böyle çıktı?" sorusu birebir cevaplanabilir.

3 Sisteme Giriş & Demo Hesaplar

Sisteme bir internet tarayıcısından (Chrome, Edge, Safari) giriş yapılır. Demo adresi size ayrıca iletilecektir. Açılış ekranında e-posta ve şifre istenir.

Demo'yu farklı gözlerden denemeniz için dört hazır hesap bulunur. Her hesabın şifresi: password

İpucuSistemi gerçekçi denemek için Doktor hesabıyla başlayın: hasta açın, veri girin, formül önerip onaylayın. Sonra Lab hesabına geçip üretim hattını ilerletin.

4 Roller ve Kim Ne Yapar?

Herkes aynı sisteme girer ama rolüne göre farklı menü ve yetki görür. Bir rol diğerinin işini yapamaz — bu bilinçli bir güvenlik tasarımıdır.

RolSorumluluğu
DoktorHasta açar, veri girer, formül önerir ve onaylar / reddeder / durdurur. Tek karar mercii.
AsistanVeri girişine yardım eder, paketlenen formülü teslim eder ve protokolün başladığını işaretler (T0).
LabÜretim hattını yürütür: üretim kuyruğu → üretim → kalite kontrol → paketleme.
AdminEngine B kurallarını yönetir (ekler, deprecate eder). Klinik onaya karışmaz.

6 Baştan Sona Bir Hasta Akışı

Tipik bir vaka, başından sonuna şu adımlardan geçer:

1
Hasta açılır Doktor Asistan
Hastalar → "Yeni Hasta". Ad, doğum tarihi, cinsiyet, iletişim gibi temel bilgiler.
2
Veri toplanır Doktor Asistan
Hasta detayında "Veri Girişi" → dört ayrı sekme: subjektif, klinik, lab, outcome. (Bkz. Bölüm 8.)
3
Formül önerilir Doktor / Motor
Hasta detayında "Engine B ile Öner" veya "Engine A (advisory)" ya da doktorun elle oluşturması. Çıktı her zaman "öneri" (proposed) durumundadır.
4
Doktor karar verir Doktor
Formüller ekranında önerilen formülü Onaylar ya da Reddeder. Onay anında sistem durumu kilitlenir (snapshot).
5
Üretim hattı işler Lab
Üretim Hattı panelinde: Üretime Al → Üretime Başla → QC'ye Gönder → (QC Geçti) Paketle. QC başarısızsa formül yeniden kuyruğa döner.
6
Teslim & protokol başı Asistan
Paketlenen ürün "Teslim Et", ardından hasta kullanıma başlayınca "Protokol Başladı (T0)" işaretlenir.
7
Sonuç verisi toplanır Doktor Asistan
3 ay gibi takip kontrollerinde "outcome" verisi girilir (T0, 1. kontrol, 2. kontrol...). Bu veri gelecekteki değerlendirmenin temelidir.

7 Formülün Yaşam Döngüsü

Bir formül, oluşturulduğu andan teslimata kadar şu durumlardan geçer. Her geçiş kayıt altına alınır; geri dönüşü olmayan adımlar sistemce engellenir (örn. teslim edilmiş bir formül kalite kontrole geri gönderilemez).

proposed (önerildi) approved (onaylandı) queued (kuyrukta) compounding (üretiliyor) qc_pending (kalite kontrol) packaged (paketlendi) delivered (teslim) protocol_started (T0)
DurumAnlamıKim ilerletir
proposedMotor veya doktor oluşturdu — henüz öneriMotor / Doktor
approved / rejectedDoktor onayladı / reddettiDoktor
queued_for_productionOnaylı, üretim sırasında bekliyorLab
compoundingAktif olarak üretiliyorLab
qc_pending → packaged / qc_failedKalite kontrol; geçerse paketlenir, geçmezse üretime dönerLab
deliveredHastaya teslim edildiAsistan
protocol_startedHasta kullanıma başladı (T0 teyidi)Asistan
discontinuedHasta bıraktı / doktor durdurdu (her aşamadan)Doktor
revisedYeni versiyon çıktı, bu versiyon pasifleştiDoktor

8 Veri Girişi (4 Ayrı Kaynak)

Hasta detayında "Veri Girişi" ekranında dört sekme vardır. Her sekme ayrı bir kaynağa yazar — bilgiler birbirine karışmaz.

SekmeNe girilirGenelde kim girer
SubjektifHastanın kendi şikâyetleri, beyanı, anket cevaplarıHasta / Asistan
KlinikDoktorun muayene bulgularıDoktor
LabLaboratuvar sonuçlarıAsistan / Lab
OutcomeTedavi sonrası takip sonuçları (T0, 1., 2. kontrol...)Doktor / Asistan

Her giriş basit "alan – değer" satırları halinde yapılır (örn. "uyku kalitesi – kötü"). İstediğiniz kadar satır eklenebilir. Kaynak (örn. cihaz, laboratuvar adı) ve tarih de işaretlenebilir.

Neden ayrı?İleride (Faz 2) bu temiz ve kaynağı belli veriler, hastaları karşılaştırıp öğrenen gelişmiş analizlerin temeli olacak. Bugün karıştırılırsa, yarın ayrıştırmak imkânsız olur.

9 Engine A / Engine B (Öneri Motorları)

İki öneri motoru vardır. İkisi de yalnızca öneri üretir, asla onaylamaz.

⚙️ Engine B — Kural Tabanlı

Admin'in tanımladığı aktif kuralları kullanarak bir formül taslağı önerir. Demo'da çalışmaya hazırdır. Yalnızca "aktif" kurallar kullanılır; "experimental" kurallar üretime asla karışmaz.

✨ Engine A — Advisory (Danışman)

Hastanın toplanan verisini ve aktif kuralları özetleyip doktora bir taslak hazırlar. Faz 1'de canlı yapay zeka çalıştırmaz — bu, müşterinin "Faz 1'de ileri AI istemiyorum" talimatına uygundur. Altyapı, ileride gerçek bir AI bağlanacak şekilde hazır bırakılmıştır.

UnutmayınHangi motoru kullanırsanız kullanın, çıkan formül "öneri" durumundadır. Hiçbir şey doktor onayı olmadan üretime geçmez.

10 Kural Yönetimi (Yalnızca Admin)

Engine B'nin kullandığı kurallar burada yönetilir. Dört sekme vardır: Aktif, Experimental, Deprecated, Arşiv.

Kural durumuDavranış
ActiveÜretimde (production) kullanılır.
ExperimentalSadece test (staging) ortamında çalışır — üretime asla karışmaz.
DeprecatedArtık yeni formüllerde kullanılmaz, ama geçmiş referans için saklanır.
ArchivedTamamen pasif, sorgulardan çıkarılır.
Önemli kural: silme yokBir kural asla silinmez; yalnızca "deprecate" edilir ve bu işlem için gerekçe zorunludur. Yerine başka bir kural geçtiyse bağlantısı kurulur. Böylece geçmiş formüllerin neden o şekilde üretildiği her zaman anlaşılır. Ayrıca "experimental kuralı üretimde çalıştır" diye bir buton bilinçli olarak yoktur.

11 Karar Günlüğü & Tekrar Üretilebilirlik

🕓 Karar Günlüğü

Sistemde gerçekleşen her önemli olay buraya yazılır: hasta verisi girildi, formül önerildi, onaylandı, üretime alındı, kural deprecate edildi... Her kayıtta kim, ne zaman, neyi (eski durum → yeni durum), neden bilgisi bulunur. Bu kayıtlar değiştirilemez ve silinemez.

🔒 Snapshot (Anlık Kilit)

Bir formül onaylandığı anda; o sıradaki aktif kural seti (versiyonlarıyla), kullanılan veriler ve motor ayarları tek bir kilitli kayda alınır. Bu kayıt bir daha değişmez. Aylar sonra bir formüle bakıldığında "bu formül hangi şartlarda, hangi kurallarla, hangi veriyle çıktı?" sorusu birebir cevaplanabilir.

Neden değerli?Sağlık/kozmetik alanında bu izlenebilirlik hem güven hem de olası denetim için kritiktir. "O gün öyleydi" demek yerine, sistem onu kanıtlar.

12 Sık Sorulanlar

Yapay zeka hastama yanlış formül verirse?

Veremez. Motor yalnızca öneri sunar; hiçbir formül doktor onayı olmadan üretime geçmez. Onay düğmesi sadece doktor hesabında vardır.

Yanlış bir durum değişikliği yaparsam geri alabilir miyim?

İleri yönlü, mantıklı geçişlere izin verilir; mantıksız/geri dönüşü olmayan geçişler (örn. teslim edilmişi tekrar üretime almak) sistem tarafından engellenir. Her şey günlüğe yazıldığı için yapılan işlem kaybolmaz.

Bir kuralı yanlışlıkla sildim mi?

Kurallar silinemez, yalnızca deprecate edilir ve geri getirilebilir referans olarak kalır.

Verilerim birbirine karışır mı?

Hayır. Dört veri kaynağı ayrı tutulur; nereden geldikleri her zaman bellidir.

Demo verileri gerçek mi?

Hayır, demo'daki hastalar ve kayıtlar örnektir; sistemi denemeniz içindir. Gerçek kullanımda sıfırdan başlanır.

13 Demo'da Bilerek Bekletilenler

Bu, müşterinin talimatına uygun olarak Faz 1 demosudur: çalışan, stabil, veri toplayan bir sistem. Aşağıdakiler bilinçli olarak ileriye bırakılmıştır:

Formülün kimyasal içerik şeması Formülün etken madde / konsantrasyon / birim gibi kesin içerik kuralları, ana teknik döküman (PRD v2.0) elimize ulaştığında netleşecektir. Şu an formül içeriği esnek bırakılmıştır; sürecin tamamı (veri → öneri → onay → üretim → teslim → loglama → kilit) eksiksiz çalışır. İçerik şeması geldiğinde kısa sürede yerine oturur.

Faz 1'de yer almayanlar (müşterinin açık talebiyle): makine öğrenmesi / tahmin motoru, hastaların otomatik karşılaştırılıp öğrenilmesi, "sonuca yakınlık" skorunun otomatik hesaplanması. Bunlar gelecekteki fazların konusudur; Faz 1 tam da bunların ihtiyaç duyacağı temiz veriyi üretmek için tasarlanmıştır.

COS Medical — Biological Optimization Platform · Kullanım Kılavuzu (Demo, Faz 1)
Bu belgeyi tarayıcıda açıp Ctrl/Cmd + P ile PDF olarak kaydedebilirsiniz.