HOS基础开发平台

# 从 2.5.0 升级到 2.5.1

# 更新时间

2023 年 12 月 14 日

# 更新内容

  1. 支持免密登录
  2. 支持单token
  3. 支持swagger开关
  4. 组织人员改造
    • 增加院区数据的维护功能；
    • 业务单元，去掉所属部门字段，增加所属院区字段；
    • 业务岗位，增加所属部门字段，去掉业务岗位关联流程岗位的功能；
    • 原有岗位管理目录，改为业务岗位管理和流程岗位管理，分别管理不同岗位类型的数据。
    • 业务岗位字典，增加查看关联流程岗位字典的功能，关联数据来自上游系统推送。
  5. 数据生命周期日志字段维护调整
  6. 修复若干 bug
  7. 优化部分用户体验

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中release-2.5.1分支中将源码下载到本地；
  2. 如果自己业务工程中 src/sys的代码没有进行过手动修改的话，将该代码手动删除，然后将hos-app-web 中src/sys 的代码复制到本地工程即可；
  3. 如果自己业务工程中 src/sys的代码进行过手动修改的话，请自行与hos-app-web 中src/sys 的代码进行比对，手动进行同步并解决冲突代码；
  4. 若项目中未对以下文件进行修改,可直接替换;若有修改,进行对比解决冲突；
  • package.json 安装依赖： hosui@1.1.26；
  1. 本次升级改动文件路径除src/sys外，其他升级改动文件路径分别为/src/biz/axios（新增了自定义拦截器，使用请见自定义拦截器）、/public/index.html、/src/defaultSettings.js、/public/environment.js（该文件支持生产环境修改全局变量不用重新打包, 详细使用情况请点击 environment.js 文件）；
  2. 修改vue.config.js文件，增加打包配置命令，可在项目打包时输入path参数指定publicPath。详情参见 配置项目根路径 。
  3. 在.env配置文件中增加消息模块开关配置: VUE_APP_MSG_BELL = '1', 代替了上一版本通过修改代码进行关闭的方式。 增加了VUE_APP_MSG_WS = '/ws', 如需配置ws直连地址,请在此处配置。

# 后端升级步骤

  1. 在根 pom 文件中修改hos-app-dependencies的版本号为2.5.1-RELEASE, 修改hos-starter-dependencies的版本号为1.3.1-RELEASE,修改 hos-security-dependencies的版本号为1.0.3-RELEASE
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-app-dependencies</artifactId>
            <version>2.5.1-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-starter-dependencies</artifactId>
            <version>1.3.1-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>

        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-security-dependencies</artifactId>
            <version>1.0.3-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.5.0/project-strcutre/project-strcutre-boot-1/oa-runner/src/main/java/com/mediway/hos） , 用户名/密码：hosuser/99ahivPJt
  2. 下载HosSecurityConfig、SecurityLoginConfig文件。
  3. 将以上两个类文件放入启动模块中。（如需了解，可见类中注释说明）

2.5.1

# 升级数据库

根据数据库实际使用情况下载对应的升级脚本。（以下为mysql的升级示例）

  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.5.0/project-strcutre/project-strcutre-boot-1/oa-doc/data/mysql/2.5.1） , 用户名/密码：hosuser/99ahivPJt
  2. 下载hos-app-base-mysql-2.5.0~2.5.1.sql文件
  3. 执行更新 SQLhos-app-base-mysql-2.5.0~2.5.1.sql

# 修改yml文件

###  配置白名单   （此白名单可直接复制替换，或根据已有的进行添加均可）
hos-security:
  login:
     white-list:                                         #认证白名单
        - ${sys.restfulPath}/**
        - /druid/**
        - /license/*
        - /loginPageData/*
        - /property/is-enable-tenant
        - /tenant/select-tenant-by-domain
        - /tenant/select-tenant
        - /core/system/files/other/**
        - /core/system/files/image/**
        - /websocket/**
        - /favicon.ico
        - /v2/api-docs
        - /swagger-resources
        - /acm/accountAndPWD/validateAccount
        - /doc
        - /**/*.css
        - /**/*.js
        - /**/*.png
        - /**/*.jpg
        - /**/*.jpeg
        - /**/*.html
        - /**/*.ico
        - /**/*.properties
        - /**/*.woff
        - /**/*.woff2
        - /**/*.ttf
        - /hos-job-admin/api/registry
        - /i18n/language/list-select
        - /i18n/element/get-loginPageElements
        - /i18n/config/is-open
        - /i18n/static-translation/transByCode
        - /poserver.zz
        - /posetup.exe
        - /sealsetup.exe
        - /poserver.zz
        - /sys/config/is-open-download-browser
        - /login/passwordFree/userInfo
###  swagger开关   （true:开启，false:关闭。不配置默认为true，可根据开发或生产环境配置不同的值）
swagger:
  show: true

# 上传模板文件

  1. 下载模板文件。
  2. 在文件存储管理中，配置好需要存储文件的服务器。 2.5.1-fileStorage.png
  3. 在文件管理中，导入第一步下载好的zip格式模板文件压缩包。 2.5.1-file.png

# 补充说明

单token配置
在yml配置文件中将hos-security:login:token:enable-refresh-token设置为false，即关闭刷新token即可。

hos-security:
  login:
     token:                                
        enable-refresh-token: false

← 从 2.4.0 升级到 2.5.0 →