基于springboot的云之家OA和纷享销客数据交互插件
2026-07-22 11:44:45
行业：企业内部管理、企业服务(saas)
载体：插件
技术：Java、Spring Boot、Apache HTTP Server
业务和功能介绍
1. 立项背景和目标
公司同时使用云之家 OA（审批工作流）和纷享销客 CRM（客户/业务对象）两套系统，审批环节产生的业务数据（如订单审批、出差申请、报销流程等）需要回写到纷享销客对应的业务对象，原生云之家无法直接对接纷享销客的 OpenAPI，且双方系统在数据格式、鉴权方式、加密机制上完全不同（云之家采用 AES/ECB/PKCS5Padding 加密推送，纷享销客采用 OAuth2.0 + Bearer Token 鉴权）。本项目（mlxcl-middle）作为云之家与纷享销客之间的轻量级中间服务，承接云之家审批推送、解密、解析、调用纷享 OpenAPI 回写等完整链路，实现审批数据从 OA 到 CRM 的自动化流转。
2. 软件功能、核心功能模块介绍
服务基于 Spring Boot 3.3.5 构建，按职责划分为四大模块：
云之家推送接入（POST /middle/yunzhijia/testapi）：负责接收云之家 CloudFlow 推送的加密数据，使用 cloudflow-key（16 字节 AES 密钥）进行 AES/ECB/PKCS5Padding 解密，还原成明文 JSON 后进入业务处理链路；解密失败立即返回 error 避免阻塞云之家重试。
纷享销客 API 代理（POST /middle/fxiaoke/testapi）：作为纷享销客 OpenAPI 的统一入口，对外屏蔽鉴权细节，接收 dataObjectApiName + objectDataId 后自动识别预制对象（如 PersonnelObj）和自定义对象（ApiName 以 __c 结尾），分别路由到 /cgi/crm/v2/data/get 或 /cgi/crm/custom/v2/data/get 接口查询详情，并自动注入 x-fs-userid、x-fs-ea 等业务 Header。
通用数据处理中台（POST /api/process）：以 bizType 为路由键的策略模式分发器（TYPE_A / TYPE_B / Default），便于后续按业务类型扩展新的对接流程，无需改动主流程。
基础设施：统一响应封装 ApiResult（code/message/data）、@Valid + @NotBlank 参数校验、Spring Boot Actuator 健康检查（/actuator/health）、/api/health 业务探活、WebMvcConfig 跨域配置。
3. 业务流程、功能路径描述
云之家→纷享审批数据流转（核心链路）：云之家工作流节点触发推送 → 调用 POST /middle/yunzhijia/testapi 传入加密报文 → 服务 AES 解密得到明文 → 落库/记录 → 立即返回 success 释放连接 → @Asy
公司同时使用云之家 OA（审批工作流）和纷享销客 CRM（客户/业务对象）两套系统，审批环节产生的业务数据（如订单审批、出差申请、报销流程等）需要回写到纷享销客对应的业务对象，原生云之家无法直接对接纷享销客的 OpenAPI，且双方系统在数据格式、鉴权方式、加密机制上完全不同（云之家采用 AES/ECB/PKCS5Padding 加密推送，纷享销客采用 OAuth2.0 + Bearer Token 鉴权）。本项目（mlxcl-middle）作为云之家与纷享销客之间的轻量级中间服务，承接云之家审批推送、解密、解析、调用纷享 OpenAPI 回写等完整链路，实现审批数据从 OA 到 CRM 的自动化流转。
2. 软件功能、核心功能模块介绍
服务基于 Spring Boot 3.3.5 构建，按职责划分为四大模块：
云之家推送接入（POST /middle/yunzhijia/testapi）：负责接收云之家 CloudFlow 推送的加密数据，使用 cloudflow-key（16 字节 AES 密钥）进行 AES/ECB/PKCS5Padding 解密，还原成明文 JSON 后进入业务处理链路；解密失败立即返回 error 避免阻塞云之家重试。
纷享销客 API 代理（POST /middle/fxiaoke/testapi）：作为纷享销客 OpenAPI 的统一入口，对外屏蔽鉴权细节，接收 dataObjectApiName + objectDataId 后自动识别预制对象（如 PersonnelObj）和自定义对象（ApiName 以 __c 结尾），分别路由到 /cgi/crm/v2/data/get 或 /cgi/crm/custom/v2/data/get 接口查询详情，并自动注入 x-fs-userid、x-fs-ea 等业务 Header。
通用数据处理中台（POST /api/process）：以 bizType 为路由键的策略模式分发器（TYPE_A / TYPE_B / Default），便于后续按业务类型扩展新的对接流程，无需改动主流程。
基础设施：统一响应封装 ApiResult
3. 业务流程、功能路径描述
云之家→纷享审批数据流转（核心链路）：云之家工作流节点触发推送 → 调用 POST /middle/yunzhijia/testapi 传入加密报文 → 服务 AES 解密得到明文 → 落库/记录 → 立即返回 success 释放连接 → @Asy
项目实现
1. 整体架构和设计思路，不同模块使用的技术栈
整体架构：采用经典 三层架构 + 异步解耦 的轻量中间服务设计。Controller 层负责协议适配和加解密；Service 层封装业务逻辑（FXiaokeApiService + FXiaokeTokenService + YunZhiJiaService + YunZhiJiaAsyncProcessor）；Config + Util 层负责配置注入与工具能力。云之家推送链路采用同步接收 + 异步处理模式（@EnableAsync + @Async），保证 OA 侧 3 秒内拿到响应，避免触发云之家重试风暴。
技术栈：
运行时：Java 21 + Spring Boot 3.3.5
Web：spring-boot-starter-web（内嵌 Tomcat，监听 43686 端口）
能力：spring-boot-starter-validation、spring-boot-starter-actuator、spring-boot-starter-async
JSON：Fastjson2 2.0.53（性能优于 Jackson，纷享 API 报文高频解析）
工具库：Hutool 5.8.34（简化集合/日期/字符串处理）
HTTP 客户端：RestTemplate（封装于 RestTemplateConfig）
加解密：JDK 自带 javax.crypto（AES/ECB/PKCS5Padding）
简化代码：Lombok（@Data / @Slf4j / @RequiredArgsConstructor）
2. “我” 的负责模块和结果（尽可能量化）
我独立完成该中间服务从需求拆解、架构设计到编码落地的全部工作，核心成果：
21 个 Java 类文件，按职责拆为 3 个 Controller、5 个 Service、3 个 Config、1 个 Util、4 个 DTO/Model，分层清晰。
6+ 个核心 REST 端点（云之家推送、纷享对象查询、通用数据处理、健康检查等），覆盖云之家→纷享、纷享→上游两个方向的数据交互。
Token 缓存双层机制：内存级缓存（ReentrantLock + 双重检查锁 DCL）+ 提前 600 秒 主动刷新策略，将高频调用场景下 /oauth2.0/token 的实际请求量降低到原来的 1/12 以下（Token 默认有效期 7200s）。
对象路由自适应：单接口同时支持纷享预制对象与自定义对象，根据 dataObjectApiName 是否以 __c 结尾自动选择 /cgi/crm/v2/data/* 或 /cgi/crm/custom/v2/data/*。
双鉴权模式兼容：既支持 accessToken 注入 Body 的传统接口，也支持 Authoriza
整体架构：采用经典 三层架构 + 异步解耦 的轻量中间服务设计。Controller 层负责协议适配和加解密；Service 层封装业务逻辑（FXiaokeApiService + FXiaokeTokenService + YunZhiJiaService + YunZhiJiaAsyncProcessor）；Config + Util 层负责配置注入与工具能力。云之家推送链路采用同步接收 + 异步处理模式（@EnableAsync + @Async），保证 OA 侧 3 秒内拿到响应，避免触发云之家重试风暴。
技术栈：
运行时：Java 21 + Spring Boot 3.3.5
Web：spring-boot-starter-web（内嵌 Tomcat，监听 43686 端口）
能力：spring-boot-starter-validation、spring-boot-starter-actuator、spring-boot-starter-async
JSON：Fastjson2 2.0.53（性能优于 Jackson，纷享 API 报文高频解析）
工具库：Hutool 5.8.34（简化集合/日期/字符串处理）
HTTP 客户端：RestTemplate（封装于 RestTemplateConfig）
加解密：JDK 自带 javax.crypto（AES/ECB/PKCS5Padding）
简化代码：Lombok（@Data / @Slf4j / @RequiredArgsConstructor）
2. “我” 的负责模块和结果（尽可能量化）
我独立完成该中间服务从需求拆解、架构设计到编码落地的全部工作，核心成果：
21 个 Java 类文件，按职责拆为 3 个 Controller、5 个 Service、3 个 Config、1 个 Util、4 个 DTO/Model，分层清晰。
6+ 个核心 REST 端点（云之家推送、纷享对象查询、通用数据处理、健康检查等），覆盖云之家→纷享、纷享→上游两个方向的数据交互。
Token 缓存双层机制：内存级缓存（ReentrantLock + 双重检查锁 DCL）+ 提前 600 秒 主动刷新策略，将高频调用场景下 /oauth2.0/token 的实际请求量降低到原来的 1/12 以下（Token 默认有效期 7200s）。
对象路由自适应：单接口同时支持纷享预制对象与自定义对象，根据 dataObjectApiName 是否以 __c 结尾自动选择 /cgi/crm/v2/data/* 或 /cgi/crm/custom/v2/data/*。
双鉴权模式兼容：既支持 accessToken 注入 Body 的传统接口，也支持 Authoriza
示例图片视频
相似推荐
基于小程序的个人小工具
本项目是一款面向个人用户的生活效率管理工具，旨在解决日常生活中记账、备忘、菜谱记录等碎片化需求分散在多个App中的痛点。核心功能模块包括：记账本（支持收支记录、资产账户管理、月度预算）、备忘录（支持待办事项、日历视图、到期提醒）、菜谱本（支持菜谱记录、图片上传、买菜清单生成）和倒计时（纪念日/节日提醒）。用户通过首页仪表盘快速查看今日概览，点击模块进入详细功能页完成操作。业务流程：用户首次进入小程序完成授权→首页展示个性化数据概览→根据需求选择功能模块→完成记录后数据自动同步云端→支持数据导出备份。
惠测试
本系统是为科研检测企业打造的业务管理与客户服务平台，覆盖工作台、会员管理、项目配置、订单管理、检测流程管理、营销管理、财务与统计、内容管理及系统设置等核心模块，助力企业实现检测业务全流程线上化、规范化管理。
一、工作台（数据驾驶舱）
二、会员管理模块
统一管理平台注册客户信息，包含客户基本信息、所属单位、历史委托记录、消费金额等数据。支持客户标签化管理，可对高校、科研机构、企业等不同类型客户进行分类管理，便于后续精准营销与服务跟进。
三、项目配置模块
用于配置检测服务项目，涵盖高端测试、材料测试、生物医药测试、环境监测等品类。管理员可自定义检测项目名称、价格、规格参数、检测周期等信息，支持上下架管理，灵活调整服务内容。
四、订单管理模块
管理平台全部委托订单，包含订单编号、客户信息、订单金额、支付状态、订单状态及下单时间等字段。支持按订单状态、支付状态、时间范围等多维度筛选查询，方便管理人员快速定位与处理订单。
五、检测流程管理模块
检测流程管理是系统核心业务模块，覆盖检测业务全生命周期：待审核订单（审核需求合理性及样品信息完整性）、待收样样品（登记确认样品信息）、检测中样品（实时更新检测进度）、待交付样品（报告审核完成后待交付）、待回寄样品（确认样品寄回信息）、待开票申请（统一处理客户开票申请）。六个环节形成完整闭环，实现从订单审核到报告交付的全链条线上化管理。
六、营销管理模块
支持企业自主发布营销活动、优惠方案及推广内容，拓展线上获客渠道，提升品牌在高校及科研机构中的曝光度。
七、财务与统计模块
集中管理全部财务数据，包含回款记录、开票管理、收支明细等。自动汇总今日回款、本月回款、本月开票等关键指标，支持按时间维度统计分析，为经营决策提供准确财务依据。
八、内容管理模块
企业可通过后台发布技术文章、行业资讯、科研动态等内容，提升网站在科研检测相关关键词下的搜索排名
数智管理平台
1.针对企业内部管理的公共平台，包含审批流程操作
2.核心模块人员起底，专业群组，自查填报等模块，包括平台的人员流动，人员打标以及审批流等基本操作
3.业务上人员从各个省份进行上报，各个省份权限管理员通过审批操作通过人员进入系统人员起底资源池
短剧出海项目
1、海外短剧市场处于高速增长期，TikTok/Reels 等内容消费习惯催生了用户对"短平快"剧集的需求。平台面向东南亚、北美、拉美等海外市场，通过 Facebook 广告投放获客，以 H5 网页形
式提供服务——无需下载 App，打开链接即看。
2、业务目标
内容变现 通过会员订阅 + 金币单集购买两种模式实现付费
广告归因 完整追踪从广告点击到付费的全链路转化数据
多支付商 支持 Stripe（信用卡）和 PayPal 两种主流支付方式
多站点 一套代码支持多个品牌站独立部署（通过 settings.yaml 配置）
iOS 友好 通过服务端 CAPI 规避 iOS 14.5+ ATT 事件拦截
3、业务流程
二狗加速脱单平台-二狗app
1、二狗脱单项目主要由腾讯内部脱单项目二狗加速脱单孵化而来，在平台上享有很快的知名度。主要是解决现在大龄青年的婚恋问题，是一个以社交平台未基础的婚恋交友平台
2、主要功能模块包括推荐，星球，心动，消息，我的等
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服