refactor(phase1): 完成包名重构 (org.example → com.superbiz.agent)

Task 4.1: 包名统一重构
- 重命名 41 个 Java 文件的包名
- 更新所有 import 语句
- 恢复枚举类(FaultCategory、DiagnosisStatus、SourceType)
- 更新测试类的 import

重构范围:
- domain/entity: 3 个实体类
- domain/model: 2 个数据类
- domain/enums: 3 个枚举类
- repository: 3 个接口
- service/session: 2 个类(接口 + 实现)
- config: 9 个配置类
- controller: 2 个控制器
- agent/tool: 4 个工具类
- client: 1 个客户端
- Main.java: 主类

验证结果:
- 编译成功,无错误
- 所有测试通过 (27/27)
  - ApiDocumentRepositoryTest: 7/7 ✅
  - CaseLibraryRepositoryTest: 6/6 ✅
  - DiagnosisRecordRepositoryTest: 6/6 ✅
  - RedisSessionManagerTest: 8/8 ✅

Progress: 21/33 tasks completed (64%)
This commit is contained in:
zhuyongxin
2026-06-23 14:56:04 +08:00
parent 8bd758dbaf
commit c3a232540a
59 changed files with 103 additions and 104 deletions
@@ -122,7 +122,7 @@ mvn clean compile -DskipTests
**示例数据**(Redis 存储格式):
```json
{
"@class": "org.example.domain.model.SessionContext",
"@class": "model.domain.com.superbiz.agent.SessionContext",
"sessionId": "test-session-abc123",
"userId": "user-123",
"businessId": "order-456",
@@ -130,7 +130,7 @@ mvn clean compile -DskipTests
"status": "ACTIVE",
"toolCalls": [
{
"@class": "org.example.domain.model.ToolCall",
"@class": "model.domain.com.superbiz.agent.ToolCall",
"toolName": "search_documents",
"arguments": {"query": "test", "limit": 10},
"result": "found 5 documents",
@@ -334,7 +334,7 @@ public String getCurrentDateTime() {
```log
📍 getCurrentDateTime 调用栈:
0 - java.lang.Thread.getStackTrace()
1 - org.example.agent.tool.DateTimeTools.getCurrentDateTime()
1 - tool.agent.com.superbiz.agent.DateTimeTools.getCurrentDateTime()
2 - jdk.internal.reflect.NativeMethodAccessorImpl.invoke0()
3 - jdk.internal.reflect.NativeMethodAccessorImpl.invoke()
4 - jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke()
+6 -6
View File
@@ -182,10 +182,10 @@ logging:
<appender-ref ref="ASYNC_FILE_ALL"/>
</logger>
<!-- 增加某个类的详细日志 -->
<logger name="org.example.service.RagService" level="TRACE" additivity="false">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE_ALL"/>
<!-- 增加某个类的详细日志 -->
<logger name="com.superbiz.agent.service.RagService" level="TRACE" additivity="false">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE_ALL"/>
</logger>
```
@@ -211,8 +211,8 @@ logging:
<!-- ... -->
</appender>
<logger name="org.example.service.RagService" level="DEBUG" additivity="false">
<appender-ref ref="FILE_RAG"/>
<logger name="com.superbiz.agent.service.RagService" level="DEBUG" additivity="false">
<appender-ref ref="FILE_RAG"/>
</logger>
```
@@ -31,7 +31,7 @@
## 4. 代码结构重构
- [ ] 4.1 包名重构 (org.example → com.superbiz.agent)
- [x] 4.1 包名重构 (org.example → com.superbiz.agent)
- [ ] 4.2 分层结构优化 (controller/service/repository/domain/tool/config/exception)
- [ ] 4.3 创建 DTO 类 (DiagnosisRequest, DiagnosisResponse, DocumentUploadRequest, DocumentQueryResponse, Result)
+1 -1
View File
@@ -192,7 +192,7 @@
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<mainClass>org.example.Main</mainClass>
<mainClass>com.superbiz.agent.Main</mainClass>
</configuration>
</plugin>
@@ -1,4 +1,4 @@
package org.example;
package com.superbiz.agent;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@@ -1,4 +1,4 @@
package org.example.agent.tool;
package com.superbiz.agent.agent.tool;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -1,7 +1,7 @@
package org.example.agent.tool;
package com.superbiz.agent.agent.tool;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.example.service.VectorSearchService;
import com.superbiz.agent.service.VectorSearchService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.tool.annotation.Tool;
@@ -1,4 +1,4 @@
package org.example.agent.tool;
package com.superbiz.agent.agent.tool;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
@@ -1,4 +1,4 @@
package org.example.agent.tool;
package com.superbiz.agent.agent.tool;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.ObjectMapper;
@@ -1,4 +1,4 @@
package org.example.client;
package com.superbiz.agent.client;
import io.milvus.client.MilvusServiceClient;
import io.milvus.grpc.DataType;
@@ -9,8 +9,8 @@ import io.milvus.param.R;
import io.milvus.param.RpcStatus;
import io.milvus.param.collection.*;
import io.milvus.param.index.CreateIndexParam;
import org.example.config.MilvusProperties;
import org.example.constant.MilvusConstants;
import com.superbiz.agent.config.MilvusProperties;
import com.superbiz.agent.constant.MilvusConstants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import okhttp3.OkHttpClient;
import org.springframework.beans.factory.annotation.Value;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import lombok.Getter;
import org.springframework.boot.context.properties.ConfigurationProperties;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import lombok.Getter;
import org.springframework.boot.context.properties.ConfigurationProperties;
@@ -1,7 +1,7 @@
package org.example.config;
package com.superbiz.agent.config;
import io.milvus.client.MilvusServiceClient;
import org.example.client.MilvusClientFactory;
import com.superbiz.agent.client.MilvusClientFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import java.util.List;
import java.util.Map;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.databind.ObjectMapper;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
@@ -1,4 +1,4 @@
package org.example.constant;
package com.superbiz.agent.constant;
public class MilvusConstants {
@@ -1,4 +1,4 @@
package org.example.controller;
package com.superbiz.agent.controller;
import com.alibaba.cloud.ai.graph.NodeOutput;
import com.alibaba.cloud.ai.graph.OverAllState;
@@ -7,8 +7,8 @@ import com.alibaba.cloud.ai.graph.streaming.OutputType;
import com.alibaba.cloud.ai.graph.streaming.StreamingOutput;
import lombok.Getter;
import lombok.Setter;
import org.example.service.AiOpsService;
import org.example.service.ChatService;
import com.superbiz.agent.service.AiOpsService;
import com.superbiz.agent.service.ChatService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.chat.model.ChatModel;
@@ -1,8 +1,8 @@
package org.example.controller;
package com.superbiz.agent.controller;
import org.example.config.FileUploadConfig;
import org.example.dto.FileUploadRes;
import org.example.service.VectorIndexService;
import com.superbiz.agent.config.FileUploadConfig;
import com.superbiz.agent.dto.FileUploadRes;
import com.superbiz.agent.service.VectorIndexService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.controller;
package com.superbiz.agent.controller;
import io.milvus.client.MilvusServiceClient;
import io.milvus.grpc.ShowCollectionsResponse;
@@ -1,4 +1,4 @@
package org.example.domain.entity;
package com.superbiz.agent.domain.entity;
import jakarta.persistence.*;
import lombok.AllArgsConstructor;
@@ -1,4 +1,4 @@
package org.example.domain.entity;
package com.superbiz.agent.domain.entity;
import jakarta.persistence.*;
import lombok.AllArgsConstructor;
@@ -1,4 +1,4 @@
package org.example.domain.entity;
package com.superbiz.agent.domain.entity;
import jakarta.persistence.*;
import lombok.AllArgsConstructor;
@@ -1,4 +1,4 @@
package org.example.domain.model;
package com.superbiz.agent.domain.model;
import lombok.AllArgsConstructor;
import lombok.Builder;
@@ -1,4 +1,4 @@
package org.example.domain.model;
package com.superbiz.agent.domain.model;
import lombok.AllArgsConstructor;
import lombok.Builder;
@@ -1,4 +1,4 @@
package org.example.dto;
package com.superbiz.agent.dto;
import lombok.Data;
@@ -1,4 +1,4 @@
package org.example.dto;
package com.superbiz.agent.dto;
import lombok.Getter;
import lombok.Setter;
@@ -1,4 +1,4 @@
package org.example.dto;
package com.superbiz.agent.dto;
import lombok.Getter;
import lombok.Setter;
@@ -1,7 +1,7 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.FaultCategory;
import org.example.domain.entity.ApiDocument;
import com.superbiz.agent.domain.entity.ApiDocument;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
@@ -1,8 +1,8 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.FaultCategory;
import com.superbiz.agent.domain.enums.SourceType;
import org.example.domain.entity.CaseLibrary;
import com.superbiz.agent.domain.entity.CaseLibrary;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
@@ -1,8 +1,8 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.DiagnosisStatus;
import com.superbiz.agent.domain.enums.FaultCategory;
import org.example.domain.entity.DiagnosisRecord;
import com.superbiz.agent.domain.entity.DiagnosisRecord;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
@@ -1,14 +1,14 @@
package org.example.service;
package com.superbiz.agent.service;
import org.springframework.ai.chat.model.ChatModel;
import com.alibaba.cloud.ai.graph.OverAllState;
import com.alibaba.cloud.ai.graph.agent.ReactAgent;
import com.alibaba.cloud.ai.graph.agent.flow.agent.SupervisorAgent;
import com.alibaba.cloud.ai.graph.exception.GraphRunnerException;
import org.example.agent.tool.DateTimeTools;
import org.example.agent.tool.InternalDocsTools;
import org.example.agent.tool.QueryLogsTools;
import org.example.agent.tool.QueryMetricsTools;
import com.superbiz.agent.agent.tool.DateTimeTools;
import com.superbiz.agent.agent.tool.InternalDocsTools;
import com.superbiz.agent.agent.tool.QueryLogsTools;
import com.superbiz.agent.agent.tool.QueryMetricsTools;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.chat.messages.AssistantMessage;
@@ -1,11 +1,11 @@
package org.example.service;
package com.superbiz.agent.service;
import com.alibaba.cloud.ai.graph.agent.ReactAgent;
import com.alibaba.cloud.ai.graph.exception.GraphRunnerException;
import org.example.agent.tool.DateTimeTools;
import org.example.agent.tool.InternalDocsTools;
import org.example.agent.tool.QueryLogsTools;
import org.example.agent.tool.QueryMetricsTools;
import com.superbiz.agent.agent.tool.DateTimeTools;
import com.superbiz.agent.agent.tool.InternalDocsTools;
import com.superbiz.agent.agent.tool.QueryLogsTools;
import com.superbiz.agent.agent.tool.QueryMetricsTools;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.chat.model.ChatModel;
@@ -1,7 +1,7 @@
package org.example.service;
package com.superbiz.agent.service;
import org.example.config.DocumentChunkConfig;
import org.example.dto.DocumentChunk;
import com.superbiz.agent.config.DocumentChunkConfig;
import com.superbiz.agent.dto.DocumentChunk;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import io.milvus.client.MilvusServiceClient;
import io.milvus.grpc.MutationResult;
@@ -9,8 +9,8 @@ import io.milvus.param.dml.DeleteParam;
import io.milvus.param.dml.InsertParam;
import lombok.Getter;
import lombok.Setter;
import org.example.constant.MilvusConstants;
import org.example.dto.DocumentChunk;
import com.superbiz.agent.constant.MilvusConstants;
import com.superbiz.agent.dto.DocumentChunk;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import io.milvus.client.MilvusServiceClient;
import io.milvus.grpc.SearchResults;
@@ -7,7 +7,7 @@ import io.milvus.param.dml.SearchParam;
import io.milvus.response.SearchResultsWrapper;
import lombok.Getter;
import lombok.Setter;
import org.example.constant.MilvusConstants;
import com.superbiz.agent.constant.MilvusConstants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,7 +1,7 @@
package org.example.service.session;
package com.superbiz.agent.service.session;
import org.example.domain.model.SessionContext;
import org.example.domain.model.ToolCall;
import com.superbiz.agent.domain.model.SessionContext;
import com.superbiz.agent.domain.model.ToolCall;
import java.util.Optional;
@@ -1,10 +1,10 @@
package org.example.service.session.impl;
package com.superbiz.agent.service.session.impl;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.example.domain.model.SessionContext;
import org.example.domain.model.ToolCall;
import org.example.service.session.SessionManager;
import com.superbiz.agent.domain.model.SessionContext;
import com.superbiz.agent.domain.model.ToolCall;
import com.superbiz.agent.service.session.SessionManager;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Service;
@@ -1,4 +1,4 @@
package org.example.tool;
package com.superbiz.agent.tool;
import io.milvus.client.MilvusServiceClient;
import io.milvus.param.ConnectParam;
+2 -2
View File
@@ -103,14 +103,14 @@
</logger>
<!-- AI Ops Service 单独记录 -->
<logger name="org.example.service.AiOpsService" level="DEBUG" additivity="false">
<logger name="com.superbiz.agent.service.AiOpsService" level="DEBUG" additivity="false">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE_AIOPS"/>
<appender-ref ref="ASYNC_FILE_ERROR"/>
</logger>
<!-- Chat Service 单独记录 -->
<logger name="org.example.service.ChatService" level="DEBUG" additivity="false">
<logger name="com.superbiz.agent.service.ChatService" level="DEBUG" additivity="false">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE_CHAT"/>
<appender-ref ref="ASYNC_FILE_ERROR"/>
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,4 +1,4 @@
package org.example.config;
package com.superbiz.agent.config;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
@@ -1,7 +1,7 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.FaultCategory;
import org.example.domain.entity.ApiDocument;
import com.superbiz.agent.domain.entity.ApiDocument;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
@@ -1,8 +1,8 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.FaultCategory;
import com.superbiz.agent.domain.enums.SourceType;
import org.example.domain.entity.CaseLibrary;
import com.superbiz.agent.domain.entity.CaseLibrary;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
@@ -1,15 +1,14 @@
package org.example.repository;
package com.superbiz.agent.repository;
import com.superbiz.agent.domain.enums.DiagnosisStatus;
import com.superbiz.agent.domain.enums.FaultCategory;
import org.example.domain.entity.DiagnosisRecord;
import com.superbiz.agent.domain.entity.DiagnosisRecord;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.test.context.TestPropertySource;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Optional;
import java.util.UUID;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@@ -1,7 +1,7 @@
package org.example.service;
package com.superbiz.agent.service;
import org.example.config.DocumentChunkConfig;
import org.example.dto.DocumentChunk;
import com.superbiz.agent.config.DocumentChunkConfig;
import com.superbiz.agent.dto.DocumentChunk;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Nested;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.MethodOrderer;
@@ -1,4 +1,4 @@
package org.example.service;
package com.superbiz.agent.service;
import io.milvus.client.MilvusServiceClient;
import io.milvus.grpc.DataType;
@@ -1,7 +1,7 @@
package org.example.service.session;
package com.superbiz.agent.service.session;
import org.example.domain.model.SessionContext;
import org.example.domain.model.ToolCall;
import com.superbiz.agent.domain.model.SessionContext;
import com.superbiz.agent.domain.model.ToolCall;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;