feat(ios): share extension ile Ratebubble iOS istemcisini ekle ve paylaşım akışını düzelt

This commit is contained in:
2026-03-01 18:07:07 +03:00
parent 8c66fa9b82
commit 5c6a829a4d
20 changed files with 1235 additions and 0 deletions

View File

@@ -0,0 +1,29 @@
---
date: 2026-03-01
topic: ios-share-extension-v1
---
# iOS Share Extension v1
## What We're Building
Projeye ikinci bir frontend olarak native iOS uygulaması eklenecek. Uygulamanın v1 ana işlevi, Netflix uygulamasından paylaşılan içerik linkini almak ve backend API'ye göndererek metadata sonucunu kullanıcıya göstermek.
Akış: Netflix içerik sayfası -> Paylaş -> bizim iOS app (Share Extension) -> URL alma -> backend `/api/getinfo` isteği -> sonuçları metin olarak gösterme (`title`, `year`, vb.).
## Why This Approach
Share Extension seçimi, iOS paylaşım menüsüne doğal şekilde entegre olur ve kullanıcı davranışıyla birebir örtüşür. Deep link tabanlı alternatiflere göre daha güvenilir URL yakalama sağlar ve v1 için en düşük sürtünmeyle çalışır.
V1 kapsamını sadece “link al, API çağır, sonucu göster” ile sınırlamak, YAGNI prensibine uygundur ve ürünü hızlıca canlı doğrulamaya taşır.
## Key Decisions
- Entegrasyon tipi: Share Extension (zorunlu).
- Kapsam: Sadece Netflix paylaşım linki ile `/api/getinfo` çağrısı.
- Yetkilendirme: `X-API-Key` olarak `API_KEY_MOBILE` kullanılacak.
- Görsellik: UI/UX tasarımı v1 sonrası iterasyona bırakılacak.
## Open Questions
- Share Extension URLyi doğrudan APIye mi gönderecek, yoksa ana appe handoff edip ana app mi çağrı yapacak?
- Başarısız API yanıtlarında kullanıcıya minimum hangi hata metni gösterilecek?
## Next Steps
-> `/workflows:plan`