JuCheap Core 4.0 后台项目介绍

• 后台使用Net6 开发，代码一键批量生成。
• 后端项目采用net6 web api来给前端提供api接口，有2个api项目。
  • 一个是JuCheap.Core.IdentityWeb，用来给api站点提供身份认证的（使用的IdentityServer4做身份认证）。
  • 另外一个是JuCheap.Core.WebApi接口项目，给前端提供api接口。

前端项目使用Ant-Design-Pro-Vue开源项目构建

• 前端的代码都在src/JuCheap.Core.WebUI.Antd目录下面，前端项目的运行说明参考里面的README.zh-CN.md说明文档
  • 1.前提条件：需要先安装node.js。
  • 2.然后安装yarn插件。npm install -g yarn
  • 3.使用命令行工具，进入src/JuCheap.Core.WebUI.Antd目录，然后安装依赖包。yarn install
  • 4.运行前端项目。yarn run serve。默认端口8000(前端项目端口修改，在vue.config.js里面的devServer.port节点修改)
  • 提示：前端项目打包发布。yarn run build

预览地址

https://blog.csdn.net/allenwdj/article/details/103325939

安装使用

• 0 首先找到源代码根目录下面的documents文件夹，里面有数据库初始化脚本

• 0.1 1_db_script_sqlserver.sql 业务数据表结构和初始数据脚本

• 0.2 1_db_script_ids_sqlserver.sql IdentityServer4的身份认证系统数据表和初始数据脚本

• 1 新建2个数据库([JuCheapCore4]和[JuCheapCore4-Ids]，名字可以随便起，但是连接字符串中需要和这个名字一样)

• 2.1 执行上面找到的初始化脚本文件(1_db_script_sqlserver.sql和1_db_script_ids_sqlserver.sql),不同版本的数据，对应不同的脚本文件，支持mysql和sql server

• 3 分别配置2个api项目的连接字符串，都在appsettings.json文件的ConnectionStrings节点中配置

  • Connection_SqlServer是SqlServer版本的连接字符串
  • Connection_MySql是MySql版本的连接字符串

• 分别启动运行两个api项目

  • 1 用Visual Studio打开JuCheap.Core.sln
  • 2 在解决方案文件上，右键->属性->启动项目
  • 3 找到JuCheap.Core.IdentityServerWeb和JuCheap.Core.WebApi两个项目，将操作，都改为“启动”
  • 4 F5调试项目

代码目录结构

• 01_Infrastructure 基础
  • JuCheap.Core.Infrastructure 基础设施
  • JuCheap.Core.Infrastructure.Web Web项目基础设施
• 02_Data 数据访问
  • JuCheap.Core.Data 数据访问层，包含实体和DbContext文件
• 03_Repository 仓储项目相关
  • JuCheap.Core.IRepository 仓储接口
  • JuCheap.Core.Repository 仓储接口实现
• 04_Service 服务
  • JuCheap.Core.IdentityServer IdentityServer4身份认证服务
  • JuCheap.Core.Model 数据模型
  • JuCheap.Core.IService 服务接口
  • JuCheap.Core.Service 服务实现
• 05_Application 应用项目(api)
  • JuCheap.Core.IdentityServerWeb 身份认证web api项目
  • JuCheap.Core.WebApi 业务数据web api项目
• 99_Test 测试
  • JuCheap.Core.Test 单元测试项目

T4代码模板生成

• 每个项目文件里面都有一个.tt的T4模板，右击该tt文件，运行该自定义文件，可以根据数据库里面表，来生成对应的实体类、仓储接口/实现、数据模型Dto类型 和 服务接口/服务实现

• 注意：T4模板的数据库访问帮助类，放在JuCheap.Core.Infrastructure/Template下面

  • DbHelper.ttinclude对应SqlServer的配置，连接字符串在文件里面开头配置
  • DbHelper.MySql.ttinclude对应Mysql的配置，连接字符串在文件里面开头配置

• T4模板生成的代码文件，不要手动修改，否则下次运行T4模板后，修改的内容会被覆盖。如果要修改文件，请复制一份到对应项目的BaseExt文件夹下面，做扩展。

关于依赖注入

• 依赖注入的接口文件在JuCheap.Core.Service/JuCheapModuleInitializer.cs文件里面，包含了数据库上下文的注册，以及仓储/服务接口/AutoMapper的配置注册，都在这里面，默认是不需要做任何改动的，如果需要修改注册方式，都统一在此文件中做变更。

技术栈

• EntityFrameworkCore (ORM)
• 仓储模式
• 工作单元
• net core 3.0
• T4模板 (代码一键生成)
• IdentityServer4 统一身份认证
• NLog 日志记录