Göktay Logo
← Referanslara Dön
Kurumsal CRM/ERP

XTech Nexus CRM

XTech Nexus CRM, iki ülkede üç ofisi olan bir organizasyon için geliştirilmiş kurumsal bir CRM/ERP sistemi. Ön muhasebe, envanter/zimmet ve personel yönetimi tek uygulamada. Çıkış noktası şu sorundu: çok sayıda elektronik ekipman vardı ve hangi cihazın kimde olduğu bilinmiyordu. Sistem; ofisleri, her ofisin ayrı kasasını ve muhasebe işlemlerini, ofislerde çalışan personeli ve personele zimmetli her cihaz ile lisansı seri numarası, satın alma tarihi ve fiyatıyla birlikte tek yerde topluyor. Hiyerarşik onay zinciri ve puantaja dayalı prim/ceza sistemi de içinde. Backend Go/Gin ile hexagonal mimaride, frontend React 19 ve Mantine ile yazıldı.

📈 Kayıp veya hasarlı ekipmanda zarar artık net olarak hesaplanıyor. Her ofisin finansal durumu ayrı izleniyor, personel de aldığı her prim ve cezanın gerekçesini görebiliyor.
GoGinGORMPostgreSQLJWTReact 19MantineTanStack QueryZustandReact Hook FormZodVitesystemd
Full-stack Geliştirici
XTech Nexus CRM — kavramsal illüstrasyon

XTech Nexus CRM, birden fazla ülkede ofisi olan bir organizasyon için geliştirilmiş kurumsal bir CRM/ERP sistemi. Ön muhasebe, envanter ve personel yönetimi tek bir uygulamada birleşiyor. Proje özel bir müşteri çalışması olduğu için şirket adı ve ekran görüntüleri paylaşılmıyor. Bu sayfada sorunu, mimariyi ve verilen mühendislik kararlarını anlatıyorum.

İşin başlangıç noktası bir yazılım ihtiyacından çok bir görünürlük sorunuydu. Organizasyonda çok sayıda elektronik ekipman vardı ama hangi cihazın kimde olduğu bilinmiyordu. İki ülkede üç ofise dağılmış bir yapı bu takibi iyice zorlaştırıyordu. Bir cihaz kaybolduğunda ya da hasar gördüğünde ne kaybedildiği, kimin sorumluluğunda olduğu ve maliyetinin ne olduğu belirsiz kalıyordu.

Ürün Kapsamı

Sistem, birbirinden kopuk duran dört alanı tek bir veri modelinde topluyor:

Kullanıcıların en çok işine yarayan özellik personel puantaj sistemi oldu. Prim ve ceza bir puan sistemine göre işliyor ve personel kendi aldığı her prim ya da cezanın ayrıntısını görebiliyor.

Teknik Mimari

Backend: Go ve hexagonal mimari

Backend Go ve Gin ile yazıldı. Veri katmanında GORM ve PostgreSQL, kimlik doğrulamada JWT kullanılıyor. Kod hexagonal (Ports & Adapters) mimariye göre düzenlendi:

Bu ayrımın bir ERP'de somut bir faydası var. Muhasebe ve İK kuralları zamanla en çok değişen kısımlar ve bu kurallar web katmanına ya da ORM'e bağlı değil. Onay zinciri veya prim hesaplama mantığı değiştiğinde dokunulan yer domain ve servis katmanı oluyor. Handler'lar ile repository'ler aynı kalıyor.

Frontend: React 19 ve Mantine

Yönetim arayüzü React 19 ve Mantine UI ile, Vite üzerinde geliştirildi. Görevler kütüphanelere net biçimde dağıtıldı:

Çok ofisli organizasyon modeli

İki ülke ve üç ofis veri modelinde ayrı bir istisna olarak ele alınmadı, hiyerarşinin parçası olarak modellendi:

Company (tüzel kişilik) → Branch (fiziksel ofis) → Department → Position

Tüzel kişilik ile fiziksel ofisin ayrı varlıklar olması, farklı ülkelerdeki yapıların aynı modelle temsil edilmesini sağlıyor. "Bu ofiste kim çalışıyor, kasasında ne var, kimin üzerinde hangi cihaz var" soruları aynı modelden yanıtlanıyor.

Davet tabanlı onboarding

Yeni personel sisteme token tabanlı bir davetle katılıyor. Davet bağlantısı 48 saat geçerli, süresi dolan bağlantı artık kullanılamıyor.

Mühendislik Kararı 1: Ürün Tanımı ile Fiziksel Varlığı Ayırmak

Sorun. "Kimde ne var" sorusunun yanıtı, envanterin nasıl modellendiğine bağlı. Envanter "MacBook Pro, adet: 50" şeklinde tutulursa elli cihazın her biri ayrı izlenemez. Hangisinin kimde olduğu, hangisinin ne zaman ve kaça alındığı, hangisinin kaybolduğu kayıtlarda görünmez. Sorunun kendisi de buydu.

Karar. Envanter iki ayrı varlık olarak modellendi:

Zimmet de ayrı bir kayıt olarak tutuluyor. AssetAssignment, bir varlığın kime ve ne zaman verildiğini, ne zaman iade edildiğini ve zimmeti kimin yaptığını saklıyor. Varlığın üzerinde yalnızca "şu an kimde" bilgisi değil, bütün zimmet geçmişi duruyor.

Sonuç. Aynı modelden elli MacBook olsa bile her biri kendi seri numarası, alış tarihi ve fiyatıyla ayrı bir kayıt. Bir cihaz kaybolduğunda ya da hasar gördüğünde hangi cihaz olduğu, son kimde olduğu, kimin zimmetlediği ve satın alma maliyeti kayıtlardan okunuyor. Zarar tahminle değil, kayıtla belirleniyor. Lisanslar ve SIM kartlar da aynı modelle izlendiği için yazılım lisansları ve hatlar da envanterin parçası.

Mühendislik Kararı 2: Para Tutarlarını int64 Kuruş Olarak Saklamak

Sorun. Sistem birden fazla ülkede ve birden fazla para birimiyle çalışıyor. Her kasa (Account) nakit (CASH) ya da banka (BANK) tipinde ve kendi para biriminde (EUR, USD, TRY). Para tutarlarını kayan noktalı sayılarla saklamak bilinen bir hata kaynağı. 0.1 + 0.2 gibi işlemler tam sonuç vermez ve çok sayıda işlem toplandığında bakiye birkaç kuruş sapabilir. Muhasebede birkaç kuruşluk fark da açıklanması gereken bir tutarsızlıktır.

Karar. Bütün Transaction tutarları int64 olarak en küçük para biriminde (kuruş/cent) saklanıyor. Örneğin 125,50 EUR veritabanında 12550 olarak duruyor. Hesaplar tam sayı aritmetiğiyle yapılıyor, ondalık gösterim sadece görüntüleme aşamasında üretiliyor.

Sonuç. Yuvarlama hatası dikkatli kod yazılarak önlenmiyor, veri tipi buna izin vermiyor. Her kasa kendi para birimini taşıdığı için farklı para birimindeki tutarlar da sessizce birbirine karışmıyor. Ofis bazlı finansal tablonun güvenilir olmasının temeli bu.

Mühendislik Kararı 3: Onay Zincirini Durum Makinesi Olarak Modellemek

Sorun. Avans veya masraf talebi hiyerarşi boyunca ilerliyor. Personel talebi oluşturuyor. Ekip lideri onaylarsa talep departman müdürüne gidiyor, müdür onaylarsa finansa geçiyor, finans onaylarsa sonuç zincir boyunca geri dönüyor. Bu akış dağınık boolean alanlarla (isApprovedByManager, isApprovedByFinance gibi) kurulursa tutarsız durumlar oluşabilir. Örneğin müdür onayı olmadan finans onayı görünen bir talep ortaya çıkabilir.

Karar. ExpenseRequest açık bir durum makinesi olarak modellendi:

PENDING_DEPT → PENDING_COMPANY / PENDING_FINANCE → APPROVED → PAID

Talep herhangi bir aşamada REJECTED durumuna geçebiliyor. Geçiş kuralları domain katmanında tanımlı ve departman yetkileri ile hiyerarşik yapı bu noktada onay zincirine bağlanıyor.

Sonuç. Bir talep her an tek ve geçerli bir durumda. Aşama atlanamıyor ve "onaylandı" ile "ödendi" birbirinden ayrı durumlar. Zincirin kuralları hexagonal mimari sayesinde domain katmanında toplu durduğu için bir onay aşaması eklemek ya da sırayı değiştirmek tek bir yerde yapılan bir değişiklik.

Mühendislik Kararı 4: Puan ve Parasal Etkiyi Tek Kayıtta Tutmak

Sorun. Puantaj sisteminin amacı şeffaflıktı. Personelin aldığı primin ya da cezanın nedenini görebilmesi gerekiyordu. Puan bir tabloda, maaş kesintisi ya da prim başka bir tabloda tutulursa ikisi arasındaki bağ kopar ve "bu ay neden daha az aldım" sorusu cevapsız kalır.

Karar. Her performans olayı tek bir PerformanceRecord olarak tutuluyor. Kaydın tipi (REWARD, PENALTY, LEAVE, LATE, OVERTIME), puan etkisi (PointImpact, artı veya eksi) ve parasal etkisi (FinancialImpact, artı veya eksi) aynı satırda. Giriş-çıkış (TimeEntry, fazla mesai bayrağıyla birlikte), izin (LeaveRequest) ve maaş (EmployeeSalary) kayıtlarıyla birlikte puantajın veri temelini oluşturuyor.

Sonuç. Her prim ve ceza puan ve para karşılığıyla birlikte tek bir kayıtta, nedeniyle izlenebiliyor. Personel bir gecikmenin ya da fazla mesainin kendisine puan ve para olarak neye karşılık geldiğini görebiliyor. Projenin en çok işe yarayan özelliği olan şeffaflık bu kayıt yapısına dayanıyor.

Mühendislik Kararı 5: Docker'sız, Tek Binary ile Deploy

Sorun. Kurumsal bir iç sistemin altyapısı kolayca gereğinden ağır hale gelebiliyor: konteyner orkestrasyonu, registry, ek proxy katmanları. Bu sistemin kullanıcıları tek bir organizasyonun personeli. Fazladan her altyapı katmanı bakım yükü ve olası arıza noktası demek.

Karar. Docker kullanılmadı. Go'nun çapraz derleme desteğiyle uygulama Linux için tek bir binary olarak derleniyor, VPS'e kopyalanıyor ve bir systemd servisi olarak çalışıyor.

Sonuç. Deploy, bir dosyanın kopyalanıp servisin yeniden başlatılmasından ibaret. Sunucuda Go çalışma ortamı, konteyner runtime'ı ya da image registry gerekmiyor. Altyapı bilinçli olarak projenin ölçeğine göre seçildi. Ölçek ileride değişirse tek binary her zaman bir konteynere konabilir. Bugün ihtiyaç olmayan karmaşıklığı baştan kurmak ise bakım maliyetini peşin ödemek olurdu.

Kapanış

XTech Nexus CRM, "kimde ne var" sorusuyla başlayıp ofisleri, kasaları, personeli ve ekipmanı aynı veri modelinde birleştiren bir sisteme dönüştü. Projenin değeri şu kararlarda:

Çok ofisli bir yapı için envanter/zimmet takibi, ön muhasebe ya da İK süreçlerini tek sistemde toplamak istiyorsanız veya Go tabanlı bir kurumsal backend arıyorsanız, proje teklifleri için iletişime geçebilirsiniz.