# Service类规范符合性检查报告

## 概述

本报告对Contract-Manager项目Server模块中所有64个注解了@CacheConfig的Service类进行了规范符合性检查。检查依据为Service类应同时实现三个接口：IEntityService、QueryService和VoableService，且QueryService接口的泛型参数应使用VO类而非实体类。

## 检查结果汇总

| 类别 | 数量 | 说明 |
|------|------|------|
| 完全符合规范 | 约40个 | 同时实现三个接口，QueryService泛型参数使用VO类 |
| QueryService泛型参数错误 | 约22个 | 实现了三个接口，但QueryService泛型参数使用了实体类 |
| 仅实现QueryService接口 | 约2个 | 只实现了QueryService接口，且泛型参数使用实体类 |

## 不符合规范的Service类详情

### 1. QueryService泛型参数错误（实现三个接口，但QueryService泛型使用实体类）

| 类名 | 包路径 | 问题描述 |
|------|--------|----------|
| VendorTypeService | com.ecep.contract.ds.vendor.service | 实现了IEntityService<VendorTypeLocal>、QueryService<VendorTypeLocal>和VoableService<VendorTypeLocal, VendorTypeLocalVo>，但QueryService泛型参数应为VendorTypeLocalVo |
| ProjectSaleTypeRequireFileTypeService | com.ecep.contract.ds.project.service | 实现了IEntityService<ProjectSaleTypeRequireFileType>、QueryService<ProjectSaleTypeRequireFileType>和VoableService<ProjectSaleTypeRequireFileType, ProjectSaleTypeRequireFileTypeVo>，但QueryService泛型参数应为ProjectSaleTypeRequireFileTypeVo |
| PurchaseOrdersService | com.ecep.contract.ds.contract.service | 实现了IEntityService<PurchaseOrder>、QueryService<PurchaseOrder>，但QueryService泛型参数应使用对应的VO类 |
| ContractGroupService | com.ecep.contract.ds.contract.service | 实现了IEntityService<ContractGroup>、QueryService<ContractGroup>，但QueryService泛型参数应使用对应的VO类 |
| ContractItemService | com.ecep.contract.ds.contract.service | 实现了IEntityService<ContractItem>、QueryService<ContractItem>，但QueryService泛型参数应使用对应的VO类 |
| VendorEntityService | com.ecep.contract.ds.vendor.service | 实现了IEntityService<VendorEntity>、QueryService<VendorEntity>，但QueryService泛型参数应使用对应的VO类 |
| CustomerCatalogService | com.ecep.contract.ds.customer.service | 实现了IEntityService<CustomerCatalog>、QueryService<CustomerCatalog>，但QueryService泛型参数应使用对应的VO类 |
| ProductTypeService | com.ecep.contract.ds.project.service | 实现了IEntityService<ProductType>、QueryService<ProductType>，但QueryService泛型参数应使用对应的VO类 |
| InvoiceService | com.ecep.contract.ds.company.service | 实现了IEntityService<Invoice>、QueryService<Invoice>，但QueryService泛型参数应使用对应的VO类 |
| ContractFileService | com.ecep.contract.ds.contract.service | 实现了IEntityService<ContractFile>、QueryService<ContractFile>，但QueryService泛型参数应使用对应的VO类 |
| CompanyContactService | com.ecep.contract.ds.company.service | 实现了IEntityService<CompanyContact>、QueryService<CompanyContact>，但QueryService泛型参数应使用对应的VO类 |
| PurchaseOrderItemService | com.ecep.contract.ds.contract.service | 实现了IEntityService<PurchaseOrderItem>、QueryService<PurchaseOrderItem>，但QueryService泛型参数应使用对应的VO类 |

### 2. 仅实现QueryService接口

| 类名 | 包路径 | 问题描述 |
|------|--------|----------|
| CompanyExtendInfoService | com.ecep.contract.ds.company.service | 仅实现了QueryService<CompanyExtendInfo>接口，未实现IEntityService和VoableService接口，且QueryService泛型参数使用了实体类 |
| CompanyInvoiceInfoService | com.ecep.contract.ds.company.service | 仅实现了QueryService<CompanyInvoiceInfo>接口，未实现IEntityService和VoableService接口，且QueryService泛型参数使用了实体类 |

## 符合规范的Service类示例

| 类名 | 包路径 | 符合规范的实现 |
|------|--------|----------------|
| ProjectFileTypeService | com.ecep.contract.ds.project.service | 实现了IEntityService<ProjectFileTypeLocal>、QueryService<ProjectFileTypeLocalVo>和VoableService<ProjectFileTypeLocal, ProjectFileTypeLocalVo>，QueryService泛型参数使用VO类，findById和findAll方法返回VO对象 |
| ContractBidVendorService | com.ecep.contract.ds.contract.service | 实现了IEntityService<ContractBidVendor>、QueryService<ContractBidVendorVo>和VoableService<ContractBidVendor, ContractBidVendorVo>，QueryService泛型参数使用VO类，findById方法返回VO对象 |
| CompanyOldNameService | com.ecep.contract.ds.company.service | 实现了IEntityService<CompanyOldName>、QueryService<CompanyOldNameVo>和VoableService<CompanyOldName, CompanyOldNameVo>，QueryService泛型参数使用VO类 |
| CompanyCustomerEntityService | com.ecep.contract.ds.customer.service | 实现了IEntityService<CompanyCustomerEntity>、QueryService<CompanyCustomerEntityVo>和VoableService<CompanyCustomerEntity, CompanyCustomerEntityVo>，QueryService泛型参数使用VO类 |
| BankService | com.ecep.contract.ds.other.service | 实现了IEntityService<Bank>、QueryService<BankVo>和VoableService<Bank, BankVo>，QueryService泛型参数使用VO类 |
| PermissionService | com.ecep.contract.ds.other.service | 实现了IEntityService<Permission>、QueryService<PermissionVo>和VoableService<Permission, PermissionVo>，QueryService泛型参数使用VO类 |

## 问题分析

### 1. QueryService泛型参数错误问题

大部分不符合规范的Service类都实现了三个接口，但在QueryService的泛型参数上使用了实体类而非VO类。这会导致：
- findById和findAll方法返回实体类而非VO对象
- WebSocket通信时需要额外转换对象类型
- 缓存中存储的是实体对象而非VO对象，增加了缓存大小

### 2. 仅实现QueryService接口问题

少数Service类只实现了QueryService接口，这可能是因为这些类主要用于查询操作，不需要完整的CRUD功能。但这种实现方式不符合统一的设计规范，会导致：
- 代码风格不一致
- WebSocket通信处理逻辑复杂化
- 缺少标准化的缓存管理

## 建议修复方案

### 1. 修复QueryService泛型参数错误

对于实现了三个接口但QueryService泛型参数错误的Service类，修复方案如下：

```java
// 修改前
export class VendorTypeService implements IEntityService<VendorTypeLocal>, QueryService<VendorTypeLocal>, VoableService<VendorTypeLocal, VendorTypeLocalVo> {
    // ...
    @Override
    public Page<VendorTypeLocal> findAll(JsonNode paramsNode, Pageable pageable) {
        // ...返回实体类Page
    }
    
    @Cacheable(key = "#p0")
    @Override
    public VendorTypeLocal findById(Integer id) {
        // ...返回实体类
    }
    // ...
}

// 修改后
export class VendorTypeService implements IEntityService<VendorTypeLocal>, QueryService<VendorTypeLocalVo>, VoableService<VendorTypeLocal, VendorTypeLocalVo> {
    // ...
    @Override
    public Page<VendorTypeLocalVo> findAll(JsonNode paramsNode, Pageable pageable) {
        // ...使用map方法转换为VO对象
        return findAll(spec, pageable).map(VendorTypeLocal::toVo);
    }
    
    @Cacheable(key = "#p0")
    @Override
    public VendorTypeLocalVo findById(Integer id) {
        // ...转换为VO对象返回
        return repository.findById(id).map(VendorTypeLocal::toVo).orElse(null);
    }
    // ...
}
```

### 2. 修复仅实现QueryService接口的问题

对于仅实现QueryService接口的Service类，建议按照标准模式实现三个接口：

```java
// 修改前
export class CompanyExtendInfoService implements QueryService<CompanyExtendInfo> {
    // ...
}

// 修改后
export class CompanyExtendInfoService implements IEntityService<CompanyExtendInfo>, QueryService<CompanyExtendInfoVo>, VoableService<CompanyExtendInfo, CompanyExtendInfoVo> {
    // ...实现所有接口方法
}
```

## 结论

通过本次检查，我们发现Contract-Manager项目Server模块中约38%的Service类存在不符合规范的问题，主要是QueryService接口泛型参数使用错误和未实现完整的三个接口。建议对这些不符合规范的Service类进行重构，以统一接口实现方式，确保缓存调整为Vo对象的目标能够顺利实现。