Kurulum
AltCommerce ASP.NET Core 9 üzerinde çalışır. Veritabanı olarak PostgreSQL 17 veya SQL Server kullanabilirsiniz. Kurulum sizin sunucunuza yapılır; uygulama yalnızca yerel arayüzü dinler, dışarıya bir ters vekil sunucu üzerinden açılır.
yapılandırma · App_Data/appsettings.json
- {
- "ConnectionStrings": {
- "ConnectionString": "Host=localhost;Database=altcommerce;...",
- "DataProvider": "postgresql"
- }
- }
Bölüm adı ConnectionStrings olmalıdır. Yanlış isimle uygulama veritabanını kurulmamış sayar, her isteği kurulum sihirbazına yönlendirir ve veri taşımaları hiç çalışmaz. Dosya BOM'suz UTF-8 olmalıdır.
Modül geliştirme
Modüller ayrı projelerdir ve çalışma zamanında yüklenir. Çekirdeği değiştirmeden özellik eklemenin yolu budur; sürüm yükseltmesinde modülünüz birlikte taşınır.
Bir modül en az bir plugin.json tanım dosyası ve bir eklenti sınıfı içerir. Yönetim ekranı gerekiyorsa bir alan denetleyicisi ve görünüm eklenir. Veri şeması değişikliği gerekiyorsa bir veri taşıma sınıfı yazılır — el ile SQL çalıştırmayın; taşımalar sürüm kaydı tutar.
Asistan aracı yazmak
Her araç, gerektirdiği izni kendisi bildirir. Alan adı iznin nokta öncesinden türetilir, dolayısıyla elle güncellenecek bir eşleme tablosu yoktur. Bağımlılık kaydı otomatiktir.
örnek · salt okunur araç
- public class DusukStokTool : BaseAgentTool
- {
- public override string Name => "dusuk_stok";
-
- public override string RequiredPermissionSystemName =>
- StandardPermission.Reports.LOW_STOCK;
-
- public override async Task<string> ExecuteAsync(...)
- {
- // servis katmanini cagirin, ham depoyu degil:
- // erisim ve magaza kapsami suzgecleri boylece uygulanir
- }
- }
Yazma yapan bir araçta RequiresConfirmation değerini true yapın ve DescribeAction içinde ne olacağını tek cümleyle anlatın. O cümle kullanıcının onay kutusunda göreceği metindir.
Sürüm yükseltme
Çekirdek güncellemesi elle taşınan bir yama değil, tekrar çalıştırılabilir bir dönüşümle gelir. Sizin özelleştirmeleriniz çekirdekten ayrı bir katmanda durduğu için, iki sürüm arasındaki fark hesaplanıp kurulumunuza yama olarak uygulanabilir.
Pratikte bu şu demek: markalama ve yeniden tasarım, güncelleme almanızı engellemiyor. Özelleştirilmiş kurulumların çoğunda kaybedilen yetenek burada duruyor.
Bakım
Kurulumla birlikte yedekleme, sağlık kontrolü ve bildirim betikleri gelir. Yedekler zamanlanmış görevlerle alınır, sağlık kontrolü uygulamanın ayakta olduğunu düzenli aralıklarla doğrular ve sorun halinde bildirim gönderir.
Yedeğiniz geri yüklenebilir olmadıkça yedek sayılmaz. Bakım kapsamındaki kurulumlarda geri yükleme tatbikatını biz yapıyoruz.