feat(ssa): Complete T-test end-to-end testing with 9 bug fixes - Phase 1 core 85% complete. R service: missing value auto-filter. Backend: error handling, variable matching, dynamic filename. Frontend: module activation, session isolation, error propagation. Full flow verified.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-19 20:57:00 +08:00
parent 8137e3cde2
commit 49b5c37cb1
86 changed files with 21207 additions and 252 deletions
--- a/backend/src/modules/ssa/routes/analysis.routes.ts
+++ b/backend/src/modules/ssa/routes/analysis.routes.ts
@@ -0,0 +1,349 @@
+/**
+ * SSA 分析执行路由
+ * 
+ * 遵循规范：
+ * - 使用 getUserId（模块认证规范）
+ * - 使用 storage（OSS 存储规范）
+ * - 使用 logger（日志服务）
+ */
+
+import { FastifyInstance, FastifyRequest } from 'fastify';
+import { RClientService } from '../executor/RClientService.js';
+import { prisma } from '../../../config/database.js';
+import { storage } from '../../../common/storage/index.js';
+import { logger } from '../../../common/logging/index.js';
+
+function getUserId(request: FastifyRequest): string {
+  const userId = (request as any).user?.userId;
+  if (!userId) {
+    throw new Error('User not authenticated');
+  }
+  return userId;
+}
+
+function getTenantId(request: FastifyRequest): string {
+  return (request as any).user?.tenantId || 'default';
+}
+
+export default async function analysisRoutes(app: FastifyInstance) {
+  const rClient = new RClientService();
+
+  // 上传数据（遵循 OSS 存储规范）
+  app.post('/:id/upload', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const userId = getUserId(req);
+    const tenantId = getTenantId(req);
+    const data = await req.file();
+    
+    if (!data) {
+      return reply.status(400).send({ error: 'No file uploaded' });
+    }
+    
+    const buffer = await data.toBuffer();
+    const filename = data.filename;
+    
+    // 生成存储 Key（遵循 OSS 目录结构规范）
+    const uuid = crypto.randomUUID().replace(/-/g, '').substring(0, 16);
+    const ext = filename.split('.').pop()?.toLowerCase() || 'csv';
+    const storageKey = `tenants/${tenantId}/users/${userId}/ssa/${uuid}.${ext}`;
+    
+    // 上传到存储服务
+    await storage.upload(storageKey, buffer);
+    logger.info('[SSA:Analysis] Data uploaded', { sessionId: id, storageKey });
+    
+    // 更新会话
+    await prisma.ssaSession.update({
+      where: { id },
+      data: { dataOssKey: storageKey }
+    });
+    
+    return reply.send({ 
+      success: true, 
+      message: 'Data uploaded successfully',
+      sessionId: id,
+      storageKey
+    });
+  });
+
+  // 生成分析计划
+  app.post('/:id/plan', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const { query } = req.body as { query: string };
+    
+    // 获取会话数据 schema
+    const session = await prisma.ssaSession.findUnique({
+      where: { id },
+      select: { dataSchema: true }
+    });
+    
+    // TODO: 调用 PlannerService 根据 query 和 schema 推荐分析方法
+    // const plan = await plannerService.generatePlan(id, query, session?.dataSchema);
+    
+    // 从 schema 中提取列名用于智能推荐
+    const schema = session?.dataSchema as any;
+    const columns = schema?.columns || [];
+    const columnNames = columns.map((c: any) => c.name.toLowerCase());
+    
+    // 从用户查询中提取变量名（简单的关键词匹配）
+    const queryLower = query.toLowerCase();
+    
+    // 找出查询中提到的所有列
+    const mentionedColumns = columns.filter((col: any) => 
+      queryLower.includes(col.name.toLowerCase())
+    );
+    
+    logger.info('[SSA:Analysis] Mentioned columns', { 
+      query, 
+      mentionedColumns: mentionedColumns.map((c: any) => ({ name: c.name, type: c.type }))
+    });
+    
+    // 从提到的列中分配变量（分类 → 分组，数值 → 值）
+    let groupVar = '';
+    let valueVar = '';
+    
+    for (const col of mentionedColumns) {
+      if (col.type === 'categorical' && !groupVar) {
+        groupVar = col.name;
+      } else if (col.type === 'numeric' && !valueVar) {
+        valueVar = col.name;
+      }
+    }
+    
+    // 如果查询中只提到了一种类型，从未提到的列中补充
+    if (!groupVar && mentionedColumns.length > 0) {
+      // 查询中没有分类变量，从其他分类变量中选一个
+      const otherCategorical = columns.find((c: any) => 
+        c.type === 'categorical' && !mentionedColumns.some((m: any) => m.name === c.name)
+      );
+      groupVar = otherCategorical?.name || columns.find((c: any) => c.type === 'categorical')?.name || '';
+    }
+    
+    if (!valueVar && mentionedColumns.length > 0) {
+      // 查询中没有数值变量，从其他数值变量中选一个
+      const otherNumeric = columns.find((c: any) => 
+        c.type === 'numeric' && !mentionedColumns.some((m: any) => m.name === c.name)
+      );
+      valueVar = otherNumeric?.name || columns.find((c: any) => c.type === 'numeric')?.name || '';
+    }
+    
+    // 如果完全没有匹配到，使用默认策略（但避免使用同一个变量）
+    if (!groupVar) {
+      groupVar = columns.find((c: any) => c.type === 'categorical' && c.name !== valueVar)?.name || columns[0]?.name || 'group';
+    }
+    if (!valueVar) {
+      valueVar = columns.find((c: any) => c.type === 'numeric' && c.name !== groupVar)?.name || columns[1]?.name || 'value';
+    }
+    
+    // 最终检查：确保两个变量不相同
+    if (groupVar === valueVar && columns.length > 1) {
+      // 如果相同，重新选择
+      const otherCol = columns.find((c: any) => c.name !== groupVar);
+      if (otherCol) {
+        if (otherCol.type === 'numeric') {
+          valueVar = otherCol.name;
+        } else {
+          groupVar = otherCol.name;
+        }
+      }
+    }
+    
+    logger.info('[SSA:Analysis] Variable matching', { 
+      query, 
+      matchedGroupVar: groupVar, 
+      matchedValueVar: valueVar,
+      availableColumns: columnNames 
+    });
+    
+    // 返回前端期望的 AnalysisPlan 格式（camelCase）
+    const mockPlan = {
+      id: `plan_${Date.now()}`,
+      toolCode: 'ST_T_TEST_IND',
+      toolName: '独立样本 T 检验',
+      description: `根据您的数据特征和分析需求"${query}"，推荐使用独立样本 T 检验，比较 ${groupVar} 分组下 ${valueVar} 的差异。`,
+      parameters: {
+        group_var: groupVar,
+        value_var: valueVar
+      },
+      guardrails: [
+        { checkName: '正态性检验', checkCode: 'NORMALITY', actionType: 'Switch', actionTarget: 'WILCOXON' },
+        { checkName: '样本量检查', checkCode: 'SAMPLE_SIZE', threshold: 'n >= 30', actionType: 'Warn' }
+      ],
+      confidence: 0.85
+    };
+    
+    logger.info('[SSA:Analysis] Plan generated', { sessionId: id, query, toolCode: mockPlan.toolCode, params: mockPlan.parameters });
+    
+    return reply.send(mockPlan);
+  });
+
+  // 执行分析
+  app.post('/:id/execute', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const { plan } = req.body as { plan: any };
+    
+    logger.info('[SSA:Analysis] Execute request', { sessionId: id, plan });
+    
+    try {
+      // 验证 plan 参数
+      if (!plan || !plan.tool_code) {
+        logger.error('[SSA:Analysis] Invalid plan', { plan });
+        return reply.status(400).send({ 
+          error: 'Invalid plan: missing tool_code',
+          user_hint: '分析计划无效，请重新生成'
+        });
+      }
+      
+      // 获取会话数据
+      const session = await prisma.ssaSession.findUnique({
+        where: { id }
+      });
+      
+      if (!session) {
+        logger.error('[SSA:Analysis] Session not found', { sessionId: id });
+        return reply.status(404).send({ error: 'Session not found' });
+      }
+      
+      if (!session.dataOssKey) {
+        logger.error('[SSA:Analysis] No data uploaded', { sessionId: id });
+        return reply.status(400).send({ 
+          error: 'No data uploaded',
+          user_hint: '请先上传数据文件'
+        });
+      }
+      
+      logger.info('[SSA:Analysis] Calling R service', { 
+        sessionId: id, 
+        toolCode: plan.tool_code,
+        dataOssKey: session.dataOssKey 
+      });
+      
+      // 调用 R 服务
+      const result = await rClient.execute(id, plan, session);
+      
+      logger.info('[SSA:Analysis] R service returned', { 
+        sessionId: id, 
+        status: result?.status,
+        hasResults: !!result?.results,
+        message: result?.message,
+        userHint: result?.user_hint
+      });
+      
+      // 检查 R 服务是否返回错误
+      if (result?.status === 'error') {
+        logger.warn('[SSA:Analysis] R service returned error', {
+          sessionId: id,
+          errorCode: result.error_code,
+          message: result.message
+        });
+        
+        // 保存错误消息（用于历史记录）
+        await prisma.ssaMessage.create({
+          data: {
+            sessionId: id,
+            role: 'assistant',
+            contentType: 'error',
+            content: result
+          }
+        });
+        
+        // 返回业务错误（使用 422 表示数据不符合业务规则）
+        return reply.status(422).send({
+          status: 'error',
+          error: result.message || '分析执行失败',
+          error_code: result.error_code,
+          user_hint: result.user_hint || result.message
+        });
+      }
+      
+      // 保存成功结果消息
+      await prisma.ssaMessage.create({
+        data: {
+          sessionId: id,
+          role: 'assistant',
+          contentType: 'result',
+          content: result
+        }
+      });
+      
+      return reply.send(result);
+      
+    } catch (error: any) {
+      logger.error('[SSA:Analysis] Execute failed', { 
+        sessionId: id, 
+        error: error.message,
+        stack: error.stack 
+      });
+      
+      return reply.status(500).send({ 
+        error: error.message,
+        user_hint: '分析执行失败，请检查 R 服务是否正常运行'
+      });
+    }
+  });
+
+  // 下载代码
+  app.get('/:id/download-code', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    
+    // 获取会话信息（用于文件名）
+    const session = await prisma.ssaSession.findUnique({
+      where: { id },
+      select: { title: true, createdAt: true }
+    });
+    
+    // 获取最新的执行结果消息
+    const latestMessage = await prisma.ssaMessage.findFirst({
+      where: { 
+        sessionId: id,
+        contentType: 'result'
+      },
+      orderBy: { createdAt: 'desc' }
+    });
+    
+    let code = `# SSA-Pro 生成的 R 代码\n# Session: ${id}\n# 暂无可用代码\n`;
+    let toolName = 'analysis';
+    
+    if (latestMessage?.content) {
+      const content = latestMessage.content as any;
+      // 从消息内容中提取 reproducible_code
+      const reproducibleCode = content.reproducible_code || content.reproducibleCode;
+      if (reproducibleCode) {
+        code = reproducibleCode;
+      }
+      // 提取工具名称
+      if (content.results?.method) {
+        toolName = content.results.method.replace(/\s+/g, '_').replace(/[^a-zA-Z0-9_]/g, '');
+      }
+    }
+    
+    // 生成有意义的文件名：工具名_数据文件名_月日_时分
+    const now = new Date();
+    const dateStr = `${String(now.getMonth() + 1).padStart(2, '0')}${String(now.getDate()).padStart(2, '0')}`;
+    const timeStr = `${String(now.getHours()).padStart(2, '0')}${String(now.getMinutes()).padStart(2, '0')}`;
+    
+    // 从 session title 提取数据文件名（去除扩展名和特殊字符）
+    let dataName = 'data';
+    if (session?.title) {
+      dataName = session.title
+        .replace(/\.(csv|xlsx|xls)$/i, '')
+        .replace(/[^a-zA-Z0-9\u4e00-\u9fa5_-]/g, '_')
+        .substring(0, 20);
+    }
+    
+    const filename = `${toolName}_${dataName}_${dateStr}_${timeStr}.R`;
+    
+    logger.info('[SSA:Analysis] Download code', { sessionId: id, filename, hasCode: code.length > 50 });
+    
+    reply.header('Content-Type', 'text/plain; charset=utf-8');
+    reply.header('Content-Disposition', `attachment; filename="${encodeURIComponent(filename)}"`);
+    return reply.send(code);
+  });
+
+  // 健康检查
+  app.get('/r-service/health', async (req, reply) => {
+    const healthy = await rClient.healthCheck();
+    return reply.send({ 
+      r_service: healthy ? 'ok' : 'unavailable' 
+    });
+  });
+}
--- a/backend/src/modules/ssa/routes/config.routes.ts
+++ b/backend/src/modules/ssa/routes/config.routes.ts
@@ -0,0 +1,130 @@
+/**
+ * SSA 配置中台路由
+ * 
+ * 遵循规范：
+ * - 管理员接口需要权限校验
+ * - 使用 logger（日志服务）
+ */
+
+import { FastifyInstance, FastifyRequest } from 'fastify';
+import { prisma } from '../../../config/database.js';
+import { logger } from '../../../common/logging/index.js';
+
+function getUserId(request: FastifyRequest): string {
+  const userId = (request as any).user?.userId;
+  if (!userId) {
+    throw new Error('User not authenticated');
+  }
+  return userId;
+}
+
+export default async function configRoutes(app: FastifyInstance) {
+
+  // 导入决策表
+  app.post('/decision-table', async (req, reply) => {
+    const data = await req.file();
+    if (!data) {
+      return reply.status(400).send({ error: 'No file uploaded' });
+    }
+    
+    // TODO: 解析 Excel 并导入决策表
+    
+    return reply.send({ 
+      success: true, 
+      message: 'Decision table imported successfully'
+    });
+  });
+
+  // 获取决策表
+  app.get('/decision-table', async (req, reply) => {
+    // TODO: 从数据库获取决策表
+    return reply.send([]);
+  });
+
+  // 上传 R 脚本
+  app.post('/r-scripts', async (req, reply) => {
+    const data = await req.file();
+    if (!data) {
+      return reply.status(400).send({ error: 'No file uploaded' });
+    }
+    
+    // TODO: 保存 R 脚本到数据库
+    
+    return reply.send({ 
+      success: true, 
+      message: 'R script uploaded successfully'
+    });
+  });
+
+  // 获取脚本列表
+  app.get('/r-scripts', async (req, reply) => {
+    // TODO: 从数据库获取脚本列表
+    return reply.send([]);
+  });
+
+  // 导入工具配置
+  app.post('/tool-config', async (req, reply) => {
+    const data = await req.file();
+    if (!data) {
+      return reply.status(400).send({ error: 'No file uploaded' });
+    }
+    
+    // TODO: 解析 Excel 并导入工具配置
+    
+    return reply.send({ 
+      success: true, 
+      message: 'Tool config imported successfully'
+    });
+  });
+
+  // 获取工具列表
+  app.get('/tools', async (req, reply) => {
+    // TODO: 从配置缓存获取工具列表
+    return reply.send([
+      {
+        tool_code: 'ST_T_TEST_IND',
+        name: '独立样本 T 检验',
+        description: '比较两组独立样本的均值差异',
+        category: '假设检验'
+      }
+    ]);
+  });
+
+  // 获取参数映射
+  app.get('/tools/:code/params', async (req, reply) => {
+    const { code } = req.params as { code: string };
+    
+    // TODO: 从数据库获取参数映射
+    return reply.send([]);
+  });
+
+  // 获取护栏规则
+  app.get('/tools/:code/guardrails', async (req, reply) => {
+    const { code } = req.params as { code: string };
+    
+    // TODO: 从数据库获取护栏规则
+    return reply.send([]);
+  });
+
+  // 热加载配置
+  app.post('/reload', async (req, reply) => {
+    // TODO: 重新加载所有配置到缓存
+    
+    return reply.send({ 
+      success: true, 
+      timestamp: new Date().toISOString() 
+    });
+  });
+
+  // 校验配置文件
+  app.post('/validate', async (req, reply) => {
+    const data = await req.file();
+    if (!data) {
+      return reply.status(400).send({ error: 'No file uploaded' });
+    }
+    
+    // TODO: 仅校验，不导入
+    
+    return reply.send({ valid: true });
+  });
+}
--- a/backend/src/modules/ssa/routes/consult.routes.ts
+++ b/backend/src/modules/ssa/routes/consult.routes.ts
@@ -0,0 +1,186 @@
+/**
+ * SSA 咨询模式路由
+ * 
+ * 遵循规范：
+ * - 使用 StreamingService（流式响应服务）
+ * - 使用 LLMFactory（LLM 网关）
+ * - 使用 getUserId（模块认证规范）
+ */
+
+import { FastifyInstance, FastifyRequest } from 'fastify';
+import { prisma } from '../../../config/database.js';
+import { createStreamingService } from '../../../common/streaming/index.js';
+import { LLMFactory } from '../../../common/llm/adapters/LLMFactory.js';
+import { logger } from '../../../common/logging/index.js';
+
+function getUserId(request: FastifyRequest): string {
+  const userId = (request as any).user?.userId;
+  if (!userId) {
+    throw new Error('User not authenticated');
+  }
+  return userId;
+}
+
+export default async function consultRoutes(app: FastifyInstance) {
+
+  // 创建咨询会话（无数据）
+  app.post('/', async (req, reply) => {
+    const userId = getUserId(req);
+    
+    const session = await prisma.ssaSession.create({
+      data: {
+        userId,
+        title: '统计咨询',
+        status: 'consult'
+      }
+    });
+    
+    return reply.send(session);
+  });
+
+  // 咨询对话（非流式）
+  app.post('/:id/chat', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const { message } = req.body as { message: string };
+    const userId = getUserId(req);
+    
+    // 保存用户消息
+    await prisma.ssaMessage.create({
+      data: {
+        sessionId: id,
+        role: 'user',
+        contentType: 'text',
+        content: { text: message }
+      }
+    });
+    
+    // TODO: 调用 ConsultService 生成回复
+    const response = `感谢您的咨询。根据您描述的研究设计，我建议考虑以下统计方法...`;
+    
+    // 保存助手回复
+    await prisma.ssaMessage.create({
+      data: {
+        sessionId: id,
+        role: 'assistant',
+        contentType: 'text',
+        content: { text: response }
+      }
+    });
+    
+    return reply.send({ response });
+  });
+
+  // 咨询对话（流式）- 使用 StreamingService
+  app.post('/:id/chat/stream', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const { message } = req.body as { message: string };
+    const userId = getUserId(req);
+    
+    logger.info('[SSA:Consult] Stream chat started', { sessionId: id, userId });
+    
+    // 保存用户消息
+    await prisma.ssaMessage.create({
+      data: {
+        sessionId: id,
+        role: 'user',
+        contentType: 'text',
+        content: { text: message }
+      }
+    });
+    
+    // 获取历史消息
+    const history = await prisma.ssaMessage.findMany({
+      where: { sessionId: id },
+      orderBy: { createdAt: 'asc' },
+      take: 20
+    });
+    
+    // 构建消息列表
+    const messages = [
+      {
+        role: 'system' as const,
+        content: `你是一个专业的生物统计咨询师。请根据用户的研究设计和需求，提供统计分析建议，并帮助用户制定统计分析计划（SAP）。
+要点：
+1. 理解研究设计（实验/观察、独立/配对、随机/分层等）
+2. 明确研究假设和主要终点
+3. 推荐合适的统计方法
+4. 提示统计前提条件和注意事项`
+      },
+      ...history.map(m => ({
+        role: m.role as 'user' | 'assistant',
+        content: (m.content as any).text || ''
+      }))
+    ];
+    
+    // 使用 StreamingService 流式输出
+    const streamingService = createStreamingService(reply, {
+      model: 'deepseek-v3',
+      temperature: 0.7,
+      maxTokens: 4096,
+      enableDeepThinking: true,
+      userId,
+      conversationId: id,
+    });
+    
+    await streamingService.streamGenerate(messages, {
+      onComplete: async (content, thinking) => {
+        // 保存助手回复
+        await prisma.ssaMessage.create({
+          data: {
+            sessionId: id,
+            role: 'assistant',
+            contentType: 'text',
+            content: { text: content, thinking }
+          }
+        });
+        logger.info('[SSA:Consult] Stream chat completed', { sessionId: id });
+      }
+    });
+  });
+
+  // 生成 SAP 文档
+  app.post('/:id/generate-sap', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    
+    // TODO: 调用 SAPGeneratorService
+    const sap = {
+      title: '统计分析计划',
+      sections: [
+        { heading: '研究背景', content: '...' },
+        { heading: '数据描述', content: '...' },
+        { heading: '统计假设', content: '...' },
+        { heading: '分析方法', content: '...' },
+        { heading: '结果解读指南', content: '...' },
+        { heading: '注意事项', content: '...' }
+      ],
+      recommendedTools: ['ST_T_TEST_IND'],
+      metadata: {
+        generatedAt: new Date().toISOString(),
+        sessionId: id,
+        version: '1.0'
+      }
+    };
+    
+    return reply.send(sap);
+  });
+
+  // 下载 SAP 文档
+  app.get('/:id/download-sap', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    const { format } = req.query as { format?: string };
+    
+    // TODO: 生成 Word 或 Markdown 格式
+    const content = `# 统计分析计划\n\n## 研究背景\n...`;
+    
+    if (format === 'word') {
+      // TODO: 使用 docx 库生成 Word
+      reply.header('Content-Type', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document');
+      reply.header('Content-Disposition', `attachment; filename="SAP_${id}.docx"`);
+    } else {
+      reply.header('Content-Type', 'text/markdown');
+      reply.header('Content-Disposition', `attachment; filename="SAP_${id}.md"`);
+    }
+    
+    return reply.send(content);
+  });
+}
--- a/backend/src/modules/ssa/routes/session.routes.ts
+++ b/backend/src/modules/ssa/routes/session.routes.ts
@@ -0,0 +1,138 @@
+/**
+ * SSA 会话管理路由
+ * 
+ * 遵循规范：
+ * - 使用 getUserId（模块认证规范）
+ * - 使用 logger（日志服务）
+ * - 使用 storage（OSS 存储规范）
+ */
+
+import { FastifyInstance, FastifyRequest } from 'fastify';
+import crypto from 'crypto';
+import { prisma } from '../../../config/database.js';
+import { logger } from '../../../common/logging/index.js';
+import { storage } from '../../../common/storage/index.js';
+import { DataParserService } from '../services/DataParserService.js';
+
+function getUserId(request: FastifyRequest): string {
+  const userId = (request as any).user?.userId;
+  if (!userId) {
+    throw new Error('User not authenticated');
+  }
+  return userId;
+}
+
+function getTenantId(request: FastifyRequest): string {
+  return (request as any).user?.tenantId || 'default';
+}
+
+export default async function sessionRoutes(app: FastifyInstance) {
+  
+  // 创建会话（支持同时上传文件）
+  app.post('/', async (req, reply) => {
+    const userId = getUserId(req);
+    const tenantId = getTenantId(req);
+    
+    // 检查是否有文件上传
+    const contentType = req.headers['content-type'] || '';
+    const isMultipart = contentType.includes('multipart/form-data');
+    
+    let dataOssKey: string | null = null;
+    let dataSchema: any = null;
+    let title = '新分析会话';
+    
+    if (isMultipart) {
+      // 处理文件上传
+      const data = await req.file();
+      if (data) {
+        const buffer = await data.toBuffer();
+        const filename = data.filename;
+        title = filename;
+        
+        // 生成存储 Key（遵循 OSS 目录结构规范）
+        const uuid = crypto.randomUUID().replace(/-/g, '').substring(0, 16);
+        const ext = filename.split('.').pop()?.toLowerCase() || 'csv';
+        dataOssKey = `tenants/${tenantId}/users/${userId}/ssa/${uuid}.${ext}`;
+        
+        // 上传到 OSS
+        await storage.upload(dataOssKey, buffer);
+        logger.info('[SSA:Session] File uploaded to OSS', { dataOssKey, filename });
+        
+        // 解析数据 schema
+        try {
+          const parser = new DataParserService();
+          dataSchema = await parser.parseSchema(buffer, ext);
+          logger.info('[SSA:Session] Data schema parsed', { 
+            columns: dataSchema.columns.length,
+            rowCount: dataSchema.rowCount 
+          });
+        } catch (parseError) {
+          logger.warn('[SSA:Session] Schema parsing failed, continuing without schema', { error: parseError });
+        }
+      }
+    }
+    
+    // 创建会话
+    const session = await prisma.ssaSession.create({
+      data: {
+        userId,
+        title,
+        status: 'active',
+        dataOssKey,
+        dataSchema
+      }
+    });
+    
+    logger.info('[SSA:Session] Session created', { 
+      sessionId: session.id, 
+      hasFile: !!dataOssKey 
+    });
+    
+    // 返回前端期望的格式
+    return reply.send({
+      sessionId: session.id,
+      schema: dataSchema || { columns: [], rowCount: 0 }
+    });
+  });
+
+  // 获取会话列表
+  app.get('/', async (req, reply) => {
+    const userId = getUserId(req);
+    
+    const sessions = await prisma.ssaSession.findMany({
+      where: { userId },
+      orderBy: { createdAt: 'desc' },
+      take: 20
+    });
+    
+    return reply.send(sessions);
+  });
+
+  // 获取会话详情
+  app.get('/:id', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    
+    const session = await prisma.ssaSession.findUnique({
+      where: { id },
+      include: { messages: true }
+    });
+    
+    if (!session) {
+      return reply.status(404).send({ error: 'Session not found' });
+    }
+    
+    return reply.send(session);
+  });
+
+  // 获取消息历史
+  app.get('/:id/messages', async (req, reply) => {
+    const { id } = req.params as { id: string };
+    
+    const messages = await prisma.ssaMessage.findMany({
+      where: { sessionId: id },
+      orderBy: { createdAt: 'asc' }
+    });
+    
+    return reply.send(messages);
+  });
+}