Appearance
MAS 模块化应用支撑平台
MAS是一个模块化的应用支撑平台，采用微服务和微应用架构，支持多租户、多站点、模块化开发和积木式搭建。基于该平台，可以快速开发各类业务微应用，通过组合微应用来搭建支持多租户和多站点的业务系统。它能够实现租户独立的、可个性化的各类业务系统(站点)，并且支持全代码和低代码的开发方式。
功能范围
| 序号 | 子平台 | 说明 |
|---|---|---|
| 1 | 平台管理中心 | 管理租户、站点、应用等 |
| 2 | 站点管理中心 | 实现一个站点的基本管理功能，包括菜单、主题及基本信息管理 |
| 3 | 帐户中心 | 实现站点账号管理、认证和角色授权 |
| 4 | MAUI开发框架 | 前端微应用开发框架，支持对前端内核扩展及业务的模块化开发 |
| 5 | 微服务开发框架 | 后端微服务开发框架，基于Spring Cloud Alibaba架构实现微服务的模块化开发 |
版本
v5.8，发布于2023年8月7日
- 工作门户中支持低代码开发的业务卡片的显示
更新内容
此版本主要更新内容如下：
新增
- 支持旧版本服务名自动转发，如名为auth的旧版本服务，会自动转换为请示mas-auth的新版本服务；
- 修改auth服务的注册客户端信息服务配置器，增加数据库中加载的功能（前台页面还未做），可提供给第三方服务另外的jwt-token用于鉴权（token中不含有租户站点等信息）；
- gateway服务增加新的获取jwt-token方式，支持从参数中获取；
- gateway服务增加租户站点校验filter，用于在转发请求时匹配该请求租户站点是否正确；
- 租户信息中增加行政级别属性；
- 新增运维日志功能；
- 门户业务卡片逻辑处理（集成低代码平台配置发布业务卡片）；
- 增加mobilePage模式处理；
- 定时任务增加通用job调用低代码平台服务，暂时只支持调用服务编排、groovy、sql这三类；
- mas平台应用上架oss存储时支持一个oss存储桶内自定义根目录（服务中通过环境变量PLAT_OSS_ROOT_DIR来自定义应用/资源的存储根位置，对应nginx的njs/oss-sign.js中的ossAccess.rootDir值应与后台服务环境变量PLAT_OSS_ROOT_DIR值一致）。
修改
- 修复新增站点时根据规则：租户code_站点code_admin产生站点管理员账号超过长度限制问题；
- 修复文件丢失问题；
- 登录角色获取去掉站点应用角色代码；
- 浙政钉免登时dingAccoutId类型报错调整；
- 会话干扰问题调整；
- 页面锁定后解锁无法登录问题处理；
- 清空分类下的页面会删除其他分类中的页面及回收站查询数据增加租户条件过滤；
- 服务编排优化流程设计器选中切换内容文本编辑器数据递增问题；
- 部件第一次拖动页面时编辑失效问题处理；
- 账号ddId 新增无法输入问题。
- 解决移动端免登失败（连接重置问题）及免登返回钉id
优化
- 登录错误提示信息遗漏调整；
- 分类应用及授权应用排序保持一致；
- 移动站点预览时如果没有设置主题默认设置为移动默认主题；
- flex项目属性面板渲染条件调整；
- 服务编排优化流程设计器的图标和颜色功能。
补丁
无
微服务版本明细
| 序号 | 模块 | 微服务 | 版本号 | 说明 |
|---|---|---|---|---|
| 基础设施 | ||||
| 1 | Nacos服务 | nacos/nacos-server | 2.0.3 | |
| 2 | Redis | redis | 6.2.6-alpine3.15 | |
| 3 | RabbitMQ | byteflair/rabbitmq-stomp | latest | 可选 |
| 平台基础 | ||||
| 4 | 前端基座 | mas-nginx | 5.8.7 | 原foa5-nginx |
| 5 | 网关服务 | mas-gateway | 5.8.3 | 原foa-cloud-gateway |
| 6 | 站点系统管理 | mas-admin | 5.8.3 | 原foa-cloud-admin |
| 7 | 鉴权服务 | mas-auth | 5.8.3 | 原foa-cloud-auth |
| 8 | 文件服务 | mas-file | 5.8.3 | 原foa-cloud-file |
| 扩展服务 | ||||
| 9 | 单点登录 | mas-sso | 5.8.3 | 可选，原foa-cloud-sso-cos |
| 10 | MQ服务 | mas-mq | 5.8.3 | 可选，原foa-cloud-mq |
| 11 | 定时任务 | mas-task | 5.8.3 | 可选，原foa-cloud-task |
| 12 | 在线WPS | mas-wps | 5.8.3 | 可选，原foa-cloud-wps |
| 13 | 浙政钉网关 | mas-dingtalk | 5.8.3 | 可选，原cos-api-gateway |
如何获取微服务镜像?
所有镜像可到容器仓库通过 docker pull 拉取
- 武汉公司内网：
192.168.1.10:5000/tangram/[微服务名]:[版本号] - 阿里云：
registry.cn-hangzhou.aliyuncs.com/tangram/[微服务名]:[版本号]
如何获取微服务jar包?
所有正式发布版本可到私服仓库下载
- 下载地址：
http://nps.zktx-soft.com:19098/repository/maven-public/com/gsoft/[平台：mas|locas]/[应用名]/[版本号]/[应用名]-[版本号].jar
微应用版本明细
| 序号 | 模块 | 微应用 | 版本号 | 说明 |
|---|---|---|---|---|
| 管理平台 | ||||
| 1 | 应用市场 | mas-ops-app | 5.8.2 | |
| 2 | 租户管理 | mas-ops-tenant | 5.8.2 | |
| 3 | 站点管理 | mas-ops-site | 5.8.2 | |
| 站点系统管理 | ||||
| 4 | 账号管理 | mas-admin-account | 5.8.3 | 可替换 |
| 5 | 角色管理 | mas-admin-role | 5.8.3 | 可替换 |
| 6 | 单点登录 | mas-admin-sso | 5.8.3 | 可选，对应mas-sso |
| 7 | 菜单初始化 | mas-admin-menu | 5.8.3 | |
| 8 | 参数管理 | mas-admin-param | 5.8.3 | 可选 |
| 9 | 数据字典 | mas-admin-dictionary | 5.8.3 | 可选 |
| 10 | 数据分类 | mas-admin-catalog | 5.8.3 | 可选 |
| 11 | 操作日志 | mas-admin-log | 5.8.3 | 可选 |
| 12 | 在线用户 | mas-admin-online | 5.8.3 | 可选 |
| 13 | 站点设置 | mas-admin-site | 5.8.3 | |
| 主题 | ||||
| 14 | 清新绿（横向） | theme-horizontal-green | 5.8.7 | 可选 |
| 15 | 中国红（横向） | theme-horizontal-red | 5.8.7 | 可选 |
| 16 | 政务蓝（纵向） | theme-vertical-blue | 5.8.7 | 可选 |
| 17 | 清新绿（纵向） | theme-vertical-green | 5.8.7 | 可选 |
| 18 | 中国红（纵向） | theme-vertical-red | 5.8.7 | 可选 |
| 19 | 蓝色综合 | theme-multiple-blue | 5.8.7 | 可选 |
| 20 | 蓝色分栏 | theme-subfield-blue | 5.8.7 | 可选 |
| 扩展功能 | ||||
| 21 | 工作门户 | mas-panel | 5.8.7 | 可选 |
| 22 | 打印模块 | mas-printer | 5.8.7 | 可选 |
可选的微应用，没有特殊说明的，对应的微服务均为必选微服务或无需对应服务
如何获取应用tgz安装包?
所有安装包可到阿里云OSS仓库下载
- 路径：
oss://foa5-oss/deploy/[平台：mas/locas]/[应用名称]/[版本号]/[应用名称]-[版本号].tgz如：oss://foa5-oss/deploy/mas/mas-panel/5.8.7/mas-panel-5.8.7.tgz
浙政钉代理（IRS托管需要）
| 序号 | 模块 | 微应用 | 版本号 | 说明 |
|---|---|---|---|---|
| 1 | 代理 | mas-ui-dingtalk | 5.8.2 | 可选 |
5.7升级至5.8
- mas平台数据库升级脚本 下载
初始化安装
- mas平台数据库初始化脚本 下载
升级资料
- mas镜像替换nginx镜像 从5.8开始，mas项目集成了原nginx镜像，并且包含了其中html目录的相关内容，此版本之后不需要再单独拷贝mas项目的dist目录到nginx镜像的html目录中，升级步骤：
拉取5.8版本的mas镜像替换掉容器中原nginx镜像：registry.cn-hangzhou.aliyuncs.com/tangram/mas-nginx:5.8.7，并映射好相关的端口配置；
需要编辑容器镜像command参数，指定相应环境的配置文件为nginx默认启动配置：command: "nginx -c /etc/nginx/conf/nginx-default.conf -g 'daemon off;'"
镜像自带默认配置及路径，不同项目使用以下不同的路径既可，如其他环境有特殊配置，可以按以前的方式将对应文件映射到宿主机上自行配置。
- 阿里云23服务器：/etc/nginx/conf/nginx-23.conf
- 阿里云119服务器：/etc/nginx/conf/nginx-119.conf
- edas：/etc/nginx/conf/nginx-edas.conf
- szjd：/etc/nginx/conf/nginx-szjd.conf
将mas-ops-app、mas-ops-tenant、mas-ops-site对应版本（5.8.2）的tgz包拷贝到/usr/local/foa5-new/apps/目录下 （该步骤暂时沿用旧版本的发布方式，需建立磁盘目录映射关系/usr/local/foa5-new/apps:/usr/local/foa5-new/apps）