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 LLM self-hosted model hatti baslatildi
- RAI LLM provider seed'i ve RAI_LLM_ENDPOINT entegrasyonu eklendi.
- 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.