SportoFlow — Yapay Zekâ Destekli Kişisel Longevity Platformu
Egzersiz, beslenme, uyku, takviye ve biyobelirteç takibini insan onaylı bir bilgi motoru ve yapay zekâ koçla birleştiren çok kiracılı SaaS.

Açıklama
Egzersiz, beslenme, uyku, takviye ve biyobelirteç takibini insan onaylı bir bilgi motoru ve yapay zekâ koçla birleştiren çok kiracılı SaaS.
Vaka çalışması
Zorluk
Longevity bilgisi podcast, bülten ve makalelere dağınık; kullanıcılar bunu kendi kan değerleri ve antrenman verileriyle ilişkilendiremiyor. Sağlık verisiyle çalışan bir üründe her önerinin kaynağı, kanıt düzeyi ve onaylayanı görünür olmak zorundaydı.
Yaklaşım
Kaynakları toplayıp kanıt dereceli iddialara dönüştüren, editör onaysız hiçbir şeyi yayınlamayan bir bilgi motoru kurduk. Antrenman planlarını dil modeline değil kural tabanlı bir motora ve denetçiye bıraktık; AI yalnızca açıklama ve kısıt çevirisi yapıyor. Koç ve hekim erişimini sporcunun onayladığı, geri alınabilir ilişkilere bağladık.
Sonuç
SportoFlow sportoflow.com adresinde canlı; bilgi, biyobelirteç, antrenman, protokol, beslenme, takviye, uyku ve uzman ağı modülleri kodda tamamlandı ve otomatik testlerle korunuyor. Cihaz sağlayıcı onayları, canlı ödeme ve mobil uygulama sıradaki adımlar.
Araçlar
Next.js 16, React 19, TypeScript, Shadcn UI, React Query, Bun, Fastify, Drizzle ORM, MySQL, Zod, Stripe
Öne Çıkan Özellikler
Kaynaklı, kanıt dereceli ve editör onaylı bilgi motoru
PubMed, ClinicalTrials.gov, RSS, podcast ve YouTube toplayıcıları
60+ biyobelirteç, PDF/OCR tahlil okuma ve PhenoAge skoru
Kural denetimli antrenman motoru: 8 branş eklentisi
ACWR, %10 hacim sınırı ve deload kuralları
Sürümlü protokoller ve yalnız etkilenene bildirim
TürKomp/USDA beslenme ve 30+ kalemlik takviye kataloğu
Onaylı ilişkiyle koç/hekim erişimi, randevu ve görüntülü görüşme
Tarayıcıda kamera ile tekrar sayımı ve form kontrolü
Kullanılan Teknolojiler
Next.js 16
React 19
TypeScript
Shadcn UI
React Query
Bun
Fastify
Drizzle ORM
MySQL
Zod
Stripe
Tasarım Öne Çıkanları
AI taslak üretir, insan onaylar: her öneride kaynak ve kanıt rozeti
Eksik veriyle de çalışan skor; eksik girdi ve nasıl tamamlanacağı görünür
Sağlık sınırı dili: “tahmindir, tanı değildir” uyarıları ve hekim onay rozeti
Kamera görüntüsü cihazda kalır; poz modeli kendi sunucudan, üçüncü taraf CDN yok
Türkçe arayüz; AI açıklamaları ve bülten Türkçe ve İngilizce
Detaylar
SportoFlow, uzun ve sağlıklı yaşamı ölçülebilir bir hedefe dönüştürmek isteyen bireyler, onlarla çalışan koçlar, diyetisyenler ve hekimler için geliştirilmiş bir longevity işletim sistemidir. Bilimsel yayınları, kan tahlili sonuçlarını, cihaz ölçümlerini ve günlük alışkanlıkları tek panelde birleştirir. Temel ilke nettir: yapay zekâ taslak üretir, kararı insan verir.
Proje bağlamı ve ihtiyaç
Longevity alanındaki bilgi; podcastlere, bültenlere, YouTube videolarına ve hakemli makalelere dağılmış durumda. Kullanıcılar bu bilgiyi kendi kan değerleriyle, antrenman geçmişleriyle ve uyku verileriyle ilişkilendiremiyor; hazır uygulamalar ise ya yalnızca egzersize ya da yalnızca beslenmeye odaklanıyor. Sağlık verisiyle çalışan bir üründe ikinci büyük sorun güven: önerinin hangi kaynağa dayandığı, kanıt düzeyi ve kimin onayladığı görünür olmalı. SportoFlow bu iki ihtiyaca göre tasarlandı: kaynaklı bilgi ve kişisel veri aynı yerde, her öneri izlenebilir.
Çözüm ve kapsam
İnsan onaylı bilgi motoru
Seçilmiş kaynaklar RSS, podcast, YouTube, e-posta bülteni, PubMed ve ClinicalTrials.gov üzerinden düzenli olarak toplanır. Ses içerikleri Whisper ile metne dönüştürülür; metinlerden yapılandırılmış iddialar çıkarılır: müdahale, doz, hedef kitle, sonuç, etki yönü ve kanıt düzeyi (meta-analiz, RCT, kohort, mekanistik, uzman görüşü, n=1). Aynı konuda zıt yönlü bir iddia geldiğinde kayıt otomatik olarak “tartışmalı” işaretlenir. Hiçbir iddia editör onayından geçmeden kullanıcıya ulaşmaz; telif sınırı gereği tam metin değil yalnızca özet ve kısa alıntı gösterilir.
Biyobelirteç takibi ve longevity skoru
Kullanıcı tahlil sonuçlarını elle girebilir ya da PDF olarak yükleyebilir. Sistem önce PDF'in metin katmanını okur, gerekirse görüntü üzerinden tablo okur; Türk laboratuvarlarının farklı adlandırmaları bir eşleme sözlüğüyle kataloğa bağlanır. Okunan değerler kullanıcı onaylamadan kayda geçmez. Katalogda 60'ı aşkın biyobelirteç normal ve optimal aralıklarıyla tanımlıdır. PhenoAge formülüne dayalı biyolojik yaş tahmini ve VO2max tabanlı fitness yaşı hesaplanır; eksik girdi varsa skor yine üretilir ama hangi değerin eksik olduğu ve nasıl tamamlanacağı açıkça gösterilir.
Deterministik antrenman motoru
Antrenman programları dil modeline yazdırılmaz; kurallarla üretilir. Koşu (VDOT), bisiklet (FTP), yüzme (CSS), triatlon, kuvvet (%1RM), hipertrofi, HIIT ve mobilite için ayrı eklentiler vardır. Kural denetçisi haftalık hacim artışını %10 ile sınırlar, akut/kronik yük oranını (ACWR) 0,8–1,3 bandında tutar, 3:1 yükleme–deload döngüsünü uygular ve tıbbi uyarı beyan edilmişse plan üretimini durdurur. Yapay zekâ yalnızca seansları açıklar ve “bu hafta iki gün yokum” gibi serbest metni yapılandırılmış kısıta çevirir; planın yapısını değiştiremez. Yapılan, kısmen yapılan ve kaçırılan seanslar sonraki haftayı yeniden hesaplar; plan ICS ve FIT formatında dışa aktarılabilir.
Protokol, beslenme, takviye ve uyku
Sekiz platform protokolü sürümlü olarak tutulur. Yalnızca meta-analiz, RCT ve kohort düzeyindeki iddialar bir protokolün hedefini değiştirebilir; değişiklik onaylandığında yalnızca o protokolü benimsemiş kullanıcılara bildirim gider. Beslenme modülü TürKomp ve USDA verisiyle besin araması, serbest metinden öğün kaydı ve günlük protein/kalori/lif halkası sunar. Takviye kataloğu 30'u aşkın kalem, etkileşim uyarıları ve “hekime danışın” bayraklarıyla gelir. Uyku sütunu, HRV yedi günlük ortalamanın belirgin altına düştüğünde o günün yüksek yoğunluklu seansını otomatik olarak hafifletir.
AI koç ve kamera ile form kontrolü
AI koç; kullanıcının aktif protokollerini, son biyobelirteç özetini ve son yedi günlük kayıtlarını bağlam olarak alır, yanıtlarını yalnızca onaylı iddialara dayandırır ve kaynak bağlantılarını gösterir. Hareket kütüphanesindeki egzersizlerde tarayıcı içinde çalışan poz tahmini tekrar sayar ve form ihlallerini anlık bildirir; görüntü ve vücut noktaları sunucuya gönderilmez.
Koç, hekim ve uzman katmanı
Aynı altyapı bireysel kullanıcıya, koça ve kliniğe hizmet eder. Uzman profilleri belge doğrulaması olmadan aktifleşmez. Koç veya hekim, yalnızca sporcunun kapsamını kendisinin seçtiği ve dilediği an geri alabildiği onaylı ilişki üzerinden veri görür; her erişim kayıt altına alınır. Koç rolü biyobelirteç yorumu ve doz önerisi uçlarına erişemez. 18 yaş altı, gebelik veya kalp rahatsızlığı beyanı gibi kırmızı bayraklarda plan hekim onayı olmadan yayınlanmaz; hedef yeni sürüme geçtiğinde onay düşer. Uzman dizini, uygunluk takvimi, randevu, mesajlaşma, LiveKit ile sesli/görüntülü görüşme (kayıt varsayılan kapalı), komisyon ve hakediş akışları da bu katmanın parçasıdır.
Yönetim paneli
Superadmin ve editörler; bilgi kaynaklarını ve senkron durumlarını, iddia onay kuyruğunu (klavye kısayollarıyla toplu onay/ret), biyobelirteç kataloğunu ve optimal aralıkların kaynak iddialarını, protokol sürümlerini, hareket kütüphanesini, hizmet kataloğunu, kiracıları, planları ve kullanım kredilerini yönetir. Kaynağı bağlanmamış bir optimal aralık “kaynak bekliyor” etiketiyle gösterilir ve öneri üretmez.
Teknik mimari
Backend Bun üzerinde Fastify 5, Drizzle ORM ve MySQL ile; panel Next.js 16, React 19, Shadcn UI ve React Query ile geliştirildi. Bilgi toplama, transkript ve OCR işleri Redis tabanlı BullMQ kuyruklarında çalışır; haftalık yeniden planlama ve bülten zamanlanmış görevlerle yürür. Çok kiracılı yapıda her kişisel tablo kiracı ve kullanıcı anahtarıyla kapsanır; bunu denetleyen tenant-scope guard kalite kapısının parçasıdır. Dil modeli sağlayıcıları (Claude, OpenAI, Groq) tek katman arkasındadır; kaynak güvenilirliğine göre model seçilir, kiracı bazında token ve maliyet ölçülür, günlük maliyet tavanı aşılırsa kuyruk durur. Arayüz Türkçedir; iddia çıkarımı, AI açıklamaları ve bülten Türkçe ve İngilizce üretilir. Public sayfalar Organization, WebSite ve SoftwareApplication yapılandırılmış verisi, site haritası ve llms.txt ile yayınlanır.
Entegrasyonlar ve güvenlik
- Cihazlar: Apple Health için kullanıcıya özel, yalnızca yazma yetkili köprü anahtarı; FIT dosyası içe aktarma; Strava, Withings, Oura ve WHOOP için adaptörler hazır, sağlayıcı onaylarıyla etkinleşecek.
- Ödeme: Stripe checkout ve webhook akışı fail-closed kuruldu; canlı hesap anahtarları tanımlanınca açılır.
- Sportoonline: kardeş e-ticaret mağazasıyla hesap bağlama ve sipariş senkronu; cihaz, laboratuvar paketi ve hizmet siparişleri panelde ilgili kayda dönüşür. Ürün önerilerinde sağlık verisi hedeflemesi kullanılmaz.
- Güvenlik: sırlar için varsayılan değer yok, cihaz token'ları şifreli, belge yüklemede MIME ve dosya imzası kontrolü, medya indirmede SSRF koruması, KVKK kapsamında veritabanı ve dosyaları birlikte silen hesap silme zinciri.
Bugün
SportoFlow sportoflow.com adresinde canlıdır; bilgi motoru, biyobelirteç, antrenman, protokol, beslenme, takviye, uyku, koç/hekim ve uzman ağı modülleri kodda tamamlanmış ve otomatik testlerle korunmaktadır. Açık kalan işler dış kapılara bağlıdır: cihaz sağlayıcılarının geliştirici onayları, canlı ödeme hesabı, teletıp için hukuki görüş ve Expo tabanlı mobil uygulama planlanan sonraki adımlardır.