MaviMasa Kaynak Kodları
MaviMasa’nın kaynak kodlu için karar verdiyseniz, aşağıdaki bilgiler size işinizi kolaylaştıracak temel bilgiler sunar. Bu belge, yazılımın mimarisini, geliştirme ortamını ve değişiklik yapma süreçlerini detaylı şekilde açıklar.
MaviMasa Kaynak Kodları: Temel Bilgiler
DestekMaviMasa, ASP.NET Core 6 MVC tabanlı, C# dilinde geliştirilmiş bir uygulamadır. Veritabanı olarak Microsoft SQL Server kullanılmaktadır.
Gerekli Yazılımlar:
- Microsoft SQL Server 2012 veya üzeri (ücretsiz “Express” sürümleri tam olarak yeterlidir).
- Visual Studio 2017 veya sonraki sürümler (ücretsiz sürümler de kullanılabilir).
⚠️ Önemli: Kaynak kodu, bir Visual Studio çözümü (solution) dür. Kodlar üzerinde çalışabilmek için bu entegre geliştirme ortamına (IDE) ihtiyacınız olacaktır.
Kapsamlı Kaynak Kod Erişimi
Kaynak kodu , tüm uygulama kaynak koduna erişim anlamına gelir. Bu sayede:
- Tüm iş mantığına erişebilirsiniz
- Her modülde değişiklik yapabilirsiniz
- Özel entegrasyonlar oluşturabilirsiniz
- Sistem düzeyinde özelleştirmeler yapabilirsiniz
🔄 Dikkat: Yeni bir sürüme güncellemek için, sadece “yeni dosyaları” indirip kendi modifikasyonlarınızla el ile birleştirme (merge) yapmanız gerekmektedir.
Bilet İşlemleri (Ticket Operations)
Uygulamanın büyük bir kısmı, iş mantığını barındıran “BusinessLayer” adlı isim uzayında (namespace) yer alır. Bu klasörde şu işlemler için sınıflar mevcuttur:
- Yeni bilet oluşturma
- Not ekleme
- Dosya ekleme
- Kullanıcı yönetimi
- E-posta gönderimi ve alımı
✅ İş mantığı bu klasörde yoğunlaşır. Kod yapılandırması standart ve anlaşılır olacak şekilde tasarlanmıştır.
Model, Görünüm ve Kontroler Yapısı
ASP.NET Core MVC prensibine uygun olarak, MaviMasa sistemi aşağıdaki yapıda düzenlenmiştir:
| Klasör | Açıklama |
|---|---|
| Models | MVC model sınıfları (biletler, kullanıcılar, kategoriler vb.) |
| Controllers | Kullanıcı girişlerine yanıt veren kontrolör sınıfları |
Bu yapı, tipik bir modern ASP.NET uygulamasında görülen standart bir dizin yapısıdır. Geliştirici deneyimli olanlar için hızlı bir şekilde tanınırlık sağlar.
MaviMasa Yardımcı Sınıfları (Helper Classes)
Tüm yardımcı fonksiyonlar, “Destek.Utils” adlı isim uzayında toplanmıştır.
Bu kütüphane, birbirinden bağımsız projelerinde kullanılmak üzere geliştirilmiş, yeniden kullanılabilir yardımcı metodlar içerir. İçerdiği destekleyici işlevler şunlardır:
- Dize (string) işlemleri
- Active Directory entegrasyonu
- Veritabanı işlemleri
- HTML ve BBCode ayrıştırma
- Destek e-postalarının otomatik olarak gönderilmesi
- Spam filtresi uygulama
- Hata yakalama ve günlük (logging) işlemleri
💡 İpucu: Bu klasörde değişiklik yapmanız genellikle tavsiye edilmez. Kodun kararlılığı, tutarlılığı ve performansı açısından bu klasör, sürüm yönetimine açık olmayan stabil bir yapıdadır.
MaviMasa’nın ORM (Nesne-İlişkisel Eşleme) Kullanımı
Dapper.NET Mikro-ORM
DestekMaviMasa, “Dapper.NET” adlı açık kaynaklı mikro-ORM kullanır. Bu teknoloji, StackOverflow.com gibi büyük ölçekli platformların da kullandığı, yüksek performanslı bir araçtır.
Dapper.NET’in Başlıca Özellikleri:
SqlConnectionnesnesini,QueryveExecutemetodlarıyla genişletir- SQL sorgularını nesneler olarak kolayca dönüştürür
- Veritabanı işlemlerini hızlı, basit ve kod okunabilirliği yüksek şekilde yapar
🔍 Daha fazla bilgi için: Dapper.NET’in resmi belgelerine dapper-dotnet adresinden ulaşabilirsiniz.
Veritabanı İstekleri: Kod ile Direkt İşlemler
Bazı durumlarda, Dapper.NET gibi bir ORM kullanmak yerine, SQL sorguları doğrudan el ile veritabanına gönderilmektedir.
✅ Bu durum, bilinçli bir tasarım seçimidir.
Neden?
- Kod daha okunabilir hâle gelir
- Performans kaybı olmaz
- Özellikle karmaşık sorgularda kontrol ve hız açısından önemli avantajlar sunar
🎯 MaviMasa ekibi, kodun basit, akıllı ve yüksek okunabilirlikte olması üzerine yoğunlaşmıştır.
Sorumluluklar ve Lisans Kısıtlamaları
“Kaynak kodları üzerinde değişiklik yapabilir miyim?”
✅ Evet. İstediğiniz kadar kod düzenlemesi, özelleştirme ve geliştirme yapabilirsiniz.
⛔ Ancak aşağıdaki durumlar yasaklanmıştır:
- MaviMasa uygulamasını veya modifiye edilmiş halini dağıtmak
- Orijinal ya da geliştirilmiş versiyonu yeniden paketlemek
🔒 Bu kural, hem teknik özgürleşmeyi hem de yasal korumayı dengelemek için tasarlanmıştır.
Kendi Değişikliklerinizi Yeni Sürüme Nasıl Birleştireceğiniz?
Her yeni sürümden sonra, kendi üzerinde değişikliklerinizin yeni sürümle uyumlu hâle getirilmesi gerekir.
Önerilen Yöntem: Farklılık Analizi ve Birleştirme Araçları
- WinMerge, Beyond Compare, Visual Studio Diff Tool gibi birleştirme araçlarını kullanın
- Eski ve yeni sürüm arasındaki farkları inceleyin
- Kendi özelleştirmelerinizin kaybolduğundan emin olun
- Uyumlu bir şekilde el ile birleştirme işlemi yapın
🛠️ İpucu: Sürüm kontrol (örneğin Git) sistemlerini kullanmanız, bu süreçte çok büyük kolaylık sağlar.
Sonuç: MaviMasa Kaynak Kodu, Daha Yerel Bir Deneyim Sunar
MaviMasa, yalnızca bir destek çözümü değil;
Kendi altyapınızda geliştirilebilir, özelleştirilebilir ve sürdürülebilir bir platformdur.
🎯 Bu sayede:
- Kurumsal iş süreçleriyle tam uyum sağlarsınız
- Güvenlik, veri kontrolü ve erişim politikası tamamen sizin elinizdedir
- Sistem içi entegrasyonlar kolayca gerçekleştirilir
- Teknik ekibiniz, sistemi kendi ihtiyaçlarınıza göre şekillendirebilir
💼 MaviMasa’ya sahip olmak, sadece bir yazılım almaktan daha fazlasıdır.
Bu, güçlü bir destek ekibini, esnek bir altyapıyı ve teknik kontrolü kendinizin eline almanız demektir.
🔐 Kaynak kodu ile gelen özgürlük, sizin kontrolünüzü temsil eder.
Yazılımınızı kendi kurallarınıza göre şekillendirin,
MaviMasa ile sadece işleyen bir sistem değil, sadece sizin için çalışan bir sistem oluşturun.