当前版本 - v101

us是us系列框架，默认数据库引擎采用mysql,如需要其他数据库，请至www.magicalcoder.com下载对应引擎
配置模板时 请设置 模板版本=us_mysql_xxx

相关技术栈：
后端：springboot2.x +mybatis+redis+mysql
前端：layui2.4.5+jquery
工具：magicalcoder前后端代码生成器+magicaldrag前端布局器

1 如何启动
    管理后台：us-admin
        
        安装环境
            框架需要redis服务，请自行下载或者双击project/redis/redis-启动.bat
        配置环境
           us\us-admin\src\main\resources\application-publish.yml
           请根据实际情况配置 mysql redis
        导入数据库
            us\us.sql 导入上面配置的数据库
        运行
            us\us-admin\src\main\java\com\magicalcoder\us\admin\YouyaBootAdminApplication.java
            main函数即可启动
        
        也可以打成jar启动也行
        方式1 java -jar us-admin.jar
        方式2 nohup>nohupGps java -jar us-admin.jar --spring.profiles.active=deploy 2>&1 &
        
        启动成功后 浏览器访问
        http://localhost:18080/us-admin
            默认 admin/admin登陆
        
2 声明
    us 为开源项目，会持续不断的更新，在使用过程中遇到问题 欢迎联系作者 QQ 799374340

3 常见问题：
    1 验证码无法使用 null报错 解决方法：请更换最新jdk1.8版本 建议多尝试几个版本的 即可解决

无缝简单升级方法 
1 升级java 
    更新us最新包，把us-core覆盖您本地，前提是您未修改us-core已经存在的类
2  升级js html
    更新us最新包，把
     us-admin\src\main\resources\static\assets\magicalcoder\vxxx 
     us-admin\src\main\resources\templates\magicalcoder\vxxx
     覆盖您本地
3 升级模板
    magicalcoder软件包soft\vms\us_xxx会发布最新版本模板，更换至最新模板即可

当然如果您不希望进行任何升级 无需改动任何内容

版本更新记录：您可以根据记录来升级您当前的版本 查看版本在 /us_mysql/README.md 如果不想升级 请做好老版本vms下的模板备份
#v101 - 2019/1/15
## 1 支持excel导出功能 
## 2 重构js模块，之前版本限制太多，现在完全开放，更大程度满足扩展性
## 变更文件记录  您可以根据此文件来进行手动更新老版本 使用idea文件差异（Ctrl选中2文件夹 Ctrl+D）对比即可完成更新
        modified:   pom.xml
        modified:   us-core/pom.xml
        modified:   us-core/src/main/java/com/magicalcoder/us/core/common/dto/KeyValue.java
        modified:   us-core/src/main/java/com/magicalcoder/us/core/service/CommonRestController.java
        new file:   us-core/src/main/java/com/magicalcoder/us/core/utils/POIUtil.java
        new folder: us-admin/src/main/resources/templates/magicalcoder/v101/
        new folder: us-admin/src/main/resources/static/assets/magicalcoder/v101/

## 开发文档
    ##1 如何自定义新页面 并配置跳转规则
    我们拿goods_category表来讲解
    templates/goodscategory/goodscategory-edit.html
    templates/goodscategory/goodscategory-list.html
    注意goodscategory文件夹要小写
    
    URL规则/admin/page_v2/{tableName}/{editOrList}
    跳转规则由 AdminRmpController.mapping来定制规则
        return {tableName}.replaceAll("_","") +"/"+ {tableName}.replaceAll("_","") +"-"+ {editOrList};
    示例：/admin/page_v2/goods_category/list
    goods_category中的_会被替换成空 然后映射到对应文件夹 和对应是页面

##开发技巧
    修改静态文件 如果不重启 立即生效：使用idea开发 修改完 按快捷键 ctrl+F9 即可完成热部署，此方法仅限静态资源热部署 修改java不一定成功
    层级太多不好调试：由于采用iframe方式，确实有这种问题，您可以直接在浏览器打开 例如http://localhost:18080/us-admin/admin/page_v2/xxx/list 这种方式开发单独的页面 会更加清晰