一体管理系统

# 好游统一管理平台（UniMgr）项目详细介绍 ## 一、项目概述 好游统一管理平台（UniMgr）是好游科技自主研发的企业级一体化数字管理平台，英文全称 **UniMgr Unified Management Platform**。"UniMgr" 源自 **Uni**fied **Mgr**（Manager），取其"统一管理"之意。当前对外版本为 **v2.7.0**。 平台基于 JDK 21、Spring Boot 4、Spring Cloud 2025 与云原生容器技术构建，采用"统一基座 + 业务微服务"的中台架构。基座提供统一认证与权限、组织架构、文件资产、在线支付、调度台账与监控运维等共性能力；业务侧提供政务综合档案、题库考试、内容管理、社区论坛、公开信息采集、图书与音乐媒资、用户会员、优惠营销、产品分发等开箱即用的模块。14 个后端服务共用一个管理后台、一套账号权限、一套交互规范，可按需组合、按模块授权。 平台支持机房裸机、Kubernetes/k3s 容器集群、政务云与内网隔离等全栈私有化部署形态，数据完全留在客户自己的机房，实现"数据不出域、扩展不受制"。 ### 一句话介绍 - **超短句**：一套平台，统管所有业务。 - **短句**：好游统一管理平台：一套可生长的数字业务中台，人财企房车事、内容、社区、考试、会员、支付全管起来。 - **标准句**：UniMgr 好游统一管理平台，采用云原生微服务架构，以统一账号权限、文件、支付为基座，内置政务综合档案、题库考试、内容管理、社区论坛、信息公开采集、图书音乐媒资、会员营销、产品分发等 12 个可插拔业务模块，支持全栈私有化部署，一套平台支撑全部数字化业务。 - **英文版**：UniMgr is a cloud-native, privately deployable unified management platform: one identity, one file system, one payment core, and twelve pluggable business modules. ## 二、产品定位与整体架构 平台采用"**一中台、多领域产品**"的矩阵架构，对外可按客户行业灵活组合，按模块授权交付。整体划分为统一基座、业务微服务、平台级子系统三个层次： - **统一基座（HyPlatform）**：由 hy-base 与 hy-gateway 构成，提供统一认证 / RBAC / 组织架构 / 字典 / 网关限流熔断 / 代码生成 / 调度台账 / 监控运维等平台底层能力。 - **业务微服务（12 个业务子产品）**：按业务域拆分的可插拔模块，独立部署、独立数据库、独立错误码段。 - **平台级子系统**：包括好游科技管理平台（统一管理后台）与好游·数据驾驶舱，随平台交付。 平台总体规模：**16 个微服务、240 个功能页面、317 张业务表（13 库）、1 167 个权限点、60 个自动化周期任务、377 个接口控制器、29 条网关路由**。 ## 三、产品矩阵（12 个业务子产品） | # | 子产品 | 对应服务 | 核心能力 | |---|---|---|---| | 1 | 好游·综合档案管理平台（政务版） | hy-archive | 人员、家庭户、特殊人群、走访、财产、企业、房产、车辆、事件"人财企房车事"六域一体（52 张业务表 / 21 个人员子档案页）、人员全景档案、合并日志 | | 2 | 好游·题库考试云 | hy-question | 证书-专业方向-科目三级题库、8 大题型、AI 辅助出题、智能组卷、在线考试、付费套餐与权益、错题本/笔记/学习统计 | | 3 | 好游·内容管理平台 | hy-cms | 多站点、多语言、内容模型（字段级配置）、栏目文章、评论与敏感词、广告位、公告、FAQ、友链、资源下载与线路管理、在线工具、访问统计 | | 4 | 好游·社区论坛 | hy-bbs | 一套实例承载 N 个论坛、板块树与能力位、主题与楼中楼、最佳答案、草稿箱、附件闭环、点赞收藏与阅读进度、版主任命/举报/禁言/版务日志、热度与口碑榜 | | 5 | 好游·公开信息采集 | hy-spider | 来源登记与授权留证、robots/限速合规闸门、URL 队列与三层去重、受控下载、配置化抽取模板、清洗与 PII 遮蔽、人工审核发布、禁采清单、下架工单、合规审计 | | 6 | 好游·图书资料管理中心 | hy-book | 图书/作者/出版社/分类、多格式电子书、ISBN→MD5→书名三级匹配开放接口 | | 7 | 好游·音乐媒资管理中心 | hy-music | 歌曲/歌手/专辑/多音质档位/歌词/音频指纹（FFmpeg chromaprint）匹配开放接口 | | 8 | 好游·用户中心 | hy-member | 注册登录、资料、积分、经验、等级、签到、分组标签、VIP 与钱包、好友私信留言、收藏点赞关注、设备与注销、分产品会员体系 | | 9 | 好游·统一支付中心 | hy-pay | 支付应用与渠道、统一下单、回调、退款、异步通知重试、超时关单、对账单与差异账、通知与订单归档 | | 10 | 好游·优惠营销中心 | hy-coupon | 优惠券模板/发放/核销回退、激活码批次与兑换、软件授权 License、营销活动与渠道、统计报表 + 用户端 H5 | | 11 | 好游·产品分发与升级中心 | hy-product | 产品档案、版本四态状态机、更新包、灰度更新策略（百分比分桶 + 白/黑名单）、依赖矩阵、升级结果回执、产品导出导入、多语言文案与帮助文档、协议、官网开放 API | | 12 | 好游·文件资产中心 | hy-file | 全格式统一存储：秒传、分片断点续传、版本、回收站、引用计数、内容审核、外链分享、用户空间与云同步、五类存储器、前端直传、水印与防盗链 | ### 平台级子系统 | 名称 | 英文名 | 能力 | |---|---|---| | 好游科技管理平台（管理后台） | UniMgr Admin | 15 个一级菜单、240 个功能页面统一入口 | | 好游·数据驾驶舱 | HyCockpit | 7 块大盘：集团运营总览、内容运营大盘、产品矩阵看板、系统运行大盘、会员与交易大盘、社区与学习大盘、数据资产大盘 | | 好游·统一基座 | HyPlatform | 统一认证 / RBAC / 组织架构 / 字典 / 网关限流熔断 / 代码生成 / 调度台账 / 监控运维 | ## 四、核心价值主张（五大支柱） | 支柱 | 主张 | 支撑事实 | |---|---|---| | 统一 | 一套账号、一套权限、一套数据、一套后台 | 16 个服务共用 1 个管理后台；240 个功能页面同一种交互规范；统一认证 + RBAC + 数据权限；人员-家庭-财产-企业-房产-车辆-事件全域关联 | | 可控 | 私有化部署，数据不出域 | 裸机 / k3s 本地集群；13 库按服务隔离、Redis 分库分前缀；操作日志 + 登录日志 + API 访问/错误日志四类留痕；网关统一鉴权与匿名白名单集中管理 | | 可生长 | 模块随需插拔，业务持续演进 | 微服务拆分，新增业务域不影响存量；以 hy-base 为模板的四步拆分流程；统一代码生成器 + 建库脚本生成器；产品矩阵自带版本/灰度/依赖矩阵，平台自身可持续升级 | | 接地气 | 从一线场景长出来的功能 | 走访处置闭环、到期预警扫描、一人多档合并、Excel 批量导入、错题本、灰度升级、网盘资源多线路下载、草稿箱与回收站、待审队列 | | 可审计 | 规范写进代码，变更留下台账 | 仓库级硬约束 + 只读自查脚本；定时任务统一注解注册、抢锁与运行日志台账（只读，不可在线改）；采集域授权留证与下架工单；支付域对账单与差异账 | ## 五、核心功能亮点 ### 统一底座能力 - **统一身份与权限**：一套账号体系，统一认证 + RBAC + 数据权限，授权精细至按钮级别（1 167 个权限点：55 个目录 + 240 个菜单 + 872 个按钮），全平台一次登录、全域访问。 - **统一文件资产**：全格式统一存储，支持秒传、分片断点续传、版本管理、回收站、引用计数、内容审核、外链分享、用户空间云同步、前端直传、水印与防盗链；提供 DB / LOCAL / FTP / SFTP / S3 五类存储器。 - **统一支付结算**：支付宝 + 微信全渠道，统一下单、退款、异步通知重试、超时关单，配套对账单与差异账，资金链路清晰可核。 - **六大政务档案域**：人员、财产、企业、房产、车辆、事件六域一体（52 张表），一人全景档案与合并日志，跨域数据天然关联。 ### 业务模块能力 - **题库考试闭环**：8 大题型 + AI 辅助出题 + 智能组卷 + 在线考试 + 错题本/笔记/学习统计，覆盖从出题到错题本的完整学习链路，支持付费套餐与权益。 - **内容与门户运营**：多站点、多语言，内容模型字段级配置（不改代码加栏目），评论与敏感词审核、广告位、公告、FAQ、资源下载多线路与失效反馈。 - **社区互动治理**：一套实例承载 N 个论坛，论坛可绑定产品线，板块能力位、主题与楼中楼、最佳答案、草稿箱、版主任命、举报、禁言、版务日志、热度与口碑榜。 - **受控信息采集**：来源登记与授权留证、robots/限速合规闸门、URL 队列三层去重、人工审核发布、禁采清单、下架工单与合规审计，面向已授权来源的受控采集。 - **图书音乐媒资**：图书全台账与多格式电子书统一管理；歌曲、歌手、专辑、多音质与歌词、音频指纹识别；提供带 API Key 与限流的 HTTP 开放接口，客户端可直接接入。 - **会员与营销**：注册登录、积分经验等级签到、VIP 与钱包、好友私信、分产品会员体系；优惠券、激活码、软件 License、营销活动四位一体，配套用户端 H5 领券中心。 - **产品分发与升级**：产品版本四态状态机、更新包与定时发布、灰度百分比分桶与白/黑名单、依赖矩阵、升级结果回执与下载流水，客户端一键检查更新。 ### 平台治理与工程约束 平台将易致生产事故的实践固化为仓库级强制规范（5 条硬约束），并配套自动化只读自查脚本： 1. **事务方法内禁止跨进程调用**——统一以提交后回调（afterCommit）执行通知、核销等旁路动作，避免"券核掉了、VIP 没到账"。 2. **钱已收必须有确定交付出口**——关单后回调稍后到达照常入账并发货并记录人工核对日志；建单失败保留待支付记录。 3. **表单标签不换行**——必填星号与说明问号始终留在原位，宽度不足时省略号截断，保证窄屏下操作效率。 4. **门户只枚举版式、永不开放模板编辑**——门户提供多种预置版式，字段结构在后台可配置，从源头规避注入风险。 5. **定时任务统一注解注册**——全平台周期任务统一抢锁、运行台账与日志集中在基座集中可查（只读，不可在线改），调度真源是代码，变更可审计。 ## 六、技术特点 - **技术栈**：JDK 21、Spring Boot 4、Spring Cloud 2025、Spring Cloud Alibaba、Nacos 注册与配置中心、MySQL、Redis、Vue 3、Vben5、Element Plus。 - **微服务架构**：16 个自研后端服务（网关、基座 + 12 个业务服务），独立部署、独立数据库（13 库 / 317 张业务表）、独立错误码段，故障隔离、演进解耦。 - **前端工程**：一个 Vue3/vben5 管理前端，240 个功能页面共用一套交互规范（搜索区 + 表格 + 行操作 + 弹窗表单），学习成本低。 - **服务治理**：服务间以 Feign RPC 与统一契约通信，配置托管 Nacos，边缘统一鉴权与限流由网关承担，Redis 按服务分库分前缀。 - **私有化与国产化友好**：基于 JDK + MySQL + Redis 开放生态，支持机房裸机与 k3s 容器集群私有化部署，可部署于自有机房、政务云与内网隔离环境，具备在国产基础软硬件上部署的条件（具体兼容性按单位环境实测确认）。 ## 七、多端触达 - Web 管理后台（桌面端为主） - PC 客户端检查更新（连接私有化部署平台） - 产品官网开放 API - 会员 H5 页面（领券、授权、个人中心等） - 门户站点（SSR 独立前端渲染） - 论坛游客可读 ## 八、适用场景（行业解决方案） ### 1. 基层治理 / 政务单位 解决人口、房屋、企业、车辆、事件等数据分散、走访靠本子、重复档案等问题。实现一人一档全域关联、以户管人、特殊人群分类关护、走访闭环留痕、事件全流程记录、重复档案合并留痕与六域数据一屏统览。跨条线调阅从登多个系统变为一次登录，档案类材料输出由人工汇总变为按域直接导出。 ### 2. 教培机构 / 行业协会 解决题库散落 Excel、组卷靠手工、考试靠纸、错题无回收、收费与权益两套台账等问题。提供证书-专业方向-科目三级结构、8 大题型与查重、AI 辅助出题、智能组卷、在线考试与场次、错题本/收藏/笔记、学习统计、套餐购买到权益生效与到期闭环。 ### 3. 媒体 / 政企门户运营 解决多站点多语言各建一套、下载链接失效无人反馈、评论审核靠人盯等问题。提供站点-栏目-内容模型三级字段级配置、多语言、资源下载多线路与失效反馈、敏感词与先审后发、广告位与 FAQ、论坛按产品/栏目分区、授权来源的采集汇聚。 ### 4. 软件厂商 / 多产品线公司 解决发版本靠群里喊、灰度没有工具、客户授权靠表格、用户反馈散落各处等问题。提供产品与版本四态状态机、更新包与定时发布、灰度百分比分桶与白/黑名单、依赖矩阵、升级结果回执与下载流水、激活码与软件 License、绑定产品线的论坛、订单与会员趋势。 ### 5. 校园 / 图书馆与资料室 解决书目在旧系统、电子书散落网盘、检索口径不统一等问题。提供图书/作者/出版社/分类台账、多格式电子书统一存储、ISBN→MD5→书名三级匹配开放接口、音频指纹与歌词管理、细粒度权限与审计。 ### 6. 有 C 端运营需求的互联网产品 解决注册登录、积分等级、VIP、优惠券、支付、消息各接一家第三方、账单对不齐等问题。提供注册登录与三方绑定、积分经验等级签到、VIP 与钱包流水、分产品会员体系、优惠券/激活码/License/活动四位一体、用户端 H5 领券中心、对账单与差异账、站内信/短信/邮件统一渠道管理。 ## 九、部署与服务方式 - **部署形态**：全栈私有化部署，支持机房裸机、Kubernetes/k3s 容器集群、政务云与内网隔离环境，数据完全留在客户自己的机房。 - **交付单元**：按模块授权、按产品矩阵版本发布，支持"只买一个业务模块"的模块化交付，新增模块共用基座，无需重建账号/权限/文件/支付。 - **实施路径**：选一个业务域上线（如综合档案或题库）→ 约 2~3 周出可操作原型 → 数据初始化与权限梳理 → 培训上线 → 按需扩展新模块。 - **后续升级**：产品可通过产品矩阵模块实现版本管理、灰度更新与升级结果回执，平台自身可持续升级演进。 ## 十、标准信息 | 项目 | 内容 | |---|---| | 产品名称 | 好游统一管理平台（UniMgr Unified Management Platform） | | 管理后台名称 | 好游科技管理平台 | | 版本号 | v2.7.0 | | 产品所属公司 | 好游科技 | | 技术栈 | JDK 21、Spring Boot 4、Spring Cloud 2025、Spring Cloud Alibaba、Nacos、MySQL、Redis、Vue 3、Vben5、Element Plus | | 部署方式 | 私有化部署（支持裸机服务器及 Kubernetes/k3s 容器集群） | | 客服邮箱 | kf@unimgr.com | | 备案信息 | 浙ICP备2022036331号-6 |