地址：http://v2.volcore.xyz/home

开发及依赖环境

       如果需要后台开发，请将VS2019更新至最新版本

• 后台：VS2019、VS2022、.NetCore3.1、.Net6 、EFCore3.1/6、JWT、Dapper、Autofac、SqlServer/MySql/PGSql/Oracle、Redis(可选)
• 前端：VSCode、Vue2.0（webpack、node.js,没有环境的搜:vue webpack npm)、Vuex、axios、promise、IView、Element-ui

启动项目

• 运行前先看后台appsettings.json配置属性说明；(注意修改DbType属性，修改为自己使用的数据库,数据库脚本在DB文件夹下)
• 1、启动后台项目：后端项目路径  ../VOL.WebApi，找到dev_run.bat命令点击启动。后台启动 默认端口是9991。
• (dev_run.bat如果闪退，请使用cmd切换至 ../VOL.WebApi目录下执行dotnet run看异常信息)
• 如从没执行过npm install命令，使用cmd命令切换至前端Vue项目../VOL.Vue路径下,执行npm install命令
• 2、启动前端项目：前端Vue项目路径 ../VOL.Vue ，  找到 run.bat命令点击启动 。
• 1、(run.bat如果闪退,说明环境没配置好，请使用cmd切换至 ../VOL.Vue目录下执行npm run dev(vue3的执行npm run serve)看异常信息)
  2、使用cmd命令切换到../VOL.Vue目录下执行npm cache clear --force或者安装node.js版本14.15.1
• 3、输入http://localhost:8080访问（本地超级管理员帐号：admin 密码:123456）
• 项目启动报错/登陆页面报错
• 1、登陆页面一直登陆中不跳转：数据库连接没配置好,在appsettings.json中重新配置，或者可以调试查看具体错误，后台调试方法见文档：【后台开发】->【调试】
• 2、登陆页面【网络出了点问题】：检查浏览器控制台是否有异常输出跨域问题；数据库连接没配置，见上面第一步
• 3、项目启动报错：.netcore.xxx表不存在(手动将数据库表改成大写开头,与代码的Model大小写一致即可)
• 4、项目启动报错：点击登陆提示网络出错(如果是mysql数据库，请确认appsettings.json配置中DBType是否改为了MySql)
• 5、项目启动报错：后台控制台提示不支持allowPublicKeyRetrieval(见上面appsettings.json配置中DBType是否改为了MySql，数据库字符串配置去掉此属性)
• 6、EntityFramework Core3.1不再支持 Sqlserver2008，请使用2008以上的数据库或使用mysql
  7、如果能看到验证码但点击登陆提示服务器异常，原因就是数据库没连上，请检查配置文件的链接，或者将后台错误信息返回(ExceptionHandlerMiddleWare.cs文件中将new { message = "~服务器没有正确处理请求,请稍等再试!", status = false }改为new { message = message, status = false })

快速上手

• 前端需要了解模块化开发、vue基础语法：router、component及子父组件传参、slot、ref、props
• 文档【代码生成】:先用代码生成器生成完整代码
• 编写扩展业务代码:文档->[前端开发]->[后台开发]->[组件api(ViewGrid组件)]
• 编写扩展业务代码涉及组件:ViewGird.vue、VolForm.vue、VolTable.vue、VolBox.vue、VolUpload,根据需要找这几个组件参数即可

端口配置变更注意事项

• 如果修改了前端启动端口(默认8080)，同时需要修改后台appsettings.json配置属性CorsUrls跨域
• 如果修改了后台端口(默认9991,在后台Program.cs中配置)，同时需要修改前端http.js配置development对应url
• 不要在vs里直接启动动项目(vs启动项目不能实时编译,前端调用后台的url也访问不了)，按照【启动项目】来操作
• 点击登陆没有反应，请参照是否有上面操作的修改

项目发布

• 发布后台

           1、直接右击发布(发布方法，选文件系统即可)，发布完成后，将upload文件夹复制到发布后的路径

          2、配置跨域,发布后的文件夹下，配置appsettings.json属性CorsUrls,将部署好的前端vue站点url添加到CorsUrls中

          3、部署后台项目站点

  部署IIS上需要安装Runtime(linux上也需要),否则站点打不开 点击下载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

前后台发布在一起

项目更新

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