YGT Labs Mimari Anayasa

Versiyon: 1.2.1
Tarih: 2026-06-16
Sahip: YGT Labs (ygtlabs.ai)
Durum: Onaylandı (operatör kararı)

---

1. Amaç

Bu anayasa, YGT Labs ekosistemindeki tüm ürün hatlarının teknik standardını tanımlar. Amaç:

1. Kendi markalarımızda ETP (ecutuningportal.com/httpdocs) olgunluğunu çoğaltmak
2. Müşteri landinglerini hızlı üretmek ve gerektiğinde teslim etmek
3. Admin panelini landing kodundan fiziksel olarak ayırmak
4. Portal kaynak satışında araç veritabanı API bağımlılığını korumak
5. 3-5 kişilik ekibe öğretilebilir, sürdürülebilir bir yol haritası sunmak

---

2. Ürün hatları (onaylanmış)

Kod	Ürün hattı	Öncelik	Detay dosyası
P1	Kendi marka landingleri	Yüksek	products/01-own-brand-landings.md
P2	Müşteri landing fabrikası	Orta	products/02-client-landings.md
P3	ETP B2B satış platformu	Koruma	products/03-etp-b2b-platform.md
P4	Site Hub CMS	Orta-Yüksek	products/04-site-hub-cms.md
P5	Pemm portal kaynak satışı	Koruma	products/05-pemm-portal.md
P6	TunerStack ECU portalı	Ayrı ekosistem	products/06-tunerstack-ecosystem.md
P7	Araç veritabanı API	Altyapı	products/07-api-vehicle-db.md
P8	Tuning Website parent brand	Dağıtım	products/08-tuningwebsite-parent-brand.md

---

3. Onaylanmış mimari kararlar

3.1 Admin topolojisi (iki ayrı model)

Kendi markalar (tuningwebsite, ygtlabs, memsidea, tunerstack landing, ETP):

• Next.js tam klon, dahili /admin katmanı
• admin.{site} subdomain kullanılmaz
• Site başına ayrı PostgreSQL DB

Müşteri landingleri (reprocarspain, kfzservice24, tuningwebsite dağıtımı):

• admin.{musteri-domain}.com → Laravel Filament Site Hub
• Landing UI ayrı repo/instance (ADR-001 sonrası)
• Site başına ayrı PostgreSQL DB
• reprocarspain Filament admin evrilir, çöpe atılmaz

3.2 Landing / admin ayrımı

• Landing UI ayrı deploy edilebilir repo veya instance
• CMS içeriği DB’den gelir; landing sadece API fetch + UI render
• Müşteri teslimi: landing repo + içerik DB dump (admin ve Hub sende kalır)

3.3 Kendi markalar (P1)

• Karar: ecutuningportal.com/httpdocs Next.js projesi klonlanarak varyant üretilir
• Markalar: ygtlabs.ai, ygtlabs.com, memsidea.com, tuningwebsite.com, tunerstack.io (sadece landing)
• ETP B2B platformu (P3) olduğu gibi kalır; klon sadece landing ihtiyacı için

3.4 Müşteri landingleri (P2)

• Karar: Onaylı (D-024): Astro 5 + React islands + Hub API. Tam ADR kilidi BL-001 sonrası.
• Inertia varsayılan değil (i18n, SPA hissi, React özgürlüğü endişeleri)
• Gereksinim: gelişmiş SEO, çok dil (site başına 1-3), admin API’den anlık içerik, hızlı sayfa hissi

3.5 İçerik yayını

• Karar: Admin’de değişiklik sonrası anlık landing güncellemesi (ADR-002)
• Müşteri sabırsızlık profili: değişikliği hemen görmek ister
• Blog ve statik bloklar: build/cache sonrası sabit kalır; revalidation ile yenilenir

3.6 CMS zorunlu modüller (tüm paketler)

1. Slider / hero alanı
2. Blog
3. Hizmetler (services)
4. FAQ
5. Contact (mail, telefon, adres)

Ek modüller paket bazlı (müşteriye seçtirilebilir).

3.7 i18n

• Kendi markalar: ETP modeli devam edebilir (geniş dil desteği)
• Müşteri siteleri: Minimal (1-3 dil, site başına admin’den seçilir)

3.8 SEO

• Tüm landinglerde iyi temel SEO (meta, sitemap, schema, CWV hedefleri)
• Ağır SEO kazanımı: ecutuningportal.com, tunerstack.io, tuningwebsite.com, memsidea.com
• Müşterilere ek SEO paketi satılabilir yapı (hreflang, gelişmiş schema, içerik stratejisi)

3.9 Pemm portal (P5)

• Kaynak kod satışı devam eder (nakit ineği, stabil)
• Yeni özellik geliştirme: sadece portal.tunerstack.io (Laravel Filament)
• API lock-in kapsamı: sadece araç/ECU veritabanı (api.ecutuningportal.com)

3.10 TunerStack portal (P6)

• portal.tunerstack.io bu anayasanın landing/CMS kapsamı dışındadır
• ECU sektörü için sürekli geliştirilecek ana portal
• tunerstack.io ana domain sadece landing işleri için bu anayasaya tabidir

3.11 ETP Next.js (P3)

• Karar: Olduğu gibi kalır (B2B satış CRM + customer self-service)
• Landing katmanı ayrı klonlara kaynak olur; ETP monolith bölünmez (şimdilik)

---

3.12 İş önceliği (satış)

Karar: Müşteri teslimi ve satış geliri, iç yapılandırma işlerine göre önceliklidir. Kendi marka klonları stratejik sırada kalır ancak müşteri işi bloklanmaz.

---

4. Ekip ve öğretilebilirlik

Rol	Sayı	Not
Operatör / mimar	1	Karar ve code review
Senior web developer	1	Frontend + mimari uygulama
Stajyer / junior	2-3	Öğretilebilir standart yol

Öğretim önceliği: ETP Next.js landing pattern, Hub API tüketimi, Filament CMS admin.

Inertia + Laravel full-stack yol öğretilmez (müşteri landing varsayılanı değil).

---

5. Yasaklar

1. Müşteriye admin paneli veya Hub backend kodu teslim etmek
2. Pemm’e yeni büyük özellik eklemek (bugfix ve stabilite hariç)
3. portal.tunerstack.io mimarisini landing/CMS kararlarına karıştırmak
4. Araç veritabanını portal kaynak koduna gömerek API bağımlılığını kırmak
5. /en/ prefix üretmek (ETP i18n kuralı, tüm Next projelerinde geçerli)
6. Mimari değişikliği governance/CHANGELOG.md güncellemeden yapmak

---

6. Açık kararlar (TBD)

Tam liste ve oturum günlüğü: governance/OPEN-DECISIONS.md

ID	Konu	Durum
OD-001	Site Hub repo/deploy (müşteri siteleri, site başına PG)	Kısmen
OD-002	ADR-001 benchmark zamanlaması	Tartışılacak
OD-003	Kendi marka admin yüzeyi	Çözüldü (Next /admin)
OD-004	CMS paket satış kanalı	Ertelendi
OD-005	Faz 1 sıra 3+ (memsidea, tunerstack)	Kısmen

---

7. Uygulama sırası (onaylanmış öncelik)

Faz 1: Kendi markalar (Next.js tam klon, site başına PG)
  └── 1) tuningwebsite.com (onaylı)
  └── 2) ygtlabs.ai / ygtlabs.com (onaylı)
  └── 3+) memsidea, tunerstack landing (sıra TBD)

Faz 2: Site Hub CMS
  └── reprocarspain Filament admin → multi-site Hub
  └── admin.{site} subdomain modeli
  └── Headless Content API

Faz 3: Müşteri landing fabrikası
  └── ADR-001 benchmark (Astro vs Next trimmed clone)
  └── reprocarspain, kfzservice24 migrate

Faz 4: Pemm → TunerStack portal geçişi (ayrı program)
  └── Yeni özellikler sadece portal.tunerstack.io

---

8. İlgili dosyalar

• Kod anchor: lib/architecture/contracts.ts
• Katman deploy: docs/runbooks/layer-deploy.md
• Reprocar white-label: reprocarspain.com/httpdocs/AGENTS.md

---

9. Revizyon

Versiyon	Tarih	Değişiklik
1.0.0	2026-06-16	İlk onay (operatör discovery oturumu)
1.1.0	2026-06-16	Faz 1 öncelik tuningwebsite; açık kararlar dosyası; SLA netleştirme
1.2.1	2026-06-16	§3.4 müşteri landing: jüri Astro önerisi (ADR-001 v1.4)