Bu portfolyo: Kişisel Web Uygulaması

Bu proje bir tema çalışması değil; gerçek bir ürün omurgasını küçük ama üretim gerçekliğine yakın bir ölçekte taşıyan mühendislik sistemi.

Mimari yaklaşım

• UI katmanı: Next.js App Router, server-first bileşenler, seçili yerlerde istemci animasyonları
• İçerik katmanı: MDX + Zod şema doğrulaması + slug bazlı güvenli derleme
• Kimlik: Auth.js (GitHub OAuth) ile guestbook giriş/rol temelli moderasyon
• Veri: Neon PostgreSQL + Drizzle ORM şema ve sorgu yönetimi
• Cache/limit: Upstash Redis ile görüntülenme sayacı ve API rate limit
• İletişim: Server Action + anti-spam guard + Resend entegrasyonu

Mühendislik kararları

1. Server-first önceliği Statik/yarı-statik bölümler server component olarak tutuldu. Böylece istemci JS yükü kontrol altında kaldı.

2. Fail-safe davranış Redis veya e-posta servisi yoksa uygulama tamamen kırılmak yerine kademeli olarak davranıyor; kritik akışlarda güvenlik önceliği korunuyor.

3. İçerik sözleşmesi Proje frontmatter alanları (problem, decision, impact, status) zorunlu düşünme şablonu gibi kullanıldı; kartlar teknik hikaye anlatır hale geldi.

Ölçülebilir çıktılar

• Tamamlanan kalite kapısı: lint, build, env/db/assets kontrolleri
• Error/loading/not-found ve OG katmanları ile daha üretim dostu UX
• Guestbook ve iletişim akışlarında kötüye kullanım riskini azaltan korumalar

Sonraki iterasyon

• Otomatik test kapsamını genişletmek (unit + entegrasyon)
• CI hattına kalite eşiklerini sıkılaştırmak
• Üretimde Redis/Resend gözlemlenebilirliğini artırmak