# JuCheap.Core.4.0

**Repository Path**: jucheap/JuCheap.Core.4.0

## Basic Information

- **Project Name**: JuCheap.Core.4.0
- **Description**: 前后台分离管理系统解决方案。后台使用net6+identityserver4开发，前端使用Ant Design Pro Vue开源框架开发。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.jucheap.com
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 4
- **Created**: 2019-10-18
- **Last Updated**: 2025-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 管理后台

## README

## 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](https://blog.csdn.net/allenwdj/article/details/103325939)

![输入图片说明](documents/20191130162746245.jpg)
![输入图片说明](documents/20191130162806723.jpg)
![输入图片说明](documents/20191130162834699.png)
![输入图片说明](documents/20191130162849496.png)
![输入图片说明](documents/20191130162917153.png)
![输入图片说明](documents/20191130162930998.png)
![输入图片说明](documents/20191130162948878.png)
![输入图片说明](documents/20191130163008469.png)

---
## 安装使用

- 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 日志记录