前言

之前分享中台 Admin.Core 的模块代码生成器，陆续也结合群友们的反馈，完善了一些功能和模板上的优化，而本篇将基于此代码生成器生成一个通用代码生成器模块的基本代码

后续再在此代码的基础上进行完善，制作一个通用的代码生成器

要做一个项目，首先我们要弄清楚需求，这里简单规划了下所需要的功能模块

可从脑图中看到，基本除了项目生成这块需要添加代码，相关模块的增删改查都可以由代码生成器来生成

前言

之前已经分享过几篇关于中台项目框架的文章，相关介绍就不再赘述

所谓工欲善其事必先利其器，一个项目拥有一个代码生成器是很有必要的，能够大大的节省时间，减少手误，提供开发效率(ps:特别小团队搞微服务但是没有代码生成器，简直要了老命)

本文将分享如何在中台框架项目 Admin.Core 中添加代码生成器模块，助力项目的快速开发

准备

作为本系列的第一篇第一个模块，我们将从拉取代码开始，当然也可以通过仓库的脚手架直接创建自己的项目，本系列后续都将直接基于源码开发，保持框架的同步更新

前言

Github Actions是什么？是 GitHub 提供的一种持续集成/持续部署（CI/CD）工作流程自动化服务,助力项目的自动化构建、测试和部署。
依托于平台，本文将分享使用 GitHub Actions 完成对一个.Net Core+Vue 的前后端分离项目 zhontai 的构建，并使用 docker 部署到云服务器(阿里云)

使用说明

经过一番尝试学习，个人感受是其功能齐全,文档完善，使用 GitHub 托管仓库完成自己的 CI/CD，不再需要自己搞构建服务了。
关于使用费用问题：每个用户/组织都有免费的使用额度：2000 分钟/月, 不同的项目归类到不同的组织，完全足够使用了。

zhontai 项目

基于 .Net7.x + Vue 等技术的前后端分离后台权限管理系统，想你所想的开发理念，希望减少工作量，帮助大家实现快速开发

后端地址：https://github.com/zhontai/Admin.Core 前端地址：https://github.com/zhontai/admin.ui.plus

• 代码生成器：

  • 后端：https://github.com/yimogit/Admin.Core.Dev Fork 自 https://github.com/share36/Admin.Core.Dev
  • 前端：https://github.com/yimogit/admin.ui.plus.dev Fork 自 https://github.com/share36/admin.ui.plus.dev

• 官方默认项目模板生成：

  • dotnet new install ZhonTai.Template
  • dotnet new MyApp -n MyCompanyName.MyProjectName

中台框架前台项目 admin.ui.plus 的初识

基于 vue3.x + CompositionAPI setup 语法糖 + typescript + vite + element plus + vue-router-next + pinia 技术，内置支持一键生成微服务接口，适配手机、平板、pc 的后台权限管理框架，希望减少工作量，帮助大家实现快速开发。

• 框架一览

• 项目地址

  • https://github.com/zhontai/admin.ui.plus

• 技术栈

  • node 16+
  • vue 3.x
  • typescript
  • element plus

• 特点

  • 界面还可以，自定义度高，适配移动端
  • 自动生成api接口定义文件
  • 没有过度封装
  • 系统权限封装基本满足大部分项目

• 推荐环境

  • Node v18
  • VsCode
  • VsCode插件
    • TypeScript Vue Plugin (Volar)
    • Vue Language Features (Volar)
    • Vue 3 Snippets
    • ESLint
    • Prettier - Code formatter

• 项目结构

  • bin 打包脚本
  • gen 根据./templates生成api相关文件，接口更新后执行npm run gen:api会生成接口的定义和接口模型
  • public 不需要打包的资源
  • src 源码，vue项目结构，具体文档参考vue-next-admin，element-plus
  • package.json script
    • npm run dev 运行
    • npm run build 打包
    • npm run gen:api 生成api代码，添加了模块后加入到apis中

中台框架后端项目 Admin.Core 的介绍与配置说明

中台 admin 是前后端分离权限管理系统，Admin.Core 为后端项目，基于.NET 7.0 开发。
支持多租户、数据权限、动态 Api、任务调度、OSS 文件上传、滑块拼图验证、多数据库，分布式缓存、分布式事务等

• 接口文档一览

• 项目地址

  • Github https://github.com/zhontai/Admin.Core

• 技术栈

  • dotnet7
  • FreeSql
  • Autofac
  • CAP
  • Mapster

• 特点

  • 快速启动，上手简单
  • 系统模块化
  • Swagger 的模块化封装
  • 读写分离
  • 分库分表
  • 分布式事务 TCC/ SAGA
  • 动态 API
  • 系统权限封装基本满足大部分项目
  • 多租户实现

• 开发环境

  • Vs2022
  • dotnet7

• 项目结构

  • hosts
    • ZhonTai.Host:默认启动项目,添加对 ZhonTai.Admin.Dev，模块的引用，并将程序集配置到 assemblyNames
  • platform
    • ZhonTai.Admin 核心服务
    • ZhonTai.ApiUI 接口文档封装，分模块加载
    • zhonTai.Common 通用库封装
    • ZhonTai.DynamicApi 动态 WebApi 库
    • ZhonTai.Admin.Dev 代码生成器添加
  • tests
    • ZhonTai.Tests 测试库
  • modules
    • XX.XX 我准备放自己的模块