← Dokümantasyon ana sayfa

Master Plan

Not: Şu an henüz Faz 0 başlamadı. Bu plan, sırayı ve yaklaşımı netleştirmek için hazırlanmıştır.

Altyapı doğrulama durumu: Tamamlandı (Render deploy + Supabase db-check + MVC skeleton).

Altyapı kararı (Güncel)

  • Deployment platformu: Render
  • Veritabanı: Supabase Postgres
  • Not: Railway kararı iptal edilmiştir. Render Postgres yerine Supabase tercih edilmiştir.

Faz 0A — Legacy Analiz & İş Mantığı Keşfi (Tamamlandı ✅)

  • Legacy ekran/modül envanteri çıkarımı
  • Mevcut iş kuralları ve exception senaryolarının analizi
  • DB şema analizi + field mapping taslağı
  • Yeni isteklerin mevcut akışlara etkisinin çıkarılması

Durum: Tamamlandı ✅ (legacy ekran/iş kuralı/DB-FK-yetki analizi kilitlendi)

Faz 0B — Ürün Akışı & UI/UX Kurgusu (Başlamadı)

  • Rol bazlı kullanıcı yolculukları (journey) ve ekran wireflow
  • Bilgi mimarisi ve modül sınırlarının netleştirilmesi
  • Form validasyon, karar noktaları ve onay akışları
  • UI/UX akışının geliştirme öncesi kilitlenmesi

Faz 0C — Platform Çekirdeği (Standartlar) (Başlamadı)

  • Role yönetimi, authentication ve authorization tasarımı
  • Logging/audit, exception handling ve hata standardı
  • Config/secret yönetimi, health check ve gözlemlenebilirlik
  • Bu çekirdek standartlar kodlanmadan modül geliştirmeye başlanmaması

Faz 0C — Önerilen Hazır Framework/Altyapı (Build yerine Compose)

  • Auth/AuthZ: ASP.NET Core Identity + Policy-based Authorization (built-in)
  • Veri katmanı: EF Core + Npgsql (PostgreSQL) + Fluent Migrations
  • Validasyon: FluentValidation
  • Exception standardı: ProblemDetails + global exception middleware
  • Logging/izlenebilirlik: Serilog + OpenTelemetry (trace/metric/log correlation)
  • Event-first uygulama katmanı: MediatR (in-process domain events)
  • Outbox & entegrasyon eventleri: MassTransit veya CAP (gereksinime göre)
  • Arkaplan işleri: Hangfire (zaten karar setinde mevcut)
  • Audit: EF Core interceptor tabanlı audit trail (gerekirse Audit.NET)

Faz 1 — Çekirdek Uygulama Omurgası

  • Clean Architecture prensiplerine uyumlu katman yapısı
  • Temel domain modelleri + modül kontratları
  • Kimlik/yetki temel akışı + ortak middleware altyapısı

Faz 2 — Business Modüllerin Geliştirilmesi (Ana Geliştirme Fazı)

  • Modül bazlı delivery planı (öncelik: operasyonu en çok etkileyen akışlar)
  • Her modülde: domain + API + UI akışı + test paketi birlikte geliştirme
  • Modül kabul kriteri: Unit + Integration + Playwright ilgili akış testleri
  • No test, no merge kuralı bu fazda zorunlu uygulanır
  • Bu faz planın en uzun sürecek ana üretim bölümüdür

Faz 3 — Event, Log ve Worker

  • Event-first kayıt akışı ve event sözlüğü standardı
  • Hangfire görev altyapısı ve retry/izleme politikası
  • Operasyonel gözlem/log standardı (trace + audit zinciri)

Faz 4 — AI Entegrasyonları

  • Provider-independent adapter/port katmanı
  • Feature bazlı AI çağrı noktaları
  • Maliyet ve kalite optimizasyon döngüsü

Faz 5 — Migration ve Kademeli Geçiş

  • Veri taşıma ve doğrulama
  • Kademeli cutover planı
  • Geri dönüş (rollback) güvenlik adımları

Faz 6 — Staging ve Güvenlik Geçidi

  • Staging ortamı kurulumu ve release öncesi doğrulama
  • Prod öncesi penetrasyon testleri ve otomatik security scan
  • Staging onayı olmadan production deploy yasağı
  • Güvenlik bulguları için düzeltme + yeniden test döngüsü

Yeni Ek Modüller (Legacy dışı) — Ön Onay

  • P1: Eğitmen hakediş takibi, eğitim kârlılık analizi
  • P2: Ön muhasebe, bütçe & hedef takibi
  • P3: Sözleşme/doküman yönetimi, tahminleme & planlama (AI destekli)
  • Not: Modül geliştirme başlangıcında detay kapsamlar ayrıca netleştirilecek.

Test Politikası (Sabit Karar)

  • UI akışlarında Playwright coverage hedefi: %100 (kritik kullanıcı akışları bazında)
  • Minimum manuel kontrol, maksimum otomasyon
  • No test, no merge: test geçmeden merge/deploy yok
  • PR kapısı: Unit + Integration + Playwright smoke zorunlu
  • Nightly: full Playwright regression