经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » 程序设计 » ASP.net » 查看文章
基于ASP.NET ZERO，开发SaaS版供应链管理系统
来源：cnblogs　　作者：freed　　时间：2023/9/6 10:56:52　　对本文有异议

前言

在园子吸收营养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文件内：

  1. [DbContext(typeof(SCMDbContext))]
  2. [Migration("20230811015119_Upgraded_To_Abp_8_3")]
  3. public partial class Upgraded_To_Abp_8_3 : Migration
  4. {
  5.    ...
  6. }

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发送执行后的结果（消息通知）。
  1. [HttpPost]
  2. [AbpMvcAuthorize(AppPermissions.Pages_Txxxs_Excel_Import)]
  3. public async Task<JsonResult> ImportFromExcel()
  4. {
  5.     try
  6.     {
  7.         var jobArgs = await DoImportFromExcelJobArgs(AbpSession.ToUserIdentifier());
  9.         var queueState = new EnqueuedState(GetJobQueueName());
  10.         IBackgroundJobClient hangFireClient = new BackgroundJobClient();
  11.         hangFireClient.Create<ImportTxxxsToExcelJob>(x => x.ExecuteAsync(jobArgs), queueState);
  13.         return Json(new AjaxResponse(new { }));
  14.     }
  15.     catch (Exception ex)
  16.     {
  17.         return Json(new AjaxResponse(new ErrorInfo(ex.Message)));
  18.     }
  19. }

6、图片与文件上传存储，ZERO的默认实现是保存上传的图片文件到数据库内，需要改造存储到OSS中：

  • 使用MD5哈希前缀，生成OSS文件对象的名称（含path），提高OSS并发性能：
  1. private static string GetOssObjName(int? tenantId, Guid id, bool isThumbnail)
  2. {
  3.     string tid = (tenantId ?? 0).ToString();
  4.     string ext = isThumbnail ? "thu" : "ori"; //thu - 缩略图、ori - 原图/原文件
  5.     string hashStr = BitConverter.ToString(MD5.HashData(Encoding.UTF8.GetBytes(tid)), 0).Replace("-", string.Empty).ToLower();
  7.     return $"{hashStr[..4]}/{tid}/{id}.{ext}";
  8. }
  • 若OSS未启用或者上传失败，则直接存储到数据库中：
  1. public async Task SaveAsync(BinaryObject file)
  2. {
  3.     if (file?.Bytes == null) { return; }
  5.     //1、OSS上传，成功后直接返回
  6.     if (OssPutObject(file.TenantId, file.Id, file.Bytes, isThumbnail: false)) { return; } 
  8.     //2、若OSS未启用或者上传失败，则直接上传到数据库中
  9.     await _binaryObjectRepository.InsertAsync(file);
  10. }
  • 获取时候遵循一样的逻辑：若OSS未启用或者获取不到，则直接自数据库中获取；自数据库获取成功后要同步数据库中记录到OSS中。

7、Webhook功能，需要改造支持推送数据到第三方接口，如：企业微信群、钉钉群、聚水潭API等：

  • 重写WebhookManager的SignWebhookRequest方法；
  • 重写DefaultWebhookSender的CreateWebhookRequestMessage、AddAdditionalHeaders、SendHttpRequest方法；
  • 缓存Webhook Subscription：
  1. private SCMWebhookCacheItem SetAndGetCache(int? tenantId, string keyName = "SubscriptionCount")
  2. {
  3.    int tid = tenantId ?? 0; var cacheKey = $"{keyName}-{tid}";
  5.    return _cacheManager.GetSCMWebhookCache().Get(cacheKey, () =>
  6.    {
  7.         int count = 0;
  8.         var names = new Dictionary<string, List<WebhookSubscription>>();
  10.         UnitOfWorkManager.WithUnitOfWork(() =>
  11.         {
  12.             using (UnitOfWorkManager.Current.SetTenantId(tenantId))
  13.             {
  14.                 if (_featureChecker.IsEnabled(tid, "SCM.H"))            //Feature 核查
  15.                 {
  16.                     var items = _webhookSubscriptionRepository.GetAllList(e => e.TenantId == tenantId && e.IsActive == true);
  17.                     count = items.Count;
  19.                     foreach (var item in items)
  20.                     {
  21.                         if (string.IsNullOrWhiteSpace(item.Webhooks)) { continue; }
  22.                         var whNames = JsonHelper.DeserializeObject<string[]>(item.Webhooks); if (whNames == null) { continue; }
  23.                         foreach (string whName in whNames)
  24.                         {
  25.                             if (names.ContainsKey(whName))
  26.                             {
  27.                                 names[whName].Add(item.ToWebhookSubscription());
  28.                             }
  29.                             else
  30.                             {
  31.                                 names.Add(whName, new List<WebhookSubscription> { item.ToWebhookSubscription() });
  32.                             }
  33.                         }
  34.                     }
  35.                 }
  36.             }
  37.         });
  39.         return new SCMWebhookCacheItem(count, names);
  40.     });
  41. }

8、在WebHostModule中设定只有一台Server执行后台Work，避免多台Server重复执行：

  1. public override void PostInitialize()
  2. {
  3.     ...
  5.     string defaultEndsWith = _appConfiguration["Job:DefaultEndsWith"];
  6.     if (string.IsNullOrWhiteSpace(defaultEndsWith)) { defaultEndsWith = "01"; }
  7.     if (AppVersionHelper.MachineName.EndsWith(defaultEndsWith))
  8.     {
  9.         var workManager = IocManager.Resolve<IBackgroundWorkerManager>();
  11.         workManager.Add(IocManager.Resolve<SubscriptionExpirationCheckWorker>());
  12.         workManager.Add(IocManager.Resolve<SubscriptionExpireEmailNotifierWorker>());
  13.         workManager.Add(IocManager.Resolve<SubscriptionPaymentsCheckWorker>());
  14.         workManager.Add(IocManager.Resolve<ExpiredAuditLogDeleterWorker>());
  15.         workManager.Add(IocManager.Resolve<PasswordExpirationBackgroundWorker>());
  16.     }
  18.     ...
  19. }

9、限流功能，ZERO默认没有实现，通过添加AspNetCoreRateLimit中间件集成限流功能：

  • 采用客户端ID（ClientRateLimiting）进行设置；
  • 重写RateLimitConfiguration的RegisterResolvers方法，添加定制化的ClientIpHeaderResolveContributor：存在客户端ID则优先获取，反之获取客户端的IP：
  1.     public class RateLimitConfigurationExtensions : RateLimitConfiguration  
  2.     {
  3.         ...
  4.         public override void RegisterResolvers()
  5.         {
  6.             ClientResolvers.Add(new ClientIpHeaderResolveContributor(SCMConsts.TenantIdCookieName));
  7.         }
  8.     }
  10.     public class ClientIpHeaderResolveContributor : IClientResolveContributor
  11.     {
  12.         private readonly string _headerName;
  14.         public ClientIpHeaderResolveContributor(string headerName)
  15.         {
  16.             _headerName = headerName;     
  17.         }
  19.         public Task<string> ResolveClientAsync(HttpContext httpContext)
  20.         {
  21.             IPAddress clientIp = null;
  23.             var headers = httpContext?.Request?.Headers;
  24.             if (headers != null && headers.Count > 0)
  25.             {
  26.                 if (headers.ContainsKey(_headerName))                               //0 scm_tid
  27.                 {
  28.                     string clientId = headers[_headerName].ToString();
  29.                     if (!string.IsNullOrWhiteSpace(clientId))
  30.                     {
  31.                         return Task.FromResult(clientId);
  32.                     }
  33.                 }
  35.                 try
  36.                 {
  37.                     if (headers.ContainsKey("X-Real-IP"))                           //1 X-Real-IP
  38.                     {
  39.                         clientIp = IpAddressUtil.ParseIp(headers["X-Real-IP"].ToString());
  40.                     }
  41.                     
  42.                     if (clientIp == null && headers.ContainsKey("X-Forwarded-For")) //2 X-Forwarded-For
  43.                     {
  44.                         clientIp = IpAddressUtil.ParseIp(headers["X-Forwarded-For"].ToString());
  45.                     }
  46.                 }
  47.                 catch {}
  49.                 clientIp ??= httpContext?.Connection?.RemoteIpAddress;             //3 RemoteIpAddress
  50.             }
  52.             return Task.FromResult(clientIp?.ToString());
  53.         }
  54.     }

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：

  1. @Component({
  2.     changeDetection: ChangeDetectionStrategy.OnPush,
  3.     templateUrl: './txxxs.component.html',
  4.     standalone: true,
  5.     imports: [...]
  6. })
  7. export class TxxxsComponent extends AppComponentBase {
  8.     ...
  9.     constructor(
  10.         injector: Injector,
  11.         changeDetector: ChangeDetectorRef,
  12.     ) {
  13.         super(injector);
  14.         setInterval(() => { changeDetector.markForCheck(); }, AppConsts.ChangeDetectorMS);
  15.     }
  16.     ...
  17. }

7、仪表盘升级为工作台，除了可以添加图表外，也可以添加业务组件（独立组件）。

8、路由直接链接业务组件，实现懒加载：

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

9、通过webpackInclude，减少打包后的文件数量；使用webpackChunkName设定打包后的文件名：

  1. function registerLocales(
  2.     resolve: (value?: boolean | Promise<boolean>) => void,
  3.     reject: any,
  4.     spinnerService: NgxSpinnerService
  5. ) {
  6.     if (shouldLoadLocale()) {
  7.         let angularLocale = convertAbpLocaleToAngularLocale(abp.localization.currentLanguage.name);
  8.         import(
  9.             /* webpackInclude: /(en|en-GB|zh|zh-Hans|zh-Hant)\.mjs$/ */
  10.             /* webpackChunkName: "angular-common-locales" */
  11.             `/node_modules/@angular/common/locales/${angularLocale}.mjs`).then((module) => {
  12.                 registerLocaleData(module.default);
  13.                 resolve(true);
  14.                 spinnerService.hide();
  15.             }, reject);
  16.     } else {
  17.         resolve(true);
  18.         spinnerService.hide();
  19.     }
  20. }

C 小程序（Vue3）部分

后端部分已经实现小程序集成微信登录，后端输出的语言文本与API等小程序都可以直接调用，因此小程序的开发实现就相对比较容易，只需要实现必要的UI界面即可。

  • 小程序采用 uni-app(vue3) 框架进行开发，整体效率较高。
  • 有部分代码可以基于前端 Angular 的代码复制后稍加调整后即可使用。
  • 目前只输出了微信小程序，方便同企业微信群内的消息推送一体化集成。
  • 后端部分实现的Webhook功能，可以直接推送消息到企业微信群内，用户可以单击消息卡片，直接打开微信小程序内对应的页面，查看数据或者进行其他的维护操作。
  • 小程序中需要在onLaunch中进行路由守卫（登录拦截），以处理通过分享单独页面或者企业微信群内通过消息卡片直接打开小程序页面的权限核查。

总结

若没有优秀的工具框架支持，开发SaaS化系统并不是一件容易的事。基于ABP框架，使用ZERO工具，极大的降低了开发SaaS化系统的门槛，也促成了这套系统的实践与发布。

本文简要介绍了我们实现这套系统中的一些要点，供有需要的人了解参考，就算是抛砖引玉吧！

原文链接：https://www.cnblogs.com/freedyang/p/17679280.html

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

ASP.net热门文章

  • 【Dotnet 工具箱】WPF UI - 现代化设计的开源 WPF 框架
  • net core 使用 SqlSugar
  • .NETCore下CI/CD之自动化测试
  • .net core部署到linux可能碰到的问题
  • Abp vNext 自定义 Ef Core 仓储引发异常
  • .NetCore 消息队列的使用
  • .NetCore WebApi——基于JWT的简单身份认证与授权（Swagger）
  • Abp.NHibernate连接PostgreSQl数据库
  • ModelValidator基于元数据的验证
  • .NET MAUI 安卓应用开发初体验

    • ASP.net推荐文章

  • Gradio.NET 支持 .NET 8 简化 Web 应用开发
  • .NET 轻量化定时任务调度 FreeScheduler
  • WPF 模仿前端大佬写一个Hover效果
  • WPF 模拟UWP原生窗口样式——亚克力|云母材质、自定义标题栏样式、原生DWM动画 （附我封装好的类）
  • .NET 音频采集
  • .NET8 Blazor 从入门到精通：（三）类库和表单
  • wpf 如何7步写一个badge控件
  • .NET 高效Nuget管理工具（开源）
  • .NET 8 跨平台高性能边缘采集网关
  • .NET 窗口/屏幕录制

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号