塔姆

本项目是一款面向个人用户的生活效率管理工具，旨在解决日常生活中记账、备忘、菜谱记录等碎片化需求分散在多个App中的痛点。核心功能模块包括：记账本（支持收支记录、资产账户管理、月度预算）、备忘录（支持待办事项、日历视图、到期提醒）、菜谱本（支持菜谱记录、图片上传、买菜清单生成）和倒计时（纪念日/节日提醒）。用户通过首页仪表盘快速查看今日概览，点击模块进入详细功能页完成操作。业务流程：用户首次进入小程序完成授权→首页展示个性化数据概览→根据需求选择功能模块→完成记录后数据自动同步云端→支持数据导出备份。

1. 立项背景和目标 公司销售环节已使用纷享销客 CRM 管理客户、销售订单与回款流程，但财务、库存、生产环节仍依赖 K/3 ERP（SQL Server 2008 R2，AIS20130806192009 账套）。两套系统长期互不相通，订单需要人工二次录入，客户变更也无法及时回流到 ERP，导致数据孤岛、人力浪费以及业务-财务对账滞后等问题。本项目旨在构建一个轻量级中间对接服务（ConnectDemo），以 K/3 为主数据底座，将纷享销客的客户主数据与销售订单自动同步到 K/3，支撑业务一体化运营。 2. 软件功能、核心功能模块介绍 本服务围绕「K/3 数据查询、纷享→K/3 客户/订单同步、辅助工具、定时任务」四大模块建设，共 25+ 个 REST 接口： K/3 业务数据查询：封装物料（ICItem）、库存（ICInventory）、销售订单（SEOrder）、应收单（ICSale）、收款单（ReceiveBill）、销售发票（ICSale2）六大实体的列表与数量接口，按日期范围分页查询。 客户主数据同步：调用纷享 Open API（/cgi/crm/v2/data/query）按 life_status=normal + k3_sync_fields_last_modify__c >= 1小时前 增量拉取客户，结合 Address/Contact 对象补全地址与联系人，写入 K/3 的 t_Item、t_Organization 表。 销售订单同步：/k3/sync-seorder 是核心，按 FBillNo + FHeadSelfS0170 来源标识判定新建/修改，调用 GetICMaxNum 存储过程获取 FInterID，通过 t_billcodeby 生成 XSDD15+yyyymmdd+流水号 形式的单据编号，写入 SEOrder 主表、明细表后执行 p_UpdateBillRelateData 重建关联。 辅助工具：地址智能解析（/util/parse-address-info）将「姓名+电话+省市区+详细地址」一锅端的混合文本拆分为结构化字段；客户档案修订接口（/account/update-account-number）支持必要时调整 K/3 客户编码。 3. 业务流程、功能路径描述 被动同步（客户）：纷享销客工作流回调 GET /fxapi/sync-accounts → 服务 60 秒后异步拉取最新客户 → 写入 K/3。主动同步（客户）：APScheduler 每小时执行 sync_accounts_from_fxiaoke_to_k3 → 调用本地 accounts_by_filters → 拉取增量客户 → 写入 K/3。 订单同步：纷享订单审批完成后回调 POST /k3/sync-seorder → 服务按

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<T>（code/message/data）、@Valid + @NotBlank 参数校验、Spring Boot Actuator 健康检查（/actuator/health）、/api/health 业务探活、WebMvcConfig 跨域配置。 3. 业务流程、功能路径描述 云之家→纷享审批数据流转（核心链路）：云之家工作流节点触发推送 → 调用 POST /middle/yunzhijia/testapi 传入加密报文 → 服务 AES 解密得到明文 → 落库/记录 → 立即返回 success 释放连接 → @Asy