基於ASP.NET ZERO,開發SaaS版供應鏈管理系統

来源:https://www.cnblogs.com/freedyang/archive/2023/09/05/17679280.html
-Advertisement-
Play Games

# 前言 在園子吸收營養10多年,一直沒有貢獻,目前園子危機時刻,除了捐款+會員,也鼓起勇氣,發篇文助力一下。 2018年下半年,公司決定開發一款SaaS版行業供應鏈管理系統,經過選型,確定採用ABP(ASP.NET Boilerplate)框架。為了加快開發效率,購買了商業版的 ASP.NET Z ...


前言

在園子吸收營養10多年,一直沒有貢獻,目前園子危機時刻,除了捐款+會員,也鼓起勇氣,發篇文助力一下。

2018年下半年,公司決定開發一款SaaS版行業供應鏈管理系統,經過選型,確定採用ABP(ASP.NET Boilerplate)框架。為了加快開發效率,購買了商業版的 ASP.NET ZERO(以下簡稱ZERO),選擇ASP.NET Core + Angular的SPA框架進行系統開發(ABP.IO屆時剛剛起步,還很不成熟,因此沒有選用)。

關於ABPZERO,園子里已經有諸多介紹,因此不再贅述。本文側重介紹我們基於ZERO框架開發系統過程中進行的一些優化、調整、擴展部分的內容,方便有需要的園友們瞭解或者參考。

系統架構

系統在2020年7月發佈上線(部署在阿裡雲上),目前有超過500家企業/個人註冊體驗(付費的很少),感興趣的可以在此系統的著陸網站 scm.plus 註冊一個免費賬號體驗一下,歡迎大家的批評指正。

系統架構圖

ZERO框架總體上來說還是不錯的,可以快速的上手,集成的通用功能(版本、租戶、角色、用戶、設置等)初期都可以直接使用,但還達不到直接發佈使用的水準,需要經過諸多的優化調整擴展後才能發佈上線。

A 後端(ASP.NET Core)部分

0、移除不需要的功能:Chat、SignalR、DynamicProperty、GraphQL、IdentityServer4。

基於系統功能定位,移除的這些不需要的功能,使系統儘可能的精簡。

1、Migrations內移除Designer.cs。

在我們的開發環境內,經過測試與驗證,使用mysql資料庫時候,可以安全移除add-migration時候生成的龐大的Designer.cs文件。移除Designer.cs文件時候,需要把該文件內的DbContext與Migration聲明語句移到對應的migration.cs文件內:

[DbContext(typeof(SCMDbContext))]
[Migration("20230811015119_Upgraded_To_Abp_8_3")]
public partial class Upgraded_To_Abp_8_3 : Migration
{
   ...
}

2、替換必要的功能包,確保系統後端可以部署到linux環境:

  • 使用SkiaSharp替換System.Drawing.Common;
  • 使用EPPlus替換NPOI。

3、停用系統預設的外部登錄( Facebook、Google、Microsoft、Twitter等),添加微信掃碼與小程式登錄。

4、停用系統預設的支付選項( Paypal、Stripe等),添加支付寶(Alipay)支付。

5、Excel文件上傳,ZERO預設沒有實現,需要自行添加Excel文件的上傳與導入功能:

  • Excel文件上傳後先緩存該文件;
  • 創建一個後臺Job(HangFire)執行Excel文件的讀取、處理等;
  • Job發送執行後的結果(消息通知)。
[HttpPost]
[AbpMvcAuthorize(AppPermissions.Pages_Txxxs_Excel_Import)]
public async Task<JsonResult> ImportFromExcel()
{
    try
    {
        var jobArgs = await DoImportFromExcelJobArgs(AbpSession.ToUserIdentifier());

        var queueState = new EnqueuedState(GetJobQueueName());
        IBackgroundJobClient hangFireClient = new BackgroundJobClient();
        hangFireClient.Create<ImportTxxxsToExcelJob>(x => x.ExecuteAsync(jobArgs), queueState);

        return Json(new AjaxResponse(new { }));
    }
    catch (Exception ex)
    {
        return Json(new AjaxResponse(new ErrorInfo(ex.Message)));
    }
}

6、圖片與文件上傳存儲,ZERO的預設實現是保存上傳的圖片文件到資料庫內,需要改造存儲到OSS中:

  • 使用MD5哈希首碼,生成OSS文件對象的名稱(含path),提高OSS併發性能:
private static string GetOssObjName(int? tenantId, Guid id, bool isThumbnail)
{
    string tid = (tenantId ?? 0).ToString();
    string ext = isThumbnail ? "thu" : "ori"; //thu - 縮略圖、ori - 原圖/原文件
    string hashStr = BitConverter.ToString(MD5.HashData(Encoding.UTF8.GetBytes(tid)), 0).Replace("-", string.Empty).ToLower();

    return $"{hashStr[..4]}/{tid}/{id}.{ext}";
}
  • 若OSS未啟用或者上傳失敗,則直接存儲到資料庫中:
public async Task SaveAsync(BinaryObject file)
{
    if (file?.Bytes == null) { return; }

    //1、OSS上傳,成功後直接返回
    if (OssPutObject(file.TenantId, file.Id, file.Bytes, isThumbnail: false)) { return; } 

    //2、若OSS未啟用或者上傳失敗,則直接上傳到資料庫中
    await _binaryObjectRepository.InsertAsync(file);
}
  • 獲取時候遵循一樣的邏輯:若OSS未啟用或者獲取不到,則直接自資料庫中獲取;自資料庫獲取成功後要同步資料庫中記錄到OSS中。

7、Webhook功能,需要改造支持推送數據到第三方介面,如:企業微信群、釘釘群、聚水潭API等:

  • 重寫WebhookManager的SignWebhookRequest方法;
  • 重寫DefaultWebhookSender的CreateWebhookRequestMessage、AddAdditionalHeaders、SendHttpRequest方法;
  • 緩存Webhook Subscription:
private SCMWebhookCacheItem SetAndGetCache(int? tenantId, string keyName = "SubscriptionCount")
{
   int tid = tenantId ?? 0; var cacheKey = $"{keyName}-{tid}";

   return _cacheManager.GetSCMWebhookCache().Get(cacheKey, () =>
   {
        int count = 0;
        var names = new Dictionary<string, List<WebhookSubscription>>();

        UnitOfWorkManager.WithUnitOfWork(() =>
        {
            using (UnitOfWorkManager.Current.SetTenantId(tenantId))
            {
                if (_featureChecker.IsEnabled(tid, "SCM.H"))            //Feature 核查
                {
                    var items = _webhookSubscriptionRepository.GetAllList(e => e.TenantId == tenantId && e.IsActive == true);
                    count = items.Count;

                    foreach (var item in items)
                    {
                        if (string.IsNullOrWhiteSpace(item.Webhooks)) { continue; }
                        var whNames = JsonHelper.DeserializeObject<string[]>(item.Webhooks); if (whNames == null) { continue; }
                        foreach (string whName in whNames)
                        {
                            if (names.ContainsKey(whName))
                            {
                                names[whName].Add(item.ToWebhookSubscription());
                            }
                            else
                            {
                                names.Add(whName, new List<WebhookSubscription> { item.ToWebhookSubscription() });
                            }
                        }
                    }
                }
            }
        });

        return new SCMWebhookCacheItem(count, names);
    });
}

8、在WebHostModule中設定只有一臺Server執行後臺Work,避免多台Server重覆執行:

public override void PostInitialize()
{
    ...

    string defaultEndsWith = _appConfiguration["Job:DefaultEndsWith"];
    if (string.IsNullOrWhiteSpace(defaultEndsWith)) { defaultEndsWith = "01"; }
    if (AppVersionHelper.MachineName.EndsWith(defaultEndsWith))
    {
        var workManager = IocManager.Resolve<IBackgroundWorkerManager>();

        workManager.Add(IocManager.Resolve<SubscriptionExpirationCheckWorker>());
        workManager.Add(IocManager.Resolve<SubscriptionExpireEmailNotifierWorker>());
        workManager.Add(IocManager.Resolve<SubscriptionPaymentsCheckWorker>());
        workManager.Add(IocManager.Resolve<ExpiredAuditLogDeleterWorker>());
        workManager.Add(IocManager.Resolve<PasswordExpirationBackgroundWorker>());
    }

    ...
}

9、限流功能,ZERO預設沒有實現,通過添加AspNetCoreRateLimit中間件集成限流功能:

  • 採用客戶端ID(ClientRateLimiting)進行設置;
  • 重寫RateLimitConfigurationRegisterResolvers方法,添加定製化的ClientIpHeaderResolveContributor:存在客戶端ID則優先獲取,反之獲取客戶端的IP:
    public class RateLimitConfigurationExtensions : RateLimitConfiguration  
    {
        ...
        public override void RegisterResolvers()
        {
            ClientResolvers.Add(new ClientIpHeaderResolveContributor(SCMConsts.TenantIdCookieName));
        }
    }

    public class ClientIpHeaderResolveContributor : IClientResolveContributor
    {
        private readonly string _headerName;

        public ClientIpHeaderResolveContributor(string headerName)
        {
            _headerName = headerName;     
        }

        public Task<string> ResolveClientAsync(HttpContext httpContext)
        {
            IPAddress clientIp = null;

            var headers = httpContext?.Request?.Headers;
            if (headers != null && headers.Count > 0)
            {
                if (headers.ContainsKey(_headerName))                               //0 scm_tid
                {
                    string clientId = headers[_headerName].ToString();
                    if (!string.IsNullOrWhiteSpace(clientId))
                    {
                        return Task.FromResult(clientId);
                    }
                }

                try
                {
                    if (headers.ContainsKey("X-Real-IP"))                           //1 X-Real-IP
                    {
                        clientIp = IpAddressUtil.ParseIp(headers["X-Real-IP"].ToString());
                    }
                    
                    if (clientIp == null && headers.ContainsKey("X-Forwarded-For")) //2 X-Forwarded-For
                    {
                        clientIp = IpAddressUtil.ParseIp(headers["X-Forwarded-For"].ToString());
                    }
                }
                catch {}

                clientIp ??= httpContext?.Connection?.RemoteIpAddress;             //3 RemoteIpAddress
            }

            return Task.FromResult(clientIp?.ToString());
        }
    }

B 前端(Angular)部分

0、類似後端,移除不需要的功能:Chat、SignalR、DynamicProperty等。

1、拆分精簡service-proxies.ts文件:

  • ZERO使用NSwag生成前端的TypeScript代碼文件service-proxies.ts,全部模塊的都生成到一個文件內,導致該文件非常龐大,最終編譯生成的main.js接近4MB;
  • 按系統執行層次,拆分service-proxies.ts為多個文件,精簡其中的共用代碼,調整module的調用、拆分、懶載入等,最終大幅度減少了main.js的大小(目前是587KB)。

2、優化表格組件primeng table,實現客戶端表格使用狀態的本地存儲:表格列寬、列順序、列顯示隱藏、列固定、分頁設定等。

3、實現客戶端的卡片視圖功能。

4、集成ng-lazyload-image,實現圖片展示的懶載入。

5、集成ngx-markdown,實現markdown格式的線上幫助。

6、業務組件設置為獨立組件,ChangeDetectionStrateg設置為OnPush:

@Component({
    changeDetection: ChangeDetectionStrategy.OnPush,
    templateUrl: './txxxs.component.html',
    standalone: true,
    imports: [...]
})
export class TxxxsComponent extends AppComponentBase {
    ...
    constructor(
        injector: Injector,
        changeDetector: ChangeDetectorRef,
    ) {
        super(injector);
        setInterval(() => { changeDetector.markForCheck(); }, AppConsts.ChangeDetectorMS);
    }
    ...
}

7、儀錶盤升級為工作台,除了可以添加圖表外,也可以添加業務組件(獨立組件)。

8、路由直接鏈接業務組件,實現懶載入:

import { Route } from '@angular/router';
export default [
    { path: 'p120303/t12030301s', loadComponent: () => import('./t12030301s.component').then(c => c.T12030301sComponent), ... },
    { path: 'p120405/t12040501s', loadComponent: () => import('./t12040501s.component').then(c => c.T12040501sComponent), ... },
    { path: 'p120405/t12040502s', loadComponent: () => import('./t12040502s.component').then(c => c.T12040502sComponent), ... },
] as Route[];

9、通過webpackInclude,減少打包後的文件數量;使用webpackChunkName設定打包後的文件名:

function registerLocales(
    resolve: (value?: boolean | Promise<boolean>) => void,
    reject: any,
    spinnerService: NgxSpinnerService
) {
    if (shouldLoadLocale()) {
        let angularLocale = convertAbpLocaleToAngularLocale(abp.localization.currentLanguage.name);
        import(
            /* webpackInclude: /(en|en-GB|zh|zh-Hans|zh-Hant)\.mjs$/ */
            /* webpackChunkName: "angular-common-locales" */
            `/node_modules/@angular/common/locales/${angularLocale}.mjs`).then((module) => {
                registerLocaleData(module.default);
                resolve(true);
                spinnerService.hide();
            }, reject);
    } else {
        resolve(true);
        spinnerService.hide();
    }
}

C 小程式(Vue3)部分

後端部分已經實現小程式集成微信登錄,後端輸出的語言文本與API等小程式都可以直接調用,因此小程式的開發實現就相對比較容易,只需要實現必要的UI界面即可。

  • 小程式採用 uni-app(vue3) 框架進行開發,整體效率較高。
  • 有部分代碼可以基於前端 Angular 的代碼複製後稍加調整後即可使用。
  • 目前只輸出了微信小程式,方便同企業微信群內的消息推送一體化集成。
  • 後端部分實現的Webhook功能,可以直接推送消息到企業微信群內,用戶可以單擊消息卡片,直接打開微信小程式內對應的頁面,查看數據或者進行其他的維護操作。
  • 小程式中需要在onLaunch中進行路由守衛(登錄攔截),以處理通過分享單獨頁面或者企業微信群內通過消息卡片直接打開小程式頁面的許可權核查。

總結

若沒有優秀的工具框架支持,開發SaaS化系統並不是一件容易的事。基於ABP框架,使用ZERO工具,極大的降低了開發SaaS化系統的門檻,也促成了這套系統的實踐與發佈。

本文簡要介紹了我們實現這套系統中的一些要點,供有需要的人瞭解參考,就算是拋磚引玉吧!


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • PEP703是未來去除GIL的計劃,當然現在提案還在繼續修改,但大致方向確定了。 對於實現細節我沒啥興趣多說,挑幾個我比較在意的點講講。 ## 儘量少依賴原子操作的引用計數 沒了GIL之後會出現兩個以上的線程同時操作同一個Python對象的情況,首先要解決的是引用計數的計算不能出岔子,否則整個記憶體管 ...
  • 享元模式在主流的標準里是放到結構大類下的,但是我感覺這個模式的最終作用也是為了獲取一個類,所以我將其劃分到創建大類下。 # What is Flyweight Pattern Flyweight 是指輕量級的。 享元模式旨在支持大量細粒度的對象共用,以減少記憶體消耗。該模式通過共用相似對象的部分狀態, ...
  •  **多個word 文檔 轉化成 PDF 文件, 最後合併成一個PDF文件** ``` import os from win32com import client from PyPDF2 import PdfMerger # 使用PdfMerger def wordToPdf(folder): # ...
  • 2021年上半年,擼了個rust cli開發的框架,基本上把交互模式,子命令提示這些cli該有的常用功能做進去了。項目地址:[https://github.com/jiashiwen/interactcli-rs。](https://github.com/jiashiwen/interactcli- ...
  • 節表(Section Table)是Windows PE/COFF格式的可執行文件中一個非常重要的數據結構,它記錄了各個代碼段、數據段、資源段、重定向表等在文件中的位置和大小信息,是操作系統載入文件時根據節表來進行各個段的映射和初始化的重要依據。節表中的每個記錄則被稱為`IMAGE_SECTION_... ...
  • # 背景: ### 介紹 天網風控**靈璣**系統是基於記憶體計算實現的高吞吐低延遲線上計算服務,提供滑動或滾動視窗內的count、distinctCout、max、min、avg、sum、std及區間分佈類的線上統計計算服務。客戶端和服務端底層通過netty直接進行tcp通信,且服務端也是基於net ...
  • 巨集的一些作用,包括但不限於這些 1. 定義一個變數、字元串、類型 2. 定義一個函數、條件表達式 3. 條件編譯、調試信息,異常類 4. 定義結構體、命名空間 5. 定義模版、枚舉、函數對象 `#define`巨集定義在C++中用於定義常量、函數、條件編譯、字元串、條件表達式、變數、註釋、調試信息、類 ...
  • [toc] | 說明 | 內容 | | | | | 漏洞編號 | CVE-2017-10271 | | 漏洞名稱 | Weblogic 其中使用了XMLDecoder來解析用戶傳入的XML數據在解析的過程中出現反序列化漏洞,導致可執行任意命令 | | 修複方案 | 打補丁上設備升級組件 | ### ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...