云灵汐项目深度解析看板
基于 1.4 GB 交接资料 + 全量源码静态分析 + 交互式架构图,对云灵汐平台的系统级研判。
核心研判:一张图看清云灵汐
项目定位与业务背景
云灵汐是一个面向旅行社的一体化文旅平台,覆盖从游客端浏览下单到旅行社 ERP 经营管理、再到供应链分销的完整业务闭环。
🧭 业务定位
旅行社 ERP + 涉旅电商分销双主线,辅以 AI 面试官、集团V号簿、AI 教育机三个旁支。
🏗️ 技术基座
ERP 基于芋道 yudao/ruoyi-vue-pro 二开(Java 17 + Spring Boot 3.5);电商基于 CRMEB Java v1.4 二开(JDK 8 + Vue2 + UniApp)。
📊 核心业务域
销售订单→计调→资源采购→财务闭环,含团期/报名/退款/应收应付完整链路。
⏰ 关键节点
2025-05 启动调研 → 2026 年持续开发 → 2026-09-01 完成交接。
24 子系统实际状态盘点
名义上 24 个子系统,实际只有 4 个有内容,其余 20 个为空占位目录。
| 子系统 | 状态 | 内容 |
|---|---|---|
| 18_涉旅电商分销 | 进行中 | 有交接文档 + 源码(ylx-mall) |
| 20_旅游社ERP | 进行中 | 六阶段齐全,文档最完整(ylx-erp) |
| 13_MAAS平台 | 已交付 | — |
| 14_设备接入管理 | 已交付 | — |
| 其余 20 个(01–12、15–17、19、21–24) | 空目录 | 无任何交付物 |
系统架构全景图 archify 交互图
下图由 archify 从 Typed JSON IR 确定性编译为独立交互式 HTML/SVG。支持深浅主题切换、节点聚焦、路径追踪、角色对比。点击架构图右上角工具栏可导出 PNG/SVG。
架构要点
- ylx-mall(电商分销):CRMEB 二开,Spring Boot 2.2.6 / JDK8 / Vue2+ElementUI / UniApp,28 个 Trip 控制器
- ylx-erp(旅行社ERP):yudao 二开,Spring Boot 3.5 / JDK17 / Vue3+Vite+TS,销售→计调→采购→财务闭环
- 基础设施:Nginx 网关统一路由,MinIO 对象存储,MySQL + Redis 双数据库(SIT/UAT 两套环境)
- 高危项:SIT/UAT 环境 DB/Redis admin-front 地址不一致,ERP R1 团期并发超卖 P0 风险
代码知识图谱 understand 工具
对 ylx-mall-admin 前端代码库(510 个文件:482 代码 + 19 页面 + 7 配置 + 2 文档)运行了 understand 知识图谱分析,自动识别组件、依赖关系、架构分层。
架构分层(understand 自动归纳)
| 层级 | 文件数 | 说明 |
|---|---|---|
| API 接口层 | 63 | 后端 API 调用封装(src/api/) |
| 通用组件 | 40 | 可复用 Vue 组件(src/components/) |
| 工具函数 | 25 | 通用工具与辅助函数(src/utils/) |
| 其他文件 | 21 | 配置、文档与其他文件 |
| 视图页面 | 13 | Vue 业务页面(src/views/) |
| 第三方库封装 | 12 | 第三方库与插件(src/libs/) |
| 状态管理 | 12 | Vuex 状态管理(src/store/) |
| 路由配置 | 15 | Vue Router 路由定义(src/router/) |
| 自定义指令 | 7 | Vue 自定义指令(src/directive/) |
| 过滤器 | 5 | Vue 过滤器(src/filters/) |
| 布局组件 | 1 | 页面布局框架(src/layout/) |
检测到的框架
代码资产深度盘点
ylx-mall(涉旅电商分销,进行中)
| 维度 | 详情 |
|---|---|
| 基座 | CRMEB Java v1.4 二开,Spring Boot 2.2.6 / JDK 1.8 / Vue2+ElementUI / UniApp |
| 核心 | 平台/供应商/分销商三视角数据权限隔离,28 个 Trip 控制器、30+ Service |
| 远端 | http://192.168.1.46:8081/ylx/ylx-mall.git,活跃分支 develop(HEAD 8ead9f3b) |
| 状态 | B端商城开发中,售后退款资金闭环未完成,站内信菜单权限 SQL 未执行 |
ylx-erp(旅行社ERP,进行中)
| 维度 | 详情 |
|---|---|
| 基座 | 芋道 yudao/ruoyi-vue-pro 二开,Java 17 + Spring Boot 3.5.15 / Vue3+Vite+TS |
| 核心 | 销售订单→计调→资源采购→财务闭环,含团期/报名/退款/应收应付 |
| 后端模块 | yudao-framework / yudao-server / yudao-module-travel(核心)/ yudao-module-ai-form-fill / yudao-module-ai |
| 前端路由 | sales / registration / dispatch-center / line / resource / finance / customer / contract / insurance / delivery |
| 状态 | 六阶段文档齐全,但风险清单最重(7 项技术风险,含 1 项 P0) |
旁支子项
AI 面试官
独立源码,陈龙杰/聂朝政交接
集团V号簿
独立源码,陈龙杰/聂朝政交接
AI 教育机
独立源码,李向晨宇/周文迪交接
风险全景
ERP 系统(ylx-erp)7 项技术风险
| 级别 | 编号 | 风险 | 一句话 |
|---|---|---|---|
| P0 | R1 | 团期余位并发超卖 | bookedCount 读-改-写非原子,并发确认报名会超占容量 |
| P1 | R2 | 部分退款无落地闭环 | 部分退款完成只返回提示文案,退人/调占位全靠人工 |
| P1 | R3 | 订单/报名/应收同步缺口 | completeOrder 无 @Transactional;cancelOrder 不挡进行中退款单 |
| P2 | R4 | 事件监听同步紧耦合 | 全部 @EventListener(非事务后置),审批链异常会回滚主流程 |
| P2 | R5 | updateById 整对象覆盖 | 并发互相覆盖,新字段易写回旧快照 |
| P2 | R6 | 资源履约金额更新覆盖 | 依赖前端只传 3 字段的口头约定,无类型约束 |
| P2 | R7 | 单号碰撞 | 退款/审批单号用时间戳取模,同毫秒并发可能撞号 |
TravelScheduleMapper 增加原子 SQL UPDATE ... SET booked_count = booked_count + #{delta} WHERE ... AND booked_count + #{delta} <= capacity,失败抛 SCHEDULE_CAPACITY_NOT_ENOUGH。电商分销(ylx-mall)高优待办
- 站内信菜单权限 SQL 未在目标库执行 → 接口 403
- 售后退款资金闭环未完成 → 余额退回待 B 端联调
- B 端订单全链路联调未做
- imagePath 仍为 Windows 路径 → 部署 Linux 需修正
SIT/UAT 环境高危不一致(3 项)
- UAT 数据库 admin/front 地址不一致(
192.168.1.184:3307vs1.14.69.198:13307) - UAT Redis admin/front 不一致(
192.168.1.184:6379vs1.14.69.198:16379) - SIT Redis 同样 admin/front 不一致
人员交接盘点(9 人)
| 人员 | 交接内容 |
|---|---|
| 王晓东 | ylx-mall 交接文档 + 源码 7z + 部署手册 |
| 聂朝政 | 项目交接 + 数据库账号 + 集团V号簿/AI面试官 + mysql 备份 |
| 宋佳瑶 | 前后端代码 + 项目交接文档 |
| 李文皓 | 交接清单 sheet |
| 唐琳睿 | 空夹(无任何交接物)— 需核实是否遗漏 |
| 张旭松 | 测试交接文档 + 交接文件 bitable |
| 陈龙杰 | AI面试官/集团V号簿/电商分销/AI教育机 4 子项 + 交接索引 |
| 李向晨宇 | 旅行社ERP + AI教育机 + 工作交接清单 |
| 周文迪 | 技术架构文档 + 部署手册 + 源码 zip + 交接 bitable |
项目时间线
证据链路与数据溯源
以下 13 条核心结论均可溯源到具体的交接文档、源码文件或环境配置:
| 结论 | 溯源依据 |
|---|---|
| 24 子系统是规划口径 | G0Sifkr 文件夹 24 子目录,20 个为空 |
| R1 P0 超卖风险 | TravelRegistrationServiceImpl.java L286-L302 源码实读 |
| R2 部分退款无闭环 | TravelOrderRefundServiceImpl.java L307-L309 源码 |
| SIT/UAT 环境不一致 | UAT与SIT环境交接文档-20260831.md 逐项比对 |
| 28 个 Trip 控制器 | crmeb_java.zip 解压后 controller 目录统计 |
| develop 分支 HEAD | 项目交接文档-20260831.md 标注 8ead9f3b |
| 唐琳睿空交接夹 | K68ff1z 人员交接目录下无内容 |
| yudao 二开基座 | ylx-erp pom.xml L37 芋道项目基础脚手架 |
| CRMEB 二开基座 | 项目交接文档-20260831.md 明确标注 CRMEB Java v1.4 |
| 40+ 篇日报 | 项目每日复盘目录 6.2–8.31 日期范围 |
| 12 PRD 文档 | PRD_需求文档目录逐文件清点 |
| 9 人交接 | 人员交接资料目录 9 个个人夹 |
| 1.4 GB 总量 | 本地留存目录 du -sh 实测 |
本地留存目录结构
~/Documents/云灵汐项目/
├── 01-交接资料/原始资料 → 软链 ~/Documents/交接资料/云灵汐项目(1.4GB)
├── 02-深度解析/
│ ├── archify-architecture.json ← archify 图谱源
│ └── 云灵汐系统架构图.html ← archify 渲染产物
├── 03-HTML看板/
│ ├── 云灵汐项目深度解析看板.html ← V1(全屏幻灯版,已弃用)
│ └── 云灵汐项目深度解析看板V2.html ← V2(本看板,滚动式)
└── 04-代码/
├── admin/ ← admin.zip 解压
├── crmeb_java/ ← crmeb_java.zip 解压
└── ylx-mall-admin/ ← Git checkout(.ua/ 知识图谱)
接手行动建议
代码到位
拿到内网 Git 仓库 192.168.1.46:8081 访问权限,拉取 develop 分支,验证编译/启动。
P0 修复
R1 团期并发超卖优先排期——生产事故级风险,上线前必须修。
环境确认
确认 SIT/UAT 三项 DB/Redis 不一致是否同一实例,修正配置。
全链路联调
B 端订单全链路联调 + 售后退款资金闭环 + 站内信权限 SQL。
研判总结
项目成熟度评估
| 维度 | 评分 | 说明 |
|---|---|---|
| 文档完整性 | ★★★★☆ | ERP 六阶段齐全,日报 40+,PRD 12 份 |
| 代码可接手性 | ★★★☆☆ | 有交接文档但 Git 权限未交付,风险清单重 |
| 架构清晰度 | ★★★★☆ | 双基座二开,边界清晰,understand 图谱已生成 |
| 生产就绪度 | ★★☆☆☆ | P0 未修,环境不一致,资金闭环未完成 |
| 人员可持续性 | ★★☆☆☆ | 2 人 vs 66 项待办,1 人空交接 |