feat(service): 实现国际化支持并优化Service层

重构文件类型相关Service以支持国际化查询
添加findOneByLang辅助方法统一查询逻辑
实现StringConverter支持UI控件显示
优化缓存配置和查询性能
新增UnitStringConverter和CustomerCatalogStringConverter
完善文档和测试用例

docs/task/enum_service_internationalization_analysis.md

@@ -0,0 +1,129 @@
+# 继承自BaseEnumEntity的Vo类对应Service国际化支持分析报告
+
+## 概述
+
+本报告分析了`d:\idea-workspace\Contract-Manager\client\src\main\java\com\ecep\contract\service`目录下，所有处理继承自`BaseEnumEntity`的Vo类的Service实现，检查它们是否符合`service_layer_rules.md`文档中关于国际化支持的要求。
+
+## 检查的Service列表
+
+通过分析，以下是处理继承自`BaseEnumEntity`的Vo类的Service：
+
+1. ContractFileTypeService - 处理ContractFileTypeLocalVo
+2. ProjectFileTypeService - 处理ProjectFileTypeLocalVo 
+3. VendorFileTypeService - 处理VendorFileTypeLocalVo
+4. CompanyFileTypeService - 处理CompanyFileTypeLocalVo
+5. CompanyCustomerFileTypeService - 处理CustomerFileTypeLocalVo
+6. VendorTypeService - 处理VendorTypeLocalVo
+7. UnitService - 处理UnitVo（注：经过详细检查，发现UnitVo并不继承自BaseEnumEntity）
+
+## 国际化支持实现情况分析
+
+### 1. 符合国际化支持要求的Service
+
+以下Service完全符合`service_layer_rules.md`文档中关于国际化支持的要求：
+
+#### CompanyFileTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<CompanyFileType, CompanyFileTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法，用于构建参数、分页查询和结果提取
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+#### CompanyCustomerFileTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<CustomerFileType, CustomerFileTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+### 2. 已完成国际化支持优化的Service
+
+以下Service在本任务中已完成国际化支持优化，现在完全符合要求：
+
+#### ContractFileTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<ContractFileType, ContractFileTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+#### ProjectFileTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<ProjectFileType, ProjectFileTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+#### VendorFileTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<VendorFileType, VendorFileTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+#### VendorTypeService
+- ✅ 实现了`findAll(Locale)`方法并添加了`@Cacheable`注解
+- ✅ 返回`Map<VendorType, VendorTypeLocalVo>`格式数据
+- ✅ 提供了`findOneByLang`私有辅助方法
+- ✅ 实现了`findByLocaleAndValue`和`findByLocaleAndType`方法
+- ✅ 使用了`@CacheConfig`配置缓存
+- ✅ 实现了`getStringConverter`方法
+
+### 3. 特殊情况：UnitService
+
+经过详细检查，发现UnitVo并不继承自BaseEnumEntity，而是一个普通的数据实体。因此，它不需要实现BaseEnumEntity相关的国际化支持方法。
+
+针对UnitService，我们进行了以下优化：
+- ✅ 实现了`findByName`方法，用于根据名称查找UnitVo对象
+- ✅ 实现了`getStringConverter`方法，提供UnitVo的StringConverter支持
+- ✅ 创建了`UnitStringConverter`类，支持UnitVo在JavaFX控件中的显示和转换
+- 使用了`@CacheConfig`配置缓存
+
+## 实现的修改
+
+在本任务中，我们对以下Service进行了修改：
+
+1. **ContractFileTypeService**：
+   - 添加了`findOneByLang`私有辅助方法
+   - 添加了`findByLocaleAndValue`方法（重构为使用findOneByLang）
+   - 添加了`findByLocaleAndType`方法
+
+2. **ProjectFileTypeService**：
+   - 添加了`findOneByLang`私有辅助方法
+   - 添加了`findByLocaleAndValue`方法（重构为使用findOneByLang）
+   - 添加了`findByLocaleAndType`方法
+
+3. **VendorFileTypeService**：
+   - 添加了`findOneByLang`私有辅助方法
+   - 添加了`findByLocaleAndValue`方法（重构为使用findOneByLang）
+   - 添加了`findByLocaleAndType`方法
+
+4. **VendorTypeService**：
+   - 添加了`findAll(Locale)`方法
+   - 添加了`findOneByLang`私有辅助方法
+   - 添加了`findByLocaleAndValue`方法（重构为使用findOneByLang）
+   - 添加了`findByLocaleAndType`方法
+
+5. **UnitService**：
+   - 添加了`findByName`方法
+   - 实现了`getStringConverter`方法
+
+6. **新增类**：
+   - 创建了`UnitStringConverter`类，支持UnitVo的字符串转换
+
+## 结论
+
+通过本任务的优化，所有处理继承自`BaseEnumEntity`的Vo类的Service现在都完全符合`service_layer_rules.md`文档中的国际化支持要求。对于特殊情况UnitService，我们也根据其实际需求进行了适当的优化。
+
+这些优化确保了：
+1. 所有相关Service都实现了统一的国际化支持方法
+2. 查询方法都正确配置了缓存，提高了系统性能
+3. 代码结构更加一致，提高了可维护性
+4. 为UI控件提供了良好的字符串转换支持
+
+经过这些改进，系统的国际化支持更加完善，为用户提供了更好的多语言体验。