feat(synthesis): add chunk-level synthesis data detail page & refine APIs/routing (#130)

* feat: implement synthesis data detail view with chunk selection and data display

frontend/src/pages/SynthesisTask/SynthDataDetail.tsx

@@ -0,0 +1,298 @@
+import { useEffect, useMemo, useState } from "react";
+import { useLocation, useNavigate, useParams } from "react-router";
+import { Badge, Button, Empty, List, Pagination, Spin, Typography } from "antd";
+import type { PaginationProps } from "antd";
+import { queryChunksByFileUsingGet, querySynthesisDataByChunkUsingGet, querySynthesisTaskByIdUsingGet } from "@/pages/SynthesisTask/synthesis-api";
+import { formatDateTime } from "@/utils/unit";
+
+interface LocationState {
+  fileName?: string;
+  taskId?: string;
+}
+
+interface ChunkItem {
+  id: string;
+  synthesis_file_instance_id: string;
+  chunk_index: number;
+  chunk_content: string;
+  chunk_metadata?: Record<string, unknown>;
+}
+
+interface PagedChunkResponse {
+  content: ChunkItem[];
+  totalElements: number;
+  totalPages: number;
+  page: number;
+  size: number;
+}
+
+interface SynthesisDataItem {
+  id: string;
+  data: Record<string, unknown>;
+  synthesis_file_instance_id: string;
+  chunk_instance_id: string;
+}
+
+interface SynthesisTaskInfo {
+  id: string;
+  name: string;
+  synthesis_type: string;
+  status: string;
+  created_at: string;
+  model_id: string;
+}
+
+const { Title, Text } = Typography;
+
+export default function SynthDataDetail() {
+  const { id: fileId = "" } = useParams();
+  const navigate = useNavigate();
+  const location = useLocation();
+  const state = (location.state || {}) as LocationState;
+
+  const [taskInfo, setTaskInfo] = useState<SynthesisTaskInfo | null>(null);
+  const [chunks, setChunks] = useState<ChunkItem[]>([]);
+  const [chunkPagination, setChunkPagination] = useState<{
+    page: number;
+    size: number;
+    total: number;
+  }>({ page: 1, size: 10, total: 0 });
+  const [selectedChunkId, setSelectedChunkId] = useState<string | null>(null);
+  const [chunkLoading, setChunkLoading] = useState(false);
+  const [dataLoading, setDataLoading] = useState(false);
+  const [synthDataList, setSynthDataList] = useState<SynthesisDataItem[]>([]);
+
+  // 加载任务信息（用于顶部展示）
+  useEffect(() => {
+    if (!state.taskId) return;
+    querySynthesisTaskByIdUsingGet(state.taskId).then((res) => {
+      setTaskInfo(res?.data?.data || null);
+    });
+  }, [state.taskId]);
+
+  const fetchChunks = async (page = 1, size = 10) => {
+    if (!fileId) return;
+    setChunkLoading(true);
+    try {
+      const res = await queryChunksByFileUsingGet(fileId, { page, page_size: size });
+      const payload: PagedChunkResponse =
+        res?.data?.data ?? res?.data ?? {
+          content: [],
+          totalElements: 0,
+          totalPages: 0,
+          page,
+          size,
+        };
+      setChunks(payload.content || []);
+      setChunkPagination({
+        page: payload.page ?? page,
+        size: payload.size ?? size,
+        total: payload.totalElements ?? payload.content?.length ?? 0,
+      });
+      // 默认选中第一个 chunk
+      if (!selectedChunkId && payload.content && payload.content.length > 0) {
+        setSelectedChunkId(payload.content[0].id);
+      }
+    } finally {
+      setChunkLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    fetchChunks(1, chunkPagination.size);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [fileId]);
+
+  const handleChunkPageChange: PaginationProps["onChange"] = (page, pageSize) => {
+    fetchChunks(page, pageSize || 10);
+  };
+
+  // 加载选中 chunk 的所有合成数据
+  const fetchSynthData = async (chunkId: string) => {
+    setDataLoading(true);
+    try {
+      const res = await querySynthesisDataByChunkUsingGet(chunkId);
+      const list: SynthesisDataItem[] = res?.data?.data ?? res?.data ?? [];
+      setSynthDataList(list || []);
+    } finally {
+      setDataLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    if (selectedChunkId) {
+      fetchSynthData(selectedChunkId);
+    } else {
+      setSynthDataList([]);
+    }
+  }, [selectedChunkId]);
+
+  const currentChunk = useMemo(
+    () => chunks.find((c) => c.id === selectedChunkId) || null,
+    [chunks, selectedChunkId]
+  );
+
+  // 将合成数据的 data 转换成键值对数组，方便以表格形式展示
+  const getDataEntries = (data: Record<string, unknown>) => {
+    return Object.entries(data || {});
+  };
+
+  return (
+    <div className="p-4 bg-white rounded-lg h-full flex flex-col overflow-hidden">
+      {/* 顶部信息和返回 */}
+      <div className="flex items-center justify-between mb-4">
+        <div className="space-y-1">
+          <div className="flex items-center gap-2">
+            <Title level={4} style={{ margin: 0 }}>
+              合成数据详情
+            </Title>
+            {state.fileName && (
+              <Text type="secondary" className="!text-xs">
+                文件：{state.fileName}
+              </Text>
+            )}
+          </div>
+          {taskInfo && (
+            <div className="text-xs text-gray-500 flex gap-4">
+              <span>
+                任务：{taskInfo.name}
+              </span>
+              <span>
+                类型：
+                {taskInfo.synthesis_type === "QA"
+                  ? "问答对生成"
+                  : taskInfo.synthesis_type === "COT"
+                  ? "链式推理生成"
+                  : taskInfo.synthesis_type}
+              </span>
+              <span>
+                创建时间：{formatDateTime(taskInfo.created_at)}
+              </span>
+              <span>模型ID：{taskInfo.model_id}</span>
+            </div>
+          )}
+        </div>
+        <Button onClick={() => navigate(-1)}>返回</Button>
+      </div>
+
+      {/* 主体左右布局 */}
+      <div className="flex flex-1 min-h-0 gap-4">
+        {/* 左侧 Chunk 列表：占比 2/5 */}
+        <div className="basis-2/5 max-w-[40%] border rounded-lg flex flex-col overflow-hidden">
+          <div className="px-3 py-2 border-b text-sm font-medium bg-gray-50">
+            Chunk 列表
+          </div>
+          <div className="flex-1 overflow-auto">
+            {chunkLoading ? (
+              <div className="h-full flex items-center justify-center">
+                <Spin />
+              </div>
+            ) : chunks.length === 0 ? (
+              <Empty description="暂无 Chunk" style={{ marginTop: 40 }} />
+            ) : (
+              <List
+                size="small"
+                dataSource={chunks}
+                renderItem={(item) => {
+                  const active = item.id === selectedChunkId;
+                  return (
+                    <List.Item
+                      className={
+                        "cursor-pointer px-3 py-2 !border-0 " +
+                        (active ? "bg-blue-50" : "hover:bg-gray-50")
+                      }
+                      onClick={() => setSelectedChunkId(item.id)}
+                    >
+                      <div className="flex flex-col gap-1 w-full">
+                        <div className="flex items-center justify-between text-xs">
+                          <span className="font-medium">Chunk #{item.chunk_index}</span>
+                          <Badge
+                            color={active ? "blue" : "default"}
+                            text={active ? "当前" : ""}
+                          />
+                        </div>
+                        {/* 展示 chunk 全部内容，不截断 */}
+                        <div className="text-xs text-gray-600 whitespace-pre-wrap break-words">
+                          {item.chunk_content}
+                        </div>
+                      </div>
+                    </List.Item>
+                  );
+                }}
+              />
+            )}
+          </div>
+          <div className="border-t px-2 py-1 flex justify-end bg-white">
+            <Pagination
+              size="small"
+              current={chunkPagination.page}
+              pageSize={chunkPagination.size}
+              total={chunkPagination.total}
+              onChange={handleChunkPageChange}
+              showSizeChanger
+              showTotal={(total) => `共 ${total} 条`}
+            />
+          </div>
+        </div>
+
+        {/* 右侧合成数据展示：占比 3/5 */}
+        <div className="basis-3/5 max-w-[60%] border rounded-lg flex flex-col min-w-0 overflow-hidden">
+          <div className="px-3 py-2 border-b flex items-center justify-between bg-gray-50 text-sm font-medium">
+            <span>合成数据</span>
+            {currentChunk && (
+              <span className="text-xs text-gray-500">
+                当前 Chunk #{currentChunk.chunk_index}
+              </span>
+            )}
+          </div>
+          <div className="flex-1 overflow-auto p-3">
+            {dataLoading ? (
+              <div className="h-full flex items-center justify-center">
+                <Spin />
+              </div>
+            ) : !selectedChunkId ? (
+              <Empty description="请选择左侧 Chunk" style={{ marginTop: 40 }} />
+            ) : synthDataList.length === 0 ? (
+              <Empty description="该 Chunk 暂无合成数据" style={{ marginTop: 40 }} />
+            ) : (
+              <div className="space-y-4">
+                {synthDataList.map((item, index) => (
+                  <div
+                    key={item.id || index}
+                    className="border border-gray-100 rounded-md p-3 bg-white shadow-sm/50"
+                  >
+                    <div className="mb-2 text-xs text-gray-500 flex justify-between">
+                      <span>记录 {index + 1}</span>
+                      <span>ID：{item.id}</span>
+                    </div>
+                    {/* 淡化表格样式的 key-value 展示 */}
+                    <div className="w-full border border-gray-100 rounded-md overflow-hidden">
+                      {getDataEntries(item.data).map(([key, value], rowIdx) => (
+                        <div
+                          key={key + rowIdx}
+                          className={
+                            "grid grid-cols-[120px,1fr] text-xs " +
+                            (rowIdx % 2 === 0 ? "bg-gray-50/60" : "bg-white")
+                          }
+                        >
+                          <div className="px-3 py-2 border-r border-gray-100 font-medium text-gray-600 break-words">
+                            {key}
+                          </div>
+                          <div className="px-3 py-2 text-gray-700 whitespace-pre-wrap break-words">
+                            {typeof value === "string" || typeof value === "number"
+                              ? String(value)
+                              : JSON.stringify(value, null, 2)}
+                          </div>
+                        </div>
+                      ))}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

frontend/src/pages/SynthesisTask/SynthFileTask.tsx

@@ -97,6 +97,14 @@ export default function SynthFileTask() {
       title: "文件名",
       dataIndex: "file_name",
       key: "file_name",
+      render: (text: string, record) => (
+        <Button
+          type="link"
+          onClick={() => navigate(`/data/synthesis/task/file/${record.id}/detail`, { state: { fileName: record.file_name, taskId } })}
+        >
+          {text}
+        </Button>
+      ),
     },
     {
       title: "状态",

frontend/src/pages/SynthesisTask/synthesis-api.ts

@@ -1,8 +1,8 @@
 import { get, post, del } from "@/utils/request";
 
 // 创建数据合成任务
-export function createSynthesisTaskUsingPost(data: unknown) {
-  return post("/api/synthesis/gen/task", data);
+export function createSynthesisTaskUsingPost(data: Record<string, unknown>) {
+  return post("/api/synthesis/gen/task", data as unknown as Record<string, never>);
 }
 
 // 获取数据合成任务详情
@@ -18,7 +18,7 @@ export function querySynthesisTasksUsingGet(params: {
   status?: string;
   name?: string;
 }) {
-  return get(`/api/synthesis/gen/tasks`, params as any);
+  return get(`/api/synthesis/gen/tasks`, params);
 }
 
 // 删除整个数据合成任务
@@ -28,10 +28,20 @@ export function deleteSynthesisTaskByIdUsingDelete(taskId: string) {
 
 // 分页查询某个任务下的文件任务列表
 export function querySynthesisFileTasksUsingGet(taskId: string, params: { page?: number; page_size?: number }) {
-  return get(`/api/synthesis/gen/task/${taskId}/files`, params as any);
+  return get(`/api/synthesis/gen/task/${taskId}/files`, params);
+}
+
+// 根据文件任务 ID 分页查询 chunk 记录
+export function queryChunksByFileUsingGet(fileId: string, params: { page?: number; page_size?: number }) {
+  return get(`/api/synthesis/gen/file/${fileId}/chunks`, params);
+}
+
+// 根据 chunk ID 查询所有合成结果数据
+export function querySynthesisDataByChunkUsingGet(chunkId: string) {
+  return get(`/api/synthesis/gen/chunk/${chunkId}/data`);
 }
 
 // 获取不同合成类型对应的 Prompt
 export function getPromptByTypeUsingGet(synthType: string) {
-  return get(`/api/synthesis/gen/prompt`, { synth_type: synthType } as any);
+  return get(`/api/synthesis/gen/prompt`, { synth_type: synthType });
 }