3.7 KiB
3.7 KiB
Requirements Document
Introduction
本文档定义了样品管理系统中样品型号和硬件版本号字段的自动完成功能需求。该功能旨在通过从已有样品数据中提取可能的取值,并支持模糊搜索,提升用户输入效率和数据一致性。
Glossary
- 样品管理系统(Sample Management System): 用于管理入库样品信息的系统模块
- 自动完成(Autocomplete): 根据用户输入自动提示可能的选项,用户可以从列表中选择或继续输入
- 模糊搜索(Fuzzy Search): 根据用户输入的部分内容,在候选列表中查找包含该内容的所有选项
- 样品型号(Sample Model): 样品的型号标识
- 硬件版本号(Hardware Version): 样品的硬件版本标识
- 候选列表(Candidate List): 从已有样品数据中提取的不重复的字段值列表
- Element UI Autocomplete: Element UI 提供的自动完成输入组件
Requirements
Requirement 1
User Story: 作为样品管理员,我希望在输入样品型号时能看到已有的型号列表,以便快速选择而不需要手动输入完整内容。
Acceptance Criteria
- WHEN 用户点击样品型号输入框 THEN 样品管理系统 SHALL 显示所有已存在的不重复样品型号列表
- WHEN 用户在样品型号输入框中输入文本 THEN 样品管理系统 SHALL 实时过滤并显示包含该文本的样品型号
- WHEN 用户从下拉列表中选择一个样品型号 THEN 样品管理系统 SHALL 将该值填入输入框
- WHEN 用户输入的内容不在候选列表中 THEN 样品管理系统 SHALL 允许用户输入新的样品型号
- WHEN 样品型号候选列表为空 THEN 样品管理系统 SHALL 允许用户正常输入文本
Requirement 2
User Story: 作为样品管理员,我希望在输入硬件版本号时能看到已有的版本号列表,以便快速选择而不需要手动输入完整内容。
Acceptance Criteria
- WHEN 用户点击硬件版本号输入框 THEN 样品管理系统 SHALL 显示所有已存在的不重复硬件版本号列表
- WHEN 用户在硬件版本号输入框中输入文本 THEN 样品管理系统 SHALL 实时过滤并显示包含该文本的硬件版本号
- WHEN 用户从下拉列表中选择一个硬件版本号 THEN 样品管理系统 SHALL 将该值填入输入框
- WHEN 用户输入的内容不在候选列表中 THEN 样品管理系统 SHALL 允许用户输入新的硬件版本号
- WHEN 硬件版本号候选列表为空 THEN 样品管理系统 SHALL 允许用户正常输入文本
Requirement 3
User Story: 作为样品管理员,我希望模糊搜索功能不区分大小写,以便更灵活地查找选项。
Acceptance Criteria
- WHEN 用户输入小写字母 THEN 样品管理系统 SHALL 匹配包含对应大写或小写字母的候选项
- WHEN 用户输入大写字母 THEN 样品管理系统 SHALL 匹配包含对应大写或小写字母的候选项
- WHEN 用户输入混合大小写文本 THEN 样品管理系统 SHALL 以不区分大小写的方式进行模糊匹配
Requirement 4
User Story: 作为样品管理员,我希望自动完成功能的交互体验流畅,以便提高工作效率。
Acceptance Criteria
- WHEN 用户输入文本时 THEN 样品管理系统 SHALL 在 300 毫秒内显示过滤后的候选列表
- WHEN 候选列表显示时 THEN 样品管理系统 SHALL 限制显示最多 20 个候选项以保持界面简洁
- WHEN 用户使用键盘上下箭头键 THEN 样品管理系统 SHALL 允许用户在候选列表中导航
- WHEN 用户按下 Enter 键 THEN 样品管理系统 SHALL 选择当前高亮的候选项
- WHEN 用户点击输入框外部 THEN 样品管理系统 SHALL 关闭候选列表