🩺 AI Doktor Asistanı / AI Doctor Assistant

🟢 Canlı uygulama / Live app · 👩‍💻 Portfolyo / Portfolio

---

🇹🇷 Türkçe

Proje Hakkında

Kullanıcının adını, yaşını ve sağlık şikayetini alarak kişiselleştirilmiş Türkçe sağlık bilgisi sunan, hafızalı bir AI doktor asistanı. OpenRouter üzerinden çalışan Google Gemini modeli, LangChain ile yönetilen konuşma hafızası ve FastAPI tabanlı bir servis ile geliştirilmiştir.

⚠️ Bu uygulama tıbbi teşhis koymaz. Sağlık sorunlarınız için mutlaka bir doktora danışınız.

Özellikler

• 🧠 Konuşma hafızası — oturum boyunca önceki mesajları hatırlar
• 👤 Kişiselleştirme — kullanıcıya ismiyle hitap eder, yaşa uygun yanıt üretir
• 🚨 Acil durum algısı — kritik semptomlarda doğrudan acil uyarısı verir, başka öneri eklemez
• 🌐 Web arayüzü — giriş formu (ad, yaş, şikayet) + sohbet ekranı
• 🔒 Oturum yönetimi — oturumu kapat ve yeni kullanıcı başlat

Ekran görüntüleri

Soldan sağa: giriş formu · kişiye özel yanıt · acil belirtide tek cümlelik yönlendirme

Mimari

Birbirine bağımlı olmayan iki servis. SSL'i sunucudaki ters vekil bitirir.

Parça	Yol	Alan adı	Host portu
Backend — FastAPI + LangChain	backend/	doctor-assistant-api.aisli.dev	8003
Frontend — React + Vite + nginx	frontend/	doctor-assistant.aisli.dev	8002

Frontend nginx'i yalnız statik dosya servis eder, backend'e bağlanmaz. Tarayıcı API'ye VITE_API_BASE adresinden doğrudan gider; bu adres derlemeye gömülür, değişirse imaj yeniden derlenmelidir. Backend de FRONTEND_URL ile yalnız frontend'in origin'ine CORS izni verir.

ai-doctor/
├── backend/
│   ├── llm.py            # model, prompt, zincir, hafıza
│   ├── api.py            # FastAPI (yalnız JSON)
│   ├── terminal.py       # terminal sürümü
│   ├── tests/            # birim testleri (pytest, sahte model)
│   ├── smoke_test.py     # davranış doğrulaması
│   ├── Dockerfile · docker-compose.yml · Makefile
│   └── .env.example
└── frontend/
    ├── src/              # React + TypeScript
    ├── Dockerfile · nginx.conf · docker-compose.yml · Makefile
    └── .env.example

Kurulum

Backend

cd backend
cp .env.example .env      # OPENROUTER_API_KEY değerini doldurun
make up                   # derle ve başlat
make health               # {"status":"ok", ...}

Frontend

cd frontend
VITE_API_BASE=http://localhost:8003 make up    # yerel backend'e bağlan

Tarayıcıda http://localhost:8002 adresini açın.

Yerel geliştirme

Docker olmadan, iki terminalde:

cd backend  && make dev        # uvicorn :8000, canlı yeniden yükleme
cd frontend && make dev        # vite :5173, /chat isteklerini :8000'e proxy'ler (yalnız dev)

Terminal sürümü için: cd backend && make terminal

Doğrulama

cd backend  && pytest          # birim testleri (API anahtarı ve ağ gerekmez)
cd backend  && make test       # gerçek API'ye karşı davranış testi
cd frontend && make typecheck  # TypeScript denetimi

pytest modeli sahte bir modelle değiştirir; HTTP katmanını (doğrulama, 503 hata yönetimi), oturum hafızasını ve sistem promptundaki güvenlik kurallarını kontrol eder ve her push'ta GitHub Actions'ta çalışır.

make test OpenRouter'a gerçek istek atar ve kredi harcar. Kontrol ettikleri:

• isimle hitap, turlar arası hafıza, acil durum yanıtının tek cümle kalması
• teşhis konmadan belirtilerden hastalık adı çıkarılmaması
• söylenmiş bilginin (süre, teşhis) tekrar sorulmaması, önceki önerilerin yeniden listelenmemesi
• ıhlamur, sıvı, dinlenme gibi zararsız önerilerin reddedilmeden verilmesi
• "uzmana danışın" ve selamlama kalıplarının her yanıtta tekrarlanmaması
• markdown kullanılmaması (arayüz düz metin gösterir)
• ilaç adı ve doz önerilmemesi

Model çıktısı deterministik olmadığından tek bir başarısızlık gürültü olabilir; tekrarlıyorsa gerçek bir gerilemedir.

Model

Varsayılan google/gemini-2.5-flash (~0.30$/1M token). OpenRouter'da ücretsiz Gemini kalmadı; daha ucuzu google/gemini-2.5-flash-lite (~0.10$) ama yönergeleri daha zayıf takip ediyor. Model OPENROUTER_MODEL ile değiştirilir.

max_tokens 800'e sabitlenmiştir: verilmezse OpenRouter modelin tavanını (65k) varsayıp bakiyeyi ona göre kontrol eder ve düşük bakiyede 402 döner.

Deploy (Dokploy)

Sunucu Dokploy ile yönetilir, SSL'i ters vekil bitirir. Sunucuda elle nginx ayarı yapılmaz, certbot çalıştırılmaz.

1. DNS (Cloudflare): doctor-assistant ve doctor-assistant-api için A kaydı → sunucu IP'si.
2. Backend servisi: Build Type Dockerfile (Nixpacks değil), Build Path /backend, Environment'a OPENROUTER_API_KEY ve FRONTEND_URL=https://doctor-assistant.aisli.dev. Domain doctor-assistant-api.aisli.dev, Container Port 8000.
3. Frontend servisi: Build Type Dockerfile, Build Path /frontend, Domain doctor-assistant.aisli.dev, Container Port 80.

Frontend varsayılan olarak https://doctor-assistant-api.aisli.dev adresine derlenir. Farklı bir API adresi gerekirse Build Args'a VITE_API_BASE girilip yeniden deploy edilir.

---

🇬🇧 English

About

A conversational AI health assistant that collects the user's name, age, and health complaint to provide personalized Turkish-language health information. Built with Google Gemini via OpenRouter, LangChain conversation memory, a FastAPI backend, and a React + Vite frontend served by nginx.

⚠️ This application does not provide medical diagnoses. Always consult a doctor for health concerns.

Screenshots

Left to right: intake form · personalised reply · one-sentence referral on an emergency symptom

Tech Stack

Layer	Technology
LLM	Google Gemini (OpenRouter)
LLM Management	LangChain
Backend	FastAPI + Uvicorn
Frontend	React + Vite + TypeScript (bun)
Web server	nginx (static only)
Deployment	Docker + Dokploy (self-hosted)

Quick start

cd backend  && cp .env.example .env && make up
cd ../frontend && VITE_API_BASE=http://localhost:8003 make up

Open http://localhost:8002.

Run make help in either folder to see all targets.

---

Bilinen sınır / Known limitation

Sohbet hafızası süreç belleğinde (store sözlüğü) tutulur: konteyner yeniden başlatıldığında tüm konuşmalar silinir ve backend tek worker ile çalışmak zorundadır. Kalıcılık gerekirse bir veritabanı katmanı eklenmelidir.

---

Built by Aslı