基於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屆時剛剛起步，還很不成熟，因此沒有選用）。

關於ABP與ZERO，園子里已經有諸多介紹，因此不再贅述。本文側重介紹我們基於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）進行設置；
  • 重寫RateLimitConfiguration的RegisterResolvers方法，添加定製化的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
更多相關文章
  • 我們能從PEP 703中學到什麼
    PEP703是未來去除GIL的計劃，當然現在提案還在繼續修改，但大致方向確定了。 對於實現細節我沒啥興趣多說，挑幾個我比較在意的點講講。 ## 儘量少依賴原子操作的引用計數 沒了GIL之後會出現兩個以上的線程同時操作同一個Python對象的情況，首先要解決的是引用計數的計算不能出岔子，否則整個記憶體管 ...
  • Flyweight Pattern —— Creational Class
    享元模式在主流的標準里是放到結構大類下的，但是我感覺這個模式的最終作用也是為了獲取一個類，所以我將其劃分到創建大類下。 # What is Flyweight Pattern Flyweight 是指輕量級的。 享元模式旨在支持大量細粒度的對象共用，以減少記憶體消耗。該模式通過共用相似對象的部分狀態， ...
  • 多個word轉化成PDF文件後再合併成一個PDF文件
     **多個word 文檔 轉化成 PDF 文件， 最後合併成一個PDF文件** ``` import os from win32com import client from PyPDF2 import PdfMerger # 使用PdfMerger def wordToPdf(folder): # ...
  • 文盤Rust -- 生命周期問題引發的 static hashmap 鎖
    2021年上半年，擼了個rust cli開發的框架，基本上把交互模式，子命令提示這些cli該有的常用功能做進去了。項目地址：[https://github.com/jiashiwen/interactcli-rs。](https://github.com/jiashiwen/interactcli- ...
  • 2.4 PE結構：節表詳細解析
    節表（Section Table）是Windows PE/COFF格式的可執行文件中一個非常重要的數據結構，它記錄了各個代碼段、數據段、資源段、重定向表等在文件中的位置和大小信息，是操作系統載入文件時根據節表來進行各個段的映射和初始化的重要依據。節表中的每個記錄則被稱為`IMAGE_SECTION_... ...
  • jdk17下netty導致堆記憶體瘋漲原因排查
    # 背景： ### 介紹 天網風控**靈璣**系統是基於記憶體計算實現的高吞吐低延遲線上計算服務，提供滑動或滾動視窗內的count、distinctCout、max、min、avg、sum、std及區間分佈類的線上統計計算服務。客戶端和服務端底層通過netty直接進行tcp通信，且服務端也是基於net ...
  • c++中的巨集#define用途
    巨集的一些作用，包括但不限於這些 1. 定義一個變數、字元串、類型 2. 定義一個函數、條件表達式 3. 條件編譯、調試信息，異常類 4. 定義結構體、命名空間 5. 定義模版、枚舉、函數對象 `#define`巨集定義在C++中用於定義常量、函數、條件編譯、字元串、條件表達式、變數、註釋、調試信息、類 ...
  • weblogic-10.3.6-'wls-wsat'-XMLDecoder反序列化漏洞-(CVE-2017-10271)
    [toc] | 說明 | 內容 | | | | | 漏洞編號 | CVE-2017-10271 | | 漏洞名稱 | Weblogic 其中使用了XMLDecoder來解析用戶傳入的XML數據在解析的過程中出現反序列化漏洞，導致可執行任意命令 | | 修複方案 | 打補丁上設備升級組件 | ### ...
一周排行
    -Advertisement-
    Play Games
  • WPF 已知問題 監聽 WMI 事件導致觸摸失效
    示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後，項目結構如下所示： MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread]特性
    [STAThread] 特性用於需要與 COM 組件交互的應用程式，尤其是依賴單線程模型（如 Windows Forms 應用程式）的組件。在 STA 模式下，線程擁有自己的消息迴圈，這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • UWP WinUI3 傳入 AddHandler 的 RoutedEventHandler 類型與事件所需不匹配將拋出參數異常
    在WinForm中使用全局異常捕獲處理 在WinForm應用程式中，全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理，可以有效地捕獲並處理未預見的異常，從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • .NET 多版本 WinForm 開源控制項庫 SunnyUI
    前言 給大家推薦一款開源的 Winform 控制項庫，可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫，同時也提供了工具類庫、擴展 ...
  • .net core8 使用Swagger（附當前源碼）
    說明 該文章是屬於OverallAuth2.0系列文章，每周更新一篇該系列文章（從0到1完成系統開發）。 該系統文章，我會儘量說的非常詳細，做到不管新手、老手都能看懂。 說明：OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友，請關註我吧(*^▽^*) ...
  • WPF 什麼時候 VisualTreeHelper.GetDescendantBounds 將返回無窮大
    一、下載安裝 1.下載git 必須先下載並安裝git，再TortoiseGit下載安裝 git安裝參考教程：https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit，Git客戶端，32/6 ...
  • C# 開源教程帶你輕鬆掌握數據結構與演算法
    前言 在項目開發過程中，理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼，還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程：Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 第22篇 生成proto文件bat腳本
    1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 記一次 .NET某上位機視覺程式 卡死分析
    一：背景 1. 講故事 前段時間有位朋友找到我，說他的窗體程式在客戶這邊出現了卡死，讓我幫忙看下怎麼回事？dump也生成了，既然有dump了那就上 windbg 分析吧。 二：WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死，入口門檻很低，後續往下分析就不一定了，不管怎麼說先用 !clrsta ...
  • 醫學DICOM文件與PACS系統進行數據傳輸
    前言 人工智慧時代，人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API，工具不僅易於集成，還具備高效處理能力。 本文將介紹一款如何利用這些API，為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...
所有分類