# 00 · Proje Özeti & Kapsam

> **Belge:** Türkiye–Romen Dayanışma Platformu — Frontend Faz 1 Planı
> **Hazırlayan:** Worgoo · **Müşteri:** Türkiye–Romen Dayanışma Derneği
> **Kaynak brief'ler:** `Teknik Mimari & Geliştirme Süreci` (WG-2026-0609-DEV) + `Online Uygulama`
> **Bu fazın çıktısı:** 3 farklı frontend tasarım varyasyonu + detaylı planlar (tıklanabilir HTML prototip)

---

## 1. Vizyon (brief'ten)

Türkiye–Romen Vatandaşlar Dayanışma Platformu; üyeleri yalnızca bir dernek çatısı altında değil, **güçlü bir dijital topluluk** içinde buluşturmayı hedefler. Üyeler profil oluşturabilir, vatandaşlık süreçlerini takip edebilir, aile fertlerini sisteme ekleyebilir, etkinliklere katılabilir, derneğin online hizmetlerine ve gezi rehberine tek bir platform üzerinden erişebilir.

**Amaç:** Türkiye ve Romanya arasında güçlü sosyal, kültürel ve ekonomik bağlar kuran, üyelerine gerçek fayda sağlayan **modern ve sürdürülebilir bir dayanışma ağı**.

---

## 2. Modüller — Kapsam Matrisi

Brief'te 10 ana modül tanımlı. Bu fazda **Sosyal Ağ** ve **Profesyonel Ağ** kapsam dışı bırakıldı (sonraki faza ertelendi).

| # | Modül | Durum | Frontend karşılığı |
|---|-------|-------|--------------------|
| 1 | **Ana Sayfa** | ✅ Kapsam içi | Dernek tanıtımı, duyurular, etkinlikler, modül vitrini, mağaza & gezi önizleme |
| 2 | **Üyelik Sistemi** | ✅ Kapsam içi | Vatandaş / aday üyelik başvuru akışı, e-posta doğrulama, durum takibi |
| 3 | **Aile Yönetimi** | ✅ Kapsam içi | Aile fertleri, 18 yaş altı ön kayıt (vasi onayı), gizlilik |
| 4 | ~~Sosyal Ağ~~ | ⛔ **Kapsam dışı** | — (LinkedIn benzeri profil, arkadaşlık, mesajlaşma, içerik akışı ertelendi) |
| 5 | ~~Profesyonel Ağ~~ | ⛔ **Kapsam dışı** | — (Meslek/şehir faceted arama, dizinleme, öneri ertelendi) |
| 6 | **Vatandaşlık Destek Merkezi** | ✅ Kapsam içi | Başvuru iş akışı, evrak yükleme & durum takibi, rehber dokümanlar |
| 7 | **Online Shop** | ✅ Kapsam içi | Ürün katalog, sepet, ürün/hizmet detayı (sanal POS sonraki entegrasyon) |
| 8 | **Gezi Rehberi** | ✅ Kapsam içi | TR & RO kültürel/turistik rehber, harita & medya, çok dilli |
| 9 | **Etkinlik & Dayanışma** | ✅ Kapsam içi | Etkinlik takvimi, kayıt, katılım, networking & kültürel buluşmalar |
| 10 | **Güvenlik & Yetkilendirme** | ✅ Kapsam içi | Çok rollü paneller (ziyaretçi/aday/vatandaş/doğrulanmış/admin), giriş/kayıt |

> **Navigasyon notu:** Sosyal Ağ ve Profesyonel Ağ kapsam dışı olduğundan, prototip navigasyonunda **"Sosyal Ağ" / "Profesyonel Ağ" menü öğeleri görünmez.** İleride eklenebileceği için bilgi mimarisi bu modüllere yer açacak şekilde genişlemeye uygun tasarlanır (bkz. `01-BILGI-MIMARISI.md`).

---

## 3. Teknoloji Yığını (hedef — Next.js'e geçişte)

| Katman | Teknoloji |
|--------|-----------|
| Frontend | **Next.js 15 (App Router)**, React 19, TypeScript, **Tailwind CSS**, shadcn/ui |
| Backend | Next.js Server Actions & Route Handlers, REST / tRPC |
| Veritabanı | PostgreSQL + Prisma ORM |
| Kimlik & Yetki | Auth.js (NextAuth) — RBAC, 2FA opsiyonu |
| Depolama & Medya | S3 uyumlu (Cloudflare R2 / Hetzner), Next/Image |
| Ödeme | Sanal POS / iyzico |
| Arama | PostgreSQL full-text / Meilisearch |
| Çok Dillilik | **next-intl — TR / RO / EN**, hreflang |
| E-posta & Bildirim | Resend / SMTP, web push |
| DevOps | Vercel / Hetzner (Docker), GitHub Actions CI/CD, CDN |
| İzleme | Sentry, Vercel Analytics / Plausible |

> **Bu faz:** Hız ve sıfır kurulum riski için varyasyonlar **kendi kendine yeten (self-contained) HTML/CSS** olarak üretilir; font **Manrope**, tasarım token'ları CSS değişkenleriyle. Yön seçildikten sonra kazanan varyasyon **Next.js 15 + Tailwind + shadcn/ui** gerçek temeline taşınır (bkz. `04-FRONTEND-YOL-HARITASI.md`).

---

## 4. Non-Fonksiyonel Gereksinimler (tasarımı bağlar)

- **Performans:** SSR/ISR, Core Web Vitals, kod bölme, görsel optimizasyonu, Redis cache.
- **Güvenlik:** RBAC, rate limiting, OWASP Top 10, şifreli belge, denetim kaydı, 2FA.
- **Uyumluluk:** **KVKK & GDPR (TR/RO)**, çerez onayı, veri saklama & silme politikaları → her sayfada çerez bildirimi + footer'da yasal linkler.
- **Erişilebilirlik:** **WCAG 2.1 AA**, mobil öncelikli responsive tasarım → tüm varyasyonlar bunu karşılar.
- **SEO & Çok Dillilik:** SSR, JSON-LD schema, sitemap, hreflang (TR/RO/EN) → semantik HTML, dil değiştirici.
- **Ölçeklenebilirlik:** Modüler bileşenler; bilgi mimarisi yeni modüllere (Sosyal/Profesyonel Ağ) açık.

---

## 5. Kapsam Dışı (brief'e göre)

Bu fazın **dışında** (talep hâlinde ayrı ele alınır): Native mobil (iOS/Android), içerik üretimi & çeviri (TR/RO/EN metin yazımı), 3. parti lisans & servis bedelleri (sanal POS komisyonu, SMS, e-posta servisi), reklam bütçeleri. Ek olarak bu faz için: **Sosyal Ağ** ve **Profesyonel Ağ** modülleri.

---

## 6. Bu Faz İçin Teslim

1. **Planlama dokümanları** (`docs/00–04`).
2. **3 frontend varyasyonu** (tıklanabilir HTML prototip): `prototypes/v1-kopru`, `prototypes/v2-diaspora`, `prototypes/v3-platform`.
3. **Karşılaştırma sayfası** (`prototypes/index.html`) — üç yönü yan yana inceleme.
4. Higgsfield ile üretilmiş **gerçek görsel kütüphanesi** (`prototypes/assets/img`).

**Sonraki adım (görüşme sonrası):** Tek yön seçilir → Next.js 15 temeline taşınır → modül modül geliştirme (sprint bazlı).