feat(contract): 新增合同余额功能及重构文件管理

重构合同文件管理逻辑，增加错误处理和日志记录
新增ContractBalance实体、Repository和VO类
完善Voable接口文档和实现规范
更新项目架构文档和数据库设计
修复SmbFileService的连接问题
移动合同相关TabSkin类到contract包
添加合同文件重建任务的WebSocket支持

server/src/main/java/com/ecep/contract/EntityService.java

@@ -17,13 +17,19 @@ import com.fasterxml.jackson.databind.JsonNode;
 
 /**
  * 实体服务基类
+ * 提供基础的CRUD操作和查询方法
  * 
  * @param <T>  实体类型
  * @param <VO> VO类型
  * @param <ID> 主键类型
  */
 public abstract class EntityService<T extends Voable<VO>, VO, ID> {
-
+    /**
+     * 获取实体数据访问层接口
+     * 子类必须实现此方法，提供具体的实体数据访问层实例
+     * 
+     * @return 实体数据访问层接口
+     */
     protected abstract MyRepository<T, ID> getRepository();
 
     public T getById(ID id) {