From 81b2a3e99bdcc57735f19f20d786acac8f6e191d Mon Sep 17 00:00:00 2001 From: b2894lxlx <517289602@qq.com> Date: Fri, 31 Jul 2026 01:32:41 +0800 Subject: [PATCH] =?UTF-8?q?1=E3=80=81=E5=A4=A7=E9=87=8F=E9=A1=B5=E9=9D=A2?= =?UTF-8?q?=E8=B0=83=E6=95=B4=202=E3=80=81=E5=AE=8C=E5=96=84=E8=BF=90?= =?UTF-8?q?=E5=8A=9B=E6=A8=A1=E5=9D=97=203=E3=80=81=E5=AE=8C=E5=96=84?= =?UTF-8?q?=E8=A7=84=E8=8C=83=E3=80=81=E9=9C=80=E6=B1=82=E5=8D=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 16 +- src/api/base/common-address.js | 11 - src/components/image-upload-field/main.vue | 89 ++ src/main.js | 2 +- src/option/base/cargo-type.js | 9 +- src/option/base/common-address.js | 113 +- src/option/business/common-cargo.js | 102 +- src/option/business/common-route.js | 42 +- src/option/business/common.js | 6 +- src/option/business/process-config.js | 226 ++-- src/option/transportCapacity/driver.js | 138 +- .../transportCapacity/transport-ship.js | 46 +- .../transportCapacity/transport-vehicle.js | 45 +- src/option/vehicle/accident-record.js | 23 +- .../vehicle/annual-inspection-record.js | 21 +- src/option/vehicle/etc-record.js | 2 +- src/option/vehicle/insurance-record.js | 23 +- src/option/vehicle/mileage-record.js | 23 +- src/option/vehicle/oil-electric-record.js | 21 +- src/option/vehicle/other-expense-record.js | 2 +- src/option/vehicle/tire-replacement-record.js | 23 +- src/option/vehicle/transport-change-record.js | 23 +- src/option/vehicle/violation-record.js | 23 +- src/styles/element-ui.scss | 3 + src/utils/search-range.js | 27 + src/views/base/airport-master.vue | 2 +- src/views/base/cargo-type.vue | 69 +- src/views/base/common-address.vue | 962 +++++++++----- src/views/base/currency.vue | 2 +- src/views/base/customer-type.vue | 2 +- src/views/base/fee-item.vue | 2 +- src/views/base/port-terminal.vue | 2 +- src/views/base/railway-station.vue | 2 +- src/views/business/common-cargo.vue | 634 ++++++++- src/views/business/common-route.vue | 657 +++++++++- src/views/business/process-config.vue | 1141 ++++++++++++++++- src/views/transportCapacity/driver.vue | 436 ++++--- src/views/transportCapacity/ship.vue | 954 ++++++++++---- src/views/transportCapacity/vehicle.vue | 779 ++++++----- src/views/vehicle/accident-record.vue | 16 +- .../vehicle/credit-score-quantification.vue | 36 +- src/views/vehicle/customer-archive.vue | 37 +- src/views/vehicle/insurance-record.vue | 101 +- src/views/vehicle/maintenance-plan.vue | 39 +- src/views/vehicle/maintenance-record.vue | 39 +- src/views/vehicle/mileage-record.vue | 17 +- src/views/vehicle/tire-replacement-record.vue | 16 +- src/views/vehicle/transport-change-record.vue | 16 +- src/views/vehicle/violation-record.vue | 16 +- 需求卡/常用地址需求卡.md | 94 +- 需求卡/常用线路需求卡.md | 83 +- 需求卡/常用货物需求卡.md | 127 +- 需求卡/货物类型管理需求卡.md | 162 +-- 需求卡/过程配置需求卡.md | 104 +- 54 files changed, 5641 insertions(+), 1965 deletions(-) create mode 100644 src/components/image-upload-field/main.vue create mode 100644 src/utils/search-range.js diff --git a/AGENTS.md b/AGENTS.md index 8dcc271..ff0870d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -172,7 +172,7 @@ Avue 表格/表单配置独立存放于 `src/option/` 目录,与 `views` 和 ` - 分页组件整体靠右展示,必须展示接口返回的数据总条数,`X条/页` 的页容量选择器必须放在总条数右侧。 - `.basic-container__card` 的直接子级 `.el-card__body` 内边距统一去除,保持 `padding: 0` - 所有 CRUD 页面搜索栏需与下方表格拆分为独立区域,两者垂直间距统一为 `8px`。 -- 所有 CRUD 页面搜索栏操作按钮(搜索、清空等)需在搜索表单下方独占一行并放置在最右侧;搜索条件超过两行时必须显示“展开/折叠”,默认折叠且仅展示两行搜索条件。 +- 所有 CRUD 页面搜索栏操作按钮(搜索、清空等)需在搜索表单下方独占一行并放置在最右侧;搜索条件超过一行时必须显示“展开/折叠”,默认折叠且仅展示一行搜索条件;一行布局默认展示 4 个筛选项,Avue 配置统一使用 `searchIndex: 4`。 - 所有 CRUD 页面中新增、批量导入等顶部按钮组行不需要背景色,应保持透明背景。 - 所有 `.basic-container__card` 内的 Avue 内层 `el-card` 需去卡片化,仅保留外层容器卡片样式,禁止出现二级卡片边框、阴影或额外内边距。 @@ -213,6 +213,20 @@ Avue 表格/表单配置独立存放于 `src/option/` 目录,与 `views` 和 ` - 表格的排序默认按照创建时间降序;分页列表应由后端默认按 `create_time DESC` 返回,前端不得在无明确业务要求时覆盖为其它默认排序。 +### 4.11 搜索顺序规范 + +- 当用户已明确列出筛选字段时,搜索栏必须严格按照用户给出的字段清单和顺序展示;不得自行新增、保留、推断或迁移未列出的筛选项。 +- 新增/编辑表单字段、表格列字段和搜索筛选字段必须分开理解;除非用户明确要求同步,禁止把表单字段或表格字段擅自加入搜索栏。 +- Avue 搜索栏的字段展示顺序按 `searchOrder` **倒序** 渲染,配置时数值越大越靠前。 + +### 4.12 日期区间搜索规范 + +- 当同一业务维度的筛选条件是开始/结束日期或时间,并且接口按区间查询时,前端搜索栏必须合并为一个 `searchRange: true` 的区间字段展示。 +- 区间字段在页面层统一归一化为后端所需的起止参数,禁止同时保留两个独立的“开始/结束”搜索项。 +- 若用户已明确要求展示区间样式,必须严格按区间控件实现,不得退回为两个普通日期控件。 +- 修改搜索项顺序时必须同步调整 `searchOrder`,不要依赖 `column` 数组前后位置来控制搜索栏顺序。 +- `searchIndex: 4` 仅控制首屏展示数量,不影响 `searchOrder` 的优先级。 + --- ## 5. 新功能开发流程 diff --git a/src/api/base/common-address.js b/src/api/base/common-address.js index 0b8eab0..8763ff3 100644 --- a/src/api/base/common-address.js +++ b/src/api/base/common-address.js @@ -39,14 +39,3 @@ export const remove = ids => { }, }); }; - -export const getSourceOptions = (addressType, keyword) => { - return request({ - url: '/blade-transport/common-address/source-options', - method: 'get', - params: { - addressType, - keyword, - }, - }); -}; diff --git a/src/components/image-upload-field/main.vue b/src/components/image-upload-field/main.vue new file mode 100644 index 0000000..608fb83 --- /dev/null +++ b/src/components/image-upload-field/main.vue @@ -0,0 +1,89 @@ + + + + + {{ emptyText }} + + + + + + {{ label }} + {{ actionText }} + + + + {{ emptyText }} + + + + + + diff --git a/src/main.js b/src/main.js index f272a6b..10815b8 100644 --- a/src/main.js +++ b/src/main.js @@ -78,7 +78,7 @@ app.use(Avue, { calcHeight: 10, crudOption: { searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchLabelWidth: 160, searchMenuSpan: 24, searchMenuPosition: 'right', diff --git a/src/option/base/cargo-type.js b/src/option/base/cargo-type.js index 7bb3b0a..5383f69 100644 --- a/src/option/base/cargo-type.js +++ b/src/option/base/cargo-type.js @@ -34,10 +34,10 @@ export const getCargoTypeOption = ctx => ({ saveBtnText: '提交', updateBtnText: '提交', searchShow: true, - searchIcon: false, + searchIcon: true, searchLabelWidth: 50, searchMenuSpan: 10, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -71,7 +71,7 @@ export const getCargoTypeOption = ctx => ({ formslot: true, hide: true, display: false, - span: 24, + span: 12, rules: [{ required: true, message: '请选择上级货物类型', trigger: 'change' }], }, { @@ -85,7 +85,7 @@ export const getCargoTypeOption = ctx => ({ minWidth: 160, }, { - label: '上级货物类型编码', + label: '上级货物编码', prop: 'parentCargoCode', slot: true, readonly: true, @@ -93,6 +93,7 @@ export const getCargoTypeOption = ctx => ({ addDisplay: false, editDisplay: false, display: false, + span: 12, minWidth: 160, rules: [{ required: true, message: '请选择上级货物类型', trigger: 'change' }], }, diff --git a/src/option/base/common-address.js b/src/option/base/common-address.js index 013062f..9ffed4a 100644 --- a/src/option/base/common-address.js +++ b/src/option/base/common-address.js @@ -5,15 +5,17 @@ export const addressTypeOptions = [ { label: '空港机场', value: '空港机场' }, ]; -export const createOption = ({ validateLongitude, validateLatitude }) => ({ +export const createOption = () => ({ height: 'auto', calcHeight: 32, dialogWidth: 980, + labelPosition: 'right', + labelWidth: 'auto', tip: false, searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -27,12 +29,64 @@ export const createOption = ({ validateLongitude, validateLatitude }) => ({ dialogClickModal: false, menuWidth: 180, column: [ + { + label: '类型', + prop: 'addressType', + type: 'select', + formslot: true, + search: true, + span: 24, + dicData: addressTypeOptions, + rules: [{ required: true, message: '请选择类型', trigger: 'change' }], + }, + { + label: '港口', + prop: 'portId', + formslot: true, + hide: true, + display: false, + span: 12, + rules: [{ required: true, message: '请选择港口', trigger: 'change' }], + }, + { + label: '码头', + prop: 'terminalId', + formslot: true, + hide: true, + display: false, + span: 12, + rules: [{ required: true, message: '请选择码头', trigger: 'change' }], + }, + { + label: '车站名称', + prop: 'stationId', + formslot: true, + hide: true, + display: false, + span: 24, + rules: [{ required: true, message: '请选择车站名称', trigger: 'change' }], + }, + { + label: '机场标准名称', + prop: 'airportId', + formslot: true, + hide: true, + display: false, + span: 24, + rules: [{ required: true, message: '请选择机场标准名称', trigger: 'change' }], + }, { label: '地址名称', prop: 'addressName', search: true, + span: 24, minWidth: 150, - rules: [{ required: true, message: '请输入地址名称', trigger: 'blur' }], + maxlength: 100, + showWordLimit: true, + rules: [ + { required: true, message: '请输入地址名称', trigger: 'blur' }, + { max: 100, message: '地址名称不能超过100个字', trigger: 'blur' }, + ], }, { label: '地址编号', @@ -41,21 +95,6 @@ export const createOption = ({ validateLongitude, validateLatitude }) => ({ addDisplay: false, editDisplay: false, }, - { - label: '类型', - prop: 'addressType', - type: 'select', - search: true, - dicData: addressTypeOptions, - rules: [{ required: true, message: '请选择类型', trigger: 'change' }], - }, - { - label: '来源主数据', - prop: 'sourceId', - formslot: true, - hide: true, - span: 24, - }, { label: '站点编码', prop: 'siteCodeDisplay', @@ -72,6 +111,14 @@ export const createOption = ({ validateLongitude, validateLatitude }) => ({ addDisplay: false, editDisplay: false, }, + { + label: '行政区划', + prop: 'regionName', + search: true, + display: false, + minWidth: 150, + rules: [{ required: true, message: '请选择行政区划', trigger: 'change' }], + }, { label: '详细地址', prop: 'detailAddress', @@ -81,28 +128,10 @@ export const createOption = ({ validateLongitude, validateLatitude }) => ({ minRows: 3, span: 24, minWidth: 220, - rules: [{ required: true, message: '请输入详细地址', trigger: 'blur' }], - }, - { - label: '经度', - prop: 'longitude', - formslot: true, - minWidth: 120, - rules: [{ validator: validateLongitude, trigger: 'blur' }], - }, - { - label: '纬度', - prop: 'latitude', - formslot: true, - minWidth: 120, - rules: [{ validator: validateLatitude, trigger: 'blur' }], - }, - { - label: '行政区划', - prop: 'regionName', - search: true, - minWidth: 150, - rules: [{ required: true, message: '请输入行政区划', trigger: 'blur' }], + rules: [ + { required: true, message: '请输入详细地址', trigger: 'blur' }, + { max: 255, message: '详细地址不能超过255个字', trigger: 'blur' }, + ], }, { label: '组织', @@ -125,12 +154,16 @@ export const createOption = ({ validateLongitude, validateLatitude }) => ({ prop: 'contactName', search: true, minWidth: 110, + maxlength: 50, + rules: [{ max: 50, message: '联系人不能超过50个字', trigger: 'blur' }], }, { label: '联系方式', prop: 'contactPhone', search: true, minWidth: 130, + maxlength: 20, + rules: [{ max: 20, message: '联系方式不能超过20个字', trigger: 'blur' }], }, { label: '备注', diff --git a/src/option/business/common-cargo.js b/src/option/business/common-cargo.js index cc92f26..6e51b67 100644 --- a/src/option/business/common-cargo.js +++ b/src/option/business/common-cargo.js @@ -1,10 +1,8 @@ import { auditColumns, createCrudOption, - nonNegativeRule, packageOptions, priceUnitOptions, - selectRule, textRule, } from './common'; @@ -15,67 +13,81 @@ export const config = { exportName: '常用货物', importUrl: '/blade-transport/common-cargo/import-common-cargo', templateUrl: '/blade-transport/common-cargo/export-template', - enableAllDept: true, + enableAllDept: false, }; export const option = createCrudOption([ - { - label: '组织', - prop: 'deptName', - search: true, - minWidth: 150, - addDisplay: false, - editDisplay: false, - }, { label: '一级货物类型', prop: 'firstCargoTypeName', + formslot: true, search: true, + searchOrder: 3, minWidth: 150, editDisabled: true, - rules: textRule('一级货物类型', 100, true), + rules: [{ required: true, message: '请选择一级货物类型', trigger: 'change' }], }, { label: '一级货物类型编码', prop: 'firstCargoTypeCode', hide: true, + display: false, + addDisplay: false, editDisabled: true, }, { label: '二级货物类型', prop: 'secondCargoTypeName', + formslot: true, search: true, + searchOrder: 4, minWidth: 150, editDisabled: true, - rules: textRule('二级货物类型', 100, true), + rules: [{ required: true, message: '请选择二级货物类型', trigger: 'change' }], }, { label: '二级货物类型编码', prop: 'secondCargoTypeCode', - search: true, - minWidth: 150, + hide: true, + display: false, + addDisplay: false, editDisabled: true, - rules: textRule('二级货物类型编码', 20, true), }, { label: '货物名称', prop: 'cargoName', search: true, + searchOrder: 1, minWidth: 150, rules: textRule('货物名称', 100, true), }, { label: '货物编号', prop: 'cargoCode', + formslot: true, search: true, + searchOrder: 2, minWidth: 120, - editDisabled: true, - rules: textRule('货物编号', 20, true), + maxlength: 20, + showWordLimit: true, + rules: [ + { required: true, message: '请输入货物编号', trigger: 'blur' }, + { max: 20, message: '货物编号不能超过20个字符', trigger: 'blur' }, + ], + }, + { + label: '组织', + prop: 'deptName', + search: true, + searchOrder: 5, + minWidth: 150, + addDisplay: false, + editDisplay: false, }, { label: '品牌', prop: 'brand', - search: true, + search: false, minWidth: 120, rules: textRule('品牌', 50), }, @@ -89,11 +101,32 @@ export const option = createCrudOption([ { label: '货值', prop: 'cargoValue', - type: 'number', - precision: 2, - min: 0, + formslot: true, + minWidth: 120, + rules: [ + { + validator: (rule, value, callback) => { + if (value === undefined || value === null || value === '') { + callback(); + return; + } + if (!/^\d+(\.\d{1,2})?$/.test(String(value))) { + callback(new Error('货值只能输入数字,最多保留2位小数')); + return; + } + callback(); + }, + trigger: 'blur', + }, + ], + }, + { + label: '计价单位', + prop: 'priceUnit', + type: 'select', + dicData: priceUnitOptions, + display: false, minWidth: 120, - rules: [nonNegativeRule('货值')], }, { label: '规格', @@ -101,13 +134,6 @@ export const option = createCrudOption([ minWidth: 120, rules: textRule('规格', 50), }, - { - label: '计价单位', - prop: 'priceUnit', - type: 'select', - dicData: priceUnitOptions, - minWidth: 120, - }, { label: '型号', prop: 'model', @@ -115,22 +141,10 @@ export const option = createCrudOption([ rules: textRule('型号', 50), }, { - label: '说明1', + label: '说明', prop: 'descriptionOne', minWidth: 160, - rules: textRule('说明1', 100), - }, - { - label: '尺寸', - prop: 'sizeText', - minWidth: 120, - rules: textRule('尺寸', 50), - }, - { - label: '说明2', - prop: 'descriptionTwo', - minWidth: 160, - rules: textRule('说明2', 100), + rules: textRule('说明', 100), }, { label: '数据来源', diff --git a/src/option/business/common-route.js b/src/option/business/common-route.js index 947a99f..507b23e 100644 --- a/src/option/business/common-route.js +++ b/src/option/business/common-route.js @@ -5,44 +5,44 @@ export const config = { permission: 'common_route', exportUrl: '/blade-transport/common-route/export-common-route', exportName: '常用线路', - enableAllDept: true, + enableAllDept: false, }; export const option = createCrudOption([ { - label: '组织', - prop: 'deptName', + label: '线路名称', + prop: 'routeName', search: true, + searchOrder: 1, + span: 24, minWidth: 150, - addDisplay: false, - editDisplay: false, + rules: textRule('线路名称', 100, true), }, { label: '线路编号', prop: 'routeCode', search: true, + searchOrder: 2, minWidth: 120, addDisplay: false, editDisabled: true, }, - { - label: '线路名称', - prop: 'routeName', - search: true, - minWidth: 150, - rules: textRule('线路名称', 100, true), - }, { label: '发货地', prop: 'departureName', search: true, + searchOrder: 3, minWidth: 140, - rules: textRule('发货地', 100, true), + addDisplay: false, + editDisplay: false, }, { label: '发货地址', prop: 'departureAddress', + formslot: true, search: true, + searchOrder: 4, + span: 24, minWidth: 220, rules: textRule('发货地址', 255, true), }, @@ -78,13 +78,18 @@ export const option = createCrudOption([ label: '收货地', prop: 'arrivalName', search: true, + searchOrder: 5, minWidth: 140, - rules: textRule('收货地', 100, true), + addDisplay: false, + editDisplay: false, }, { label: '收货地址', prop: 'arrivalAddress', + formslot: true, search: true, + searchOrder: 6, + span: 24, minWidth: 220, rules: textRule('收货地址', 255, true), }, @@ -116,6 +121,15 @@ export const option = createCrudOption([ minWidth: 140, rules: [phoneRule('收货联系方式'), ...textRule('收货联系方式', 50)], }, + { + label: '组织', + prop: 'deptName', + search: true, + searchOrder: 7, + minWidth: 150, + addDisplay: false, + editDisplay: false, + }, { label: '备注', prop: 'remark', diff --git a/src/option/business/common.js b/src/option/business/common.js index f158f9f..1aa92b6 100644 --- a/src/option/business/common.js +++ b/src/option/business/common.js @@ -156,7 +156,9 @@ export const textRule = (label, max, required = false) => { return rules; }; -export const selectRule = label => [{ required: true, message: `请选择${label}`, trigger: 'change' }]; +export const selectRule = label => [ + { required: true, message: `请选择${label}`, trigger: 'change' }, +]; export const nonNegativeRule = label => ({ validator: (rule, value, callback) => { @@ -189,7 +191,7 @@ export const createCrudOption = columns => ({ searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, diff --git a/src/option/business/process-config.js b/src/option/business/process-config.js index 1a8c09a..bed6548 100644 --- a/src/option/business/process-config.js +++ b/src/option/business/process-config.js @@ -1,103 +1,147 @@ -import { auditColumns, createCrudOption, nodeOptions, processStatusOptions, selectRule, textRule } from './common'; +import { + auditColumns, + createCrudOption, + nodeOptions, + processStatusOptions, + selectRule, + textRule, +} from './common'; export const config = { title: '过程配置', permission: 'process_config', exportUrl: '/blade-transport/process-config/export-process-config', exportName: '过程配置', - enableAllDept: true, + enableAllDept: false, actions: ['copy', 'enable', 'disable'], statusProp: 'status', statusTextProp: 'statusName', deleteStatus: [0, 2], }; -export const option = createCrudOption([ - { - label: '配置编号', - prop: 'configCode', - search: true, - minWidth: 130, - addDisplay: false, - editDisabled: true, - }, - { - label: '配置名称', - prop: 'configName', - search: true, - minWidth: 150, - rules: textRule('配置名称', 100, true), - }, - { - label: '项目ID集合', - prop: 'projectIds', - hide: true, - rules: textRule('项目ID集合', 1000, true), - }, - { - label: '项目', - prop: 'projectNames', - search: true, - type: 'textarea', - minRows: 2, - minWidth: 180, - rules: textRule('项目', 1000, true), - }, - { - label: '包含过程节点', - prop: 'includedNodes', - search: true, - type: 'select', - multiple: true, - dicData: nodeOptions, - minWidth: 180, - rules: selectRule('包含过程节点'), - }, - { - label: '默认完成运输天数', - prop: 'defaultFinishDays', - type: 'number', - min: 1, - max: 999, - minWidth: 150, - }, - { - label: '状态', - prop: 'status', - type: 'select', - search: true, - dicData: processStatusOptions, - slot: true, - minWidth: 100, - addDisplay: false, - editDisplay: false, - }, - { - label: '所属组织', - prop: 'deptName', - search: true, - minWidth: 150, - addDisplay: false, - editDisplay: false, - }, - { - label: '节点配置JSON', - prop: 'nodeConfigJson', - type: 'textarea', - minRows: 6, - span: 24, - hide: true, - }, - { - label: '备注', - prop: 'remark', - type: 'textarea', - minRows: 4, - span: 24, - hide: true, - maxlength: 500, - showWordLimit: true, - rules: textRule('备注', 500), - }, - ...auditColumns, -]); +export const option = { + ...createCrudOption([ + { + label: '', + prop: 'basicInfo', + formslot: true, + span: 24, + hide: true, + }, + { + label: '配置编号', + prop: 'configCode', + search: true, + searchOrder: 4, + minWidth: 130, + addDisplay: false, + editDisplay: false, + editDisabled: true, + }, + { + label: '配置名称', + prop: 'configName', + search: true, + searchOrder: 6, + span: 12, + minWidth: 150, + addDisplay: false, + editDisplay: false, + rules: textRule('配置名称', 100, true), + }, + { + label: '项目ID集合', + prop: 'projectIds', + hide: true, + display: false, + addDisplay: false, + editDisplay: false, + rules: textRule('项目ID集合', 1000, true), + }, + { + label: '项目', + prop: 'projectNames', + formslot: true, + search: true, + searchOrder: 5, + searchType: 'select', + type: 'textarea', + minRows: 2, + span: 12, + minWidth: 180, + dicData: [], + filterable: true, + addDisplay: false, + editDisplay: false, + rules: textRule('项目', 1000, true), + }, + { + label: '包含过程节点', + prop: 'includedNodes', + search: true, + searchOrder: 3, + type: 'select', + multiple: true, + dicData: nodeOptions, + minWidth: 180, + rules: selectRule('包含过程节点'), + }, + { + label: '默认完成运输天数', + prop: 'defaultFinishDays', + formslot: true, + type: 'number', + min: 1, + max: 999, + span: 12, + minWidth: 150, + addDisplay: false, + editDisplay: false, + }, + { + label: '状态', + prop: 'status', + type: 'select', + search: true, + searchOrder: 1, + dicData: processStatusOptions, + slot: true, + minWidth: 100, + addDisplay: false, + editDisplay: false, + }, + { + label: '组织', + prop: 'deptName', + search: true, + searchOrder: 2, + minWidth: 150, + addDisplay: false, + editDisplay: false, + }, + { + label: '', + prop: 'nodeConfigJson', + formslot: true, + span: 24, + hide: true, + }, + { + label: '备注', + prop: 'remark', + type: 'textarea', + minRows: 4, + span: 24, + hide: true, + addDisplay: false, + editDisplay: false, + maxlength: 500, + showWordLimit: true, + rules: textRule('备注', 500), + }, + ...auditColumns, + ]), + dialogTop: '10px', + dialogWidth: '96%', + searchSpan: 8, +}; diff --git a/src/option/transportCapacity/driver.js b/src/option/transportCapacity/driver.js index 0e73b34..922a54a 100644 --- a/src/option/transportCapacity/driver.js +++ b/src/option/transportCapacity/driver.js @@ -5,7 +5,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -21,76 +21,61 @@ export const option = { label: '姓名', prop: 'driverName', search: true, + searchOrder: 7, slot: true, width: 110, }, { - label: '身份证号', - prop: 'idCardNo', - search: true, - width: 190, - }, - { - label: '手机号码', + label: '手机号', prop: 'mobile', search: true, + searchOrder: 6, width: 130, }, - { - label: '性别', - prop: 'gender', - width: 80, - align: 'center', - }, - { - label: '司机类型', - prop: 'driverType', - search: true, - type: 'select', - dicData: [ - { - label: '自有', - value: '自有', - }, - { - label: '外协', - value: '外协', - }, - ], - width: 100, - align: 'center', - }, - { - label: '岗位', - prop: 'posts', - width: 150, - }, { label: '准驾车型', prop: 'drivingType', search: true, + searchOrder: 5, + hide: true, + type: 'select', + dicData: [ + { + label: 'A1', + value: 'A1', + }, + { + label: 'A2', + value: 'A2', + }, + { + label: 'A3', + value: 'A3', + }, + { + label: 'B1', + value: 'B1', + }, + { + label: 'B2', + value: 'B2', + }, + { + label: 'C1', + value: 'C1', + }, + { + label: 'C2', + value: 'C2', + }, + ], width: 110, }, - { - label: '所属组织', - prop: 'organizationName', - type: 'cascader', - search: true, - emitPath: false, - checkStrictly: true, - filterable: true, - dicData: [], - props: { - label: 'label', - value: 'value', - children: 'children', - }, - width: 140, - }, { label: '状态', prop: 'status', search: true, + searchOrder: 4, type: 'select', slot: true, dicData: [ @@ -106,6 +91,53 @@ export const option = { width: 90, align: 'center', }, + { + label: '司机类型', + prop: 'driverType', + search: true, + searchOrder: 3, + type: 'select', + dicData: [ + { + label: '自有员工', + value: '自有', + }, + { + label: '外协', + value: '外协', + }, + ], + width: 100, + align: 'center', + }, + { + label: '身份证号', + prop: 'idCardNo', + search: true, + searchOrder: 2, + width: 190, + }, + { + label: '所属组织', + prop: 'organizationName', + search: true, + searchOrder: 1, + type: 'select', + filterable: true, + dicData: [], + width: 140, + }, + { + label: '性别', + prop: 'gender', + width: 80, + align: 'center', + }, + { + label: '岗位', + prop: 'posts', + width: 150, + }, { label: '驾驶认证', prop: 'drivingLicenseEndDate', diff --git a/src/option/transportCapacity/transport-ship.js b/src/option/transportCapacity/transport-ship.js index 74dc53c..28adf75 100644 --- a/src/option/transportCapacity/transport-ship.js +++ b/src/option/transportCapacity/transport-ship.js @@ -5,7 +5,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -17,29 +17,49 @@ export const option = { menuWidth: 210, dialogClickModal: false, column: [ - { label: '船舶名', prop: 'shipName', search: true, slot: true, width: 130 }, - { label: '船舶识别号', prop: 'shipIdentifierNo', search: true, width: 140 }, - { label: '所属组织', prop: 'organizationName', search: true, width: 160 }, - { label: '船检登记号', prop: 'shipInspectionNo', search: true, width: 130 }, + { label: '船舶名', prop: 'shipName', search: true, searchOrder: 5, slot: true, width: 130 }, + { + label: '船舶识别号', + prop: 'shipIdentifierNo', + search: true, + searchOrder: 4, + width: 140, + }, + { + label: '船检登记号', + prop: 'shipInspectionNo', + search: true, + searchOrder: 3, + width: 130, + }, { label: '船舶类型', prop: 'shipType', search: true, + searchOrder: 2, type: 'select', dicData: [ - { label: '干货船', value: '干货船' }, - { label: '集装箱船', value: '集装箱船' }, { label: '散货船', value: '散货船' }, + { label: '集装箱船', value: '集装箱船' }, + { label: '杂货船', value: '杂货船' }, { label: '油船', value: '油船' }, - { label: '拖轮', value: '拖轮' }, ], width: 110, align: 'center', }, + { + label: '所属组织', + prop: 'organizationName', + search: true, + searchOrder: 1, + type: 'select', + filterable: true, + dicData: [], + width: 160, + }, { label: '状态', prop: 'status', - search: true, type: 'select', slot: true, dicData: [ @@ -49,7 +69,13 @@ export const option = { width: 90, align: 'center', }, - { label: '国籍证有效期至', prop: 'nationalityCertEndDate', slot: true, width: 150, align: 'center' }, + { + label: '国籍证有效期至', + prop: 'nationalityCertEndDate', + slot: true, + width: 150, + align: 'center', + }, { label: '最低安全配员证书有效期至', prop: 'safeManningCertEndDate', diff --git a/src/option/transportCapacity/transport-vehicle.js b/src/option/transportCapacity/transport-vehicle.js index 5523a36..b4f6b0a 100644 --- a/src/option/transportCapacity/transport-vehicle.js +++ b/src/option/transportCapacity/transport-vehicle.js @@ -5,7 +5,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -21,6 +21,7 @@ export const option = { label: '车牌号', prop: 'plateNo', search: true, + searchOrder: 5, slot: true, width: 120, }, @@ -28,46 +29,41 @@ export const option = { label: '所属组织', prop: 'organizationName', search: true, - width: 150, - }, - { - label: '车辆类型', - prop: 'vehicleType', - search: true, + searchOrder: 1, type: 'select', - dicData: [ - { label: '厢式', value: '厢式' }, - { label: '高栏', value: '高栏' }, - { label: '平板', value: '平板' }, - { label: '仓栅', value: '仓栅' }, - { label: '牵引车', value: '牵引车' }, - ], - width: 110, - align: 'center', + filterable: true, + dicData: [], + width: 150, }, { label: '业务关系', prop: 'businessRelation', search: true, + searchOrder: 4, type: 'select', dicData: [ + { label: '全部', value: '' }, { label: '自有', value: '自有' }, - { label: '业务合作', value: '业务合作' }, { label: '管理挂靠', value: '管理挂靠' }, + { label: '业务合作', value: '业务合作' }, ], width: 120, align: 'center', }, { - label: '能源类型', - prop: 'energyType', + label: '车辆类型', + prop: 'vehicleType', search: true, + searchOrder: 3, type: 'select', dicData: [ - { label: '柴油', value: '柴油' }, - { label: '汽油', value: '汽油' }, - { label: '新能源', value: '新能源' }, - { label: '天然气', value: '天然气' }, + { label: '全部', value: '' }, + { label: '高栏车', value: '高栏' }, + { label: '低栏车', value: '低栏' }, + { label: '平板车', value: '平板' }, + { label: '厢式车', value: '厢式' }, + { label: '拖挂车', value: '拖挂' }, + { label: '半挂车', value: '半挂' }, ], width: 110, align: 'center', @@ -79,9 +75,10 @@ export const option = { align: 'right', }, { - label: '状态', + label: '车辆状态', prop: 'status', search: true, + searchOrder: 2, type: 'select', slot: true, dicData: [ diff --git a/src/option/vehicle/accident-record.js b/src/option/vehicle/accident-record.js index 8b55c90..d5ef2a7 100644 --- a/src/option/vehicle/accident-record.js +++ b/src/option/vehicle/accident-record.js @@ -45,7 +45,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -211,22 +211,13 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, + search: true, hide: true, addDisplay: false, editDisplay: false, diff --git a/src/option/vehicle/annual-inspection-record.js b/src/option/vehicle/annual-inspection-record.js index 7e43d88..82937d1 100644 --- a/src/option/vehicle/annual-inspection-record.js +++ b/src/option/vehicle/annual-inspection-record.js @@ -44,7 +44,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -215,22 +215,11 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', hide: true, addDisplay: false, editDisplay: false, diff --git a/src/option/vehicle/etc-record.js b/src/option/vehicle/etc-record.js index 9c4158f..422768f 100644 --- a/src/option/vehicle/etc-record.js +++ b/src/option/vehicle/etc-record.js @@ -34,7 +34,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, diff --git a/src/option/vehicle/insurance-record.js b/src/option/vehicle/insurance-record.js index 8b0a0c2..595e608 100644 --- a/src/option/vehicle/insurance-record.js +++ b/src/option/vehicle/insurance-record.js @@ -42,7 +42,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -182,23 +182,12 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, diff --git a/src/option/vehicle/mileage-record.js b/src/option/vehicle/mileage-record.js index 76b388d..89c10c4 100644 --- a/src/option/vehicle/mileage-record.js +++ b/src/option/vehicle/mileage-record.js @@ -30,7 +30,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -168,23 +168,12 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, diff --git a/src/option/vehicle/oil-electric-record.js b/src/option/vehicle/oil-electric-record.js index f778c71..0e96429 100644 --- a/src/option/vehicle/oil-electric-record.js +++ b/src/option/vehicle/oil-electric-record.js @@ -31,7 +31,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -227,22 +227,11 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', hide: true, addDisplay: false, editDisplay: false, diff --git a/src/option/vehicle/other-expense-record.js b/src/option/vehicle/other-expense-record.js index 3837963..d8309ac 100644 --- a/src/option/vehicle/other-expense-record.js +++ b/src/option/vehicle/other-expense-record.js @@ -42,7 +42,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, diff --git a/src/option/vehicle/tire-replacement-record.js b/src/option/vehicle/tire-replacement-record.js index ad8f39f..cc7f76e 100644 --- a/src/option/vehicle/tire-replacement-record.js +++ b/src/option/vehicle/tire-replacement-record.js @@ -35,7 +35,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -150,23 +150,12 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, diff --git a/src/option/vehicle/transport-change-record.js b/src/option/vehicle/transport-change-record.js index e517913..7141397 100644 --- a/src/option/vehicle/transport-change-record.js +++ b/src/option/vehicle/transport-change-record.js @@ -22,7 +22,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -105,23 +105,12 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, diff --git a/src/option/vehicle/violation-record.js b/src/option/vehicle/violation-record.js index ac593c4..b4a1c43 100644 --- a/src/option/vehicle/violation-record.js +++ b/src/option/vehicle/violation-record.js @@ -53,7 +53,7 @@ export const option = { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -233,23 +233,12 @@ export const option = { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, diff --git a/src/styles/element-ui.scss b/src/styles/element-ui.scss index 11eabe3..9588ce4 100644 --- a/src/styles/element-ui.scss +++ b/src/styles/element-ui.scss @@ -148,9 +148,12 @@ margin-bottom: 8px; } +.avue-crud__search .avue-form__menu, .avue-crud__search .avue-form__menu--right { display: flex; + flex: 0 0 100%; justify-content: flex-end; + max-width: 100%; width: 100%; } diff --git a/src/utils/search-range.js b/src/utils/search-range.js new file mode 100644 index 0000000..e5723cd --- /dev/null +++ b/src/utils/search-range.js @@ -0,0 +1,27 @@ +export const normalizeSearchRangeParams = (params = {}, rangeMap = {}) => { + const values = { ...params }; + + Object.entries(rangeMap).forEach(([rangeProp, mapping]) => { + const [startProp, endProp, startSuffix = '00:00:00', endSuffix = '23:59:59'] = Array.isArray( + mapping + ) + ? mapping + : [mapping.startProp, mapping.endProp, mapping.startSuffix, mapping.endSuffix]; + + const range = values[rangeProp]; + if (Array.isArray(range) && range.length === 2) { + values[startProp] = range[0] ? `${range[0]} ${startSuffix}` : undefined; + values[endProp] = range[1] ? `${range[1]} ${endSuffix}` : undefined; + } + + delete values[rangeProp]; + }); + + Object.keys(values).forEach(key => { + if (values[key] === undefined || values[key] === null || values[key] === '') { + delete values[key]; + } + }); + + return values; +}; diff --git a/src/views/base/airport-master.vue b/src/views/base/airport-master.vue index 94a245b..01e6453 100644 --- a/src/views/base/airport-master.vue +++ b/src/views/base/airport-master.vue @@ -205,7 +205,7 @@ export default { searchLabelWidth: 160, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, diff --git a/src/views/base/cargo-type.vue b/src/views/base/cargo-type.vue index cd908f2..453cb06 100644 --- a/src/views/base/cargo-type.vue +++ b/src/views/base/cargo-type.vue @@ -24,35 +24,33 @@ 新增 - 批量导入 + 批量导入 下载模板 - 批量导出 - 批量删除 + >下载模板 + 批量导出 + 批量删除 + + 货物类型 + {{ row.typeLevel === 1 ? '/' : row.parentCargoName || '/' }} + + 上级货物类型编码 + {{ row.typeLevel === 1 ? '/' : row.parentCargoCode || '/' }} @@ -68,7 +66,7 @@ clearable :remote-method="loadParentOptions" :loading="parentLoading" - :disabled="dialogType !== 'add' || form.typeLevel !== 2" + :disabled="dialogType === 'view' || form.typeLevel !== 2" placeholder="请输入名称或编码搜索" style="width: 100%" @change="handleParentChange" @@ -99,12 +97,7 @@ > 编辑 - + 删除 @@ -130,13 +123,7 @@ + + diff --git a/src/views/business/common-route.vue b/src/views/business/common-route.vue index 061ef72..a020278 100644 --- a/src/views/business/common-route.vue +++ b/src/views/business/common-route.vue @@ -1,20 +1,669 @@ - + + + + 新增 + + 批量导出 + + 批量删除 + + + + + + + + + + + + + + + + + + + + + + + + + + 查看 + + + 编辑 + + + 删除 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 查询 + 重置 + + + + + + + + + + + + + + + + + + + + {{ row.addressType === '常规地址' ? '/' : row.siteCodeDisplay || row.siteCode || '' }} + + + + + + 选择 + + + + + + + + + + 关闭 + 确认 + + + + + diff --git a/src/views/business/process-config.vue b/src/views/business/process-config.vue index 0387f80..7f7b5c2 100644 --- a/src/views/business/process-config.vue +++ b/src/views/business/process-config.vue @@ -1,20 +1,1155 @@ - + + + + 新增 + + 批量导出 + + 批量删除 + + + + + + {{ row.statusName || displayStatus(row.status) }} + + + + + + 基本信息 + + + + 配置名称 + + + + + + 项目 + + + + + + + + 默认后台完成运输天数 + + 默认 + + 天后台完成运输 + + + + + + 备注 + + + + + + + + + + 现行过程节点 + + + + + {{ node.name }} + + {{ text }} + + + + + + 节点设置 + + + + + + {{ row.name }} + + + + + + + + + 是否确认 + + 是 + 无需确认接单 + + + + 确认接单人 + 司机 + + + + + + 是否确认 + + 是 + 无需确认完成 + + + + 确认完成 + 内部人员 + + + + + + + 是否打卡 + + 是 + 否 + + + + 上传货量 + + 是 + 否 + + + + 打卡频次,每 + handleFrequencyInput(row, value)" + /> + 天打卡1次 + + + 打卡定位 + + 是 + 否 + + + + 上传货量类型 + + 重量 + 体积 + 数量 + + + + 打卡时段 + + - + + + + + + + + + + + + 上传凭证 + + 是 + 否 + + + + 凭证类型 + + + {{ item }} + + + + + + + + + + + + + 查看 + + + 编辑 + + + 复制 + + + 启用 + + + 停用 + + + 删除 + + + + + + + + diff --git a/src/views/transportCapacity/driver.vue b/src/views/transportCapacity/driver.vue index 7998569..681a526 100644 --- a/src/views/transportCapacity/driver.vue +++ b/src/views/transportCapacity/driver.vue @@ -1,7 +1,22 @@ - - + + 批量删除 - - - 全部({{ expiryStat.total }}) - 30天内到期({{ expiryStat.within30 }}) - 已到期({{ expiryStat.expired }}) - - - - + + + + 全部({{ expiryStat.total }}) + 30天内到期({{ expiryStat.within30 }}) + 已到期({{ expiryStat.expired }}) + + {{ row.driverName }} @@ -61,12 +66,28 @@ - + {{ formatEndDate(row.drivingLicenseEndDate, row.drivingLicenseLongTerm) }} - + {{ formatEndDate(row.qualificationEndDate, row.qualificationLongTerm) }} @@ -120,12 +141,12 @@ > 基础身份信息 - + - + - + - + + + @@ -148,12 +171,14 @@ - + - + + + - + + + - - - - - - - - - + @@ -196,6 +215,8 @@ + + setImage('idCardFront', url)" /> @@ -213,6 +235,7 @@ :value="driverForm.idCardBack" :readonly="readonly" :headers="uploadHeaders" + large @success="url => setImage('idCardBack', url)" /> @@ -223,6 +246,7 @@ :value="driverForm.headPhoto" :readonly="readonly" :headers="uploadHeaders" + large @success="url => setImage('headPhoto', url)" /> @@ -253,7 +277,7 @@ - + - + 是 + + 从业资格证信息 - + - - + @@ -339,20 +372,24 @@ type="date" value-format="YYYY-MM-DD" :disabled="driverForm.qualificationLongTerm === 1" + @change="validateFormField('qualificationEndDate')" /> - + 是 + + 司机联系信息 - + - + - + - + - + + + - + - + - - - - - - + + + @@ -470,6 +499,7 @@ import { getDeptTree } from '@/api/system/dept'; import { exportBlob } from '@/api/common'; import { getToken } from '@/utils/auth'; import { downloadXls } from '@/utils/util'; +import ImageUploadField from '@/components/image-upload-field/main.vue'; const emptyForm = () => ({ id: '', @@ -505,64 +535,12 @@ const emptyForm = () => ({ organizationName: '', emergencyContactName: '', emergencyContactMobile: '', - remark: '', status: 1, }); -const imageUploadField = { - name: 'ImageUploadField', - props: { - label: String, - prop: String, - value: String, - readonly: Boolean, - headers: Object, - large: Boolean, - }, - emits: ['success'], - methods: { - handleSuccess(res) { - if (res.code === 200 && res.data) { - this.$emit('success', res.data.link || res.data.url || res.data.domain || ''); - } else { - this.$message.error(res.msg || '上传失败'); - } - }, - beforeUpload(file) { - const validType = ['image/jpeg', 'image/png', 'image/jpg', 'image/bmp'].includes(file.type); - const validSize = file.size / 1024 / 1024 < 5; - if (!validType) { - this.$message.error('仅支持 JPG、PNG、BMP 图片'); - } - if (!validSize) { - this.$message.error('图片大小不能超过 5MB'); - } - return validType && validSize; - }, - }, - template: ` - - - - 上传证件图片 - - - `, -}; - export default { components: { - ImageUploadField: imageUploadField, + ImageUploadField, }, data() { return { @@ -594,24 +572,108 @@ export default { 'Blade-Auth': `bearer ${getToken()}`, 'Blade-Requested-With': 'BladeHttpRequest', }, + nationOptions: [ + '汉族', + '蒙古族', + '回族', + '藏族', + '维吾尔族', + '苗族', + '彝族', + '壮族', + '布依族', + '朝鲜族', + '满族', + '侗族', + '瑶族', + '白族', + '土家族', + '哈尼族', + '哈萨克族', + '傣族', + '黎族', + '傈僳族', + '佤族', + '畲族', + '高山族', + '拉祜族', + '水族', + '东乡族', + '纳西族', + '景颇族', + '柯尔克孜族', + '土族', + '达斡尔族', + '仫佬族', + '羌族', + '布朗族', + '撒拉族', + '毛南族', + '仡佬族', + '锡伯族', + '阿昌族', + '普米族', + '塔吉克族', + '怒族', + '乌孜别克族', + '俄罗斯族', + '鄂温克族', + '德昂族', + '保安族', + '裕固族', + '京族', + '塔塔尔族', + '独龙族', + '鄂伦春族', + '赫哲族', + '门巴族', + '珞巴族', + '基诺族', + ], educationOptions: ['初中', '高中', '中专', '大专', '本科', '硕士及以上'], drivingTypeOptions: ['A1', 'A2', 'A3', 'B1', 'B2', 'C1', 'C2'], + qualificationTypeOptions: [ + '放射品押运员', + '道路运输从业资格证', + '危险货物运输从业资格证', + 'A1', + 'A2', + 'B1', + 'B2', + 'C1', + 'C2', + ], relationOptions: ['父母', '配偶', '子女', '兄弟姐妹', '朋友', '同事'], - deptCascaderOptions: [], - deptCascaderProps: { - label: 'label', - value: 'value', - children: 'children', - checkStrictly: true, - emitPath: false, - }, + organizationOptions: [], formRules: { driverName: [{ required: true, message: '请输入司机姓名', trigger: 'blur' }], idCardNo: [{ required: true, message: '请输入身份证号', trigger: 'blur' }], + gender: [{ required: true, message: '请选择性别', trigger: 'change' }], + postList: [ + { + type: 'array', + required: true, + min: 1, + message: '请至少选择一个岗位', + trigger: 'change', + }, + ], drivingType: [{ required: true, message: '请选择准驾车型', trigger: 'change' }], + drivingLicenseNo: [{ required: true, message: '请输入档案编号', trigger: 'blur' }], drivingLicenseEndDate: [ { validator: this.validateDrivingLicenseEndDate, trigger: 'change' }, ], + drivingLicenseLongTerm: [ + { required: true, message: '请选择驾驶证是否长期有效', trigger: 'change' }, + ], + qualificationType: [ + { required: true, message: '请选择从业资格认证类型', trigger: 'change' }, + ], + qualificationNo: [{ required: true, message: '请输入资格证号', trigger: 'blur' }], + qualificationEndDate: [{ validator: this.validateQualificationEndDate, trigger: 'change' }], + qualificationLongTerm: [ + { required: true, message: '请选择从业资格证是否长期有效', trigger: 'change' }, + ], driverType: [{ required: true, message: '请选择司机类型', trigger: 'change' }], mobile: [{ required: true, message: '请输入手机号', trigger: 'blur' }], emergencyContactName: [ @@ -625,7 +687,6 @@ export default { idCardBack: [{ required: true, message: '请上传身份证反面照', trigger: 'change' }], drivingLicenseFront: [{ required: true, message: '请上传驾驶证主页', trigger: 'change' }], drivingLicenseBack: [{ required: true, message: '请上传驾驶证副页', trigger: 'change' }], - remark: [{ max: 200, message: '备注最多200字', trigger: 'blur' }], }, }; }, @@ -659,31 +720,43 @@ export default { }, initDeptTree() { getDeptTree(this.userInfo.tenantId).then(res => { - this.deptCascaderOptions = this.formatDeptCascaderOptions(res.data.data || []); + this.organizationOptions = this.formatDeptOptions(res.data.data || []); const column = this.findColumn(this.option.column, 'organizationName'); - column.dicData = this.deptCascaderOptions; + column.dicData = this.organizationOptions; }); }, - formatDeptCascaderOptions(tree = []) { - return tree.map(item => { + formatDeptOptions(tree = [], level = 0) { + const result = []; + tree.forEach(item => { const label = item.title || item.deptName || item.name; - const option = { - label, + result.push({ + label: `${' '.repeat(level)}${label}`, value: label, - }; + }); if (item.children && item.children.length) { - option.children = this.formatDeptCascaderOptions(item.children); + result.push(...this.formatDeptOptions(item.children, level + 1)); } - return option; }); + return result; }, validateDrivingLicenseEndDate(rule, value, callback) { + if (!this.driverForm.drivingLicenseStartDate) { + callback(new Error('请选择驾驶证有效期起')); + return; + } if (this.driverForm.drivingLicenseLongTerm !== 1 && !value) { callback(new Error('请选择驾驶证有效期止')); return; } callback(); }, + validateQualificationEndDate(rule, value, callback) { + if (this.driverForm.qualificationLongTerm !== 1 && !value) { + callback(new Error('请选择从业资格证有效期')); + return; + } + callback(); + }, openDriver(row, readonly = false) { this.readonly = readonly; if (!row?.id) { @@ -711,6 +784,9 @@ export default { this.driverForm[prop] = url; this.$refs.driverForm?.validateField(prop); }, + validateFormField(prop) { + this.$refs.driverForm?.validateField(prop); + }, handleSubmit() { this.$refs.driverForm.validate(valid => { if (!valid) { @@ -863,19 +939,13 @@ export default { } return date || '-'; }, - getDateClass(row, dateProp, longTermProp) { + isDateExpiring(row, dateProp, longTermProp) { if (row[longTermProp] === 1 || !row[dateProp]) { - return ''; + return false; } const today = this.$dayjs(); const endDate = this.$dayjs(row[dateProp]); - if (endDate.isBefore(today, 'day')) { - return 'date-danger'; - } - if (endDate.diff(today, 'day') <= 30) { - return 'date-warning'; - } - return ''; + return endDate.isValid() && endDate.diff(today, 'day') <= 30; }, }, }; @@ -883,24 +953,22 @@ export default { diff --git a/src/views/transportCapacity/vehicle.vue b/src/views/transportCapacity/vehicle.vue index 4cba2c3..2df4fc8 100644 --- a/src/views/transportCapacity/vehicle.vue +++ b/src/views/transportCapacity/vehicle.vue @@ -1,7 +1,22 @@ - - + + 批量删除 - - - 全部({{ expiryStat.total }}) - 30天内到期({{ expiryStat.within30 }}) - 已到期({{ expiryStat.expired }}) - - - - + + + + 全部({{ expiryStat.total }}) + 30天内到期({{ expiryStat.within30 }}) + 已到期({{ expiryStat.expired }}) + + {{ row.plateNo }} @@ -129,19 +128,60 @@ > 基础车辆信息 - - - + + + + + - + + + - + + + + + + + + + @@ -154,14 +194,69 @@ > - + + + + + 长 + + + + 宽 + + + + 高 + + + + + + + + + + + + + + + + + + - + + + - - - + + + + + + 长期有效 + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - 是 - - - - 行驶证信息 + 车辆资质图片 - + - - + + + 长期有效 + - - - - 是 - - - - - setImage('drivingLicenseImage', url)" - /> - - - - 道路运输证信息 - - + - + + + - - + + + 长期有效 + - - - - 是 - - - - + + + + 长期有效 + + - - - - 是 - - - - - setImage('roadTransportCertImage', url)" - /> - - - 机动车登记本信息 - + - + - - - - - - + + + setImage('drivingLicenseImage', url)" + /> + + + setImage('drivingLicenseMainBack', url)" + /> + + + setImage('drivingLicenseViceFront', url)" + /> + + + + + setImage('drivingLicenseViceBack', url)" + /> + + + setImage('roadTransportCertImage', url)" + /> + + + setImage('registrationImage', url)" /> @@ -458,14 +498,19 @@ import { changeStatus, getExpiryStat, } from '@/api/transportCapacity/transport-vehicle'; +import { getDeptTree } from '@/api/system/dept'; import { exportBlob } from '@/api/common'; import { getToken } from '@/utils/auth'; import { downloadXls } from '@/utils/util'; +import ImageUploadField from '@/components/image-upload-field/main.vue'; const emptyForm = () => ({ id: '', organizationName: '', + plateProvince: '', + plateNoBody: '', plateNo: '', + plateColor: '', vehicleType: '', outerLength: undefined, outerWidth: undefined, @@ -482,6 +527,9 @@ const emptyForm = () => ({ drivingLicenseEndDate: '', drivingLicenseLongTerm: 0, drivingLicenseImage: '', + drivingLicenseMainBack: '', + drivingLicenseViceFront: '', + drivingLicenseViceBack: '', roadTransportCertNo: '', roadTransportCertStartDate: '', roadTransportCertEndDate: '', @@ -492,64 +540,50 @@ const emptyForm = () => ({ registrationNo: '', registrationDate: '', registrationImage: '', - remark: '', status: 1, }); -const imageUploadField = { - name: 'ImageUploadField', - props: { - label: String, - prop: String, - value: String, - readonly: Boolean, - headers: Object, - large: Boolean, - }, - emits: ['success'], - methods: { - handleSuccess(res) { - if (res.code === 200 && res.data) { - this.$emit('success', res.data.link || res.data.url || res.data.domain || ''); - } else { - this.$message.error(res.msg || '上传失败'); - } - }, - beforeUpload(file) { - const validType = ['image/jpeg', 'image/png', 'image/jpg', 'image/bmp'].includes(file.type); - const validSize = file.size / 1024 / 1024 < 5; - if (!validType) { - this.$message.error('仅支持 JPG、PNG、BMP 图片'); - } - if (!validSize) { - this.$message.error('图片大小不能超过 5MB'); - } - return validType && validSize; - }, - }, - template: ` - - - - 上传证件图片 - - - `, -}; +const plateProvinceOptions = [ + '京', + '津', + '沪', + '渝', + '冀', + '豫', + '云', + '辽', + '黑', + '湘', + '皖', + '鲁', + '新', + '苏', + '浙', + '赣', + '鄂', + '桂', + '甘', + '晋', + '蒙', + '陕', + '吉', + '闽', + '贵', + '粤', + '青', + '藏', + '川', + '宁', + '琼', + '港', + '澳', +].map(item => ({ label: item, value: item })); + +const plateColorOptions = ['黄牌', '蓝牌', '绿牌'].map(item => ({ label: item, value: item })); export default { components: { - ImageUploadField: imageUploadField, + ImageUploadField, }, data() { return { @@ -581,34 +615,34 @@ export default { 'Blade-Auth': `bearer ${getToken()}`, 'Blade-Requested-With': 'BladeHttpRequest', }, - vehicleTypeOptions: ['厢式', '高栏', '平板', '仓栅', '牵引车', '冷藏车'], - businessRelationOptions: ['自有', '业务合作', '管理挂靠'], + organizationOptions: [], + plateProvinceOptions, + plateColorOptions, + vehicleTypeOptions: [ + { label: '高栏车', value: '高栏' }, + { label: '低栏车', value: '低栏' }, + { label: '平板车', value: '平板' }, + { label: '厢式车', value: '厢式' }, + { label: '拖挂车', value: '拖挂' }, + { label: '半挂车', value: '半挂' }, + ], + businessRelationOptions: ['自有', '管理挂靠', '业务合作'], energyTypeOptions: ['柴油', '汽油', '新能源', '天然气'], formRules: { - organizationName: [{ required: true, message: '请输入所属组织', trigger: 'blur' }], - plateNo: [ - { required: true, message: '请输入车牌号', trigger: 'blur' }, - { - pattern: /^[\u4e00-\u9fa5][A-Z][A-Z0-9挂学警港澳]{5,6}$/, - message: '请输入标准车牌号', - trigger: 'blur', - }, - ], + organizationName: [{ required: true, message: '请选择所属组织', trigger: 'change' }], + plateNo: [{ validator: this.validatePlateNo, trigger: 'change' }], vehicleType: [{ required: true, message: '请选择车辆类型', trigger: 'change' }], approvedLoadKg: [{ required: true, message: '请输入核定载质量', trigger: 'blur' }], businessRelation: [{ required: true, message: '请选择业务关系', trigger: 'change' }], energyType: [{ required: true, message: '请选择能源类型', trigger: 'change' }], drivingLicenseNo: [{ required: true, message: '请输入行驶证档案编号', trigger: 'blur' }], - drivingLicenseEndDate: [ - { validator: this.validateDrivingLicenseEndDate, trigger: 'change' }, - ], + drivingLicenseEndDate: [{ required: true, message: '请选择行驶证有效期', trigger: 'change' }], roadTransportCertNo: [{ required: true, message: '请输入道路运输证号', trigger: 'blur' }], roadTransportCertEndDate: [ - { validator: this.validateRoadTransportCertEndDate, trigger: 'change' }, + { required: true, message: '请选择道路运输证有效期', trigger: 'change' }, ], annualReviewEndDate: [{ validator: this.validateAnnualReviewEndDate, trigger: 'change' }], registrationNo: [{ required: true, message: '请输入机动车登记编号', trigger: 'blur' }], - remark: [{ max: 200, message: '备注最多200字', trigger: 'blur' }], }, }; }, @@ -633,20 +667,44 @@ export default { return this.vehicleForm.id ? '修改车辆' : '新增车辆'; }, }, + created() { + this.initDeptTree(); + }, methods: { hasPermission(code) { return this.isAdmin || this.permission?.[code] === true; }, - validateDrivingLicenseEndDate(rule, value, callback) { - if (this.vehicleForm.drivingLicenseLongTerm !== 1 && !value) { - callback(new Error('请选择行驶证有效期止')); + initDeptTree() { + getDeptTree(this.userInfo.tenantId).then(res => { + this.organizationOptions = this.flattenDeptOptions(res.data.data || []); + const column = this.findColumn(this.option.column, 'organizationName'); + column.dicData = this.organizationOptions; + }); + }, + flattenDeptOptions(tree = [], level = 0) { + const result = []; + tree.forEach(item => { + const label = item.title || item.deptName || item.name; + result.push({ + label: `${' '.repeat(level)}${label}`, + value: label, + }); + if (item.children && item.children.length) { + result.push(...this.flattenDeptOptions(item.children, level + 1)); + } + }); + return result; + }, + validatePlateNo(rule, value, callback) { + const plateProvince = String(this.vehicleForm.plateProvince || '').trim(); + const plateNoBody = String(this.vehicleForm.plateNoBody || '').trim().toUpperCase(); + const plateColor = String(this.vehicleForm.plateColor || '').trim(); + if (!plateProvince || !plateNoBody || !plateColor) { + callback(new Error('请完整填写车牌号')); return; } - callback(); - }, - validateRoadTransportCertEndDate(rule, value, callback) { - if (this.vehicleForm.roadTransportCertLongTerm !== 1 && !value) { - callback(new Error('请选择道路运输证有效期止')); + if (!/^[A-Z][A-Z0-9挂学警港澳]{5,6}$/.test(plateNoBody)) { + callback(new Error('请输入标准车牌号')); return; } callback(); @@ -662,6 +720,7 @@ export default { this.readonly = readonly; if (!row?.id) { this.vehicleForm = emptyForm(); + this.syncPlateNo(false); this.vehicleBox = true; return; } @@ -670,6 +729,8 @@ export default { ...emptyForm(), ...(res.data.data || {}), }; + this.splitPlateNo(); + this.syncPlateNo(false); this.vehicleBox = true; }); }, @@ -683,7 +744,33 @@ export default { this.vehicleForm[prop] = url; this.$refs.vehicleForm?.validateField(prop); }, + handlePlateBodyInput(value) { + this.vehicleForm.plateNoBody = String(value || '').toUpperCase(); + this.syncPlateNo(); + }, + syncPlateNo(validate = true) { + const plateProvince = String(this.vehicleForm.plateProvince || '').trim(); + const plateNoBody = String(this.vehicleForm.plateNoBody || '').trim().toUpperCase(); + const plateColor = String(this.vehicleForm.plateColor || '').trim(); + this.vehicleForm.plateNoBody = plateNoBody; + this.vehicleForm.plateNo = plateProvince && plateNoBody ? `${plateProvince}${plateNoBody}` : ''; + this.vehicleForm.plateColor = plateColor; + if (validate) { + this.$refs.vehicleForm?.validateField('plateNo'); + } + }, + splitPlateNo() { + const plateNo = String(this.vehicleForm.plateNo || '').trim(); + if (!plateNo) { + this.vehicleForm.plateProvince = ''; + this.vehicleForm.plateNoBody = ''; + return; + } + this.vehicleForm.plateProvince = plateNo.slice(0, 1); + this.vehicleForm.plateNoBody = plateNo.slice(1).toUpperCase(); + }, handleSubmit() { + this.syncPlateNo(); this.$refs.vehicleForm.validate(valid => { if (!valid) { return; @@ -850,20 +937,6 @@ export default { diff --git a/src/views/vehicle/accident-record.vue b/src/views/vehicle/accident-record.vue index 0261da0..c6122c6 100644 --- a/src/views/vehicle/accident-record.vue +++ b/src/views/vehicle/accident-record.vue @@ -119,11 +119,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/accident-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -388,9 +393,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -411,7 +416,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -446,11 +451,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/accident-record/export-template?${this.website.tokenHeader}=${getToken()}` diff --git a/src/views/vehicle/credit-score-quantification.vue b/src/views/vehicle/credit-score-quantification.vue index bb8e907..19af646 100644 --- a/src/views/vehicle/credit-score-quantification.vue +++ b/src/views/vehicle/credit-score-quantification.vue @@ -361,10 +361,15 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -409,7 +414,7 @@ export default { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -459,20 +464,12 @@ export default { minWidth: 160, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - hide: true, - display: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, hide: true, display: false, }, @@ -795,9 +792,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -814,7 +811,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, Object.assign(params, this.query)).then(res => { + getList(page.currentPage, page.pageSize, this.buildQuery(params)).then(res => { const data = res.data.data; this.page.total = data.total; this.data = data.records; @@ -845,11 +842,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/credit-score-quantification/export-template?${ diff --git a/src/views/vehicle/customer-archive.vue b/src/views/vehicle/customer-archive.vue index d734761..c460031 100644 --- a/src/views/vehicle/customer-archive.vue +++ b/src/views/vehicle/customer-archive.vue @@ -600,10 +600,15 @@ import { getDeptTree } from '@/api/system/dept'; import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + const EditableTable = { props: { data: { @@ -788,7 +793,7 @@ export default { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -869,21 +874,12 @@ export default { clearable: true, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - display: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, display: false, @@ -1377,9 +1373,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -1400,7 +1396,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const pageData = res.data.data; this.page.total = pageData.total; @@ -1432,11 +1428,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, }, }; diff --git a/src/views/vehicle/insurance-record.vue b/src/views/vehicle/insurance-record.vue index 0c29853..16640c5 100644 --- a/src/views/vehicle/insurance-record.vue +++ b/src/views/vehicle/insurance-record.vue @@ -157,11 +157,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/insurance-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -281,6 +286,9 @@ export default { } return values; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, validateRow(row) { if (row.startDate && row.endDate && row.endDate < row.startDate) { this.$message.warning('结束日期不能早于开始日期'); @@ -386,9 +394,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -409,7 +417,8 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + const query = this.buildQuery(params); + getList(page.currentPage, page.pageSize, query) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -444,7 +453,7 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; @@ -493,10 +502,10 @@ export default { display: flex; align-items: center; justify-content: space-between; - min-height: 116px; - padding: 26px 46px 26px 32px; - border: 2px dashed #8b8b8b; - border-radius: 12px; + min-height: 88px; + padding: 16px 28px 16px 22px; + border: 1px dashed #8b8b8b; + border-radius: 8px; background: #fff; } @@ -511,34 +520,34 @@ export default { display: flex; align-items: center; justify-content: center; - width: 56px; - height: 56px; - margin-right: 30px; + width: 42px; + height: 42px; + margin-right: 18px; color: #707070; } :global(.insurance-record-page__upload-icon::before), :global(.insurance-record-page__upload-icon::after) { position: absolute; - width: 14px; - height: 14px; + width: 11px; + height: 11px; content: ''; } :global(.insurance-record-page__upload-icon::before) { top: 0; left: 0; - border-top: 4px solid currentColor; - border-left: 4px solid currentColor; - border-radius: 4px 0 0; + border-top: 3px solid currentColor; + border-left: 3px solid currentColor; + border-radius: 3px 0 0; } :global(.insurance-record-page__upload-icon::after) { right: 0; bottom: 0; - border-right: 4px solid currentColor; - border-bottom: 4px solid currentColor; - border-radius: 0 0 4px; + border-right: 3px solid currentColor; + border-bottom: 3px solid currentColor; + border-radius: 0 0 3px; } :global(.insurance-record-page__upload-card) { @@ -546,10 +555,10 @@ export default { display: flex; align-items: center; justify-content: center; - width: 36px; - height: 28px; - border: 4px solid currentColor; - border-radius: 4px; + width: 28px; + height: 22px; + border: 3px solid currentColor; + border-radius: 3px; } :global(.insurance-record-page__upload-card::before), @@ -559,38 +568,38 @@ export default { } :global(.insurance-record-page__upload-card::before) { - top: 7px; - left: 9px; - width: 8px; - height: 8px; - border: 3px solid currentColor; + top: 5px; + left: 7px; + width: 6px; + height: 6px; + border: 2px solid currentColor; border-radius: 2px; } :global(.insurance-record-page__upload-card::after) { - top: 8px; - right: 7px; - width: 8px; - height: 3px; + top: 6px; + right: 5px; + width: 6px; + height: 2px; background: currentColor; - box-shadow: 0 8px 0 currentColor; + box-shadow: 0 6px 0 currentColor; } :global(.insurance-record-page__upload-card span) { position: absolute; - right: 7px; - bottom: 5px; - width: 10px; - height: 3px; + right: 5px; + bottom: 4px; + width: 8px; + height: 2px; background: currentColor; } :global(.insurance-record-page__upload-text) { display: flex; flex-direction: column; - gap: 8px; + gap: 4px; color: #303133; - font-size: 20px; + font-size: 16px; line-height: 1.25; } @@ -605,7 +614,7 @@ export default { :global(.insurance-record-page__upload-action) { flex: 0 0 auto; - margin-left: 24px; + margin-left: 18px; } :global(.insurance-record-page__upload-action .el-upload) { @@ -613,10 +622,10 @@ export default { } :global(.insurance-record-page__upload-button) { - min-width: 156px; - height: 58px; - border-radius: 8px; - font-size: 20px; + min-width: 112px; + height: 40px; + border-radius: 6px; + font-size: 14px; font-weight: 500; } @@ -624,8 +633,8 @@ export default { :global(.insurance-record-page__upload) { align-items: stretch; flex-direction: column; - gap: 18px; - padding: 22px; + gap: 12px; + padding: 16px; } :global(.insurance-record-page__upload-action) { diff --git a/src/views/vehicle/maintenance-plan.vue b/src/views/vehicle/maintenance-plan.vue index 8c11f0c..220f42f 100644 --- a/src/views/vehicle/maintenance-plan.vue +++ b/src/views/vehicle/maintenance-plan.vue @@ -120,10 +120,15 @@ import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { formatUpdateUserName } from '@/utils/audit'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { const validateNonNegative = (rule, value, callback) => { @@ -160,7 +165,7 @@ export default { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -337,23 +342,12 @@ export default { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, @@ -652,9 +646,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -675,7 +669,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -710,11 +704,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/maintenance-plan/export-template?${ diff --git a/src/views/vehicle/maintenance-record.vue b/src/views/vehicle/maintenance-record.vue index 709ac12..4136c97 100644 --- a/src/views/vehicle/maintenance-record.vue +++ b/src/views/vehicle/maintenance-record.vue @@ -117,10 +117,15 @@ import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { formatUpdateUserName } from '@/utils/audit'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { const validateNonNegative = (rule, value, callback) => { @@ -158,7 +163,7 @@ export default { searchShow: true, searchMenuSpan: 24, searchIcon: true, - searchIndex: 8, + searchIndex: 4, searchMenuPosition: 'right', border: true, index: true, @@ -333,23 +338,12 @@ export default { minWidth: 170, }, { - label: '创建开始时间', - prop: 'createTimeStart', + label: '创建时间', + prop: 'createTimeRange', type: 'date', - format: 'YYYY-MM-DD 00:00:00', - valueFormat: 'YYYY-MM-DD 00:00:00', - search: true, - hide: true, - addDisplay: false, - editDisplay: false, - viewDisplay: false, - }, - { - label: '创建结束时间', - prop: 'createTimeEnd', - type: 'date', - format: 'YYYY-MM-DD 23:59:59', - valueFormat: 'YYYY-MM-DD 23:59:59', + format: 'YYYY-MM-DD', + valueFormat: 'YYYY-MM-DD', + searchRange: true, search: true, hide: true, addDisplay: false, @@ -637,9 +631,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -660,7 +654,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -695,11 +689,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/maintenance-record/export-template?${ diff --git a/src/views/vehicle/mileage-record.vue b/src/views/vehicle/mileage-record.vue index 746c7bc..da2f6be 100644 --- a/src/views/vehicle/mileage-record.vue +++ b/src/views/vehicle/mileage-record.vue @@ -138,11 +138,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/mileage-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -464,15 +469,16 @@ export default { searchReset() { this.query = {}; if (this.$refs.crud?.search) { + this.$refs.crud.search.createTimeRange = undefined; this.$refs.crud.search.totalMileageStart = undefined; this.$refs.crud.search.totalMileageEnd = undefined; } this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -493,7 +499,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -528,11 +534,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/mileage-record/export-template?${this.website.tokenHeader}=${getToken()}` diff --git a/src/views/vehicle/tire-replacement-record.vue b/src/views/vehicle/tire-replacement-record.vue index a869991..cd62309 100644 --- a/src/views/vehicle/tire-replacement-record.vue +++ b/src/views/vehicle/tire-replacement-record.vue @@ -118,11 +118,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/tire-replacement-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -328,9 +333,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -351,7 +356,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -386,11 +391,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/tire-replacement-record/export-template?${ diff --git a/src/views/vehicle/transport-change-record.vue b/src/views/vehicle/transport-change-record.vue index 14f4b6d..6cd2908 100644 --- a/src/views/vehicle/transport-change-record.vue +++ b/src/views/vehicle/transport-change-record.vue @@ -101,11 +101,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/transport-change-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -346,9 +351,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -369,7 +374,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -404,11 +409,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/transport-change-record/export-template?${ diff --git a/src/views/vehicle/violation-record.vue b/src/views/vehicle/violation-record.vue index f4c5a0d..a53fe4c 100644 --- a/src/views/vehicle/violation-record.vue +++ b/src/views/vehicle/violation-record.vue @@ -145,11 +145,16 @@ import { exportBlob } from '@/api/common'; import { downloadXls } from '@/utils/util'; import { openImportDialog } from '@/utils/import-excel'; import { getToken } from '@/utils/auth'; +import { normalizeSearchRangeParams } from '@/utils/search-range'; import { mapGetters } from 'vuex'; import { excelOption, option } from '@/option/vehicle/violation-record'; import NProgress from 'nprogress'; import 'nprogress/nprogress.css'; +const createTimeRangeMap = { + createTimeRange: ['createTimeStart', 'createTimeEnd'], +}; + export default { data() { return { @@ -454,9 +459,9 @@ export default { this.onLoad(this.page); }, searchChange(params, done) { - this.query = params; + this.query = this.buildQuery(params); this.page.currentPage = 1; - this.onLoad(this.page, params); + this.onLoad(this.page); done(); }, selectionChange(list) { @@ -477,7 +482,7 @@ export default { }, onLoad(page, params = {}) { this.loading = true; - getList(page.currentPage, page.pageSize, { ...params, ...this.query }) + getList(page.currentPage, page.pageSize, this.buildQuery(params)) .then(res => { const data = res.data.data; this.page.total = data.total; @@ -512,11 +517,14 @@ export default { }, buildExportParams() { return { - ...this.query, + ...this.buildQuery(), ids: this.ids, [this.website.tokenHeader]: getToken(), }; }, + buildQuery(params = {}) { + return normalizeSearchRangeParams({ ...params, ...this.query }, createTimeRangeMap); + }, handleTemplate() { exportBlob( `/blade-transport/violation-record/export-template?${ diff --git a/需求卡/常用地址需求卡.md b/需求卡/常用地址需求卡.md index 6bb05e2..12e529c 100644 --- a/需求卡/常用地址需求卡.md +++ b/需求卡/常用地址需求卡.md @@ -3,113 +3,117 @@ REQ-ADDR-01 模块入口与访问权限 - 功能点:支持具备常用地址功能权限的账号从基础数据进入常用地址列表页面,查看权限范围内的地址主数据。 -- 异常与边界:①账号无该模块权限时不展示入口或禁止进入页面;②账号权限被调整后再次进入页面应按最新权限判断;③进入页面失败时保留在当前可访问页面并给出明确提示。 -- 反例:①不允许无权限账号直接访问常用地址页面;②不允许绕过基础数据菜单进入未授权模块;③不允许权限失效后继续操作历史打开页面中的数据。 +- 异常与边界:① 账号无该模块权限时不展示入口或禁止进入页面;② 账号权限被调整后再次进入页面应按最新权限判断;③ 进入页面失败时保留在当前可访问页面并给出明确提示。 +- 反例:① 不允许无权限账号直接访问常用地址页面;② 不允许绕过基础数据菜单进入未授权模块;③ 不允许权限失效后继续操作历史打开页面中的数据。 REQ-ADDR-02 条件查询 - 功能点:支持按地址名称、类型、详细地址、行政区划、站点编码、组织、联系人、联系方式筛选常用地址数据。 -- 异常与边界:①未输入查询条件时默认查询权限范围内全部数据;②地址名称、详细地址、行政区划、联系人、联系方式按模糊匹配查询;③类型、组织按下拉选择值精确匹配,站点编码按精确匹配查询。 -- 反例:①不允许类型条件出现常规、港口/码头、铁路车站、空港机场之外的值;②不允许站点编码输入空格后被当作有效编码查询;③不允许普通用户通过组织条件越权修改其他组织数据。 +- 异常与边界:① 未输入查询条件时默认查询权限范围内全部数据;② 地址名称、详细地址、行政区划、联系人、联系方式按模糊匹配查询;③ 类型、组织按下拉选择值精确匹配,站点编码按精确匹配查询。 +- 反例:① 不允许类型条件出现常规、港口/码头、铁路车站、空港机场之外的值;② 不允许站点编码输入空格后被当作有效编码查询;③ 不允许普通用户通过组织条件越权修改其他组织数据。 REQ-ADDR-03 查询重置 - 功能点:支持一键重置查询条件,清空用户已输入的筛选项并恢复默认组织范围。 -- 异常与边界:①点击重置后地址名称、类型、详细地址、行政区划、站点编码、联系人、联系方式恢复为空或全部;②组织条件恢复为当前用户所属组织默认值;③重置后列表按默认条件重新加载。 -- 反例:①不允许重置后残留上一次的文本查询条件;②不允许重置后组织范围变成未授权组织;③不允许只清空界面条件但列表仍按旧条件展示。 +- 异常与边界:① 点击重置后地址名称、类型、详细地址、行政区划、站点编码、联系人、联系方式恢复为空或全部;② 组织条件恢复为当前用户所属组织默认值;③ 重置后列表按默认条件重新加载。 +- 反例:① 不允许重置后残留上一次的文本查询条件;② 不允许重置后组织范围变成未授权组织;③ 不允许只清空界面条件但列表仍按旧条件展示。 REQ-ADDR-04 列表展示 -- 功能点:支持分页展示常用地址列表,展示序号、地址名称、地址编号、类型、站点编码、详细地址、经纬度、行政区划、联系人、联系方式、组织、备注、更新时间、创建时间和操作。 -- 异常与边界:①进入页面默认展示当前组织全部数据,并按更新时间降序排列;②列表默认每页 10 条,支持切换 20、50、100 条每页;③常规类型站点编码显示为“/”,其他类型显示对应主数据编码。 -- 反例:①不允许列表直接展示 createUser、updateUser 等用户 ID 字段;②不允许常规地址展示虚假的站点编码;③不允许分页切换后丢失当前查询条件。 +- 功能点:支持分页展示常用地址列表,展示序号、类型、地址名称、地址编号、站点编码、行政区划、详细地址、联系人、联系方式、组织、备注、更新时间、创建时间和操作。 +- 异常与边界:① 进入页面默认展示当前组织全部数据,并按更新时间降序排列;② 列表默认每页 10 条,支持切换 20、50、100 条每页;③ 常规类型站点编码显示为“/”,其他类型显示后端返回的站点编码。 +- 反例:① 不允许列表直接展示 createUser、updateUser 等用户 ID 字段;② 不允许常规地址展示虚假的站点编码;③ 不允许分页切换后丢失当前查询条件。 REQ-ADDR-05 组织数据范围 -- 功能点:支持通过组织字段控制数据权限,普通用户默认查看当前组织数据,可按权限切换查看全部组织只读数据。 -- 异常与边界:①当前组织为空或组织权限异常时应阻止查询并提示;②切换组织范围后列表、分页和导出均按新范围生效;③查看全部组织数据时非本组织或无操作权限的数据仅允许查看。 -- 反例:①不允许普通用户编辑或删除无权限组织的数据;②不允许通过手动构造组织条件获取未授权数据;③不允许导出超出当前组织权限范围的数据。 +- 功能点:通过组织字段控制数据权限,列表默认按当前组织权限范围展示,不在表格顶部提供“当前组织/全部组织”切换。 +- 异常与边界:① 当前组织为空或组织权限异常时应阻止查询并提示;② 列表、分页和导出均按当前权限范围生效;③ 非本组织或无操作权限的数据仅允许查看。 +- 反例:① 不允许普通用户编辑或删除无权限组织的数据;② 不允许通过手动构造组织条件获取未授权数据;③ 不允许导出超出当前组织权限范围的数据。 REQ-ADDR-06 新增常规地址 -- 功能点:支持手工新增常规地址,录入地址类型、地址名称、联系人、联系方式、详细地址、行政区划、经纬度和备注等信息。 -- 异常与边界:①类型、地址名称、详细地址为必填项,缺失时阻止提交并提示;②经纬度通过地图选点产生,提交时经度保留 6 位且范围为 -180 到 180,纬度保留 6 位且范围为 -90 到 90;③提交失败时保留用户已录入内容,便于修正后重新提交。 -- 反例:①不允许新增没有地址名称的常规地址;②不允许手工录入超出范围的经纬度,如经度 181 或纬度 -91;③不允许备注超过 200 个字后仍提交。 +- 功能点:支持手工新增常规地址,类型使用单选并单独展示在第一行,地址名称单独展示在第二行,详细地址行内并排展示行政区划自动带出项与详细地址地图选择项,录入联系人、联系方式和备注等信息。 +- 异常与边界:① 类型、地址名称、行政区划、详细地址为必填项,缺失时阻止提交并提示;② 行政区划通过地图组件搜索或点击选点自动回填,不提供自行输入入口;③ 提交失败时保留用户已录入内容,便于修正后重新提交。 +- 反例:① 不允许新增没有地址名称的常规地址;② 不允许手工录入行政区划绕过地图选择;③ 不允许备注超过 200 个字后仍提交。 REQ-ADDR-07 新增港口/码头地址 -- 功能点:支持从港口/码头主数据选择记录生成常用地址,自动带出地址名称、详细地址、行政区划、站点编码和经纬度信息。 -- 异常与边界:①未选择港口/码头主数据时阻止提交;②选择后地址名称默认填充港口/码头名称且允许修改;③站点编码自动带出港口/码头编码且不可修改。 -- 反例:①不允许把港口/码头地址的站点编码改成其他编码;②不允许选择不存在或已失效的港口/码头主数据;③不允许港口/码头类型提交为常规地址的“/”站点编码。 +- 功能点:支持新增港口/码头类型常用地址,类型通过单选切换;选择类型后展示港口和码头字段,港口为下拉搜索选择,码头必须在选定港口后联动加载港口下属码头;选择码头后自动带出地址名称、行政区划、详细地址和站点编码,地址名称允许修改。 +- 异常与边界:① 类型、港口、码头、地址名称、行政区划、详细地址为必填项;② 未选择港口时码头不可选择;③ 站点编码关联主数据自动带出,不在新增、编辑表单中手工维护。 +- 反例:① 不允许未选择港口直接选择码头;② 不允许选择非当前港口下属的码头;③ 不允许用户手工修改港口/码头站点编码。 REQ-ADDR-08 新增铁路车站地址 -- 功能点:支持从铁路车站主数据选择记录生成常用地址,自动带出地址名称、详细地址、行政区划、站点编码和经纬度信息。 -- 异常与边界:①未选择铁路车站主数据时阻止提交;②选择后地址名称默认填充车站名称且允许修改;③站点编码自动带出铁路车站编码且不可修改。 -- 反例:①不允许铁路车站类型使用港口码头或机场编码;②不允许手工伪造车站编码完成提交;③不允许已被主数据删除或停用的车站继续作为新增来源。 +- 功能点:支持新增铁路车站类型常用地址,类型通过单选切换;选择类型后展示车站名称下拉搜索选择,车站名称来源于铁路车站主数据;选择车站后自动带出地址名称、行政区划、详细地址和铁路车站编码,地址名称允许修改。 +- 异常与边界:① 类型、车站名称、地址名称、行政区划、详细地址为必填项;② 车站名称必须从铁路车站主数据中选择;③ 站点编码关联主数据自动带出,不在新增、编辑表单中手工维护。 +- 反例:① 不允许手工输入不存在的车站名称作为主数据来源;② 不允许铁路车站类型使用港口码头或机场编码;③ 不允许用户手工伪造车站编码完成提交。 REQ-ADDR-09 新增空港机场地址 -- 功能点:支持从空港机场主数据选择记录生成常用地址,自动带出地址名称、详细地址、行政区划、站点编码和经纬度信息。 -- 异常与边界:①未选择空港机场主数据时阻止提交;②选择后地址名称默认填充机场名称且允许修改;③站点编码自动带出机场编码且不可修改。 -- 反例:①不允许空港机场类型使用常规地址的“/”站点编码;②不允许将铁路车站编码作为机场站点编码;③不允许选择不存在或已失效的机场主数据。 +- 功能点:支持新增空港机场类型常用地址,类型通过单选切换;选择类型后展示机场标准名称下拉搜索选择,机场标准名称来源于机场主数据;选择机场后自动带出地址名称、行政区划、详细地址和机场 IATA 编码,地址名称允许修改。 +- 异常与边界:① 类型、机场标准名称、地址名称、行政区划、详细地址为必填项;② 机场标准名称必须从机场主数据中选择;③ 站点编码关联主数据自动带出,不在新增、编辑表单中手工维护。 +- 反例:① 不允许手工输入不存在的机场标准名称作为主数据来源;② 不允许空港机场类型使用常规地址的“/”站点编码;③ 不允许将铁路车站编码作为机场站点编码。 REQ-ADDR-10 地址编号生成 - 功能点:系统为每条常用地址自动生成全局唯一地址编号,编号以 DZ 开头并按 5 位流水号递增。 -- 异常与边界:①新增提交时由系统生成地址编号,用户无需录入;②并发新增时应保证地址编号不重复;③编辑地址时保留原地址编号不重新生成。 -- 反例:①不允许用户手工填写地址编号;②不允许出现两个地址共用同一地址编号;③不允许编辑保存后地址编号从 DZ00001 变成新的流水号。 +- 异常与边界:① 新增提交时由系统生成地址编号,用户无需录入;② 并发新增时应保证地址编号不重复;③ 编辑地址时保留原地址编号不重新生成。 +- 反例:① 不允许用户手工填写地址编号;② 不允许出现两个地址共用同一地址编号;③ 不允许编辑保存后地址编号从 DZ00001 变成新的流水号。 REQ-ADDR-11 地图选点与地址回填 -- 功能点:常规地址支持通过地图组件搜索和手动选点,自动回填详细地址、行政区划、经度和纬度。 -- 异常与边界:①地图搜索无结果时保持当前输入内容并提示无匹配地址;②用户重新选点后应覆盖原经纬度和地址回填信息;③地图组件加载失败时应提示用户稍后重试或重新打开弹窗。 -- 反例:①不允许未选点时生成无效经纬度;②不允许经纬度弹窗字段前台不展示却后台不记录;③不允许详细地址与经纬度明显来自两次不同选点结果。 +- 功能点:新增、编辑地址时支持通过高德地图组件搜索和点击选点,自动回填行政区划,并可同步回填详细地址。 +- 异常与边界:① 高德地图搜索无结果时保持当前输入内容并提示无匹配地址;② 用户重新选点后应覆盖原行政区划、详细地址和后台坐标信息;③ 高德地图组件加载失败时应提示用户稍后重试或重新打开弹窗。 +- 反例:① 不允许未选择地图位置时回填行政区划;② 不允许在新增、编辑表单中展示或手工维护经纬度字段;③ 不允许详细地址与行政区划明显来自两次不同选点结果。 REQ-ADDR-12 查看地址详情 - 功能点:支持在操作列查看单条常用地址详情,展示该地址的基础信息、组织信息、地址信息和创建更新时间。 -- 异常与边界:①无查看权限时隐藏查看入口或禁止打开;②记录已被删除时提示数据不存在并刷新列表;③查看全部组织数据时详情页保持只读。 -- 反例:①不允许查看详情时进入可编辑状态;②不允许详情页展示用户 ID 代替组织或人员名称;③不允许已删除记录仍显示为可查看有效数据。 +- 异常与边界:① 无查看权限时隐藏查看入口或禁止打开;② 记录已被删除时提示数据不存在并刷新列表;③ 无编辑权限或只读数据详情页保持只读。 +- 反例:① 不允许查看详情时进入可编辑状态;② 不允许详情页展示用户 ID 代替组织或人员名称;③ 不允许已删除记录仍显示为可查看有效数据。 REQ-ADDR-13 编辑常用地址 -- 功能点:支持编辑权限范围内的常用地址,维护地址名称、联系人、联系方式、详细地址、行政区划、经纬度和备注等信息。 -- 异常与边界:①无编辑权限或非可编辑组织数据时禁止编辑;②站点编码按地址类型规则控制,常规地址显示“/”,港口/码头、铁路车站、空港机场自动带出且不可修改;③保存成功后刷新列表并保留当前分页和查询条件。 -- 反例:①不允许编辑时修改地址编号;②不允许把港口/码头地址直接改成机场编码但仍保留港口信息;③不允许备注超过 200 个字后仍保存。 +- 功能点:支持编辑权限范围内的常用地址,维护类型、地址名称、联系人、联系方式、行政区划、详细地址和备注等信息。 +- 异常与边界:① 无编辑权限或非可编辑组织数据时禁止编辑;② 类型使用单选展示,地址名称单独占一行,详细地址行内并排展示行政区划自动带出项与详细地址地图选择项;③ 保存成功后刷新列表并保留当前分页和查询条件。 +- 反例:① 不允许编辑时修改地址编号;② 不允许在新增、编辑表单中展示来源主数据、经纬度或组织范围切换;③ 不允许备注超过 200 个字后仍保存。 REQ-ADDR-14 单条删除 - 功能点:支持在操作列删除单条常用地址,删除前进行二次确认并校验是否被业务数据引用。 -- 异常与边界:①点击删除后弹出确认提示,用户取消时不删除数据;②删除前若已被业务数据引用则提示不可删除并保持原数据;③删除成功后刷新列表并提示删除成功。 -- 反例:①不允许未确认直接删除地址;②不允许删除已被业务单据引用的地址;③不允许无删除权限用户看到或触发删除操作。 +- 异常与边界:① 点击删除后弹出确认提示,用户取消时不删除数据;② 删除前若已被业务数据引用则提示不可删除并保持原数据;③ 删除成功后刷新列表并提示删除成功。 +- 反例:① 不允许未确认直接删除地址;② 不允许删除已被业务单据引用的地址;③ 不允许无删除权限用户看到或触发删除操作。 REQ-ADDR-15 批量删除 - 功能点:支持勾选多条常用地址后批量删除,删除前进行二次确认并逐一校验业务引用关系。 -- 异常与边界:①未勾选数据时点击批量删除应提示先选择数据;②确认删除前系统逐条校验引用状态,已引用记录从删除队列跳过并提示;③删除完成后刷新列表并提示成功删除条数和因引用跳过条数。 -- 反例:①不允许批量删除时删除未被勾选的数据;②不允许因部分记录被引用导致所有可删除记录都无法删除;③不允许越权批量删除其他组织数据。 +- 异常与边界:① 未勾选数据时点击批量删除应提示先选择数据;② 确认删除前系统逐条校验引用状态,已引用记录从删除队列跳过并提示;③ 删除完成后刷新列表并提示成功删除条数和因引用跳过条数。 +- 反例:① 不允许批量删除时删除未被勾选的数据;② 不允许因部分记录被引用导致所有可删除记录都无法删除;③ 不允许越权批量删除其他组织数据。 REQ-ADDR-16 批量导出 - 功能点:支持批量导出常用地址数据,勾选多行时导出勾选数据,未勾选时按当前查询条件导出全部匹配数据。 -- 异常与边界:①导出字段与列表展示字段保持一致;②导出范围受当前查询条件和组织权限限制;③导出失败时提示失败原因,不清空当前查询条件和勾选状态。 -- 反例:①不允许导出超出当前权限范围的数据;②不允许导出文件缺少列表中的关键业务字段;③不允许未勾选时忽略当前查询条件导出全库数据。 +- 异常与边界:① 导出字段与列表展示字段保持一致;② 导出范围受当前查询条件和组织权限限制;③ 导出失败时提示失败原因,不清空当前查询条件和勾选状态。 +- 反例:① 不允许导出超出当前权限范围的数据;② 不允许导出文件缺少列表中的关键业务字段;③ 不允许未勾选时忽略当前查询条件导出全库数据。 REQ-ADDR-17 操作列权限控制 - 功能点:列表操作列固定支持查看、编辑、删除,并根据用户权限和数据范围决定按钮展示或可用状态。 -- 异常与边界:①无查看权限时不展示查看操作;②无编辑或删除权限时隐藏对应操作;③只读组织数据仅保留查看,不允许编辑和删除。 -- 反例:①不允许前端显示了无权限按钮但点击后才提示失败;②不允许只读数据出现编辑入口;③不允许批量按钮绕过行级权限控制。 +- 异常与边界:① 无查看权限时不展示查看操作;② 无编辑或删除权限时隐藏对应操作;③ 只读组织数据仅保留查看,不允许编辑和删除。 +- 反例:① 不允许前端显示了无权限按钮但点击后才提示失败;② 不允许只读数据出现编辑入口;③ 不允许批量按钮绕过行级权限控制。 ## 通用规则 - 常用地址类型固定为常规地址、港口/码头、铁路车站、空港机场,新增和查询不得使用其他类型。 - 地址编号由系统自动生成,全局唯一,格式为 DZ 开头加 5 位递增流水号,用户不可手工录入或修改。 -- 常规地址通过地图选点生成详细地址、行政区划、经度和纬度;经度、纬度后台记录并在列表展示,保留 6 位小数。 -- 港口/码头、铁路车站、空港机场地址从对应主数据选择生成,站点编码自动带出且不可修改,地址名称可在默认带出后调整。 +- 新增、编辑弹窗中类型使用单选并单独展示在第一行,地址名称单独展示在第二行。 +- 新增、编辑弹窗中行政区划和详细地址放在同一行,行政区划自动带出,详细地址点击后弹出高德地图组件。 +- 新增、编辑弹窗不展示来源主数据选择项,不展示或手工维护经纬度字段。 +- 地址通过高德地图选点生成行政区划,可同步回填详细地址;经纬度作为后台坐标信息保留,不在列表和表单中展示。 +- 港口/码头类型先选择港口再选择码头,码头为港口附属数据;铁路车站类型通过车站名称下拉搜索选择;空港机场类型通过机场标准名称下拉搜索选择。 +- 港口/码头、铁路车站、空港机场选择对应主数据后自动带出地址名称、行政区划、详细地址和站点编码,其中地址名称允许用户修改,站点编码不在新增、编辑表单中手工维护。 - 列表默认按更新时间降序展示,默认每页 10 条,支持 20、50、100 条每页。 -- 组织字段作为数据权限字段,普通用户默认查看当前组织数据,查看全部组织数据时按权限只读展示。 +- 组织字段作为数据权限字段,列表顶部不提供“当前组织/全部组织”切换。 - 删除前必须校验是否被业务数据引用,已引用的记录不允许删除;批量删除时已引用记录跳过并提示。 - 备注类字段最多 200 个字,超过限制时前端阻止提交并给出明确提示。 - 用户可见场景不得直接展示 createUser、updateUser 等用户 ID 字段;涉及人员展示时优先使用姓名字段。 diff --git a/需求卡/常用线路需求卡.md b/需求卡/常用线路需求卡.md index 2e5e83b..1ee86a8 100644 --- a/需求卡/常用线路需求卡.md +++ b/需求卡/常用线路需求卡.md @@ -19,23 +19,24 @@ ### REQ-CYXL-001 列表与分页 - 功能点: + - 默认展示当前组织全部常用线路数据,列表按更新时间降序排列。 - 展示组织、线路编号、线路名称、发货地、发货地址、收货地、收货地址、创建人、更新时间、创建时间、操作等字段。 - - 常规类型站点编码在列表中显示为“/”,其他类型显示对应编码。 - 支持勾选多行数据用于批量导出、批量删除。 - 操作列固定展示查看、编辑、删除,具体显示受权限控制。 - - 普通用户默认仅看当前组织数据;具备权限时可切换查看全部组织数据,但切换后的全部组织视图仅作只读查看。 - - 分页默认10条/页,支持20/50/100条/页。 + - 普通用户默认仅看当前组织数据,列表顶部不提供“当前组织/全部组织”切换。 + - 分页默认 10 条/页,支持 20/50/100 条/页。 - 异常与边界: + - 查询无数据时展示空状态。 - 当前页删除后无数据时自动回退页码并刷新列表。 - - 切换组织范围时保留当前查询条件,仅重载数据。 + - 列表、分页和导出均按当前组织权限范围生效。 - 列表加载失败时保留当前筛选与分页条件。 - 反例: - 不允许默认按更新时间以外的字段覆盖排序规则。 - - 不允许普通用户在全部组织视图下执行编辑、删除等写操作。 + - 不允许通过列表顶部组织范围切换查看全部组织数据。 - 不允许分页后丢失当前查询条件。 --- @@ -43,7 +44,8 @@ ### REQ-CYXL-002 条件查询与重置 - 功能点: - - 支持按线路名称、线路编号、发货地、发货地址、收货地、收货地址、组织等条件组合查询。 + + - 筛选条件仅保留线路名称、线路编号、发货地、发货地址、收货地、收货地址、组织,按该顺序展示。 - 线路名称、发货地、发货地址、收货地、收货地址支持模糊查询。 - 线路编号支持精确匹配。 - 组织默认带出当前用户所属组织。 @@ -51,6 +53,7 @@ - 点击重置后清空所有条件并恢复默认列表。 - 异常与边界: + - 查询条件为空时点击查询,按默认规则展示当前组织全部数据。 - 查询结果为空时展示空状态,不清空用户已输入条件。 - 重置后页码恢复第一页,并按更新时间降序重新加载。 @@ -58,18 +61,20 @@ - 反例: - 不允许重置后仍保留隐藏条件。 - 不允许只按单一条件查询而忽略组合条件。 - - 不允许查询后改变列表字段展示范围。 + - 不允许展示联系人、联系方式、经纬度、备注、审计字段等额外筛选条件。 --- ### REQ-CYXL-003 查看常用线路 - 功能点: + - 支持通过行操作查看常用线路详情。 - 详情展示所有业务字段,字段全部置灰不可编辑。 - 查看弹窗底部仅显示关闭按钮。 - 异常与边界: + - 数据已删除或不存在时提示数据不存在,并刷新列表。 - 详情加载失败时提示失败原因,不影响列表现状。 @@ -83,26 +88,29 @@ ### REQ-CYXL-004 新增常用线路 - 功能点: + - 支持新增常用线路,用于运单创建时发货地址与收货地址的快速选择来源。 - - 线路编号由系统自动生成,规则为 XL + 5位流水号自增,保存后全局唯一。 - - 线路名称使用文本输入框,必填,长度不超过100字符。 - - 发货地址使用地址选择器,必填,支持地图搜索选点或从常用地址库中选择。 - - 收货地址使用地址选择器,必填,支持地图搜索选点或从常用地址库中选择。 - - 选择地址后,系统自动带出地址名称、详细地址、经度、纬度,并回填到表单关联字段。 - - 发货联系人、发货联系方式、收货联系人、收货联系方式使用文本输入框,长度不超过50字符。 - - 备注使用文本输入框,长度不超过500字符。 + - 线路编号由系统自动生成,规则为 XL + 5 位流水号自增,保存后全局唯一。 + - 线路名称使用文本输入框,必填,长度不超过 100 字符,并在新增弹窗中单独占一整行展示。 + - 发货地址和收货地址按地址行展示:左侧自动回填发货地/收货地,中间自动回填详细地址,最右侧使用 List 图标按钮打开“选择常用地址”弹窗。 + - 选择常用地址弹窗筛选区字段固定为地址名称、地址类型、详细地址、组织,并提供查询、重置按钮。 + - 选择常用地址弹窗表格字段固定为序号、地址名称、地址编号、类型、站点编码、详细地址、操作;操作列提供“选择”,底部提供关闭、确认按钮。 + - 选择地址后,系统自动带出地址名称、详细地址、经度、纬度,并回填到发货或收货地址关联字段。 + - 发货联系人、发货联系方式、收货联系人、收货联系方式使用文本输入框,长度不超过 50 字符。 + - 备注使用文本输入框,长度不超过 500 字符。 - 保存成功后刷新列表。 - 异常与边界: + - 线路名称为空时阻止提交并提示。 - 同一组织内线路名称重复时阻止提交并提示“同一组织内线路名称不允许重复”。 - 发货地址或收货地址为空时阻止提交并提示。 - 发货地址和收货地址组合在同一组织内重复时阻止提交并提示。 - 发货联系方式、收货联系方式不符合手机号或固定电话格式时阻止提交并提示。 - - 发货联系人、收货联系人超过50字符时阻止提交并提示。 - - 发货联系方式、收货联系方式超过50字符时阻止提交并提示。 - - 备注超过500字符时阻止提交并提示。 - - 选择地址后未能正确回填地址名称、详细地址、经纬度时阻止提交。 + - 发货联系人、收货联系人超过 50 字符时阻止提交并提示。 + - 发货联系方式、收货联系方式超过 50 字符时阻止提交并提示。 + - 备注超过 500 字符时阻止提交并提示。 + - 选择地址后未能正确回填地址名称、详细地址时阻止提交。 - 提交失败时保留用户已填写内容,方便修正后重新提交。 - 反例: @@ -116,14 +124,16 @@ ### REQ-CYXL-005 编辑常用线路 - 功能点: + - 支持编辑已存在的常用线路。 - 线路编号在编辑状态下置灰不可编辑。 - - 线路名称可编辑,校验规则与新增一致。 - - 发货地址、收货地址可重新选择,校验规则与新增一致。 + - 线路名称可编辑,校验规则与新增一致,并在编辑弹窗中单独占一整行展示。 + - 发货地址、收货地址可通过右侧 List 图标按钮重新从常用地址弹窗中选择,校验规则与新增一致。 - 发货联系人、发货联系方式、收货联系人、收货联系方式、备注可编辑。 - 保存成功后刷新列表。 - 异常与边界: + - 同一组织内线路名称修改后仍需保持唯一。 - 同一组织内发货地址与收货地址组合修改后仍需保持唯一。 - 线路编号为空或被篡改时阻止提交。 @@ -140,16 +150,18 @@ ### REQ-CYXL-006 线路编号与地址联动规则 - 功能点: - - 线路编号由系统按 XL + 5位流水号自增自动生成。 + + - 线路编号由系统按 XL + 5 位流水号自增自动生成。 - 线路编号在系统中全局唯一。 - - 发货地址与收货地址支持地图搜索选点或常用地址库选择。 + - 发货地址与收货地址通过常用地址库弹窗选择。 - 选择地址后自动回填地址名称、详细地址、经度、纬度。 - 切换发货地址或收货地址时,相关回填信息同步更新。 - 异常与边界: + - 编码生成失败时阻止保存并提示。 - 已存在相同线路编号时阻止保存并提示。 - - 地址选择返回的信息不完整时阻止保存。 + - 地址选择返回的地址名称或详细地址不完整时阻止保存。 - 发货地址与收货地址任一项变更后应重新校验重复组合。 - 反例: @@ -162,11 +174,13 @@ ### REQ-CYXL-007 批量导出 - 功能点: + - 支持勾选多行数据后批量导出 Excel 文件。 - 未勾选数据时点击批量导出,默认导出当前查询条件下的全部数据。 - 导出字段与列表显示字段一致。 - 异常与边界: + - 当前条件下无数据时允许导出空文件或提示无可导出数据。 - 导出失败时提示失败原因,不改变当前勾选状态。 @@ -179,11 +193,13 @@ ### REQ-CYXL-008 单条删除 - 功能点: + - 支持通过行操作删除单条常用线路。 - 点击删除弹出二次确认弹窗,提示删除后不可恢复。 - 删除成功后刷新列表,并提示“删除成功”。 - 异常与边界: + - 删除前必须校验是否已被运单、合同等业务数据引用。 - 已被引用时不允许删除,并提示“该线路已被业务引用,不可删除”。 - 数据不存在时提示数据不存在,并刷新列表。 @@ -197,13 +213,15 @@ ### REQ-CYXL-009 批量删除 - 功能点: + - 支持勾选多行常用线路后批量删除。 - 点击批量删除弹出二次确认弹窗。 - 删除前逐一校验所选数据是否被业务引用。 - 已引用记录从删除队列剔除并单独提示。 - - 删除成功后刷新列表,并提示“删除成功XX条,因引用跳过XX条”。 + - 删除成功后刷新列表,并提示“删除成功 XX 条,因引用跳过 XX 条”。 - 异常与边界: + - 未勾选数据时点击批量删除,应提示先选择需要删除的数据。 - 所选数据全部被引用时不执行删除,并提示全部跳过原因。 - 部分删除失败时应提示成功数量和跳过数量。 @@ -218,18 +236,20 @@ ### REQ-CYXL-010 组织权限与审计 - 功能点: + - 组织列作为数据权限字段,普通用户默认仅可查看当前组织数据。 - - 具备权限的用户可切换查看全部组织数据,但该视图仅允许只读查看。 + - 列表顶部不提供“当前组织/全部组织”切换。 - 根据权限配置控制查看、编辑、删除、导出等操作入口。 - 创建人、创建时间、更新时间由系统自动记录。 - 异常与边界: + - 无权限用户访问时提示权限不足。 - - 在全部组织只读视图中不开放新增、编辑、删除、导出等写操作。 + - 不允许通过前端组织范围切换越权查看或操作全部组织数据。 - 列表、详情、导出等用户可见场景优先展示创建人姓名,不直接展示用户 ID。 - 反例: - - 不允许普通用户在全部组织视图下修改数据。 + - 不允许普通用户通过手动构造组织条件越权修改数据。 - 不允许手动维护创建人、创建时间、更新时间。 - 不允许删除或篡改审计信息。 @@ -238,12 +258,15 @@ ## 通用规则 - 常用线路用于记录企业内高频使用的运输线路,作为运单创建时发货地址与收货地址的快速选择来源。 -- 线路编号由系统自动生成,规则为 XL + 5位流水号自增,且全局唯一。 +- 线路编号由系统自动生成,规则为 XL + 5 位流水号自增,且全局唯一。 - 同一组织内线路名称不允许重复。 - 同一组织内相同的发货地址与收货地址组合不允许重复创建。 -- 发货地址与收货地址必须填写,且支持地图搜索选点或从常用地址库选择。 +- 新增、编辑弹窗中线路名称单独占一整行展示。 +- 发货地址与收货地址必须通过常用地址弹窗选择,地址行左侧自动回填发货地/收货地,中间自动回填详细地址,最右侧使用 List 图标按钮打开弹窗。 +- 选择常用地址弹窗筛选字段固定为地址名称、地址类型、详细地址、组织,列表字段固定为序号、地址名称、地址编号、类型、站点编码、详细地址、操作。 - 选择地址后必须自动回填地址名称、详细地址、经度、纬度。 +- 列表顶部不提供“当前组织/全部组织”切换。 - 发货联系方式、收货联系方式需校验手机号或固定电话格式。 -- 备注最多500字符。 +- 备注最多 500 字符。 - 删除前必须校验业务引用,已引用线路不允许删除。 - 新增、编辑、导出成功后均需刷新列表。 diff --git a/需求卡/常用货物需求卡.md b/需求卡/常用货物需求卡.md index 302e55c..a81a870 100644 --- a/需求卡/常用货物需求卡.md +++ b/需求卡/常用货物需求卡.md @@ -21,22 +21,24 @@ ### REQ-CYHW-001 列表与分页 - 功能点: + - 默认展示当前组织全部常用货物数据,列表按更新时间降序排列。 - - 展示组织、一级货物类型、二级货物类型、货物名称、货物编号、品牌、包装、货值、规格、计价单位、型号、说明1、尺寸、说明2、备注、创建人、更新时间、创建时间、操作等字段。 + - 展示组织、一级货物类型、二级货物类型、货物名称、货物编号、品牌、包装、货值、规格、计价单位、型号、说明、备注、创建人、更新时间、创建时间、操作等字段。 - 支持勾选多行数据用于批量导出、批量删除。 - 操作列固定展示查看、编辑、删除,具体显示受权限控制。 - - 普通用户默认仅看当前组织数据;具备权限时可切换查看全部组织数据,但切换后的全部组织视图仅作只读查看。 - - 分页默认10条/页,支持20/50/100条/页。 + - 普通用户默认仅看当前组织数据,列表顶部不提供“当前组织/全部组织”切换。 + - 分页默认 10 条/页,支持 20/50/100 条/页。 - 异常与边界: + - 查询无数据时展示空状态。 - 当前页删除后无数据时自动回退页码并刷新列表。 - - 切换组织范围时保留当前查询条件,仅重载数据。 + - 列表、分页、导入、导出均按当前组织权限范围生效。 - 列表加载失败时保留当前筛选与分页条件。 - 反例: - 不允许默认按更新时间以外的字段覆盖排序规则。 - - 不允许普通用户在全部组织视图下执行编辑、删除等写操作。 + - 不允许通过列表顶部组织范围切换查看全部组织数据。 - 不允许分页后丢失当前查询条件。 --- @@ -44,11 +46,13 @@ ### REQ-CYHW-002 条件查询与重置 - 功能点: - - 支持按一级货物类型、二级货物类型、货物名称、货物编号、品牌、组织等条件组合查询。 + + - 筛选条件仅保留货物名称、货物编号、一级货物类型、二级货物类型、组织,按该顺序展示。 - 点击查询后按条件展示数据。 - 点击重置后清空所有条件并恢复默认列表。 - 异常与边界: + - 查询条件为空时点击查询,按默认规则展示当前组织全部数据。 - 查询结果为空时展示空状态,不清空用户已输入条件。 - 重置后页码恢复第一页,并按更新时间降序重新加载。 @@ -56,18 +60,20 @@ - 反例: - 不允许重置后仍保留隐藏条件。 - 不允许只按单一条件查询而忽略组合条件。 - - 不允许查询后改变列表字段展示范围。 + - 不允许展示品牌、包装、货值、规格、计价单位、型号、说明、数据来源等额外筛选条件。 --- ### REQ-CYHW-003 查看常用货物 - 功能点: + - 支持通过行操作查看常用货物详情。 - 详情展示所有业务字段,字段全部置灰不可编辑。 - 查看弹窗底部仅显示关闭按钮。 - 异常与边界: + - 数据已删除或不存在时提示数据不存在,并刷新列表。 - 详情加载失败时提示失败原因,不影响列表现状。 @@ -81,44 +87,44 @@ ### REQ-CYHW-004 新增常用货物 - 功能点: + - 支持新增常用货物档案,货物所属类别通过一级货物类型与二级货物类型级联选择定义。 - 一级货物类型使用下拉搜索选择。 - 二级货物类型使用下拉搜索选择,未选一级货物类型时置灰不可操作;切换一级货物类型时二级选项自动清空并重新加载。 - - 一级货物类型、二级货物类型、货物名称、货物编号为必填字段,字段名称需展示“*”标识。 - - 选择二级货物类型后,其编码自动带出为货物编号前4位前缀。 - - 货物编号由二级货物类型编码前4位 + 用户输入2位数字后缀组成,共6位。 - - 货物名称使用文本输入框,必填,长度不超过100字符。 - - 货物编号后缀使用文本输入框,必填,仅允许输入2位数字。 - - 品牌使用文本输入框,选填,长度不超过50字符。 - - 货值使用数字输入框,选填,保留2位小数;计价单位使用下拉选择。 - - 规格使用文本输入框,选填,长度不超过50字符。 - - 型号使用文本输入框,选填,长度不超过50字符。 - - 说明1使用文本输入框,选填,长度不超过100字符。 - - 尺寸使用文本输入框,选填,长度不超过50字符。 - - 说明2使用文本输入框,选填,长度不超过100字符。 - - 备注使用文本域,选填,长度不超过200字符。 + - 一级货物类型、二级货物类型、货物名称、货物编号为必填字段,字段名称需展示“\*”标识。 + - 新增、编辑表单不展示一级货物类型编码、二级货物类型编码,只保留货物编号字段。 + - 选择二级货物类型后,货物编号自动拼接一级货物类型编号在前面,用户仅需继续补充后续编号。 + - 货物名称使用文本输入框,必填,长度不超过 100 字符。 + - 货物编号使用文本输入框,必填,长度不超过 20 字符。 + - 品牌使用文本输入框,选填,长度不超过 50 字符。 + - 货值使用普通输入框,选填,仅允许输入数字,最多保留 2 位小数;计价单位下拉选择放在货值输入框后面同一行展示。 + - 规格使用文本输入框,选填,长度不超过 50 字符。 + - 型号使用文本输入框,选填,长度不超过 50 字符。 + - 说明使用文本输入框,选填,长度不超过 100 字符。 + - 备注使用文本域,选填,长度不超过 200 字符。 - 包装为下拉选择,选项包含袋装、散装、桶装、箱装、托盘等。 - 计价单位为下拉选择,选项包含元/吨、元/立方米、元/件、元/车。 - 保存成功后刷新列表。 - 异常与边界: + - 一级货物类型为空时阻止提交并提示“请选择一级货物类型”。 - 二级货物类型为空时阻止提交并提示“请选择二级货物类型”。 - 货物名称为空、超长或格式不合法时阻止提交并提示“请输入货物名称”。 - - 货物编号后缀为空、不是2位数字或货物编号不满6位时阻止提交并提示“请输入2位数字”。 - - 选择二级货物类型后未带出前4位编码时阻止提交。 + - 货物编号为空、超长或未拼接一级货物类型编号前缀时阻止提交。 + - 选择二级货物类型后未带出一级货物类型编号前缀时阻止提交。 - 二级货物类型不属于当前一级货物类型时阻止提交。 - 货物编号重复时阻止提交并提示“该货物编号已存在”。 - - 货值小于0或小数位超过2位时阻止提交。 + - 货值包含非数字字符或小数位超过 2 位时阻止提交。 - 包装或计价单位不在允许选项内时阻止提交。 - - 品牌、规格、型号、尺寸超过50字符时阻止提交。 - - 说明1、说明2超过100字符时阻止提交。 - - 备注超过200字符时阻止提交并提示。 + - 品牌、规格、型号超过 50 字符时阻止提交。 + - 说明超过 100 字符时阻止提交。 + - 备注超过 200 字符时阻止提交并提示。 - 提交失败时保留用户已填写内容。 - 反例: - 不允许在未选择一级货物类型时选择二级货物类型。 - - 不允许手工修改二级货物类型带出的前4位编号前缀。 + - 不允许手工删除或修改货物编号中的一级货物类型编号前缀。 - 不允许保存重复货物编号。 - 不允许新增启用/停用状态字段。 @@ -127,14 +133,18 @@ ### REQ-CYHW-005 编辑常用货物 - 功能点: + - 支持编辑已存在的常用货物档案。 - 一级货物类型、二级货物类型在编辑状态下置灰不可编辑。 - 货物编号在编辑状态下置灰不可编辑。 - - 货物名称、品牌、包装、货值、规格、计价单位、型号、说明1、尺寸、说明2、备注等字段可编辑。 + - 编辑表单不展示一级货物类型编码、二级货物类型编码,只保留货物编号字段。 + - 货物名称、品牌、包装、货值、规格、计价单位、型号、说明、备注等字段可编辑。 + - 货值使用普通输入框且只能输入数字,计价单位下拉选择紧跟在货值后面同一行展示。 - 可编辑字段的控件类型、长度限制和校验规则与新增一致。 - 保存成功后刷新列表。 - 异常与边界: + - 货物名称、货值、包装、计价单位、备注等字段的校验规则与新增保持一致。 - 编辑的数据已不存在时提示数据不存在,并刷新列表。 - 提交失败时保留用户修改内容。 @@ -149,16 +159,18 @@ ### REQ-CYHW-006 编号与级联规则 - 功能点: + - 常用货物所属类别由一级货物类型和二级货物类型级联定义。 - 一级货物类型变更时,二级货物类型选项同步刷新。 - 二级货物类型必须归属于当前选择的一级货物类型。 - - 二级货物类型编码作为货物编号前4位来源。 + - 选择二级货物类型后,货物编号必须自动拼接一级货物类型编号在前面。 - 货物编号全局唯一。 - 异常与边界: + - 一级货物类型未选择时二级货物类型下拉置灰不可操作。 - 切换一级货物类型后已选二级货物类型自动清空。 - - 二级货物类型编码不存在时不允许继续保存。 + - 一级货物类型编号前缀不存在时不允许继续保存。 - 二级货物类型与一级货物类型不匹配时不允许继续保存。 - 货物编号重复时阻止提交并提示“该货物编号已存在”。 @@ -172,17 +184,19 @@ ### REQ-CYHW-007 下载导入模板 - 功能点: + - 支持下载 Excel 导入模板。 - - 模板字段包含一级货物类型、二级货物类型编码、货物名称、货物编号后缀、品牌、包装、单价、规格、计价单位、型号、说明1、尺寸、说明2、备注。 - - 模板中一级货物类型、二级货物类型编码、货物名称、货物编号后缀为必填字段,字段名称需增加“*”标识。 + - 模板字段包含一级货物类型、二级货物类型编码、货物名称、货物编号后缀、品牌、包装、单价、规格、计价单位、型号、说明、备注。 + - 模板中一级货物类型、二级货物类型编码、货物名称、货物编号后缀为必填字段,字段名称需增加“\*”标识。 - 模板中的字段顺序与导入校验顺序保持一致。 - - 模板字段说明需标明:货物名称不超过100字符;品牌、规格、型号、尺寸不超过50字符;说明1、说明2不超过100字符;备注不超过200字符。 + - 模板字段说明需标明:货物名称不超过 100 字符;品牌、规格、型号不超过 50 字符;说明不超过 100 字符;备注不超过 200 字符。 - 模板用于批量导入常用货物档案。 - 异常与边界: + - 模板下载失败时提示失败,允许重新下载。 - 模板字段缺失或顺序错误时视为模板异常,应修正后再发布。 - - 模板应附带字段说明,明确货物编号后缀为2位数字,单价为数值且保留2位小数。 + - 模板应附带字段说明,明确货物编号后缀为 2 位数字,单价为数值且保留 2 位小数。 - 反例: - 不允许模板缺少一级货物类型、二级货物类型编码、货物名称、货物编号后缀等关键字段。 @@ -194,27 +208,29 @@ ### REQ-CYHW-008 批量导入 - 功能点: + - 支持上传 Excel 文件批量导入常用货物。 - 导入时逐条校验必填项、长度、数字格式、货物编号唯一性、二级货物类型编码是否存在等规则。 - - 导入时根据二级货物类型编码自动取得4位货物编号前缀,并与货物编号后缀组成完整货物编号。 + - 导入时根据二级货物类型编码自动取得 4 位货物编号前缀,并与货物编号后缀组成完整货物编号。 - 导入成功的数据标记为“批量导入”。 - 存在失败行时自动生成错误报告 Excel 并自动下载,失败文件字段顺序与原模板一致,并在最后一列追加“导入失败原因”。 - 导入失败明细文件名包含“常用货物导入失败明细”和时间戳。 - 导入完成后刷新列表,并在页面上方提示“导入数据成功”。 - 异常与边界: + - 文件格式错误时阻止导入并提示失败原因。 - 一级货物类型为空时对应行导入失败并写入错误原因。 - 二级货物类型编码不存在时对应行导入失败并写入错误原因。 - 二级货物类型编码不属于填写的一级货物类型时对应行导入失败。 - - 货物名称为空或超过100字符时对应行导入失败。 - - 货物编号后缀为空或不是2位数字时对应行导入失败。 + - 货物名称为空或超过 100 字符时对应行导入失败。 + - 货物编号后缀为空或不是 2 位数字时对应行导入失败。 - 货物编号重复时对应行导入失败并写入错误原因“该货物编号已存在”。 - - 品牌、规格、型号、尺寸超过50字符时对应行导入失败。 - - 说明1、说明2超过100字符时对应行导入失败。 - - 单价小于0或小数位超过2位时对应行导入失败。 + - 品牌、规格、型号超过 50 字符时对应行导入失败。 + - 说明超过 100 字符时对应行导入失败。 + - 单价小于 0 或小数位超过 2 位时对应行导入失败。 - 包装或计价单位不在允许选项内时对应行导入失败。 - - 备注超过200字符时对应行导入失败。 + - 备注超过 200 字符时对应行导入失败。 - 单行错误不影响其他正确数据入库。 - 全部失败时不入库,但仍生成错误报告。 - 存在部分失败时下载失败明细,并提示“部分数据导入失败,已下载失败明细”。 @@ -229,11 +245,13 @@ ### REQ-CYHW-009 批量导出 - 功能点: + - 支持勾选多行数据后批量导出 Excel 文件。 - 未勾选数据时点击批量导出,默认导出当前查询条件下的全部数据。 - 导出字段与列表显示字段一致。 - 异常与边界: + - 当前条件下无数据时允许导出空文件或提示无可导出数据。 - 导出失败时提示失败原因,不改变当前勾选状态。 @@ -246,11 +264,13 @@ ### REQ-CYHW-010 单条删除 - 功能点: + - 支持通过行操作删除单条常用货物。 - 点击删除弹出二次确认弹窗,提示删除后不可恢复。 - 删除成功后刷新列表,并提示“删除成功”。 - 异常与边界: + - 删除前必须校验是否已被运单、合同、报价单、库存记录等业务数据引用。 - 已被引用时不允许删除,并 toast 提示“已被业务引用,不允许删除”。 - 数据不存在时提示数据不存在,并刷新列表。 @@ -265,13 +285,15 @@ ### REQ-CYHW-011 批量删除 - 功能点: + - 支持勾选多行常用货物后批量删除。 - 点击批量删除弹出二次确认弹窗。 - 删除前逐一校验所选数据是否被业务引用。 - 已引用记录从删除队列剔除并单独提示。 - - 删除成功后刷新列表,并提示“删除成功XX条,因引用跳过XX条”。 + - 删除成功后刷新列表,并提示“删除成功 XX 条,因引用跳过 XX 条”。 - 异常与边界: + - 未勾选数据时点击批量删除,应提示先选择需要删除的数据。 - 所选数据全部被引用时不执行删除,并提示全部跳过原因。 - 部分删除失败时应提示成功数量和跳过数量。 @@ -286,18 +308,20 @@ ### REQ-CYHW-012 组织权限与审计 - 功能点: + - 组织列作为数据权限字段,普通用户默认仅可查看当前组织数据。 - - 具备权限的用户可切换查看全部组织数据,但该视图仅允许只读查看。 + - 列表顶部不提供“当前组织/全部组织”切换。 - 根据权限配置控制查看、编辑、删除、导入、导出等操作入口。 - 创建人、创建时间、更新时间由系统自动记录。 - 异常与边界: + - 无权限用户访问时提示权限不足。 - - 在全部组织只读视图中不开放新增、编辑、删除、导入等写操作。 + - 不允许通过前端组织范围切换越权查看或操作全部组织数据。 - 列表、详情、导出等用户可见场景优先展示创建人姓名,不直接展示用户 ID。 - 反例: - - 不允许普通用户在全部组织视图下修改数据。 + - 不允许普通用户通过手动构造组织条件越权修改数据。 - 不允许手动维护创建人、创建时间、更新时间。 - 不允许删除或篡改审计信息。 @@ -307,14 +331,15 @@ - 常用货物是实际业务中高频使用的具体货物档案。 - 货物所属类别必须通过一级货物类型与二级货物类型级联确定。 -- 货物编号由二级货物类型编码前4位与用户输入的2位数字后缀组成,共6位。 +- 新增、编辑表单不展示一级货物类型编码、二级货物类型编码,只保留货物编号。 +- 选择二级货物类型后,货物编号必须自动拼接一级货物类型编号在前面。 - 货物编号在系统中全局唯一,新增、编辑、导入时均需校验重复;重复时提示“该货物编号已存在”。 - 一级货物类型与二级货物类型为级联关系,一级变更时二级选项必须清空并重新加载。 -- 货物名称必填且长度不超过100字符。 -- 货值为数字,保留2位小数,不得小于0。 -- 品牌、规格、型号、尺寸最多50字符。 -- 说明1、说明2最多100字符。 -- 备注最多200字符。 +- 货物名称必填且长度不超过 100 字符。 +- 货值使用普通输入框,仅允许输入数字,最多保留 2 位小数;计价单位下拉放在货值后面同一行展示。 +- 品牌、规格、型号最多 50 字符。 +- 说明最多 100 字符。 +- 备注最多 200 字符。 - 包装选项包含袋装、散装、桶装、箱装、托盘等;计价单位选项包含元/吨、元/立方米、元/件、元/车。 - 新增、编辑、导入成功后均需刷新列表。 - 删除前必须校验业务引用,已引用记录不允许删除。 diff --git a/需求卡/货物类型管理需求卡.md b/需求卡/货物类型管理需求卡.md index b7bdb37..70b4cc9 100644 --- a/需求卡/货物类型管理需求卡.md +++ b/需求卡/货物类型管理需求卡.md @@ -21,15 +21,17 @@ ### REQ-CARGO-001 列表与分页 - 功能点: + - 默认展示全部货物类型数据。 - - 展示序号、货物类型、货物类型编码、上级货物类型、上级货物类型编码、创建人、备注、更新时间、创建时间、操作等字段。 + - 展示序号、货物类型、货物类型编码、上级货物类型、上级货物类型编码、创建人、备注、更新时间、创建时间、操作等字段,其中列表中的类型列标题展示为“货物类型”,新增、编辑表单仍展示为“类型”。 - 一级货物类型的上级货物类型、上级货物类型编码显示为“/”。 - 默认按创建时间降序展示。 - - 支持分页展示,默认10条/页,支持20/50/100条/页。 + - 支持分页展示,默认 10 条/页,支持 20/50/100 条/页。 - 支持勾选多行数据,用于批量导出、批量删除。 - 操作列固定展示查看、编辑、删除。 - 异常与边界: + - 查询无数据时展示空状态。 - 当前页数据删除后为空时自动调整页码并刷新列表。 - 列表加载失败时保留当前查询条件和分页条件,提示用户重新查询。 @@ -39,18 +41,19 @@ - 不允许分页后丢失当前查询条件。 - 不允许在操作列展示启用、停用操作。 - --- ### REQ-CARGO-002 条件查询与重置 - 功能点: + - 支持按货物类型、货物类型编码条件查询。 - 选择或输入查询条件后,点击查询按钮展示符合条件的数据。 - 点击重置按钮清空所有查询条件,并恢复默认列表。 - 支持多个查询条件组合筛选。 - 异常与边界: + - 查询条件为空时点击查询,按默认规则展示全部数据。 - 查询结果为空时展示空状态,不清空用户已输入的查询条件。 - 重置后页码恢复到第一页,并按创建时间降序重新加载数据。 @@ -60,58 +63,60 @@ - 不允许只按单个条件查询而忽略其他已选择条件。 - 不允许查询后改变列表字段或操作按钮范围。 - --- ### REQ-CARGO-003 查看货物类型 - 功能点: + - 支持通过行操作查看货物类型详情。 - 详情展示类型、上级货物类型、上级货物类型编码、货物类型、货物类型编码、备注、创建人、创建时间、更新时间等信息。 - 查看状态下字段只读。 - 异常与边界: + - 数据已被删除或不存在时提示数据不存在,并刷新列表。 - 一级货物类型详情中的上级货物类型、上级货物类型编码显示为“/”或空值。 - 详情加载失败时提示失败原因,不改变列表数据。 - 反例: - 不允许在查看状态下保存修改。 - - 不允许将创建人展示为用户ID。 + - 不允许将创建人展示为用户 ID。 - 不允许查看详情时自动切换为编辑状态。 - --- ### REQ-CARGO-004 新增货物类型 - 功能点: + - 支持新增一级货物类型和二级货物类型。 - - 新增字段包含类型、上级货物类型、上级货物类型编码、货物类型、货物类型编码、备注。 - - 类型使用radio单选控件,选项为一级货物类型、二级货物类型,默认选中一级货物类型。 + - 新增字段包含类型、上级货物类型、上级货物编码、货物类型、货物类型编码、备注。 + - 类型使用 radio 单选控件,选项为一级货物类型、二级货物类型,默认选中一级货物类型。 - 上级货物类型使用搜索下拉选择控件,仅在选择二级货物类型时显示,支持按上级货物类型名称或编码搜索。 - - 上级货物类型编码使用文本输入框展示,选择上级货物类型后自动带出,不可编辑。 - - 货物类型使用文本输入框,必填,长度为1~50字符。 - - 货物类型编码使用文本输入框,必填,长度为4以内;一级货物类型编码为2位数字,二级货物类型编码为4位数字且前2位继承父级编码。 - - 备注使用文本输入框,非必填,最多200字符。 - - 类型字段必填,并在字段名称前展示“*”标识。 - - 货物类型字段必填,并在字段名称前展示“*”标识。 - - 选择一级货物类型时,录入货物类型、货物类型编码、备注;货物类型编码必填并在字段名称前展示“*”标识,上级货物类型和上级货物类型编码不展示。 - - 选择二级货物类型时,展示上级货物类型、上级货物类型编码、货物类型编码等字段;上级货物类型、上级货物类型编码、货物类型、货物类型编码均必填并在字段名称前展示“*”标识。 - - 选择二级货物类型时,上级货物类型通过搜索下拉选择;上级货物类型编码、货物类型编码在选择上级货物类型后自动带出。 + - 上级货物编码使用文本输入框展示,选择上级货物类型后自动带出,不可编辑。 + - 货物类型使用文本输入框,必填,长度为 1~50 字符。 + - 货物类型编码使用文本输入框,必填,长度为 4 以内;一级货物类型编码为 2 位数字,二级货物类型编码为 4 位数字且前 2 位继承父级编码。 + - 备注使用文本输入框,非必填,最多 200 字符。 + - 类型字段必填,并在字段名称前展示“\*”标识。 + - 货物类型字段必填,并在字段名称前展示“\*”标识。 + - 选择一级货物类型时,录入货物类型、货物类型编码、备注;货物类型编码必填并在字段名称前展示“\*”标识,上级货物类型和上级货物编码不展示。 + - 选择二级货物类型时,展示上级货物类型、上级货物编码、货物类型编码等字段;上级货物类型、上级货物编码、货物类型、货物类型编码均必填并在字段名称前展示“\*”标识。 + - 选择二级货物类型时,上级货物类型通过搜索下拉选择;上级货物类型和上级货物编码放在同一行展示,上级货物编码、货物类型编码在选择上级货物类型后自动带出。 - 保存成功后刷新列表。 - 异常与边界: + - 类型为空时阻止提交并提示“请选择货物类型级别”。 - 选择二级货物类型且上级货物类型为空时阻止提交并提示“请选择上级货物类型”。 - 货物类型为空时阻止提交并提示“请输入货物类型名称”。 - - 货物类型超过50字符时阻止提交并提示。 + - 货物类型超过 50 字符时阻止提交并提示。 - 同一上级下存在同名货物类型时阻止提交并提示“该上级下已存在同名货物类型”。 - - 一级货物类型的货物类型编码为空或不是2位数字时阻止提交并提示“货物类型编码格式不正确”。 - - 二级货物类型的货物类型编码为空或不是4位数字时阻止提交并提示“货物类型编码格式不正确”。 - - 二级货物类型编码前2位与上级货物类型编码不一致时阻止提交并提示“二级编码前2位必须与上级货物类型编码一致”。 + - 一级货物类型的货物类型编码为空或不是 2 位数字时阻止提交并提示“货物类型编码格式不正确”。 + - 二级货物类型的货物类型编码为空或不是 4 位数字时阻止提交并提示“货物类型编码格式不正确”。 + - 二级货物类型编码前 2 位与上级货物类型编码不一致时阻止提交并提示“二级编码前 2 位必须与上级货物类型编码一致”。 - 货物类型编码重复时阻止提交并提示“该货物类型编码已存在”。 - - 备注超过200字符时阻止提交并提示“备注不能超过200字”。 + - 备注超过 200 字符时阻止提交并提示“备注不能超过 200 字”。 - 提交失败时保留用户已填写内容,方便修正后重新提交。 - 反例: @@ -119,36 +124,37 @@ - 不允许新增无上级货物类型的二级货物类型。 - 不允许新增时设置启用或停用状态。 - --- ### REQ-CARGO-005 编辑货物类型 - 功能点: + - 支持编辑已存在的货物类型信息。 - - 编辑字段包含类型、上级货物类型、上级货物类型编码、货物类型、货物类型编码、备注。 - - 类型使用radio单选控件,选项为一级货物类型、二级货物类型。 + - 编辑字段包含类型、上级货物类型、上级货物编码、货物类型、货物类型编码、备注。 + - 类型使用 radio 单选控件,选项为一级货物类型、二级货物类型。 - 上级货物类型使用搜索下拉选择控件,仅在选择二级货物类型时显示,支持按上级货物类型名称或编码搜索。 - - 上级货物类型编码使用文本输入框展示,选择上级货物类型后自动带出,不可编辑。 - - 货物类型使用文本输入框,必填,长度为1~50字符。 - - 货物类型编码使用文本输入框,必填,长度为4以内;一级货物类型编码为2位数字,二级货物类型编码为4位数字且前2位继承父级编码。 - - 备注使用文本输入框,非必填,最多200字符。 - - 二级货物类型选择上级货物类型后,自动带出上级货物类型编码和货物类型编码。 + - 上级货物编码使用文本输入框展示,选择上级货物类型后自动带出,不可编辑。 + - 货物类型使用文本输入框,必填,长度为 1~50 字符。 + - 货物类型编码使用文本输入框,必填,长度为 4 以内;一级货物类型编码为 2 位数字,二级货物类型编码为 4 位数字且前 2 位继承父级编码。 + - 备注使用文本输入框,非必填,最多 200 字符。 + - 二级货物类型选择上级货物类型后,自动带出上级货物编码和货物类型编码;上级货物类型、上级货物编码放在同一行展示。 - 保存成功后刷新列表。 - 异常与边界: + - 类型为空时阻止提交并提示“请选择货物类型级别”。 - 选择二级货物类型且上级货物类型为空时阻止提交并提示“请选择上级货物类型”。 - 货物类型为空时阻止提交并提示“请输入货物类型名称”。 - - 货物类型超过50字符时阻止提交并提示。 + - 货物类型超过 50 字符时阻止提交并提示。 - 同一上级下存在同名货物类型时阻止提交并提示“该上级下已存在同名货物类型”。 - 修改货物类型编码时重新校验编码格式和全局唯一性。 - 修改二级货物类型的上级货物类型时,重新校验层级关系合法性。 - - 一级货物类型的货物类型编码为空或不是2位数字时阻止提交并提示“货物类型编码格式不正确”。 - - 二级货物类型的货物类型编码为空或不是4位数字时阻止提交并提示“货物类型编码格式不正确”。 - - 二级货物类型编码前2位与上级货物类型编码不一致时阻止提交并提示“二级编码前2位必须与上级货物类型编码一致”。 + - 一级货物类型的货物类型编码为空或不是 2 位数字时阻止提交并提示“货物类型编码格式不正确”。 + - 二级货物类型的货物类型编码为空或不是 4 位数字时阻止提交并提示“货物类型编码格式不正确”。 + - 二级货物类型编码前 2 位与上级货物类型编码不一致时阻止提交并提示“二级编码前 2 位必须与上级货物类型编码一致”。 - 货物类型编码重复时阻止提交并提示“该货物类型编码已存在”。 - - 备注超过200字符时阻止提交并提示“备注不能超过200字”。 + - 备注超过 200 字符时阻止提交并提示“备注不能超过 200 字”。 - 编辑的数据已不存在时提示数据不存在,并刷新列表。 - 提交失败时保留用户修改内容,方便修正后重新提交。 @@ -157,49 +163,51 @@ - 不允许将二级货物类型修改为无上级货物类型的数据。 - 不允许通过编辑操作设置启用或停用状态。 - --- ### REQ-CARGO-006 编码与层级校验 - 功能点: + - 货物类型采用两级层级结构,一级货物类型为大类,二级货物类型为小类。 - 每条二级货物类型通过上级货物类型编码关联到一级货物类型。 - - 一级货物类型编码为2位数字。 - - 二级货物类型编码为4位数字,前2位继承父级编码,后2位为自增序号。 + - 一级货物类型编码为 2 位数字。 + - 二级货物类型编码为 4 位数字,前 2 位继承父级编码,后 2 位为自增序号。 - 货物类型编码在系统中全局唯一。 - 异常与边界: - - 一级货物类型编码不是2位数字时阻止提交。 - - 二级货物类型编码不是4位数字时阻止提交。 - - 二级货物类型编码前2位与上级货物类型编码不一致时阻止提交。 + + - 一级货物类型编码不是 2 位数字时阻止提交。 + - 二级货物类型编码不是 4 位数字时阻止提交。 + - 二级货物类型编码前 2 位与上级货物类型编码不一致时阻止提交。 - 编码重复时阻止提交并提示“该货物类型编码已存在”。 - 反例: - - 不允许一级货物类型编码为1、001、A1。 - - 不允许二级货物类型编码为120、00120、01A0。 - - 不允许上级货物类型编码为01时录入0201作为二级货物类型编码。 - + - 不允许一级货物类型编码为 1、001、A1。 + - 不允许二级货物类型编码为 120、00120、01A0。 + - 不允许上级货物类型编码为 01 时录入 0201 作为二级货物类型编码。 --- ### REQ-CARGO-007 下载导入模板 - 功能点: - - 支持下载Excel导入模板。 + + - 支持下载 Excel 导入模板。 - 模板字段包含类型、上级货物类型、上级货物类型编码、货物类型、货物类型编码、备注。 - - 模板中类型、货物类型、货物类型编码为必填字段,字段名称需增加“*”标识。 - - 模板中上级货物类型、上级货物类型编码仅在类型为二级货物类型时必填,字段名称需增加“*”标识并注明适用条件。 - - 模板必填字段标题需展示为“*类型”“*上级货物类型”“*上级货物类型编码”“*货物类型”“*货物类型编码”,其中上级货物类型和上级货物类型编码仅适用于二级货物类型。 - - 模板字段说明需标明:类型为单选值,仅允许填写一级货物类型或二级货物类型;上级货物类型支持按名称或编码匹配;货物类型长度1~50字符;备注最多200字符。 + - 模板中类型、货物类型、货物类型编码为必填字段,字段名称需增加“\*”标识。 + - 模板中上级货物类型、上级货物类型编码仅在类型为二级货物类型时必填,字段名称需增加“\*”标识并注明适用条件。 + - 模板必填字段标题需展示为“*类型”“*上级货物类型”“*上级货物类型编码”“*货物类型”“\*货物类型编码”,其中上级货物类型和上级货物类型编码仅适用于二级货物类型。 + - 模板字段说明需标明:类型为单选值,仅允许填写一级货物类型或二级货物类型;上级货物类型支持按名称或编码匹配;货物类型长度 1~50 字符;备注最多 200 字符。 - 模板中一级货物类型的货物类型编码由用户手动填写,二级货物类型的货物类型编码根据选择的上级货物类型自动带出。 - 模板用于批量导入一级货物类型和二级货物类型。 - 异常与边界: + - 模板下载失败时提示下载失败,用户可重新下载。 - 模板字段顺序应保持稳定,避免用户导入时映射错误。 - 模板中的编码填写说明应与层级编码规则保持一致。 - - 模板中必填字段未带“*”标识时视为模板不符合要求,应修正后发布。 + - 模板中必填字段未带“\*”标识时视为模板不符合要求,应修正后发布。 - 反例: - 不允许模板缺少类型、货物类型编码等关键字段。 @@ -207,34 +215,35 @@ - 不允许模板字段与导入校验字段不一致。 - 不允许二级货物类型导入模板隐藏上级货物类型或上级货物类型编码。 - --- ### REQ-CARGO-008 批量导入 - 功能点: - - 支持上传Excel文件批量导入货物类型。 + + - 支持上传 Excel 文件批量导入货物类型。 - 导入时逐条校验必填项、字段长度、数据格式、同级名称唯一性、编码唯一性、层级关系合法性。 - 导入类型仅允许一级货物类型、二级货物类型。 - 导入二级货物类型时,上级货物类型为条件必填,需能按上级货物类型名称或编码匹配到唯一一级货物类型,并自动关联上级货物类型编码。 - 导入一级货物类型时,上级货物类型和上级货物类型编码不参与校验和入库。 - 校验通过的数据入库成功,并标记为“批量导入”。 - - 若存在失败行,生成错误报告Excel并自动下载。 + - 若存在失败行,生成错误报告 Excel 并自动下载。 - 导入完成后刷新列表,并在页面上方提示“导入数据成功”。 - 异常与边界: + - 文件格式错误时阻止导入并提示失败原因。 - 类型为空或不属于允许选项时对应行导入失败,并写入错误原因“请选择货物类型级别”。 - 二级货物类型的上级货物类型为空或无法匹配到唯一一级货物类型时对应行导入失败,并写入错误原因“请选择上级货物类型”。 - 货物类型为空时对应行导入失败,并写入错误原因“请输入货物类型名称”。 - - 货物类型超过50字符时对应行导入失败并写入错误原因。 + - 货物类型超过 50 字符时对应行导入失败并写入错误原因。 - 同一上级下存在同名货物类型时对应行导入失败,并写入错误原因“该上级下已存在同名货物类型”。 - - 一级货物类型的货物类型编码为空或不是2位数字时对应行导入失败,并写入错误原因“货物类型编码格式不正确”。 - - 二级货物类型的货物类型编码为空或不是4位数字时对应行导入失败,并写入错误原因“货物类型编码格式不正确”。 - - 二级货物类型编码前2位与上级货物类型编码不一致时对应行导入失败,并写入错误原因“二级编码前2位必须与上级货物类型编码一致”。 - - 备注超过200字符时对应行导入失败,并写入错误原因“备注不能超过200字”。 + - 一级货物类型的货物类型编码为空或不是 2 位数字时对应行导入失败,并写入错误原因“货物类型编码格式不正确”。 + - 二级货物类型的货物类型编码为空或不是 4 位数字时对应行导入失败,并写入错误原因“货物类型编码格式不正确”。 + - 二级货物类型编码前 2 位与上级货物类型编码不一致时对应行导入失败,并写入错误原因“二级编码前 2 位必须与上级货物类型编码一致”。 + - 备注超过 200 字符时对应行导入失败,并写入错误原因“备注不能超过 200 字”。 - 单行数据错误不影响其他校验通过的数据入库。 - - 全部数据失败时不入库,但仍生成错误报告Excel。 + - 全部数据失败时不入库,但仍生成错误报告 Excel。 - 导入文件内存在重复编码或与系统已有编码重复时,对应行导入失败并写入错误原因。 - 二级货物类型引用的上级货物类型不存在时,对应行导入失败并写入错误原因。 @@ -244,17 +253,18 @@ - 不允许只提示失败数量而不提供错误报告。 - 不允许导入启用或停用状态。 - --- ### REQ-CARGO-009 批量导出 - 功能点: - - 支持勾选多行数据后批量导出Excel文件。 + + - 支持勾选多行数据后批量导出 Excel 文件。 - 未勾选数据时点击批量导出,默认导出当前查询条件下的全部数据。 - 导出字段与列表显示字段一致。 - 异常与边界: + - 当前查询条件下无数据时允许导出空文件或提示无可导出数据。 - 导出数据量较大时提示用户等待或按系统策略异步处理。 - 导出失败时提示失败原因,不改变列表勾选状态。 @@ -264,17 +274,18 @@ - 不允许只导出当前页数据。 - 不允许导出列表未展示的启用、停用状态字段。 - --- ### REQ-CARGO-010 单条删除 - 功能点: + - 支持通过行操作删除单条货物类型。 - 点击删除时弹出二次确认弹窗,提示“确定要删除该货物类型吗?删除后不可恢复。”。 - 删除成功后刷新列表,并提示“删除成功”。 - 异常与边界: + - 删除前校验该货物类型是否已被运单、合同等业务数据引用。 - 已被业务数据引用时不允许删除,并提示“该货物类型已被业务数据引用,不可删除”。 - 数据已不存在时提示数据不存在,并刷新列表。 @@ -285,19 +296,20 @@ - 不允许删除已被业务数据引用的货物类型。 - 不允许用停用状态替代删除操作。 - --- ### REQ-CARGO-011 批量删除 - 功能点: + - 支持勾选多行货物类型后批量删除。 - 点击批量删除时弹出二次确认弹窗。 - 确认删除前逐一校验所选数据是否被业务引用。 - 已引用的记录从删除队列剔除并单独提示。 - - 删除完成后刷新列表,并提示“删除成功XX条,因业务引用跳过XX条”。 + - 删除完成后刷新列表,并提示“删除成功 XX 条,因业务引用跳过 XX 条”。 - 异常与边界: + - 未勾选数据时点击批量删除,应提示先选择需要删除的数据。 - 所选数据全部被引用时不执行删除,并提示全部跳过原因。 - 部分删除失败时应提示成功数量、失败数量和失败原因。 @@ -308,41 +320,41 @@ - 不允许因为部分数据被引用而取消全部可删除数据的删除。 - 不允许删除后不刷新列表。 - --- ### REQ-CARGO-012 权限与日志 - 功能点: + - 根据用户权限控制查看、新增、编辑、删除、导入、导出等操作入口。 - 记录新增、编辑、删除、批量导入、批量导出等关键操作日志。 - 创建人、创建时间、更新时间由系统自动记录。 - 异常与边界: + - 无权限访问或操作时提示权限不足。 - 操作失败时不记录为成功日志。 - - 列表、详情、导出等用户可见场景优先展示创建人姓名,不直接展示用户ID。 + - 列表、详情、导出等用户可见场景优先展示创建人姓名,不直接展示用户 ID。 - 反例: - 不允许无权限用户执行新增、编辑、删除、导入、导出操作。 - 不允许用户手动维护创建人、创建时间、更新时间。 - 不允许删除或篡改操作日志。 - --- ## 通用规则 - 货物类型数据采用两级层级结构:一级货物类型为大类,二级货物类型为小类。 - 每条二级货物类型必须通过上级货物类型编码关联到一级货物类型。 -- 货物类型编码遵循层级编码规则:一级货物类型为2位数字编码,二级货物类型为4位数字编码,前2位继承父级编码,后2位为自增序号。 +- 货物类型编码遵循层级编码规则:一级货物类型为 2 位数字编码,二级货物类型为 4 位数字编码,前 2 位继承父级编码,后 2 位为自增序号。 - 货物类型编码在系统中全局唯一,新增、编辑、导入提交时均需校验重复;重复时提示“该货物类型编码已存在”。 -- 新增页面和导入模板中,类型、货物类型、货物类型编码必须做必填校验并展示“*”标识;选择二级货物类型时,上级货物类型、上级货物类型编码必须显示、必填并展示“*”标识。 -- 新增、编辑页面中,类型使用radio单选控件,上级货物类型使用下拉选择控件,其他字段使用输入框。 -- 一级货物类型编码由用户手动输入;二级货物类型的上级货物类型编码、货物类型编码在选择上级货物类型后自动带出。 +- 新增页面和导入模板中,类型、货物类型、货物类型编码必须做必填校验并展示 `*` 标识;选择二级货物类型时,上级货物类型、上级货物编码必须显示、必填并展示 `*` 标识。 +- 新增、编辑页面中,类型使用 radio 单选控件,上级货物类型使用下拉选择控件,其他字段使用输入框。 +- 一级货物类型编码由用户手动输入;二级货物类型的上级货物编码、货物类型编码在选择上级货物类型后自动带出;二级时上级货物类型与上级货物编码同一行展示。 - 本模块不设置启用/停用状态,货物类型一旦创建后长期有效;业务上不需要的货物类型通过删除操作处理。 - 删除货物类型前必须校验是否已被运单、合同等业务数据引用;已被引用的数据不允许删除。 -- 备注最多200个字,超过限制时应阻止提交并提示。 -- 列表默认按创建时间降序展示,分页默认10条/页,支持20/50/100条/页。 +- 备注最多 200 个字,超过限制时应阻止提交并提示。 +- 列表默认按创建时间降序展示,分页默认 10 条/页,支持 20/50/100 条/页。 - 新增、编辑、导入、删除成功后均需刷新列表。 -- 列表、详情、导出等用户可见场景应展示用户姓名,避免直接展示用户ID。 +- 列表、详情、导出等用户可见场景应展示用户姓名,避免直接展示用户 ID。 diff --git a/需求卡/过程配置需求卡.md b/需求卡/过程配置需求卡.md index c927fbf..6d5bcfe 100644 --- a/需求卡/过程配置需求卡.md +++ b/需求卡/过程配置需求卡.md @@ -21,6 +21,7 @@ ### REQ-PROC-001 列表与分页 - 功能点: + - 默认展示当前组织全部过程配置数据,列表按创建时间降序排列。 - 展示配置名称、配置编号、项目、包含过程节点、状态、默认后台完成运输天数、备注、组织、创建人、创建时间、更新时间、操作等字段。 - 支持勾选多行数据用于批量删除。 @@ -28,12 +29,13 @@ - 草稿状态显示查看、编辑、复制、删除。 - 启用状态显示查看、编辑、复制、停用。 - 停用状态显示查看、编辑、复制、删除、启用。 - - 分页默认10条/页,支持20/50/100条/页。 + - 分页默认 10 条/页,支持 20/50/100 条/页。 - 异常与边界: + - 查询无数据时展示空状态。 - 当前页删除后无数据时自动回退页码并刷新列表。 - - 切换组织范围时保留当前查询条件,仅重载数据。 + - 列表始终按当前组织权限范围加载数据。 - 列表加载失败时保留当前筛选与分页条件。 - 反例: @@ -46,9 +48,10 @@ ### REQ-PROC-002 条件查询与重置 - 功能点: - - 支持按配置名称、项目、配置编号、包含过程节点、状态、组织等条件组合查询。 + + - 支持按配置名称、项目、配置编号、包含过程节点、组织、状态等条件组合查询,按该顺序展示。 - 配置名称支持模糊查询。 - - 项目支持下拉模糊搜索选择,默认范围为当前用户所属组织下的项目。 + - 项目支持下拉模糊搜索选择。 - 配置编号支持精确匹配。 - 包含过程节点支持多选,枚举值为接单、到场、装货、发货、在途、到货、卸货、签收、回单。 - 状态支持全部、草稿、启用、停用,默认全部。 @@ -57,6 +60,7 @@ - 点击重置后清空所有条件并恢复默认列表。 - 异常与边界: + - 查询条件为空时点击查询,按默认规则展示当前组织全部数据。 - 查询结果为空时展示空状态,不清空用户已输入条件。 - 重置后页码恢复第一页,并按创建时间降序重新加载。 @@ -65,25 +69,28 @@ - 不允许重置后仍保留隐藏条件。 - 不允许只按单一条件查询而忽略组合条件。 - 不允许查询后改变列表字段展示范围。 + - 不允许在页面顶部提供“当前组织/全部组织”切换。 --- ### REQ-PROC-003 查看过程配置 - 功能点: + - 支持通过行操作查看过程配置详情。 - 详情展示基本信息、现行过程节点、节点启用状态、节点联动配置、默认后台完成运输天数、备注、组织、创建人、创建时间、更新时间等信息。 - 查看状态下字段全部置灰不可编辑。 - 查看弹窗底部仅显示关闭按钮。 - 异常与边界: + - 数据已删除或不存在时提示数据不存在,并刷新列表。 - 详情加载失败时提示失败原因,不影响列表现状。 - 仅展示已勾选启用的现行过程节点,未启用节点不展示在时间线中。 - 反例: - 不允许在查看状态下保存修改。 - - 不允许查看时切换组织范围并修改数据。 + - 不允许查看时修改数据。 - 不允许查看弹窗出现提交按钮。 --- @@ -91,22 +98,28 @@ ### REQ-PROC-004 新增过程配置 - 功能点: + - 支持新增过程配置,用于按项目维度配置运输过程各节点的司机打卡要求。 - - 配置编号由系统自动生成,规则为 GC + 5位流水号,保存后全局唯一。 - - 配置名称使用文本输入框,必填,长度1到100字符,同一组织内不允许重复。 - - 项目使用下拉多选控件,支持模糊搜索,必填,默认仅显示当前用户所属组织下的项目。 - - 默认后台完成运输天数使用数字输入框,非必填,最多3位整数,不设置默认值。 - - 备注使用文本输入框,非必填,长度不超过500字符。 + - 配置编号由系统自动生成,规则为 GC + 5 位流水号,保存后全局唯一。 + - 新增编辑弹窗分为三个板块:基本信息、现行过程节点、节点设置。 + - 新增编辑弹窗距离页面顶部 10px,弹窗宽度需保证节点设置三列内容在一屏内完整展示。 + - 基本信息板块包含配置名称、项目、默认 X 天后台完成运输、备注。 + - 项目使用下拉选择控件,支持模糊搜索,必填。 + - 默认后台完成运输天数使用普通输入框,仅允许输入正整数,最多 3 位。 + - 备注使用文本输入框,非必填,长度不超过 500 字符。 - 新建保存后默认状态为草稿。 - - 新建弹窗包含基本信息与过程节点配置两个区域。 + - 现行过程节点以横向 timeline 展示当前配置已启用节点。 + - 节点设置区域使用表格展示固定节点内容,节点与字段不可拖拽改序。 + - 新增时节点设置不默认勾选过程节点,确认人、货量类型、凭证类型等复选项不预置选择;操作要求中的是否确认、是否打卡、上传货量、打卡定位默认选择“是”。 - 异常与边界: + - 配置名称为空时阻止提交并提示“配置名称不能为空”。 - - 配置名称超过100字符时阻止提交。 + - 配置名称超过 100 字符时阻止提交。 - 同一组织内配置名称重复时阻止提交并提示“配置名称已存在”。 - 项目为空时阻止提交并提示“项目不能为空”。 - - 默认后台完成运输天数不是正整数或超过3位时阻止提交并提示“请输入正整数”。 - - 备注超过500字符时阻止提交并提示。 + - 默认后台完成运输天数不是正整数或超过 3 位时阻止提交并提示“请输入正整数”。 + - 备注超过 500 字符时阻止提交并提示。 - 提交失败时保留用户已填写内容。 - 反例: @@ -119,15 +132,16 @@ ### REQ-PROC-005 编辑过程配置 - 功能点: + - 支持编辑已存在的过程配置。 - 配置编号在编辑状态下置灰不可编辑。 - - 配置名称可编辑,校验规则同新增。 + - 配置名称、项目、默认后台完成运输天数、备注可编辑,校验规则同新增。 - 项目可重新选择,但若该配置已被运单引用,则项目不可变更。 - 过程节点配置可调整,校验规则同新增。 - - 默认后台完成运输天数、备注可编辑。 - 保存成功后刷新列表。 - 异常与边界: + - 配置名称修改后仍需满足同组织内唯一。 - 项目被运单引用时禁止变更项目并提示。 - 编辑的数据已不存在时提示数据不存在,并刷新列表。 @@ -143,6 +157,7 @@ ### REQ-PROC-006 复制过程配置 - 功能点: + - 支持复制已有过程配置生成新配置。 - 复制后配置名称自动追加“ - 副本”。 - 节点设置内容全部复制。 @@ -151,6 +166,7 @@ - 复制后的配置可继续编辑后保存。 - 异常与边界: + - 复制后若配置名称仍触发同组织重复校验,则阻止保存并提示。 - 原配置不存在时不允许复制。 - 复制失败时不影响原配置数据。 @@ -165,16 +181,18 @@ ### REQ-PROC-007 编号与唯一性规则 - 功能点: - - 配置编号由系统自动生成,规则为 GC + 5位流水号。 + + - 配置编号由系统自动生成,规则为 GC + 5 位流水号。 - 配置编号在系统中全局唯一。 - 配置名称在同一组织内唯一。 - 一个项目在同一时间只能关联一条启用状态的过程配置。 - 异常与边界: + - 编号生成冲突时阻止保存并重新生成。 - 同一组织内配置名称重复时阻止保存。 - - 启用前若所选项目中存在其他启用配置时阻止启用,并提示“该项目已有关联的启用配置,请先停用原配置”。 - - 项目为多选时,需要逐个校验每个项目的启用唯一性。 + - 启用前若所选项目存在其他启用配置时阻止启用,并提示“该项目已有关联的启用配置,请先停用原配置”。 + - 项目为单选下拉选择,同一项目同一时间只能关联一条启用配置。 - 反例: - 不允许手工编辑配置编号。 @@ -186,24 +204,24 @@ ### REQ-PROC-008 过程节点配置与联动 - 功能点: + - 过程节点顺序固定,不可拖拽排序,依次为接单、到场、装货、发货、在途、到货、卸货、签收、回单。 - - 仅勾选启用的节点会展示在现行过程节点时间线中。 - - 节点配置区域以逐行方式展示,每行对应一个节点。 - - 各节点的是否打卡、上传货量、上传凭证相互独立,可单独选择或多选。 - - 节点是否确认项必须选择确认方式;接单节点可选“无需确认接单”,回单节点可选“无需确认完成”,其他节点必须选择是或否。 - - 是否打卡选否时,打卡定位、打卡频次、打卡时段置灰不可编辑。 - - 上传货量选否时,上传货量类型置灰不可编辑。 - - 上传凭证选否时,凭证类型全量置灰不可编辑。 - - 仅在途节点支持打卡频次和打卡时段,默认打卡频次为1次,默认打卡时段为00:00-24:00。 - - 接单节点的是否确认支持“无需确认接单”。 - - 回单节点的是否确认支持“无需确认完成”,且选择是时系统自动勾选内部人员。 - - 打卡定位、上传货量类型、凭证类型根据当前节点可配置项展示。 + - 仅勾选启用的节点会展示在现行过程节点时间线中,时间线横向展示。 + - 节点配置区域以表格方式展示,固定包含节点设置、操作要求、附件要求三列。 + - 节点设置列包含勾选框和节点名称按钮样式展示。 + - 新增状态下所有过程节点默认未勾选,节点相关复选框默认不选中。 + - 接单节点的操作要求包含是否确认、确认接单人,是否确认提供“是 / 无需确认接单”单选,确认接单人使用“司机”复选框。 + - 到场、装货、发货、在途、到货、卸货、签收节点的操作要求包含是否打卡、打卡定位;装货、发货、到货、卸货、签收还包含上传货量和上传货量类型;附件要求包含上传凭证和凭证类型。 + - 在途节点额外包含打卡频次和打卡时段,打卡频次使用普通输入框,打卡时段使用时间选择器。 + - 回单节点的操作要求包含是否确认、确认完成,是否确认提供“是 / 无需确认完成”单选,确认完成使用“内部人员”复选框。 + - 各节点中是否打卡、上传货量、上传凭证均使用单选或复选输入,控件类型与截图保持一致。 - 异常与边界: + - 节点是否确认项为空时阻止提交并提示“请选择确认方式”。 - 节点是否打卡为空时阻止提交并提示“请选择是否打卡”。 - 在途节点是否打卡为是但未配置打卡频次或打卡时段时阻止提交。 - - 在途节点打卡频次为空或小于1时阻止提交并提示“请输入打卡频次 / 打卡频次必须≥1”。 + - 在途节点打卡频次为空或小于 1 时阻止提交并提示“请输入打卡频次 / 打卡频次必须 ≥1”。 - 在途节点打卡时段为空时阻止提交并提示“请选择打卡时段”。 - 非在途节点出现打卡频次或打卡时段时应不展示。 - 保存时若同时勾选签收和回单,且两者都配置上传凭证,则弹窗提示“签收与回单同时勾选了上传凭证,司机将需重复上传凭证,是否确认?”,按钮为确认、返回修改。 @@ -221,6 +239,7 @@ ### REQ-PROC-009 启用/停用 - 功能点: + - 配置状态分为草稿、启用、停用三种,新增或复制后默认进入草稿状态。 - 草稿状态下编辑页面点击保存并启用后投入使用,状态变更为启用。 - 启用状态下可停用,状态变更为停用。 @@ -228,6 +247,7 @@ - 停用的配置在运单创建等下游业务场景中不再展示,但历史已引用数据保留关联关系。 - 异常与边界: + - 草稿启用前若同一项目已有其他启用配置,则阻止启用并提示先停用原配置。 - 启用状态停用前若存在关联的未完成运单,则阻止停用并提示“该条配置已被引用,不可停用”。 - 停用状态重新启用时仍需重新校验同一项目启用唯一性。 @@ -243,11 +263,13 @@ ### REQ-PROC-010 单条删除 - 功能点: + - 支持通过行操作删除单条过程配置。 - 点击删除时弹出二次确认弹窗。 - 删除成功后刷新列表,并提示“删除成功”。 - 异常与边界: + - 草稿配置可直接删除。 - 停用配置删除前需校验未被运单引用,已引用则提示“该条配置已被引用,不可删除”。 - 启用配置不可删除,需先停用后再处理。 @@ -263,12 +285,14 @@ ### REQ-PROC-011 批量删除 - 功能点: + - 支持勾选多行过程配置后批量删除。 - 点击批量删除时弹出二次确认弹窗。 - 删除时按单条规则逐一校验状态与业务引用。 - - 删除成功后刷新列表,并提示“删除成功XX条,因引用跳过XX条”。 + - 删除成功后刷新列表,并提示“删除成功 XX 条,因引用跳过 XX 条”。 - 异常与边界: + - 未勾选数据时点击批量删除,应提示先选择需要删除的数据。 - 草稿配置可直接删除。 - 停用配置逐条校验是否被运单引用,已引用记录剔除并单独提示。 @@ -285,18 +309,18 @@ ### REQ-PROC-012 组织权限与审计 - 功能点: + - 组织列作为数据权限字段,普通用户默认仅可查看当前组织数据。 - - 具备权限的用户可切换查看全部组织数据,但该视图仅允许只读查看。 - 根据权限配置控制查看、编辑、复制、删除、启用、停用等操作入口。 - 创建人、创建时间、更新时间由系统自动记录。 - 异常与边界: + - 无权限用户访问时提示权限不足。 - - 在全部组织只读视图中不开放新增、编辑、删除、启用、停用等写操作。 - 列表、详情等用户可见场景优先展示创建人姓名,不直接展示用户 ID。 - 反例: - - 不允许普通用户在全部组织视图下修改数据。 + - 不允许普通用户通过手动构造组织条件查看全部组织数据。 - 不允许手动维护创建人、创建时间、更新时间。 - 不允许删除或篡改审计信息。 @@ -305,13 +329,15 @@ ## 通用规则 - 过程配置用于按项目维度配置运输过程各节点的司机打卡要求,确保运输过程可追溯。 -- 配置编号由系统自动生成,规则为 GC + 5位流水号,且全局唯一。 +- 配置编号由系统自动生成,规则为 GC + 5 位流水号,且全局唯一。 - 配置名称在同一组织内不允许重复。 - 一个项目在同一时间只能关联一条启用状态的过程配置。 - 过程节点顺序固定,不可拖拽排序,依次为接单、到场、装货、发货、在途、到货、卸货、签收、回单。 - 仅勾选启用的节点才会展示在现行过程节点时间线中。 -- 是否打卡、上传货量、上传凭证为节点内相互独立的配置项,可单独配置或多选。 -- 仅在途节点支持打卡频次和打卡时段,默认打卡频次为1次,默认打卡时段为00:00-24:00。 -- 节点配置触发重复上传凭证提示时,应允许用户确认后继续或返回修改。 +- 新增、编辑弹窗由基本信息、现行过程节点、节点设置三个板块组成。 +- 新增、编辑弹窗顶部距离为 10px,弹窗宽度需保证节点设置内容一屏完整展示。 +- 节点设置表格固定展示节点设置、操作要求、附件要求三列,控件类型与截图保持一致。 +- 新增时节点设置不默认勾选节点,复选项不预置选择,操作要求单选项默认选择“是”。 +- 仅在途节点支持打卡频次和打卡时段,默认打卡频次为 1 次,默认打卡时段为 00:00-24:00。 - 新增、编辑、复制、启用、停用、删除成功后均需刷新列表。 - 删除前必须校验状态与业务引用,已引用配置不允许直接删除或停用。