新增普通表单的手动岗位新建/编辑/删除PRD §3.1 路径 0并接入新的 q 搜索参数q搜索q过滤是什么文章目录q 搜索 / q 过滤 解释什么是 q 参数q 搜索 vs q 过滤在你提到的需求中的含义常见的 q 参数用法示例为什么用 q 而不是 search 或 keyword“q 搜索” / “q 过滤” 解释什么是q参数在 Web 开发和 API 设计中q是“query”查询的缩写是业界约定俗成的通用搜索参数名。它通常以 URL 查询参数的形式出现GET /api/positions?q前端工程师 GET /api/forms?q请假q 搜索 vs q 过滤概念含义典型场景q 搜索用q参数做全文/模糊搜索在多个字段中匹配关键词搜索框输入关键词跨名称、描述、编号等字段查找q 过滤用q参数对已有列表做筛选过滤缩小展示范围在列表页顶部输入文字实时过滤掉不匹配的条目两者本质很接近核心思路都是一个统一的文本输入框 → 一个q参数 → 后端/前端根据该参数返回匹配结果。在你提到的需求中的含义新增普通表单的手动岗位新建/编辑/删除PRD §3.1 路径 0并接入新的 q 搜索参数这句话的意思是新增功能为普通表单增加手动岗位的 CRUD新建 / 编辑 / 删除操作接入 q 搜索在岗位列表中加入一个搜索框将用户输入的关键词作为q参数传给后端或用于前端过滤从而实现对岗位列表的搜索/过滤功能常见的q参数用法示例// 前端发起请求fetch(/api/positions?q${encodeURIComponent(keyword)})// 后端接收并处理constkeywordreq.query.q;constresultsawaitPosition.find({$or:[{name:{$regex:keyword,$options:i}},{description:{$regex:keyword,$options:i}}]});为什么用q而不是search或keyword这是源自Google、GitHub、Stack Overflow等大型产品的惯例q短小、通用、语义明确已成为 REST API 和 Web 应用中搜索参数的事实标准。简单总结q就是搜索关键词的参数名接入新的 q 搜索参数就是在岗位列表里加一个搜索框让用户能按关键词搜索岗位。
