创建数据库
1. db文件夹下，找到对应数据库脚本并执行(需要提前创建好数据库后再执行脚本)
启动后台
1. 使用VS2022打开后台项目修改appsettings.json中数据库链接串；
2. 打开后台目录.Net6版本,双击dev_run.bat启动 后台启动 默认端口是9991

启动前端
1. 打开目录../Vol.Vue3.vite或Vol.Vue3版本 ，双击install.bat等待安装，安装完成后双击run.bat启动
2. 启动成功后，浏览器输入http://localhost:9990/访问

启动异常排查
后台启动闪退
1. 使用vs2022打开项目，手动生成下解决方案。
2. 使用cmd切换至 /Vol.WebApi目录输入dotnet run查看异常
3. 检查appsettings.json数据库连接配置与DBType属性是否配置正确
前端启动闪退
1. 使用cmd输入node -v检查是否安装nodejs
2. 前端启动异常：
vie版本使用cmd切换至 ../Vol.Vue3.Vite目录下执行npm install
老版本使用cmd切换至 ../Vol.Vue3目录下执行 npm config set strict-ssl false&npm cache clear --force & npm install
3. 如果没有报错，再接着执行 npm run serve 看异常信息
前端登录报错
1. 看不到验证码：检查后台有没有启动
2. 能看到验证码但一直显示登录或者报错，WebApi目录下->Download->Logger看异常信或者将后台错误信息返回(ExceptionHandlerMiddleWare.cs文件中将new { message = "~服务器没有正确处理请求,请稍等再试!", status = false }改为new { message = message, status = false })

代码生成
先在数据库创建表，必须有主键,只能是自增Id或Guid，MySql数据库使用Guid请将字段设置为char长度36位
表最好包括创建(修改)人、时间等字段，在新增或编辑时，框架会自动给这几个字段设置值
字段格式要求参照后台项目appsettings.json中属性CreateMember、ModifyMember的说明

主从(明细)表生成代码需要注意
明细表的外键必须是主表的主键字段,可参照SellOrder的明细表SellOrderList的外建
主从表代码生成步骤都是一样，在生成主表前需要先将从表按现有步骤生成
在主表生成配置页面填上【明细表名】与【明细表中文名】,点击生成vue页面、model、业务类即可完成主从页面代码的生成
代码生成器中可以不用生成从表vue页面

1、创建mysql表，只有字段类型是guid时设置成char(36),其他字段的长度都不要设置成长度36，否则会替换成guid类型
2、数据库字段不要设置类型bit(bool)，请用int或byte替代
后台请运行 ../VOL.WebApi/builder_run.bat命令，如果不需要生成业务类运行dev_run.bat即可(第一次生成某张表代码时候才需要运行builder_run.bat)

项目发布
发布后台

1、直接右击发布(发布方法，选文件系统即可)

2、将发布的文件全部放到iis目录下

3、浏览器打开后台的部署地址，能显示swagger界面就说明部署成功了(出现异常请看下面的[发布后访问报错])

部署IIS上需要安装Runtime(linux上也需要),否则站点打不开 点击下载6.0 hosting 点击下载3.1.8 hosting ,下载安装完成后重启IIS，或者使用cmd输入iisreset重启

发布前端
1、修改src\api\http.js文件，修改process.env.NODE_ENV 配置：axios.defaults.baseURL ='部署的后台地址'，如：http://132.232.2.109:9991/

2、执行前端发布：../vol.vue/目录下双击build.bat运行，发布完成后的项目在dist文件夹里

发布后访问报错

1、确认后台部署的站点能不能打开

2、确认后台appsettings.json中是否配置跨域。(修改配置后，重启下后台项目)

3、在部署的后台项目文件夹下，修改web.config属性stdoutLogEnabled="true"，当前目录下新建一个空文件夹logs,再直接访问后台接口，查看logs日志

4、如果logs文件夹下没有日志，查数据库sys_log表或Logger\Queue\路径下日志

5、linux下发布.netcore需要安装libgdiplus插件

前端刷新页面404报错
1、修改前端route文件夹下index.js文件，将 mode: 'history'改为 history: true

前后台发布在一起
将前端发布后的dist文件里面的内容(只要复制dist里面的内容)直接放到wwwroot文件下即可(前端http.js里面的axios.defaults.baseURL值改为空)
//axios.defaults.baseURL = '';

注意：如果是vue3版本请将Startup.cs中的app.UseDefaultFiles();注释掉 这个测试不去也行

项目更新
直接覆盖文件：后台VOL.Core类库、VOL.Builder类库，前端：components->basic、builder文件夹，common.js
注意：在没有修改过上面的文件才能直接覆盖，如果有修改请对比文件差异
其他文件更新：后台：VOL.System类库,Template文件夹；前端：main.js、views->index.vue、login.vue、router文件夹，根据需要更新，不更新也没影响

参考文档

https://gitee.com/x_discoverer/Vue.NetCore
http://v2.volcore.xyz/document/
http://v3.volcore.xyz/