workbuddy通过三种方式应对分布式事务：一、集成hmily/seata等tcc框架，手动实现try/confirm/cancel三阶段；二、基于openapi与表结构自动生成含幂等校验的tcc骨架代码；三、采用事件驱动+本地消息表实现最终一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy构建分布式系统时遇到跨服务数据一致性问题，则可能是由于缺乏对事务边界的显式控制与补偿机制支持。以下是WorkBuddy应对分布式事务问题的可行路径及TCC逻辑生成能力说明：
一、依赖外部TCC框架集成实现事务协调
WorkBuddy本身不内建分布式事务引擎，但可通过标准接口与成熟TCC框架（如Hmily、Seata-TCC模式）对接，将业务逻辑注入Try/Confirm/Cancel三阶段生命周期。该方式要求开发者手动编写各阶段方法，并在WorkBuddy定义的服务契约中声明事务语义。
1、在WorkBuddy服务模块中引入Hmily客户端依赖，配置hmily.yml指定事务存储库与序列化方式。
2、为需参与分布式事务的接口方法添加@HmilyTCC注解，并明确指定confirmMethod与cancelMethod名称。
3、在对应Service类中实现三个独立方法：Try阶段执行资源冻结与参数校验；Confirm阶段完成真实扣减或状态变更；Cancel阶段执行资源解冻或状态回退。
4、确保所有Try方法具备幂等性，通过事务ID查询日志表判断是否已执行，避免重复冻结导致资损。
二、基于代码模板自动生成TCC骨架代码
WorkBuddy提供面向业务场景的代码生成器，可依据数据库表结构与API定义自动输出符合TCC规范的Java类模板，包含基础方法签名、日志记录占位、事务上下文注入点，但不生成具体业务逻辑实现。
1、在WorkBuddy控制台选择“分布式事务支持”选项，上传OpenAPI 3.0规范文件或选择已有微服务模块。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、勾选目标实体表（如order、inventory、account），系统解析字段类型与关联关系，识别出需预留/变更的核心数值字段。
3、点击生成，输出含Try、Confirm、Cancel三方法的Service类，其中Try方法内已预置if (tryLogMapper.existsById(xid)) return;幂等校验逻辑。
4、开发者仅需在生成代码中标注// TODO: 实现库存预占逻辑等提示位置填充实际业务操作。
三、利用事件驱动+本地消息表模拟TCC行为
当无法修改服务代码或引入TCC框架时，WorkBuddy支持通过事件总线与本地消息表协同构建最终一致性的准TCC流程。该方案将Try阶段转化为本地事务写入消息表并发布事件，Confirm/Cancellation则由订阅方异步处理并更新状态。
1、在WorkBuddy中启用“事件溯源增强模式”，为关键业务操作配置消息表持久化策略。
2、Try阶段执行本地数据库更新（如订单状态设为“预创建”）的同时，向本地消息表插入一条含xid、service、status、payload的消息记录。
3、Confirm阶段由下游服务消费该消息后执行真实库存扣减，并回调WorkBuddy更新消息表status为“CONFIRMED”。若回调失败，WorkBuddy内置定时任务将持续重试直至成功。
4、Cancel阶段触发条件为消息超时未确认，系统自动将消息标记为“CANCELED”，并通知上游执行逆向操作（如释放冻结库存）。
