Next.js 14 ile Finansal Hesaplama Motoru Geliştirmek: Hemen Hesap Mimarisi

Source: Dev.to

Neden Yeni Bir Hesaplama Motoru? 👋

Finansal okuryazarlık, karmaşık vergi mevzuatları ve sürekli değişen oranlar arasında kaybolabiliyor. Hemen Hesap, Türkiye’deki güncel vergi, maaş ve finansal hesaplamaları herkes için erişilebilir ve anlaşılır kılmak amacıyla başlattığım bir proje.

1. Teknoloji Yığını ve Mimari 🏗️

1.1. Core Stack

• Next.js 14 (App Router) – Projenin omurgası. SSR (Server‑Side Rendering) ve SSG (Static Site Generation) yetenekleri sayesinde hem SEO dostu hem de şimşek hızında sayfalar oluşturduk.

1.2. UI/UX

• Lucide React – Hafif ikon seti.
• Atomic Design – InputGroup, SelectGroup, ResultCard gibi yeniden kullanılabilir, izole bileşenler.

1.3. Klasör Yapısı

src/

2. Hesaplama Algoritmaları ve İş Kuralları

Bu projenin kalbi src/lib/engines altında atıyor. Her hesaplama aracı (KDV, Maaş, MTV) kendi izole motoruna sahip.

2.1. JavaScript ve Matematiksel Doğruluk

JavaScript’te 0.1 + 0.2 !== 0.3 sorunu vardır. Finansal işlemlerde kuruş hatası kabul edilemez. Bu yüzden özel bir Akıllı Yuvarlama (smartRound) mekanizması geliştirdik.

// Basitleştirilmiş örnek
export function smartRound(value, precision = 2) {
  const factor = Math.pow(10, precision);
  return Math.round((value + Number.EPSILON) * factor) / factor;
}

2.2. Hesaplama Motorları

• KDV Hesaplama – Dahil/Hariç dönüşümleri.
• Gelir Vergisi – 2025 kümülatif matrah takibi.
• Maaş Hesaplama – Brüt/Net döngüsü ve SGK tavan kontrolü.
• Kıdem Tazminatı – Tavan ücret ve giydirilmiş ücret analizi.

Tüm bu motorlar, verilerini veritabanı yerine performans için Statik JSON dosyalarından (data/) çeker. Bu sayede vergi oranları değiştiğinde sadece JSON’ı güncellemek yeterlidir.

3. SEO Stratejisi: Google Bizi Nasıl Görüyor?

Finansal araçlarda rekabet yüksek. Teknik SEO ile fark yarattık.

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "url": "https://hemenhesap.com",
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://hemenhesap.com/search?q={search_term_string}",
    "query-input": "required name=search_term_string"
  }
}

3.1. Teknik Detaylar

• Dinamik Metadata – Her hesaplama sayfası için özel title ve description.
• Sitemap – sitemap.ts ile her build işleminde otomatik güncellenen harita.
• İç Linkleme – Hesaplayıcılar ve blog yazıları arasında anlamsal bağlar.

4. Test ve Kalite Güvencesi (QA)

• Vitest – Jest’e göre daha hızlı olduğu için tercih ettik.

5. Performans

• Statik Önbellekleme (SSG) – Hesaplama sayfalarının iskeleti build anında oluşturulur.

6. Sonuç ve Yol Haritası

Hemen Hesap, modern web teknolojilerinin finansal araçlara nasıl entegre edilebileceğinin canlı bir örneği oldu.

Gelecek Planları

• 📄 Hesaplama sonuçlarının PDF olarak indirilmesi.
• 🌍 Çoklu dil desteği (döviz çevirici için).
• 🔌 Public API (diğer geliştiricilerin kullanması için).

Bu teknik yolculukta edindiğim tecrübeleri paylaşmaya devam edeceğim. Projeyi incelemek isterseniz:

Kodla kalın, hatasız hesaplayın! 👨‍💻