Sayılarla Proje

Summary

Projeyi somut rakamlarla özetleyen tek sayfa. Kod miktarı, test sayısı, sayfa sayısı, bileşen sayısı, altyapı maliyeti ve performans hedefleri.

Yolculuk

MetrikDeğer
Geliştirme süresi~7 ay (2025 sonbaharı → 2026 ilkbaharı)
Ekip büyüklüğü1 (solo geliştirme)
Geliştirici11. sınıf lise öğrencisi
Bu projenin yazarı içinİlk büyük çaplı yazılım projesi
Sergilenen öğrenme modeliYaparken öğrenme (learn-by-doing)
Tersine mühendislikle keşfedilen API uç sayısıTüm yukarı akış ulaşım API’si
Araştırılan ve elenen algoritmaDijkstra + diğer transit routing algoritmaları
Üretimde kullanılan algoritmaMcRAPTOR

Kod ve Yapı

MetrikDeğer
Frontend kaynak dosya sayısı (TS/TSX)~110
Sayfa bileşeni (route) sayısı14
shadcn/ui primitifi54
Uygulama-özel React bileşeni~10
Backend kaynak dosya sayısı (TS)~15
Backend route modülü5 (stations, routes, pharmacies, feedback, planner)
Backend servis modülü7 (cache, denizli-api, realtime, route-geometry, planner-*)
Paylaşılan tip tanımlarıbackend/src/types.ts~30 interface/type

Test

MetrikDeğer
Vitest test projesi (ortam)3 (frontend / node / workerd)
Birim test dosyası10
Playwright E2E spec3 (smoke, harita, feedback)
Test helper modülütests/helpers/ altında yeniden kullanılabilir altyapı
CI kapısı3 adım (typecheck + unit + e2e)

Ürün

MetrikDeğer
Uçtan uca özellik alanı9 (harita, duraklar, hatlar, planlayıcı, kart, favoriler, eczaneler, dolum, geri bildirim, istatistik, hakkında)
Desteklenen platform2 (Web + Android)
Desteklenen tema2 (Açık + Koyu)
Arayüz dili1 (Türkçe)
Erişilebilirlik hedefiWCAG AA

Performans

MetrikHedef
First Contentful Paint< 1 s
Time To Interactive< 2.5 s
API ortalama yanıt süresi< 80 ms (TR içi)
Cloudflare Workers CPU / istek< 10 ms (free tier)
Ortalama bundle boyutu (gzipped)< 300 KB
Offline planlama kapsaması%100 (tam veri seti cihazda)

Altyapı

BileşenAdet / Limit
Cloudflare Worker1 (backend)
KV namespace1 (CACHE)
R2 bucket1 (DATASETS, opsiyonel)
Pages project1 (frontend)
GitHub Actions workflow2 (test.yml, planner-dataset.yml)
Devbox paketi7 (node, jdk, gradle, android-tools, wrangler, gcloud, corepack)
Bağımlılık (frontend, prod)~60
Bağımlılık (dev)~25

Önbellek TTL Dağılımı

KaynakYaklaşık TTL
İstasyonlarSaatler
HatlarSaatler
Hat güzergahı / geometriGünler
Planlayıcı dataset indeksiGünler
Gerçek zamanlı varış~10 saniye
Nöbetçi eczaneler~1 saat

Maliyet Projeksiyonu

ServisYıllık maliyet
Cloudflare Pages$0 (sınırsız istek, ücretsiz)
Cloudflare Workers$0 (100k istek/gün’e kadar ücretsiz)
Cloudflare KV$0 (100k okuma/gün’e kadar ücretsiz)
Cloudflare R2$0 (10 GB’a kadar ücretsiz)
Self-hosted UmamiMevcut altyapıya dahil
Domain (opsiyonel)~$10/yıl
TOPLAM10 / yıl

Doküman

VaultDosya SayısıHedef Kitle
docs/ (İngilizce)22 markdownGeliştiriciler
vitrin/ (Türkçe)13 markdownCTO, işe alım, portföy
ADR (karar kayıtları)3Mimari karar izi
Root-level dokümanlarREADME.md, AGENTS.md, CLAUDE.md, GEMINI.md, tests/README.md

Güvenlik Yüzeyi

KategoriAdet
Kimlik doğrulama vektörü0 (oturum yok)
SQL veritabanı0 (SQL injection olanaksız)
Kullanıcı-yüklü dosya vektörü0
Kişisel veri alanı0 (zorunlu)
Topladığımız üçüncü taraf çerezi0

Yapay Zekâ Hazırlığı

Dosyaİçeriği
AGENTS.md11 bölüm — tüm ajanlar için kanonik kural seti
CLAUDE.mdClaude Code’a özel notlar
GEMINI.mdGemini CLI’ya özel notlar
.cursor/rules/project.mdcCursor kural dosyası

Devamı