# 01 — Emare Superapp: Vizyon ve Kararlar

> **AI'lere sorulacak:** Bu vizyon doğru mu? D1–D5 kararlarına alternatif öneriniz var mı?

**Versiyon:** 1.0 · **2026-07-05**

---

## 1. Tek cümlelik vizyon

Emare Superapp, Emare Cloud ekosistemindeki **binlerce kurumsal mini uygulamayı** tek Android kabukta sunar; kullanıcı tek oturumla tüm modüllere erişir, **AI asistan yetki sınırları içinde bağlı telefonu yönetebilir**.

---

## 2. Problem (bugün)

| Sorun | Etki |
|-------|------|
| Superapp v1.0 + Emare Asistan v2.3.x **ayrı APK** | Çift kurulum, çift oturum |
| Web mağaza (`app.emarecloud.tr`) statik katalog | Tenant manifest'e bağlı değil |
| Device control yok | AI telefon aksiyonu alamıyor |
| Superapp Android git dışı klasör | CI, versiyon, ekip sync zor |

---

## 3. Hedef ürün

**Kullanıcı:** kurumsal giriş → mini-app grid → WebView veya native modül aç → asistanla komut.

**Teknik hedef:**

| Bileşen | Hedef |
|---------|--------|
| Paket | `com.emare.superapp` (birleşik) |
| API | `https://aiasistan.emarecloud.tr/` |
| Mağaza vitrin | `https://app.emarecloud.tr/` |
| Manifest | tenant `workspace.json` (platform spec) |

---

## 4. Kapsam dışı (v1)

- Play Store prod (internal track sonra)
- iOS native shell (ayrı proje)
- Tam MDM fleet (Device Owner — enterprise faz)
- Odoo canlı sync

---

## 5. Karar bekleyen maddeler (D1–D5)

| # | Karar | Seçenekler | Öneri |
|---|--------|------------|--------|
| **D1** | APK stratejisi | Tek APK / iki APK geçiş | Tek APK + geçici `agent` flavor |
| **D2** | Root kapsamı | Test only / fleet / kapalı | Opt-in modül, varsayılan kapalı |
| **D3** | Repo | Monorepo `superapp/` / ayrı git | Elyafgroup monorepo |
| **D4** | İlk device komutları | Öncelik listesi | `open_app`, `open_url`, `start_ai_call` |
| **D5** | Katalog | Statik JSON / tenant API | Faz 2'de tenant API |

---

## 6. Başarı kriterleri (faz gate)

| Faz | Kriter |
|-----|--------|
| 0 | Docs + repo taşıma planı onaylı |
| 1 | Tek giriş, birleşik nav, Asistan modülleri shell içinde |
| 2 | Mağazadan app deep link ile açılır |
| 3 | Cihaz kayıtlı; ≥3 Seviye A komut çalışır |
| 4 | Shizuku/root opt-in + audit log |

---

## 7. Paydaşlar

| Rol | Sorumluluk |
|-----|------------|
| Ürün sahibi | D1–D5 onayı |
| Platform backend | Auth, manifest, device API |
| Mobil | Shell, device agent, birleşme |
| DevOps | Deploy, imza, OTA |

---

## 8. Mevcut durum özeti (2026-07-05)

| Bileşen | Durum |
|---------|--------|
| Web mağaza | ✅ Canlı — 2.420 app katalog |
| Superapp Android v1.0 | ⚠️ Legacy — `/Users/emre/Emare superapp` |
| Emare Asistan v2.3.4 | ✅ `Mobile App/` |
| Birleşik APK | ❌ Faz 1 |
| Device Agent | ❌ Faz 3–4 |

---

## 9. AI'den istenen geri bildirim

1. Vizyon eksik veya fazla geniş mi?
2. D1–D5 için farklı öneriniz?
3. İlk MVP'de kesilmesi gereken scope?
4. Rekabet / benzer ürün referansı öneriniz?

**Sonraki dosya:** [02-MIMARI-VE-ENTEGRASYON.md](./02-MIMARI-VE-ENTEGRASYON.md)