tian/AnsysLink
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
48d95a77bb
AnsysLink/.kiro/specs/remove-simulation-mode/requirements.md
tian 48d95a77bb 移除仿真模式
2025-08-11 13:58:59 +08:00

4.6 KiB
Raw Blame History

Requirements Document

Introduction

本项目需要移除现有的仿真模式，只保留真实的ANSYS Mechanical集成模式。系统应该能够真正调用ANSYS API来生成网格文件、获取生成的网格文件信息、网格质量数据，并导出网格可视化图片用于Web界面展示。这是从演示原型向生产就绪系统的重要升级。

Requirements

Requirement 1

User Story: 作为一名开发者，我希望移除所有仿真模式相关的代码，以便系统只使用真实的ANSYS Mechanical集成。

Acceptance Criteria

  1. WHEN 系统启动时 THEN 系统 SHALL 不再提供仿真模式选项
  2. WHEN 用户发起网格生成请求时 THEN 系统 SHALL 只使用真实的PyMechanical API调用ANSYS
  3. WHEN 检查代码库时 THEN 系统 SHALL 不包含任何simulation_mode相关的参数或逻辑
  4. IF ANSYS不可用 THEN 系统 SHALL 返回明确的错误信息而不是回退到仿真模式

Requirement 2

User Story: 作为一名CAE工程师，我希望系统能够真正调用ANSYS Mechanical生成网格文件，以便获得真实的仿真结果。

Acceptance Criteria

  1. WHEN 网格生成完成时 THEN 系统 SHALL 通过PyMechanical API调用ANSYS Mechanical的mesh.GenerateMesh()方法
  2. WHEN 网格生成成功时 THEN 系统 SHALL 能够从ANSYS会话中获取真实的网格统计数据
  3. WHEN 网格生成过程中 THEN 系统 SHALL 提供真实的进度反馈而不是模拟的进度
  4. WHEN 网格生成失败时 THEN 系统 SHALL 捕获并报告真实的ANSYS错误信息

Requirement 3

User Story: 作为一名CAE工程师，我希望系统能够获取生成的网格文件和详细信息，以便进行后续的分析工作。

Acceptance Criteria

  1. WHEN 网格生成完成时 THEN 系统 SHALL 能够通过PyMechanical API获取真实的单元数量和节点数量
  2. WHEN 请求网格质量信息时 THEN 系统 SHALL 从ANSYS中获取真实的网格质量指标（单元质量、纵横比、偏斜度等）
  3. WHEN 需要导出网格数据时 THEN 系统 SHALL 能够将网格数据导出为标准格式（如.msh、.cdb文件）
  4. WHEN 获取网格信息时 THEN 系统 SHALL 提供详细的网格统计信息包括单元类型分布

Requirement 4

User Story: 作为一名CAE工程师，我希望系统能够生成真实的网格可视化图片，以便在Web界面中查看网格质量。

Acceptance Criteria

  1. WHEN 网格生成完成时 THEN 系统 SHALL 通过PyMechanical的Graphics.ExportImage()方法导出网格可视化图片
  2. WHEN 导出图片时 THEN 系统 SHALL 支持多种视角（等轴测图、前视图、侧视图、俯视图）
  3. WHEN 生成可视化时 THEN 系统 SHALL 能够显示网格质量颜色映射以便识别问题区域
  4. WHEN 图片导出完成时 THEN 系统 SHALL 提供高分辨率图片（至少1280x720）用于Web展示

Requirement 5

User Story: 作为一名系统管理员，我希望系统具有强健的错误处理机制，以便在ANSYS集成出现问题时能够提供有用的诊断信息。

Acceptance Criteria

  1. WHEN ANSYS启动失败时 THEN 系统 SHALL 提供详细的错误信息包括可能的解决方案
  2. WHEN PyMechanical导入失败时 THEN 系统 SHALL 检查ANSYS安装和许可证状态并报告具体问题
  3. WHEN 网格生成超时时 THEN 系统 SHALL 能够安全地终止ANSYS会话并清理资源
  4. WHEN 系统资源不足时 THEN 系统 SHALL 监控内存和磁盘使用情况并提供预警

Requirement 6

User Story: 作为一名CAE工程师，我希望系统能够提供真实的网格生成进度跟踪，以便了解处理状态。

Acceptance Criteria

  1. WHEN 网格生成开始时 THEN 系统 SHALL 通过ANSYS API监控真实的生成进度
  2. WHEN 生成过程中 THEN 系统 SHALL 提供当前操作的详细状态信息（如"正在生成单元"、"正在优化网格质量"）
  3. WHEN 长时间操作时 THEN 系统 SHALL 定期更新进度百分比和预估剩余时间
  4. WHEN 用户请求取消时 THEN 系统 SHALL 能够安全地中断ANSYS操作并清理会话

Requirement 7

User Story: 作为一名开发者，我希望系统的API接口保持一致，以便前端代码无需大幅修改。

Acceptance Criteria

  1. WHEN 移除仿真模式后 THEN 现有的API端点 SHALL 继续工作但只返回真实数据
  2. WHEN API响应格式时 THEN 系统 SHALL 保持相同的JSON结构但填充真实的ANSYS数据
  3. WHEN 错误处理时 THEN 系统 SHALL 使用相同的错误响应格式但包含真实的错误信息
  4. WHEN 前端请求数据时 THEN 系统 SHALL 确保响应时间在合理范围内（通常小于30秒）