refactor(modules): 拆分多模块工程并收口common基础模块

common-agent-observability/pom.xml

@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.bruce</groupId>
+        <artifactId>common-agent-parent</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>common-agent-observability</artifactId>
+    <name>common-agent-observability</name>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.bruce</groupId>
+            <artifactId>common-agent-common</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.bruce</groupId>
+            <artifactId>common-agent-agent</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.bruce</groupId>
+            <artifactId>common-agent-modelprovider</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.bruce</groupId>
+            <artifactId>common-agent-workflow</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.baomidou</groupId>
+            <artifactId>mybatis-plus-spring-boot4-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>postgresql</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+</project>

common-agent-observability/src/main/java/com/bruce/observability/controller/ObservabilityTraceController.java

@@ -0,0 +1,27 @@
+package com.bruce.observability.controller;
+
+import com.bruce.common.domain.model.RequestResult;
+import com.bruce.observability.vo.ObservabilityTraceVO;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+/**
+ * 运行观测控制器先提供占位查询接口，
+ * 后续在 observability 模块完善聚合服务实现。
+ */
+@RestController
+@RequestMapping("/api/observability")
+public class ObservabilityTraceController {
+
+    @GetMapping("/trace")
+    public RequestResult<ObservabilityTraceVO> trace(@RequestParam("requestId") String requestId) {
+        ObservabilityTraceVO vo = new ObservabilityTraceVO();
+        vo.setRequestId(requestId);
+        vo.setStepSummaries(List.of());
+        return RequestResult.success(vo);
+    }
+}

common-agent-observability/src/main/java/com/bruce/observability/vo/ObservabilityTraceVO.java

@@ -0,0 +1,31 @@
+package com.bruce.observability.vo;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * requestId 级别的运行追踪聚合返回对象。
+ */
+@Data
+public class ObservabilityTraceVO {
+
+    private String requestId;
+
+    private String workflowStatus;
+
+    private String sessionStatus;
+
+    private Integer workflowStepCount;
+
+    private Integer messageCount;
+
+    private Integer modelCallCount;
+
+    private Integer totalDurationMs;
+
+    private BigDecimal estimatedCost;
+
+    private List<String> stepSummaries;
+}