Borocean
Amerikan (NYSE/NASDAQ) ve Türkiye (BIST) borsalarındaki hisseleri temel ve teknik analiz parametreleriyle değerlendiren bir borsa takip uygulaması. BIST şimdilik devre dışı; canlı fiyat kaynağı bulunduğunda tek bir bayrakla açılacak.
Canlı: https://borocean.com · API: https://trendus-api.onrender.com
Başlıca özellikler:
- Hisse arama, genel bakış, temel analiz ve sektör kıyaslaması
- Gösterge ve çizim araçlı fiyat grafiği, kural bazlı sinyaller, metrik puanı
- Tarama ve karşılaştırma
- İzleme listesi, fiyat ve sinyal alarmları
- Portföy takibi ve her sabahki portföy gelişme taraması
- Alım-satım simülasyonu
- Yapay zeka destekli analiz raporları ve günlük sektör bülteni
Uygulama yatırım danışmanlığı yapmaz; kurallar için bkz. docs/compliance.md.
İlgili dokümanlar (Türkçe / English): docs/PRD.md (EN), docs/architecture.md (EN), docs/epics.md (EN), docs/product-brief-epic9-ai.md (EN), docs/product-brief-epic13-portfolio-insights.md (EN), docs/compliance.md. Story dokümanları: docs/stories/.
Türkçe dokümanlar kaynak metindir (source of truth); İngilizce versiyonlar her güncellemede eşlenir. Bkz. LICENSE — bu proje kapalı kaynaklı, tüm hakları saklıdır.
Monorepo Yapısı
apps/
web/ # Next.js (TypeScript) web uygulaması
mobile/ # React Native / Expo (TypeScript) mobil uygulaması
api/ # FastAPI (Python) backend
packages/
shared/ # Backend OpenAPI şemasından üretilecek paylaşımlı TS tipleri
Ön Koşullar
- Node.js 24+
- pnpm 12+ (
npm install -g pnpm)
- Python 3.11+
- Bir Supabase projesi (PostgreSQL + Auth) — Proje URL'si ve Publishable Key'i API Settings sayfasından alın. Google/Apple ile giriş için ilgili sağlayıcıları Auth Providers altında etkinleştirin (web için; mobilde native Google/Apple girişi henüz desteklenmiyor, bkz.
docs/stories/story-1.2.md).
Web (apps/web)
pnpm install
cp apps/web/.env.example apps/web/.env.local # NEXT_PUBLIC_SUPABASE_* değerlerini doldurun
pnpm --filter web dev # http://localhost:3000 — /login sayfasından kayıt/giriş yapılabilir
pnpm --filter web build # production build
pnpm --filter web typecheck
pnpm --filter web lint
Mobil (apps/mobile)
pnpm install
cp apps/mobile/.env.example apps/mobile/.env # EXPO_PUBLIC_SUPABASE_* değerlerini doldurun
pnpm --filter mobile start # Expo geliştirme sunucusu, QR kod ile Expo Go veya simülatörde açılır — e-posta/şifre ile kayıt/giriş ekranı açılır
pnpm --filter mobile typecheck
pnpm --filter mobile lint
Backend API (apps/api)
cd apps/api
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env # SUPABASE_*, FINNHUB_API_KEY değerlerini doldurun
uvicorn app.main:app --reload # http://localhost:8000
FINNHUB_API_KEY olmadan da API çalışır — yalnızca ABD hisse araması devre dışı kalır ve yanıt bunu warnings alanında açıkça belirtir (BIST araması statik bir dizinle her koşulda çalışır). Ücretsiz bir anahtar finnhub.io'dan alınabilir.
Doğrulama:
GET /health → {"status": "ok"}GET /health/db → Supabase Postgres bağlantısı kuruluysa {"status": "ok"}, değilse 503 ile {"status": "unavailable"}GET /symbols/search?q=GARAN → BIST/ABD sembol aramasıGET /openapi.json → OpenAPI şeması
Test ve lint:
pytest -q
ruff check .
Tüm Workspace'i Birden Çalıştırma
Kök dizinden turbo ile tüm JS/TS uygulamaları için aynı komutu tetikleyebilirsiniz (backend ayrı, Python tabanlı olduğu için kapsam dışıdır):
pnpm lint
pnpm typecheck
pnpm build
CI
.github/workflows/ci.yml, her pull request'te web/mobile lint+typecheck(+build) ve backend ruff+pytest kontrollerini otomatik çalıştırır.
