RAI PACS Developer Platform
Bulut PACS, DICOM gateway ve AI raporlama icin teknik merkez.
dev.raipacs.com; RAI PACS mimarisi, entegrasyon yuzeyleri, DICOM aktarim bilgileri, AI servisleri ve surum notlari icin canli dokumantasyon alanidir.
Guides
Baslangic noktasi
Metadata PostgreSQL'de, orijinal DICOM nesneleri Supabase Storage dicom-originals bucket'inda saklanir.
DICOM GatewayModaliteler C-STORE ile gateway'e gelir; Orthanc gateway katmani RAI metadata ve Storage import akisina baglanir.
ViewerRAI Viewer hizli preview, cache, frame kontrolu ve OHIF yeni sekme koprusuyle birlikte calisir.
AI RaporlamaOpenAI, Claude, Gemini, MedGemma ve RAI LLM adaptorlari ayni AI job ve draft rapor modelinde toplanir.
Architecture
Cift katmanli PACS veri ayrimi
RAI PACS metadata ve buyuk DICOM nesnelerini ayirir. PostgreSQL; organizasyon, sube, hasta, tetkik, seri, instance, rapor, audit ve yetki metadata bilgisini tutar. Supabase Storage ise orijinal DICOM dosyalarini private dicom-originals bucket alaninda saklar.
Storage key:
{organization_id}/{study_instance_uid}/{series_instance_uid}/{sop_instance_uid}.dcmDICOM
DICOM Gateway baglanti bilgileri
Modalite kaynak AE Title, kaynak IP, Called AE ve opsiyonel kurulus/sube kodu ile eslestirilir. Gelisen canli kurulumda once serbest erisim, hastane canli gecisinde IP veya ulke bazli firewall kisitlamasi uygulanir.
Viewer
RAI Viewer ve OHIF koprusu
RAI Viewer radyolog icin ana is istasyonudur. Scroll, pan, window/level, zoom, fit, frame ok tuslari, seri paneli, preview/liste modu, privacy mode ve AI on rapor paneli birlikte calisir. OHIF yeni sekme, harici OHIF viewer ile dicomjson entegrasyonu icin korunur.
- Frame cache ve preview katmani viewer performansini hizlandirir.
- Renkli US gibi farkli fotometrik yorumlar desteklenir.
- Harici paylasim linkleri privacy mode on varsayimi ile calisir.
API
Public ve signed teknik yuzeyler
| Method | Path | Kapsam | Yetki |
|---|---|---|---|
GET | /viewer-data/studies/:studyId | OHIF dicomjson metadata | Signed launch token |
GET/HEAD | /viewer-data/instances/:instanceId | Range destekli DICOM instance proxy | Signed launch token |
POST | /api/share | Sureli harici paylasim linki | RAI oturumu |
GET | /api/share/:token veya /share?s=:id | Paylasim onizleme ve OHIF acilis | Sureli share token |
DICOM instance proxy Range headerlarini upstream Storage signed URL tarafina tasir. OHIF CORS yalnizca viewer.ohif.org icin aciktir; RAI Viewer dahili signed URL akisini kullanir.
Database
Ana tablo ve sorumluluklar
organizations | Tenant/konsolidasyon siniri |
branches | Merkez, Dev, Kosova gibi sube ayrimi |
organization_members | Kullanici rol ve varsayilan sube |
organization_member_branches | Kullanici bazli sube yetkisi |
patients | Hasta demografi ve HIS kaynak alanlari |
studies / series / instances | DICOM metadata hiyerarsisi |
reports | Taslak ve nihai radyoloji raporlari |
ai_service_providers / ai_jobs | AI servis secimi ve is kuyrugu |
ai_usage_events | Token ve maliyet raporlama |
external_study_shares | Sureli guvenli paylasim linkleri |
AI
AI servisleri ve on rapor akisi
AI islemi viewer icinden manuel baslatilir. Secilen provider ai_jobs kaydi olusturur, tetkik metadata verisi ve hazirlanan goruntu onizlemeleri provider adapter katmanina tasinir, sonuc ai_report_drafts icinde saklanir.
Token ve maliyet izleme ai_usage_events tablosu uzerinden Admin AI Servisleri ekraninda tarih araligi, provider, model ve rapor bazinda gosterilir.
HIS
HIS / RIS entegrasyon modeli
HIS tanimlari Admin panelinden sube bazli tutulur. HL7, REST ve planlanan DICOM Modality Worklist akislari icin vendor, protokol, mesaj tipleri, auth tipi ve test sonuc alanlari hazirdir.
- Hasta demografi alanlari HIS kaynak kimlikleriyle genisletildi.
- HIS kaynak alanlari yalnizca Admin grubunda gorunur.
- Sube ve tenant ayrimi tek organizasyon icinde baslatildi.
Operations
Operasyon runbook
npm run import:dicom-folder npm run sync:orthanc-events npm run sync:orthanc-logs
Changelog
Surum notlari
RAI AI Orchestrator ve RAI LLM checklist eklendi
- Admin AI Servisleri ekranina RAI LLM kurulum checklist'i eklendi.
- RAI AI Orchestrator provider'i aktif olarak seed edilir ve manuel AI butonunda secilebilir.
- Orchestrator RAI LLM, OpenAI, Gemini, Claude, MedGemma ve RAI Mock sirasiyla calisabilir provider'a route eder.
RAI LLM GPU quota on kosulu netlestirildi
- Cloud Run L4 GPU deploy script'i no-zonal-redundancy parametresiyle kalici hale getirildi.
- Google Cloud Run NVIDIA L4 GPU kotasi 0 oldugunda deploy'un duracagi ve quota talebi gerektigi dokumante edildi.
- RAI LLM runbook'u Cloud Run GPU quota kontrolu ve Vercel aktivasyon adimlariyla guncellendi.
RAI LLM Vercel aktivasyon script'i eklendi
- Cloud Run deploy sonrasinda endpoint ve token degerlerini rai-llm-vercel.env dosyasina yazan akis eklendi.
- RAI LLM production env degerlerini Vercel'e tek komutla gecmek icin npm run configure:rai-llm:vercel script'i eklendi.
- RAI LLM canli kullanim icin Cloud Run GPU endpoint, Vercel env ve Admin canli test adimlari netlestirildi.
RAI LLM Cloud Run GPU deploy script'i eklendi
- RAI LLM icin Google Cloud Run Gen2 + NVIDIA L4 GPU deploy script'i hazirlandi.
- Artifact Registry build, Cloud Run deploy ve endpoint smoke-test akisi tek runbook'a baglandi.
- Servis public HTTPS endpoint verir; erisim Bearer token ile uygulama icinde sinirlanir.
RAI LLM operasyon durumu Admin ekranina eklendi
- Admin AI Servisleri ekraninda RAI LLM provider, model, endpoint ve API token hazirlik durumu gosterilir.
- Endpoint degeri maskeli gosterilir; secret degerleri UI'da aciga cikmaz.
- Canli GPU endpoint hazir oldugunda kullanilacak smoke-test komutu ayni panelde yer alir.
RAI LLM endpoint test ve operasyon runbook'u eklendi
- RAI LLM OpenAI-compatible endpoint icin npm run test:rai-llm smoke-test komutu eklendi.
- GPU endpoint kurulumu, Vercel env tanimlari ve canli test adimlari dokumante edildi.
- Endpoint hazir oldugunda RAI Viewer AI akisi ayni provider uzerinden test edilebilir hale geldi.
RAI LLM self-hosted model hatti baslatildi
- RAI LLM provider seed'i ve RAI_LLM_ENDPOINT entegrasyonu eklendi.
- Admin AI Servisleri sayfasi RAI LLM provider eksikse otomatik olusturur.
- Qwen/Qwen2.5-VL-7B-Instruct tabanli OpenAI-compatible inference servisi hazirlandi.
- RAI LLM modeli ileride RAI radyoloji veri setleriyle fine-tune edilebilir hat olarak konumlandi.
Developer portal yayina hazirlandi
- dev.raipacs.com host'u public teknik dokumantasyon sayfasina rewrite edilir.
- Mimari, API, DICOM, AI, HIS ve operasyon notlari tek portalda toplandi.
- Surum notlari icin RAI gelistirme akisi baslatildi.
Admin kullanici ve sube yetkileri
- Kullanici yonetimi acilir bloklara ve filtrelenebilir tabloya tasindi.
- Dev ve Kosova subeleri olusturuldu; Admin varsayilan subesi Dev yapildi.
- organization_member_branches ile kullanici bazli sube yetkisi eklendi.
Rapor taslaklari ve AI goruntu onizleme
- Ayni tetkik uzerinde birden fazla taslak rapor kaydi desteklendi.
- DICOM preview verileri AI servislerine tasinabilir hale getirildi.
- Gorunur hata mesajlarina kopyalama kontrolu eklendi.
MedGemma ve tibbi AI presetleri
- MedGemma endpoint adapter, retry ve cold-start toleransi eklendi.
- OpenAI, Claude, Gemini, MedGemma ve RaDialog provider secenekleri ayni modelde toplandi.
- AI provider hata durumlari viewer icinde daha acik gosterilmeye baslandi.
Harici paylasim ve AI token raporlama
- Sureli guvenli paylasim linkleri eklendi.
- AI token tuketimi provider, model, rapor ve tarih araligi bazinda izlenebilir oldu.
- OHIF icin viewer-data koprusu daha kararli hale getirildi.
DICOM Server ve HIS yonetimi
- DICOM modalite, gateway sagligi, baglanti loglari ve import kuyrugu Admin paneline eklendi.
- HIS entegrasyon tanimlari, mesaj tipleri ve test aksiyonlari icin arayuz hazirlandi.
- Branch ve modality matching temeli kuruldu.
RAI PACS MVP veri modeli
- Hasta, tetkik, seri, instance, rapor ve audit tablolarindan olusan temel PACS semasi olusturuldu.
- Turkce karakter desteği, Supabase Storage ve DICOM import akisi MVP'ye alindi.
- RAI Viewer ve OHIF koprusu ilk calisan surume geldi.