318 lines
15 KiB
Markdown
318 lines
15 KiB
Markdown
# 过程配置需求卡
|
||
|
||
## 目录
|
||
|
||
- [REQ-PROC-001 列表与分页](#req-proc-001-列表与分页)
|
||
- [REQ-PROC-002 条件查询与重置](#req-proc-002-条件查询与重置)
|
||
- [REQ-PROC-003 查看过程配置](#req-proc-003-查看过程配置)
|
||
- [REQ-PROC-004 新增过程配置](#req-proc-004-新增过程配置)
|
||
- [REQ-PROC-005 编辑过程配置](#req-proc-005-编辑过程配置)
|
||
- [REQ-PROC-006 复制过程配置](#req-proc-006-复制过程配置)
|
||
- [REQ-PROC-007 编号与唯一性规则](#req-proc-007-编号与唯一性规则)
|
||
- [REQ-PROC-008 过程节点配置与联动](#req-proc-008-过程节点配置与联动)
|
||
- [REQ-PROC-009 启用/停用](#req-proc-009-启用停用)
|
||
- [REQ-PROC-010 单条删除](#req-proc-010-单条删除)
|
||
- [REQ-PROC-011 批量删除](#req-proc-011-批量删除)
|
||
- [REQ-PROC-012 组织权限与审计](#req-proc-012-组织权限与审计)
|
||
- [通用规则](#通用规则)
|
||
|
||
---
|
||
|
||
### REQ-PROC-001 列表与分页
|
||
|
||
- 功能点：
|
||
- 默认展示当前组织全部过程配置数据，列表按创建时间降序排列。
|
||
- 展示配置名称、配置编号、项目、包含过程节点、状态、默认后台完成运输天数、备注、组织、创建人、创建时间、更新时间、操作等字段。
|
||
- 支持勾选多行数据用于批量删除。
|
||
- 操作列根据状态与权限展示查看、编辑、复制、删除、启用、停用等按钮。
|
||
- 草稿状态显示查看、编辑、复制、删除。
|
||
- 启用状态显示查看、编辑、复制、停用。
|
||
- 停用状态显示查看、编辑、复制、删除、启用。
|
||
- 分页默认10条/页，支持20/50/100条/页。
|
||
|
||
- 异常与边界：
|
||
- 查询无数据时展示空状态。
|
||
- 当前页删除后无数据时自动回退页码并刷新列表。
|
||
- 切换组织范围时保留当前查询条件，仅重载数据。
|
||
- 列表加载失败时保留当前筛选与分页条件。
|
||
|
||
- 反例：
|
||
- 不允许默认按创建时间以外的字段覆盖排序规则。
|
||
- 不允许在不满足状态条件时展示删除、启用或停用按钮。
|
||
- 不允许分页后丢失当前查询条件。
|
||
|
||
---
|
||
|
||
### REQ-PROC-002 条件查询与重置
|
||
|
||
- 功能点：
|
||
- 支持按配置名称、项目、配置编号、包含过程节点、状态、组织等条件组合查询。
|
||
- 配置名称支持模糊查询。
|
||
- 项目支持下拉模糊搜索选择，默认范围为当前用户所属组织下的项目。
|
||
- 配置编号支持精确匹配。
|
||
- 包含过程节点支持多选，枚举值为接单、到场、装货、发货、在途、到货、卸货、签收、回单。
|
||
- 状态支持全部、草稿、启用、停用，默认全部。
|
||
- 组织默认带出当前用户所属组织。
|
||
- 点击查询后按条件展示数据。
|
||
- 点击重置后清空所有条件并恢复默认列表。
|
||
|
||
- 异常与边界：
|
||
- 查询条件为空时点击查询，按默认规则展示当前组织全部数据。
|
||
- 查询结果为空时展示空状态，不清空用户已输入条件。
|
||
- 重置后页码恢复第一页，并按创建时间降序重新加载。
|
||
|
||
- 反例：
|
||
- 不允许重置后仍保留隐藏条件。
|
||
- 不允许只按单一条件查询而忽略组合条件。
|
||
- 不允许查询后改变列表字段展示范围。
|
||
|
||
---
|
||
|
||
### REQ-PROC-003 查看过程配置
|
||
|
||
- 功能点：
|
||
- 支持通过行操作查看过程配置详情。
|
||
- 详情展示基本信息、现行过程节点、节点启用状态、节点联动配置、默认后台完成运输天数、备注、组织、创建人、创建时间、更新时间等信息。
|
||
- 查看状态下字段全部置灰不可编辑。
|
||
- 查看弹窗底部仅显示关闭按钮。
|
||
|
||
- 异常与边界：
|
||
- 数据已删除或不存在时提示数据不存在，并刷新列表。
|
||
- 详情加载失败时提示失败原因，不影响列表现状。
|
||
- 仅展示已勾选启用的现行过程节点，未启用节点不展示在时间线中。
|
||
|
||
- 反例：
|
||
- 不允许在查看状态下保存修改。
|
||
- 不允许查看时切换组织范围并修改数据。
|
||
- 不允许查看弹窗出现提交按钮。
|
||
|
||
---
|
||
|
||
### REQ-PROC-004 新增过程配置
|
||
|
||
- 功能点：
|
||
- 支持新增过程配置，用于按项目维度配置运输过程各节点的司机打卡要求。
|
||
- 配置编号由系统自动生成，规则为 GC + 5位流水号，保存后全局唯一。
|
||
- 配置名称使用文本输入框，必填，长度1到100字符，同一组织内不允许重复。
|
||
- 项目使用下拉多选控件，支持模糊搜索，必填，默认仅显示当前用户所属组织下的项目。
|
||
- 默认后台完成运输天数使用数字输入框，非必填，最多3位整数，不设置默认值。
|
||
- 备注使用文本输入框，非必填，长度不超过500字符。
|
||
- 新建保存后默认状态为草稿。
|
||
- 新建弹窗包含基本信息与过程节点配置两个区域。
|
||
|
||
- 异常与边界：
|
||
- 配置名称为空时阻止提交并提示“配置名称不能为空”。
|
||
- 配置名称超过100字符时阻止提交。
|
||
- 同一组织内配置名称重复时阻止提交并提示“配置名称已存在”。
|
||
- 项目为空时阻止提交并提示“项目不能为空”。
|
||
- 默认后台完成运输天数不是正整数或超过3位时阻止提交并提示“请输入正整数”。
|
||
- 备注超过500字符时阻止提交并提示。
|
||
- 提交失败时保留用户已填写内容。
|
||
|
||
- 反例：
|
||
- 不允许手工填写配置编号。
|
||
- 不允许新增时跳过项目必填校验。
|
||
- 不允许新增后默认直接进入启用状态。
|
||
|
||
---
|
||
|
||
### REQ-PROC-005 编辑过程配置
|
||
|
||
- 功能点：
|
||
- 支持编辑已存在的过程配置。
|
||
- 配置编号在编辑状态下置灰不可编辑。
|
||
- 配置名称可编辑，校验规则同新增。
|
||
- 项目可重新选择，但若该配置已被运单引用，则项目不可变更。
|
||
- 过程节点配置可调整，校验规则同新增。
|
||
- 默认后台完成运输天数、备注可编辑。
|
||
- 保存成功后刷新列表。
|
||
|
||
- 异常与边界：
|
||
- 配置名称修改后仍需满足同组织内唯一。
|
||
- 项目被运单引用时禁止变更项目并提示。
|
||
- 编辑的数据已不存在时提示数据不存在，并刷新列表。
|
||
- 提交失败时保留用户修改内容。
|
||
|
||
- 反例：
|
||
- 不允许编辑时修改配置编号。
|
||
- 不允许编辑后产生同组织重名配置。
|
||
- 不允许绕过新增时的节点联动与校验规则。
|
||
|
||
---
|
||
|
||
### REQ-PROC-006 复制过程配置
|
||
|
||
- 功能点：
|
||
- 支持复制已有过程配置生成新配置。
|
||
- 复制后配置名称自动追加“ - 副本”。
|
||
- 节点设置内容全部复制。
|
||
- 配置编号重新生成。
|
||
- 新配置默认状态为草稿。
|
||
- 复制后的配置可继续编辑后保存。
|
||
|
||
- 异常与边界：
|
||
- 复制后若配置名称仍触发同组织重复校验，则阻止保存并提示。
|
||
- 原配置不存在时不允许复制。
|
||
- 复制失败时不影响原配置数据。
|
||
|
||
- 反例：
|
||
- 不允许复制后沿用原配置编号。
|
||
- 不允许复制后直接变为启用状态。
|
||
- 不允许复制时丢失节点配置内容。
|
||
|
||
---
|
||
|
||
### REQ-PROC-007 编号与唯一性规则
|
||
|
||
- 功能点：
|
||
- 配置编号由系统自动生成，规则为 GC + 5位流水号。
|
||
- 配置编号在系统中全局唯一。
|
||
- 配置名称在同一组织内唯一。
|
||
- 一个项目在同一时间只能关联一条启用状态的过程配置。
|
||
|
||
- 异常与边界：
|
||
- 编号生成冲突时阻止保存并重新生成。
|
||
- 同一组织内配置名称重复时阻止保存。
|
||
- 启用前若所选项目中存在其他启用配置时阻止启用，并提示“该项目已有关联的启用配置，请先停用原配置”。
|
||
- 项目为多选时，需要逐个校验每个项目的启用唯一性。
|
||
|
||
- 反例：
|
||
- 不允许手工编辑配置编号。
|
||
- 不允许同一组织内出现同名配置。
|
||
- 不允许同一项目同时存在两条启用配置。
|
||
|
||
---
|
||
|
||
### REQ-PROC-008 过程节点配置与联动
|
||
|
||
- 功能点：
|
||
- 过程节点顺序固定，不可拖拽排序，依次为接单、到场、装货、发货、在途、到货、卸货、签收、回单。
|
||
- 仅勾选启用的节点会展示在现行过程节点时间线中。
|
||
- 节点配置区域以逐行方式展示，每行对应一个节点。
|
||
- 各节点的是否打卡、上传货量、上传凭证相互独立，可单独选择或多选。
|
||
- 节点是否确认项必须选择确认方式；接单节点可选“无需确认接单”，回单节点可选“无需确认完成”，其他节点必须选择是或否。
|
||
- 是否打卡选否时，打卡定位、打卡频次、打卡时段置灰不可编辑。
|
||
- 上传货量选否时，上传货量类型置灰不可编辑。
|
||
- 上传凭证选否时，凭证类型全量置灰不可编辑。
|
||
- 仅在途节点支持打卡频次和打卡时段，默认打卡频次为1次，默认打卡时段为00:00-24:00。
|
||
- 接单节点的是否确认支持“无需确认接单”。
|
||
- 回单节点的是否确认支持“无需确认完成”，且选择是时系统自动勾选内部人员。
|
||
- 打卡定位、上传货量类型、凭证类型根据当前节点可配置项展示。
|
||
|
||
- 异常与边界：
|
||
- 节点是否确认项为空时阻止提交并提示“请选择确认方式”。
|
||
- 节点是否打卡为空时阻止提交并提示“请选择是否打卡”。
|
||
- 在途节点是否打卡为是但未配置打卡频次或打卡时段时阻止提交。
|
||
- 在途节点打卡频次为空或小于1时阻止提交并提示“请输入打卡频次 / 打卡频次必须≥1”。
|
||
- 在途节点打卡时段为空时阻止提交并提示“请选择打卡时段”。
|
||
- 非在途节点出现打卡频次或打卡时段时应不展示。
|
||
- 保存时若同时勾选签收和回单，且两者都配置上传凭证，则弹窗提示“签收与回单同时勾选了上传凭证，司机将需重复上传凭证，是否确认？”，按钮为确认、返回修改。
|
||
- 节点启用状态与时间线展示不一致时阻止保存。
|
||
- 选择为否后仍保留被置灰字段的旧值时，保存前应按禁用状态规则处理。
|
||
|
||
- 反例：
|
||
- 不允许拖拽调整节点顺序。
|
||
- 不允许非在途节点配置打卡频次和打卡时段。
|
||
- 不允许是否打卡为否时仍强制填写打卡定位或打卡时段。
|
||
- 不允许上传凭证关闭后仍提交凭证类型。
|
||
|
||
---
|
||
|
||
### REQ-PROC-009 启用/停用
|
||
|
||
- 功能点：
|
||
- 配置状态分为草稿、启用、停用三种，新增或复制后默认进入草稿状态。
|
||
- 草稿状态下编辑页面点击保存并启用后投入使用，状态变更为启用。
|
||
- 启用状态下可停用，状态变更为停用。
|
||
- 停用状态下可重新启用。
|
||
- 停用的配置在运单创建等下游业务场景中不再展示，但历史已引用数据保留关联关系。
|
||
|
||
- 异常与边界：
|
||
- 草稿启用前若同一项目已有其他启用配置，则阻止启用并提示先停用原配置。
|
||
- 启用状态停用前若存在关联的未完成运单，则阻止停用并提示“该条配置已被引用，不可停用”。
|
||
- 停用状态重新启用时仍需重新校验同一项目启用唯一性。
|
||
- 状态切换失败时保持原状态不变。
|
||
|
||
- 反例：
|
||
- 不允许启用状态直接删除。
|
||
- 不允许绕过启用唯一性校验直接投入使用。
|
||
- 不允许被引用的配置直接停用。
|
||
|
||
---
|
||
|
||
### REQ-PROC-010 单条删除
|
||
|
||
- 功能点：
|
||
- 支持通过行操作删除单条过程配置。
|
||
- 点击删除时弹出二次确认弹窗。
|
||
- 删除成功后刷新列表，并提示“删除成功”。
|
||
|
||
- 异常与边界：
|
||
- 草稿配置可直接删除。
|
||
- 停用配置删除前需校验未被运单引用，已引用则提示“该条配置已被引用，不可删除”。
|
||
- 启用配置不可删除，需先停用后再处理。
|
||
- 数据不存在时提示数据不存在，并刷新列表。
|
||
|
||
- 反例：
|
||
- 不允许跳过二次确认直接删除。
|
||
- 不允许删除启用状态配置。
|
||
- 不允许删除已被引用的停用配置。
|
||
|
||
---
|
||
|
||
### REQ-PROC-011 批量删除
|
||
|
||
- 功能点：
|
||
- 支持勾选多行过程配置后批量删除。
|
||
- 点击批量删除时弹出二次确认弹窗。
|
||
- 删除时按单条规则逐一校验状态与业务引用。
|
||
- 删除成功后刷新列表，并提示“删除成功XX条，因引用跳过XX条”。
|
||
|
||
- 异常与边界：
|
||
- 未勾选数据时点击批量删除，应提示先选择需要删除的数据。
|
||
- 草稿配置可直接删除。
|
||
- 停用配置逐条校验是否被运单引用，已引用记录剔除并单独提示。
|
||
- 启用配置不进入删除队列，并提示需先停用。
|
||
- 所选数据全部不满足删除条件时不执行删除。
|
||
|
||
- 反例：
|
||
- 不允许批量删除启用状态配置。
|
||
- 不允许因为部分记录不可删而影响草稿记录删除。
|
||
- 不允许删除后不刷新列表。
|
||
|
||
---
|
||
|
||
### REQ-PROC-012 组织权限与审计
|
||
|
||
- 功能点：
|
||
- 组织列作为数据权限字段，普通用户默认仅可查看当前组织数据。
|
||
- 具备权限的用户可切换查看全部组织数据，但该视图仅允许只读查看。
|
||
- 根据权限配置控制查看、编辑、复制、删除、启用、停用等操作入口。
|
||
- 创建人、创建时间、更新时间由系统自动记录。
|
||
|
||
- 异常与边界：
|
||
- 无权限用户访问时提示权限不足。
|
||
- 在全部组织只读视图中不开放新增、编辑、删除、启用、停用等写操作。
|
||
- 列表、详情等用户可见场景优先展示创建人姓名，不直接展示用户 ID。
|
||
|
||
- 反例：
|
||
- 不允许普通用户在全部组织视图下修改数据。
|
||
- 不允许手动维护创建人、创建时间、更新时间。
|
||
- 不允许删除或篡改审计信息。
|
||
|
||
---
|
||
|
||
## 通用规则
|
||
|
||
- 过程配置用于按项目维度配置运输过程各节点的司机打卡要求，确保运输过程可追溯。
|
||
- 配置编号由系统自动生成，规则为 GC + 5位流水号，且全局唯一。
|
||
- 配置名称在同一组织内不允许重复。
|
||
- 一个项目在同一时间只能关联一条启用状态的过程配置。
|
||
- 过程节点顺序固定，不可拖拽排序，依次为接单、到场、装货、发货、在途、到货、卸货、签收、回单。
|
||
- 仅勾选启用的节点才会展示在现行过程节点时间线中。
|
||
- 是否打卡、上传货量、上传凭证为节点内相互独立的配置项，可单独配置或多选。
|
||
- 仅在途节点支持打卡频次和打卡时段，默认打卡频次为1次，默认打卡时段为00:00-24:00。
|
||
- 节点配置触发重复上传凭证提示时，应允许用户确认后继续或返回修改。
|
||
- 新增、编辑、复制、启用、停用、删除成功后均需刷新列表。
|
||
- 删除前必须校验状态与业务引用，已引用配置不允许直接删除或停用。
|