diff --git a/docs/操作日志_智能气阀新建归属互斥_20260813.md b/docs/操作日志_智能气阀新建归属互斥_20260813.md new file mode 100644 index 0000000..6e18688 --- /dev/null +++ b/docs/操作日志_智能气阀新建归属互斥_20260813.md @@ -0,0 +1,41 @@ +# 智能气阀新建归属互斥操作日志 + +操作时间：2026-08-13 +操作类型：修改 +影响模块：平台总后台智能气阀新建页面 + +## 操作前状态 + +新建智能气阀时，库房、气站、配送点和用户使用“唯一标识”技术名称，空下拉框缺少明确选择提示；四个互斥归属可以在前端同时选择，直到后端保存校验时才被拒绝。 + +## 具体操作 + +1. 字段标题改为“库房”“气站”“配送点”“用户”。 +2. 新建表单分别显示“请选择库房”等引导文案。 +3. 选择任一非空归属后自动清空另外三个归属。 +4. 在新建表单顶部明确提示当前归属四选一及自动清空规则。 +5. 保留通用关系联动调用和后端最终合法性校验。 +6. 扩展既有专项检查，覆盖新建页面互斥行为、说明文案与展示配置。 + +## 操作后状态 + +管理员进入新建页面即可看到四选一说明，只需选择一个目标归属；切换归属类型时旧值自动清空。详情空值仍显示“未填写”。 + +## 代码变更 + +- `frontend/platform_admin/src/views/resource/ResourceRecordPage.vue`：接入新建页归属互斥处理。 +- `frontend/platform_admin/src/api/resources.ts`：配置业务字段名和选择提示。 +- `frontend/platform_admin/scripts/check-product-ownership-action.mjs`：覆盖新建页互斥行为。 +- `frontend/platform_admin/scripts/check-product-ownership-display.mjs`：覆盖字段名、空值和提示文案。 + +## 验证结果 + +- `npm.cmd run product-ownership:check`：通过，新建页与专用弹窗均自动清空其他归属。 +- `npm.cmd run product-ownership-display:check`：通过，业务字段名、选择提示和详情空值文案配置完整。 +- `npm.cmd run resource-pages:check`：通过，详情 46 类、新建 25 类、编辑 23 类。 +- `npm.cmd run build`：通过，TypeScript 类型检查与 Vite 生产构建成功。 +- `git diff --check`：通过，未发现空白符错误。 + +## 风险评估 + +修改仅作用于智能气阀新建表单的前端交互与文案，不改变数据库、接口结构及后端校验。 diff --git a/docs/项目文档_智能气阀新建归属互斥_v1.0.md b/docs/项目文档_智能气阀新建归属互斥_v1.0.md new file mode 100644 index 0000000..a4f55d1 --- /dev/null +++ b/docs/项目文档_智能气阀新建归属互斥_v1.0.md @@ -0,0 +1,37 @@ +# 项目文档：智能气阀新建归属互斥 v1.0 + +## 1. 项目概述 + +智能气阀新建页面将库房、气站、配送点和用户作为同一组互斥归属。选择任一归属后自动清空其他归属，避免构造后端必然拒绝的多重归属请求。 + +## 2. 目录结构说明 + +```text +platforms/ +├── frontend/platform_admin/ +│ ├── src/api/resources.ts +│ ├── src/views/resource/ResourceRecordPage.vue +│ └── scripts/ +│ ├── check-product-ownership-action.mjs +│ └── check-product-ownership-display.mjs +└── docs/ + ├── 项目文档_智能气阀新建归属互斥_v1.0.md + └── 操作日志_智能气阀新建归属互斥_20260813.md +``` + +## 3. 核心行为 + +- 新建页字段标题使用业务名称，不显示“唯一标识”。 +- 新建表单顶部说明四选一规则和自动清空行为。 +- 未选择时显示“请选择…”；详情空值继续显示“未填写”。 +- 选择一个非空归属时自动清空另外三个。 +- 主动清空当前归属不会自动选择其他值。 +- 关系变更后继续调用共享联动逻辑，避免影响其他资源表单。 + +## 4. 接口兼容性 + +创建请求仍使用 `warehouse_identity`、`gas_basic_identity`、`delivery_basic_identity` 和 `user_account_identity`。后端仍执行最多一个当前归属的最终校验。 + +## 5. 维护指南 + +新建页和“变更智能气阀归属”弹窗应保持相同的互斥规则。新增归属类型时必须同步更新两处字段集合、后端校验和专项检查。 diff --git a/frontend/platform_admin/scripts/check-product-ownership-action.mjs b/frontend/platform_admin/scripts/check-product-ownership-action.mjs index bc9354e..9b7dc3d 100644 --- a/frontend/platform_admin/scripts/check-product-ownership-action.mjs +++ b/frontend/platform_admin/scripts/check-product-ownership-action.mjs @@ -10,6 +10,11 @@ const componentUrl = new URL( import.meta.url, ); const source = await readFile(fileURLToPath(componentUrl), 'utf8'); +const recordPageUrl = new URL( + '../src/views/resource/ResourceRecordPage.vue', + import.meta.url, +); +const recordPageSource = await readFile(fileURLToPath(recordPageUrl), 'utf8'); const requiredFragments = [ '@change-relation="changeRelation"', 'ownershipKeys.includes(field.key)', @@ -24,4 +29,20 @@ for (const fragment of requiredFragments) { } } -console.log('智能气阀归属互斥检查通过：选择时自动清空，提交时保留防御校验。'); +const createPageFragments = [ + '@change-relation="changeRelation"', + "mode === 'create' && definition.name === 'product_info'", + '当前归属只能选择库房、气站、配送点或用户中的一个；选择新归属时会自动清空其他归属。', + "definition.value.name === 'product_info'", + 'productOwnershipKeys.includes(field.key)', + 'if (key !== field.key) form[key] = undefined', + 'await relationLinkage.change(field, value)', +]; + +for (const fragment of createPageFragments) { + if (!recordPageSource.includes(fragment)) { + throw new Error(`智能气阀新建页归属互斥检查缺少实现：${fragment}`); + } +} + +console.log('智能气阀归属互斥检查通过：新建页与专用弹窗均自动清空，提交时保留防御校验。'); diff --git a/frontend/platform_admin/scripts/check-product-ownership-display.mjs b/frontend/platform_admin/scripts/check-product-ownership-display.mjs index 2360308..a7dad23 100644 --- a/frontend/platform_admin/scripts/check-product-ownership-display.mjs +++ b/frontend/platform_admin/scripts/check-product-ownership-display.mjs @@ -8,10 +8,10 @@ import { fileURLToPath } from 'node:url'; const resourcesUrl = new URL('../src/api/resources.ts', import.meta.url); const source = await readFile(fileURLToPath(resourcesUrl), 'utf8'); const ownershipRelations = [ - "relation('warehouse_identity', '/product_warehouse', false, { emptyText: '未填写' })", - "relation('gas_basic_identity', '/gas_basic', false, { emptyText: '未填写' })", - "relation('delivery_basic_identity', '/delivery_basic', false, { emptyText: '未填写' })", - "relation('user_account_identity', '/user_account', false, { emptyText: '未填写' })", + "relation('warehouse_identity', '/product_warehouse', false, { label: '库房', emptyText: '未填写', placeholder: '请选择库房' })", + "relation('gas_basic_identity', '/gas_basic', false, { label: '气站', emptyText: '未填写', placeholder: '请选择气站' })", + "relation('delivery_basic_identity', '/delivery_basic', false, { label: '配送点', emptyText: '未填写', placeholder: '请选择配送点' })", + "relation('user_account_identity', '/user_account', false, { label: '用户', emptyText: '未填写', placeholder: '请选择用户' })", ]; for (const relation of ownershipRelations) { diff --git a/frontend/platform_admin/src/api/resources.ts b/frontend/platform_admin/src/api/resources.ts index 55c432a..0751ea1 100644 --- a/frontend/platform_admin/src/api/resources.ts +++ b/frontend/platform_admin/src/api/resources.ts @@ -447,7 +447,7 @@ export const resources: ResourceUiDefinition[] = [ define('producer_account', '生产商管理', 'writable', [f('producer_code', { required: true }), f('name', { required: true }), f('credit_code'), f('principal'), f('phone'), f('address', { emptyText: '未填写', placeholder: '请输入地址' }), f('username', { required: true }), f('password', { required: true }), f('display_name'), producerAdminRole(), f('remark')]), define('product_type', '智能气阀类型', 'editable', [f('code', { required: true }), f('name', { required: true })]), define('product_warehouse', '智能气阀库房', 'editable', [f('code', { required: true }), f('name', { required: true }), f('address', { emptyText: '未填写', placeholder: '请输入地址' }), f('manager'), f('phone')]), - define('product_info', '智能气阀', 'editable', [f('code', { required: true }), f('name', { required: true }), relation('producer_account_identity', '/producer_account', true, { label: '生产商', listLabel: '生产商', listRelationNameOnly: true, displayRelationLabel: true, showIdentityCopy: true, emptyText: '未填写', placeholder: '请选择生产商' }), relation('product_type_identity', '/product_type', true, { label: '智能气阀类型', listLabel: '智能气阀类型', listRelationNameOnly: true, displayRelationLabel: true, showIdentityCopy: true, emptyText: '未填写', placeholder: '请选择智能气阀类型' }), f('params', { required: true }), relation('warehouse_identity', '/product_warehouse', false, { emptyText: '未填写' }), relation('gas_basic_identity', '/gas_basic', false, { emptyText: '未填写' }), relation('delivery_basic_identity', '/delivery_basic', false, { emptyText: '未填写' }), relation('user_account_identity', '/user_account', false, { emptyText: '未填写' }), f('produced_at', { required: true })], 'list', [ + define('product_info', '智能气阀', 'editable', [f('code', { required: true }), f('name', { required: true }), relation('producer_account_identity', '/producer_account', true, { label: '生产商', listLabel: '生产商', listRelationNameOnly: true, displayRelationLabel: true, showIdentityCopy: true, emptyText: '未填写', placeholder: '请选择生产商' }), relation('product_type_identity', '/product_type', true, { label: '智能气阀类型', listLabel: '智能气阀类型', listRelationNameOnly: true, displayRelationLabel: true, showIdentityCopy: true, emptyText: '未填写', placeholder: '请选择智能气阀类型' }), f('params', { required: true }), relation('warehouse_identity', '/product_warehouse', false, { label: '库房', emptyText: '未填写', placeholder: '请选择库房' }), relation('gas_basic_identity', '/gas_basic', false, { label: '气站', emptyText: '未填写', placeholder: '请选择气站' }), relation('delivery_basic_identity', '/delivery_basic', false, { label: '配送点', emptyText: '未填写', placeholder: '请选择配送点' }), relation('user_account_identity', '/user_account', false, { label: '用户', emptyText: '未填写', placeholder: '请选择用户' }), f('produced_at', { required: true })], 'list', [ { name: '修改智能气阀状态', resource: '/product_info/:identity/lifecycle', method: 'PATCH', fields: [f('product_status', { required: true, type: 'select', options: [{ label: '待处理', value: 10 }, { label: '在库', value: 28 }, { label: '运输中', value: 29 }, { label: '使用中', value: 30 }, { label: '维修中', value: 31 }, { label: '已报废', value: 27 }] })] }, { name: '变更智能气阀归属', resource: '/product_info/:identity', method: 'PUT', fields: [relation('warehouse_identity', '/product_warehouse'), relation('gas_basic_identity', '/gas_basic'), relation('delivery_basic_identity', '/delivery_basic'), relation('user_account_identity', '/user_account'), f('action', { required: true, type: 'select', options: [{ label: '入库', value: 'warehouse' }, { label: '分配', value: 'assigned' }, { label: '归还', value: 'returned' }, { label: '人工调整', value: 'manual' }] }), f('reason', { required: true }), f('remark')] }, ]), diff --git a/frontend/platform_admin/src/views/resource/ResourceRecordPage.vue b/frontend/platform_admin/src/views/resource/ResourceRecordPage.vue index c52053f..9f7aaff 100644 --- a/frontend/platform_admin/src/views/resource/ResourceRecordPage.vue +++ b/frontend/platform_admin/src/views/resource/ResourceRecordPage.vue @@ -116,6 +116,14 @@
基本信息
+ + 当前归属只能选择库房、气站、配送点或用户中的一个；选择新归属时会自动清空其他归属。 + (); const avatar = useResourceAvatar(); @@ -262,6 +280,22 @@ const contractAttachmentState = computed(() => ({ removed: contractAttachment.removed.value, })); +/** 新建智能气阀选择归属时清空其他互斥归属，再执行字段原有联动。 */ +async function changeRelation(field: ResourceField, value: unknown) { + if ( + mode.value === 'create' && + definition.value.name === 'product_info' && + productOwnershipKeys.includes(field.key) && + value != null && + String(value).trim() !== '' + ) { + for (const key of productOwnershipKeys) { + if (key !== field.key) form[key] = undefined; + } + } + await relationLinkage.change(field, value); +} + const accountSummary = computed(() => usesAccountSummary(definition.value)); const accountSummaryVisible = computed( () =>