3.7 KiB
3.7 KiB
订单导入功能模块 - FTP 集成功能 - 产品需求文档
概述
- 摘要：在订单导入功能模块中整合面单文件上传功能和 FTP 上传检查功能，无需提供上传目录选择参数，系统默认使用预设的上传目录路径，实现文件自动上传至指定位置，并完成 FTP 上传状态的自动检查与反馈。
- 目的：简化用户操作流程，减少用户输入错误，确保面单文件能够正确上传到指定的 FTP 位置，并及时反馈上传状态。
- 目标用户：使用订单导入功能的操作人员，需要上传面单文件到 FTP 服务器的用户。
目标
- 整合面单文件上传功能到订单导入模块
- 整合 FTP 上传检查功能到订单导入模块
- 系统默认使用预设的上传目录路径，无需用户输入
- 实现文件自动上传至指定位置
- 完成 FTP 上传状态的自动检查与反馈
非目标（超出范围）
- 不修改现有的订单导入核心逻辑
- 不改变现有的 FTP 服务器配置
- 不添加新的用户界面元素，保持界面简洁
背景与上下文
- 现有系统已经实现了订单导入功能，可以通过 Excel 文件导入订单数据
- 现有系统已经实现了面单文件上传功能，可以上传文件到 FTP 服务器
- 现有系统已经实现了 FTP 上传检查功能，可以检查文件是否存在于 FTP 服务器
- 用户当前需要在不同的标签页之间切换来完成订单导入、文件上传和上传检查，操作繁琐
功能需求
- FR-1：在订单导入功能模块中整合面单文件上传功能
- FR-2：在订单导入功能模块中整合 FTP 上传检查功能
- FR-3：系统默认使用预设的上传目录路径，无需用户输入
- FR-4：实现文件自动上传至指定位置
- FR-5：完成 FTP 上传状态的自动检查与反馈
非功能需求
- NFR-1：保持现有界面的简洁性，不增加额外的用户输入字段
- NFR-2：上传和检查过程应该有明确的进度反馈
- NFR-3：错误处理应该清晰明确，方便用户理解和解决问题
约束
- 技术：基于现有的 ASP.NET Core Web API 和 FTP 上传服务
- 依赖：依赖现有的
FtpUploadService和相关的 API 端点
假设
- 预设的上传目录路径是固定的，不需要用户配置
- 面单文件的命名规则与订单数据中的中性面单单号或尾程单号一致
验收标准
AC-1：订单导入时自动上传面单文件
- 给定：用户选择了包含订单数据的 Excel 文件和对应的面单文件
- 当：用户点击 "导入订单" 按钮
- 然后：系统自动将面单文件上传到预设的 FTP 目录
- 验证：
programmatic - 备注：上传过程应该有进度反馈
AC-2：订单导入时自动检查 FTP 上传状态
- 给定：面单文件已经上传到 FTP 服务器
- 当：文件上传完成后
- 然后：系统自动检查文件是否成功上传到 FTP 服务器
- 验证：
programmatic - 备注：检查结果应该在导入结果中显示
AC-3：使用预设的上传目录路径
- 给定：用户进行订单导入操作
- 当：系统执行文件上传操作
- 然后：系统使用预设的上传目录路径，无需用户输入
- 验证：
programmatic - 备注：预设路径应该在代码中配置
AC-4：上传和检查状态的反馈
- 给定：系统执行文件上传和检查操作
- 当：操作完成后
- 然后：系统在导入结果中显示上传和检查的状态
- 验证：
human-judgment - 备注：状态信息应该清晰易读
开放问题
- 预设的上传目录路径具体是什么？
- 面单文件的命名规则是否与现有系统一致？