Bir Finans
Kuruşu kuruşuna tutan bir finans çekirdeği.



Ekranlar, örnek verilerle çalışan bir demo kopyadan alınmıştır; gerçek müşteri verisi içermez.
01 — Problem
Retainer müşterilerde aylık paket, kota kullanımı, ekstra işler ve revizyonlar; tahsilatlar, çekler, banka hareketleri ve KDV ayrı yerlerde tutuluyordu. Dönem kapanışı ve müşteri bakiyesi her ay elle hesaplanıyordu.
02 — Sistem
Her parasal kaydın borç ve alacağı dengelenmek zorunda olan çift taraflı bir defter üzerine kurulu bir iş ve finans uygulaması geliştirdik. Düzeltmeler silme ile değil ters kayıtla yapılır; tutarlar ondalık hassasiyetle saklanır, döviz belgeleri TCMB kuru ve kur farkıyla TL deftere işlenir.
Dönem kapanışı
İş kaydından tahsilata kadar her adım defterde dengeli bir kayıt bırakır.
- 01İş kaydı
- 02Kota hesabı
- 03Dönem kapanışı
- 04Alacak
- 05Tahsilat
Düzeltme → ters kayıt
Bir Finans
İş kaydı
Kota hesabı
Dönem kapanışı
Alacak
Tahsilat
03 — Mimari
Next.js arayüzü sunucu tarafı oturumlarla NestJS API'ye bağlanır. Para işlemlerinde idempotency anahtarı, dönem kapanışında satır kilidi kullanılır; tüm kayıtlar denetim günlüğüne düşer.
- L0Kullanıcılar
- Sahip
- Yönetici
- Personel
- İzleyici
- L1Arayüzler
- Web uygulaması · PWA
- Mutabakat linki
- L2Uygulama
- NestJS 10
- Prisma 6
- Denetim günlüğü
- L3Modüller
- Defter
- Cari
- Belgeler
- Nakit & banka
- Çek & senet
- Kota motoru
- Raporlar
- L4Veri
- PostgreSQL 16
- DECIMAL(19,4)
- L5Dış servisler
- TCMB kur servisi
04 — Yetenekler
- 01
Çift taraflı defter
Borç ve alacağı dengelenmeyen hiçbir işlem kaydedilmez; hesap türleri, ayrı KDV hesabı ve silme yerine ters kayıtla iptal.
- 02
Cari hesaplar
Müşteri, tedarikçi, kişi ve kurum carileri; VKN/TCKN sağlama doğrulaması, risk seviyesi, Excel içe/dışa aktarım, ekstre ve mahsup/virman.
- 03
Belgeler
Satış/alış faturası, iade ve teklif; satır ve genel iskonto, KDV dahil/hariç, numara serileri, tekliften faturaya dönüşüm ve tekrarlayan belgeler.
- 04
Nakit, banka, çek-senet
Türk banka formatlarını tanıyan ekstre içe aktarma ve eşleştirme, kasa sayımı; portföyden tahsile, cirodan karşılıksıza çek ve senet yaşam döngüsü ve çek takvimi.
- 05
Kota ve dönem motoru
Fiyat versiyonlu sözleşmeler, paket/ekstra/saatlik fiyatlama, kota ve revizyon aşımı; gerekçe ve denetimle aylık dönem kapatma ve yeniden açma.
- 06
Mutabakat ve raporlar
Müşterinin onaylayıp itiraz edebildiği tokenlı mutabakat sayfası; yaşlandırma, kâr-zarar, KDV, nakit ve denetim dahil PDF/Excel raporlar.
05 — Etki
- 01
Retainer müşterilerde dönem kapanışı ve bakiye hesabı uygulamaya devredildi.
- 02
Hiçbir kayıt silinmiyor; her düzeltme defterde izlenebilir.
- 19,4
- ondalık hassasiyet
- 42
- veri modeli
- ~90
- uygulama ekranı
- ~293
- test senaryosu
Teknoloji yığını
Arayüz
- Next.js 15.5
- React 19
- TanStack Query
- Radix UI
Sunucu
- NestJS 10
- Prisma 6
- Zod
- decimal.js
Veri
- PostgreSQL 16
Doküman
- Puppeteer
- ExcelJS
Altyapı
- Docker Compose
- nginx
- Playwright

