proje detayları

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.

Müşteri

SportoFlow

Başlangıç

02 May 2026

Bitiş

Web Sitesi

sportoflow.com
SportoFlow ana sayfası: sağlıklı yaşamınız yapay zekâ ile güçlensin
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.