erp / tax-agent · Commits

- 在recordMappingError方法中添加StringWriter和PrintWriter
- 使用printStackTrace将完整堆栈信息写入StringWriter
- 将errorMessage字段设置为完整的堆栈跟踪字符串
- 替换原有的简单消息记录方式

- 在 Sender 基类中新增 validSuccess 方法统一处理空成功实体情况
- 移除 ReceiptSender、ReceivableSender 和 RefundSender 中重复的空列表检查代码
- 引入 JsonUtils 和 MessageFormat 用于构建详细的错误消息
- 当远程调用返回空的成功实体列表时，抛出带有错误详情的异常

- 添加 MappingErrorApi 控制器，提供分页查询和重试接口
- 实现 MappingErrorService 的分页及消息重发逻辑
- 引入 MappingErrorCO 和 MappingErrorVO 数据传输对象
- 更新生产字段配置中的固定值参数
- 集成 RabbitMQ 消息队列用于重新推送失败的消息
- 使用 MyBatis Plus 进行数据库操作和分页处理
- 添加事务注解确保数据一致性

- 将systemCode字段更名为systemType
- 更新多个配置项的pipelineId值从2改为1
- 修改configMapValue值从101.02为101
- 更新固定值字段如chargeItemDept和saleDept的值
- 调整客户相关配置如customerGroup和customerUseOrg的默认值

- 将Nacos发现和配置的命名空间ID从54c39cfe-d1c4-4022-a94b-a3486c5927fc更新为2267e673-b41f-458d-9643-2a03e4fd92fb
- 在生产字段配置文档中将实体ID从42更改为57
- 更新了对应的账套编码从MALL_42到MALL_57

- 移除了多个类中未使用的导入语句
- 调整了部分文件中的 import 顺序以符合规范
- 删除了冗余的 BigDecimal 和其他未引用的类型导入
- 优化了部分模块的依赖引入方式
- 统一了部分包内类的导入风格
- 移除了废弃或重复的 ControllerAdvice 注解
- 精简了 KingDeeHelper 中不必要的实体类导入
- 更新了日志保留时间从 30 天延长至 180 天
- 调整了部分 domain 类的 Lombok 注解使用方式
- 优化了 tax-boot 模块中模型类的字段校验注解顺序

- 使用 Optional 简化空值检查逻辑
- 在查询金蝶接口后增加结果日志输出
- 引入 JsonUtils 工具类序列化日志内容
- 添加 Slf4j 注解以支持结构化日志记录
- 重构条件判断避免嵌套判空操作

- 在设置有效键值前增加非空及非空列表判断
- 避免对空列表进行后续处理导致潜在异常
- 提高代码健壮性和可读性

- 修改订单支付(CI185)配置值从1-1更新为1-2
- 修改在线充值(CI185)配置值从2-1更新为2-2
- 修改订单退款(CI185)配置值从1-2更新为1-1
- 修改平台提现(CI185)所有相关配置值从x-1更新为x-2
- 修改其他相关配置项以匹配最新业务需求

- 修改 MappingUtils 中的远程参数获取方式，使用 getRemoteParam() 替代
  getPipelineDocFieldTypeRemoteParamDO()
- 更新 PipelineDocFieldTypeDO 模型中的字段命名，统一为 remoteParam
- 简化 PipelineDocFieldTypeService 中的方法签名，去除冗余的全限定类名
- 调整 saveConfig 和相关方法参数类型，提升代码一致性与可读性
- 统一 queryByPipelineRemoteFieldTypeId 返回值设置方式为 setRemoteParam()

- 修改 PipelineDocFieldTypeCO 类中的字段命名以提高可读性
- 更新生产字段配置文档，调整业务费用项分类与编码
- 优化应收单、收款单等相关配置结构
- 调整账套配置示例中的参数值与命名规范
- 完善各类支付场景下的配置映射关系

- 移除未使用的 Optional 导入
- 添加 putDefaultValid 抽象方法用于自定义校验规则
- 将 getVerifyKeys 和 getReturnKeys 方法重命名为 loadDbValid 和 loadDbValidReturn
- 新增 reflectFieldValue 工具方法统一处理字段访问异常
- 优化验证字符串生成逻辑，支持默认校验规则注入
- 调整 Transformer 类结构，增强扩展性和可维护性

- 将taxPipelineBusinessId重命名为pipelineBusinessId
- 保证模型字段命名一致性
- 减少冗余前缀提高可读性

- 将 tax_pipeline_business_id 字段重命名为 pipeline_business_id
- 更新了对应的实体类属性注解配置
- 确保与数据库表结构变更保持一致

- 删除 server.port 配置项
- 移除 spring.profiles.active 配置项
- 保留应用名称和 Nacos 发现配置

- 将 systemCode 字段统一更名为 systemType
- 修改 SystemType 枚举验证方法名 validateSystemCode 为 validateSystemType
- 更新 PipelineDO 中 systemType 字段类型为 systemTypeEnum
- 调整 TenantService 中获取管道信息时的系统类型转换逻辑
- 优化 PipelineMappingRepository 接口参数传递方式和 SQL 查询条件
- 增加 MyBatis Plus 分页插件配置支持
- 引入 mybatis-plus-jsqlparser 依赖以增强 SQL 解析能力
- 完善租户查询逻辑，增加异常处理和 ID 设置机制

- 将 TenantPipeline 重命名为 PipelineDO
- 将 TenantPipelineConfig 重命名为 PipelineDocFieldTypeDO
- 将 PipelineBusinessKeyword 重命名为 PipelineBusinessKeywordDO
- 将 TaxPipelineMappingError 重命名为 PipelineMappingErrorDO
- 将 TaxPipelineVerify 重命名为 PipelineDocValidDO
- 将 TaxPipelineVerifyReturn 重命名为 PipelineValidReturnDO
- 将 TaxPipelineMappingCreate 重命名为 PipelineMappingCreateDO
- 将 TenantTaxPipelineMapping 重命名为 PipelineMappingDO
- 将 ITaxTenantService 重命名为 ITenantService
- 将 ITaxPipelineBusinessKeywordService 重命名为 IPipelineBusinessKeywordService
- 将 ITaxMappingErrorService 重命名为 IMappingErrorService
- 将 ITaxPipelineVerifyService 重命名为 IPipelineDocValidService
- 将 ITaxPipelineMappingService 重命名为 IPipelineMappingService
- 更新所有引用上述类名的变量和方法参数
- 修改 AdoptMessageServiceImpl 中的业务逻辑以适配新的 DO 类型
- 修改 CustomerBuilder 中的数据处理逻辑以使用新命名的类
- 修改 MappingUtils 中的字段反射逻辑以适应新类结构
- 修改 CustomerTransformer 中的转换逻辑以使用 PipelineDO
- 更新 KingDeeConnectionManager 中的连接获取方法参数类型
- 更新 MessageContext 中的 tenantPipeline 字段为 pipelineDO
- 更新 Builder 接口中的 build 方法参数类型
- 更新 Transformer 接口中的 transform 方法参数类型
- 更新 InitializeProcessor 和 MappingProcessor 中的构建与转换调用
- 重命名存储层相关的实体类和仓库接口以符合新的命名规范

- 移除 TaxPipelineBusinessResponse 中的 configs 和 businessExt 字段
- 删除 TaxPipelineBusinessConfigCO、TaxPipelineBusinessExtCO 等配置类
- 清理控制器中与业务文档和扩展相关的接口方法
- 移除 TaxPipelineBusinessConfigRepository 等冗余仓储接口
- 简化服务层对业务配置和扩展信息的处理逻辑
- 调整 VO 类字段类型及注释，提升数据一致性
- 优化 TaxPipelineVO 和 TaxTenantVO 的字段描述和结构

- 新增 F_PZCW_Base_qtr1 类用于收款部门编号验证
- 在 ReceivableBill 中添加 receiveDept 字段并配置转换器
- 扩展 ReceivableMapping 以支持 F_PZCW_Base_qtr1 映射
- 实现 ReceivableReceiveDeptConverter 进行字段值转换
- 更新生产字段配置文档中的动态值映射规则
- 添加收款部门字段的完整配置 JSON 示例说明

- 删除了 tax_pipeline_mapping 表中 origin_data 更新时的 error_message 字段赋值
- 修正了更新操作中不必要的字段修改逻辑
- 避免了因错误消息字段导致的数据覆盖问题

- 添加客户相关字段配置说明
- 新增currency币别配置示例
- 补充customerGroup客户分组配置
- 增加contactCompanyType往来单位类型设置
- 完善customerUseOrg使用组织配置
- 添加customerCreateOrg创建组织配置

- 为 ReceiptMapping、ReceivableMapping 和 RefundMapping 类添加 JsonPropertyOrder 注解以指定序列化顺序
- 更新 ReceivableBill 中的业务卡号字段注释和转换目标字段名
- 修改生产字段配置文档中的 configValue 格式，从单一数字改为带后缀的形式（如 "0-1", "0-2"）
- 简化部分配置项中重复的 "-7" 后缀为通配符 "*" 表达方式

- 修改AR_receivable文档中currency和standardCurrency的固定值
- 新增收款单据中settleCurrency、bankCardNumber和saleDept字段配置
- 调整收款退款单配置中多个字段的编号顺序
- 统一修改多处PRE101为PRE001的固定值引用
- 重新组织文档结构以匹配最新的字段配置需求

- 在BaseMapping类中添加verifyInformation字段的@JsonIgnore注解
- 在BaseMapping类中添加returnKeys字段的@JsonIgnore注解
- 引入com.fasterxml.jackson.annotation.JsonIgnore包

---
feat(doc): 更新生产字段配置文档

- 添加settleMethod结算方式配置示例
- 补充对应的JSON配置结构说明

- 将接口 VerifyMarkInterface 中的 getVerifyMark() 方法重命名为 verify()
- 更新所有实现类中的对应方法名为 verify()
- 修改 BaseBill 类中货币转换器为 CurrencyConverter
- 删除 CustomerMapping 中的注释掉的字段声明
- 优化 ReceiptTransformer、ReceivableTransformer 和 RefundTransformer 中的映射逻辑，使用 Optional 处理可能为空的验证键和返回键
- 在 Transformer 中调用 verify() 方法替代原来的 getVerifyMark() 方法

- 将 k3cloud-webapi-sdk 的 systemPath 从项目内部资源目录调整为上级 lib 目录
- 在 maven-shade-plugin 配置中添加 includeSystemScope 以确保系统依赖被打包
- 确保外部 JAR 文件能被正确引用和构建进最终制品中

- 修改 YongYouConnectionManager 类继承自 AbstractConnectionManager<YongYouConnections>
- 重写 getConnection 方法以返回 YongYouConnections 实例
- 新增 YongYouConnections 配置类用于封装连接参数
- 引入 JsonUtils 工具类用于对象转换
- 添加 YongYouConnections 类型导入依赖

- 修改parse方法返回类型为Object并增加空值校验
- 新增parseString方法用于安全字符串转换
- 在MappingUtils中替换使用新的parseString方法
- 新增YongYouConnectionManager实现类
- 实现系统类型标记和连接获取基础逻辑

- 修改 findByPipelineIdAndDocumentTypeAndSystemDataId 方法签名，移除 pipelineDataId 参数
- 新增 findByPipelineIdAndDocumentTypeAndSystemDataIdAndPipelineDataId 方法用于精确查询
- 更新接口和实现类中的方法定义与调用
- 补充数据库查询语句和 XML 配置文件的对应修改
- 在 TaxReceiveService 中使用新的精确查询方法替换原有调用
- 设置默认状态为 SYNCED 以确保数据一致性

- 在 CustomerBuilder 中调用映射服务时传入 pipelineDataId 参数
- 更新 DynamicTaxPipelineMappingService 方法签名及实现，增加 pipelineDataId 参数
- 修改 ITaxPipelineMappingService 接口定义，支持 pipelineDataId 查询条件
- 调整 TaxPipelineMappingRepository.xml 查询语句，加入 pipeline_data_id 过滤条件
- 修正 TaxReceiveService 中的调用方法，确保传递 pipelineDataId 参数
- 移除 TaxReceiveService 中未使用的 PrintWriter 和 StringWriter 导入语句

- 移除冗余的 JSON 转换逻辑，直接传递 mapping 对象
- 新增 auditSend 方法支持 BaseMapping 参数类型
- 提取重复发送校验逻辑到 Sender 基类的 validMapping 方法
- 删除无用的第三方 ID 字段定义
- 统一异常处理和日志记录方式
- 优化代码结构和减少不必要的导入包
- 增强类型安全性和可维护性

- 在TaxPipelineMapping表中新增idx_system_data_id_pipeline_id索引
- 优化账套同步数据查询性能
- 提高系统数据与管道关联查询效率

- 删除了表 TaxPipelineMapping 中关于 pipeline_id、document_type 和 system_data_id 的唯一索引 uk_pipeline_id_document_type_system_data_id
- 保留了现有的主键和状态索引 idx_pipeline_id_state
- 确保数据完整性由应用层或其他数据库约束维护

- 新增业务费用项配置说明
- 添加应收单、收款单、收款退款单配置示例
- 包含结算方式与业务类型组合的详细映射
- 提供账套配置JSON结构说明
- 完善各类单据字段配置规则

- 移除原有 ApplicationReadyEvent 监听器注解
- 新增独立的事件监听方法 loadTenantPipelineEvent
- 通过事件方法调用原有的加载逻辑
- 确保应用启动时正确加载租户管道配置

- 在ITaxTenantService接口中新增findByTenantIdAndPipelineCode方法
- 在TaxTenantService实现类中实现新的查询方法
- 优化TenantStorageContext上下文加载逻辑
- 移除CommandLineRunner接口改为使用ApplicationReadyEvent事件监听
- 更新租户管道查询逻辑，支持通过tenantId直接查询
- 清理无用的事件发布代码和相关依赖注入

- 创建完整的系统设计文档，涵盖架构、模块设计、数据模型等
- 详细描述各模块功能及核心组件，包括tax-boot、tax-central等六大模块
- 提供系统核心流程说明，如消息处理、责任链模式应用
- 定义系统核心概念，如租户、账套、文档、映射和代理
- 描述与金蝶K3 Cloud的集成方式及API调用机制
- 说明配置管理机制，支持多租户、多账套灵活配置
- 添加异常处理机制和错误码定义
- 提供部署架构、安全设计和监控日志方案
- 规划未来功能扩展方向和性能优化策略

- 将fullySyncCustomer接口的@PostMapping注解改为@RequestMapping
- ExcelUtils增加@Slf4j注解用于日志记录
- 使用DataFormatter处理Excel单元格值，提升数据读取准确性
- 改进表头读取逻辑，支持动态列映射
- 增加对空单元格的处理，返回null而非空字符串
- 为TaxTenantController的call方法添加默认"value"字段

- 添加 AbstractCustomer、ContactCO 和 CustomerCO 模型类
- 修改 AdoptMessageController 支持金蝶客户同步接口参数
- 在 AdoptMessageServiceImpl 中实现金蝶数据映射逻辑
- 增加系统类型判断与异常处理机制
- 优化消息体构造方式，支持不同系统的数据转换