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.