Bakımı Kolay

Klasör yapısının, gelecekteki bir geliştiricinin yargılayacağı ilk şey olduğunu garanti ediyoruz. Belirgin, tutarlı klasör yapıları kullanılıyor (örneğin, src/components, src/services, src/hooks, src/features).

Kodumuzu sadece derleyici için değil, insanlar için yazıyoruz. Tüm projelerde tutarlı adlandırma kuralları ve kalıpları takip ediliyor. Kod kalitesini baştan sağlamak için Husky gibi pre-commit hook'ları aracılığıyla biçimlendirmeyi zorunlu kılmak için ESLint ve Prettier ayarlandı. Daha iyi bakım için TypeScript'i JavaScript yerine tercih ederek tipli dillere öncelik veriyoruz. Kodun her zaman okunabilir ve yönetilebilir, odaklı ve küçük olmasını sağlıyoruz.

Tasarım kararlarını yeniden kullanılabilir kod bileşenlerine kodlayarak tasarım kaosundan kaçınıyoruz. Projeler arasında tutarlılığı sağlamak için ShadCN, Tailwind UI veya Material UI gibi yerleşik bileşen sistemleri kullanılıyor. Bu yaklaşım, kesinlikle gerekli olmadıkça tek seferlik UI kodu yazmaktan kaçınmaya yardımcı olarak zaman kazandırıyor ve tasarım tutarlılığını sağlıyor.

İş mantığının UI katmanında yer almadığından emin oluyoruz. İş mantığını doğru bir şekilde izole etmek ve organize etmek için servis katmanları, özel hook'lar veya kontrolcü modüller kullanılır. API etkileşimleri için modern veri alma desenleri, önbellekleme ve hata durumlarını verimli bir şekilde yöneten SWR, React Query veya özel sarıcılar kullanılarak uygulanır. Tüm API çağrıları, kod tabanını daha sürdürülebilir ve test edilebilir hale getiren services/api/user.ts gibi özel servis klasörlerine soyutlanmıştır.

Roman yazmıyoruz—sadece bir sonraki geliştiriciyi hızlı bir şekilde yönlendirmek için yeterince. README.md her zaman kurulum, ortam değişkenleri, dağıtım talimatları ile yazılır. Karmaşık mantıklar için kısa yorumlar eklenir (aşırı yorum yapmayın). Kamuya açık yöntemler için TSDoc / JSDoc kullanılır. Testlerin nasıl çalıştırılacağı / kurallar için bir CONTRIBUTING.md eklenir.

Yüzde 100 kapsama ihtiyacımız yok, ancak başarısızlığın maliyetli olduğu yerlerde tam kapsama ihtiyacımız var. Birim testleri, iş açısından kritik işlevler için önceliklidir. API uç noktaları veya iş akışları için entegrasyon testleri kullanılır. Kullanımı kolay araçlar seçilir: Jest + Testing Library (React), e2e için Playwright. Böylece kapsama ile pazara çıkış süresi arasında bir denge kurabiliriz.

Her commit güvenlik kontrollerini tetikler. Type kontrolleri (örneğin, tsc --noEmit), Lint/format kontrolleri, Birim testleri, Staging'e otomatik dağıtım yapan basit bir CI/CD hattı kurulur. Yaygın Araçlar kullanılır: GitHub Actions, Docker Compose.

Hardcoded her şeyden kaçınıyoruz = uzun vadeli acı. Tüm gizli bilgiler/yapılandırmalar .env veya uzaktan yapılandırmada (örneğin, AWS SSM, Vercel envs) saklanır. Ortam tabanlı kurulum kullanılır (process.env.NODE_ENV). .env.*, API anahtarları, kimlik bilgileri vb. eklemekten kaçınılır. Ve bunlar iyi bir şekilde belgelenmiştir.