feat: 统一账户角色展示并优化资源页面

This commit is contained in:
czl231
2026-08-11 02:01:00 +08:00
parent 9cf16ccb3c
commit ff345dc42a
28 changed files with 555 additions and 76 deletions

View File

@@ -114,9 +114,9 @@
新建和编辑页使用全宽信息卡,内部表单内容最大宽度为 `1440px`,并按内容容器宽度在双列与单列之间切换。页面内容从顶部自然排列,只保留面包屑和右侧返回按钮,不重复展示“新建/编辑资源名称”及操作说明;字段和底部操作按钮保持统一基线。账户头像摘要和详情页展示结构不随该表单布局调整而改变。
标准详情页同样只保留面包屑、编辑和返回操作,不重复展示“详情资源名称”及说明文字。详情卡片按内容自然高度从顶部排列,统一使用 `12px` 间距和紧凑内边距;基本信息在大屏、中屏和小屏分别采用三列、两列和单列。未开通钱包使用单行提示,气站启停继续保留独立状态管理卡片,不改变原有接口和权限校验。
标准详情页同样只保留面包屑、编辑和返回操作,不重复展示“详情资源名称”及说明文字。详情卡片按内容自然高度从顶部排列,统一使用 `12px` 间距和紧凑内边距;基本信息在大屏、中屏和小屏分别采用三列、两列和单列。字段标签按文字自然宽度与值保持 `12px` 间距,长标签禁止拆字换行,不使用固定标签列制造多余空白。未开通钱包使用单行提示,气站启停继续保留独立状态管理卡片,不改变原有接口和权限校验。
新建与编辑使用不同字段规则。唯一标识、用户名、创建编码、不可变归属等创建后锁定字段只读展示且禁止修改;后端更新协议要求原归属标识时,页面只会原样回传该字段。合同状态、检修结果、系统角色和平台权限等限制同时由页面和后端校验。编辑页离开前检测未保存内容,详情页的聚合子表、钱包摘要、气站状态开关及资源专属业务动作继续保留。
新建与编辑使用不同字段规则。唯一标识、用户名、创建编码、不可变归属等创建后锁定字段以灰色禁用控件展示且禁止修改,不重复显示顶部说明条、字段旁提示或禁用占位文字;后端更新协议要求原归属标识时,页面只会原样回传该字段。合同状态、检修结果、系统角色和平台权限等限制同时由页面和后端校验。编辑页离开前检测未保存内容,详情页的聚合子表、钱包摘要、气站状态开关及资源专属业务动作继续保留。
### 6.1 机构管理
@@ -129,6 +129,10 @@
气站只能由平台总后台新增,创建后直接进入启用状态,无需审核。已启用或已停用气站可继续切换启停状态。
气站账户与配送点账户当前均只有管理员角色。新建时服务端分别固定写入 `admin`,编辑时不允许变更角色;旧客户端继续提交 `role_code` 时服务端兼容接收但不采纳。列表、详情、新建和编辑页面统一显示“角色”,并将 `admin` 显示为“气站管理员”或“配送点管理员”。历史未知编码显示为“未知角色(原编码)”,不得自动改成管理员。
气站账户、配送点账户和生产商账户没有头像字段与受控头像接口。它们的详情和编辑页使用紧凑文字账户摘要,新建页直接显示基本信息表单,不展示无法上传或保存的默认头像。工作人员、用户和平台账户继续使用真实头像上传与受控读取链路。
### 6.2 工作人员管理
| 资源 | 路径 | 模式 | 已实现能力 |
@@ -165,6 +169,8 @@
智能气阀必须关联生产商和类型,可选关联库房、气站、配送点或用户。生产商登录密码仅保存哈希且不通过资源接口返回;独立生产端登录路由待生产管理系统落地时接入。归属组合由后端校验,不允许形成非法多重归属。生命周期支持待处理、在库、运输中、使用中、维修中和已报废;状态变化使用 `/product_info/:identity/lifecycle`,不能通过通用编辑直接改写。归属变化自动追加归属记录。
生产商账户当前没有完整角色权限字典。本阶段仅移除无效头像占位,不改变其 `role_code` 写入规则;待生产管理系统明确角色模型后再统一中文角色名称和权限约束。
### 6.5 配送合同
| 资源 | 路径 | 模式 | 已实现能力 |

View File

@@ -40,6 +40,9 @@
- 气站账号由平台总后台创建;气站端不允许自助创建管理员。
- 仅启用状态、关联启用气站且 `role_code = admin``gas_account` 可以登录。
- 平台创建气站账户时固定保存 `role_code = admin`,更新账户时不允许修改角色;旧客户端携带该字段时兼容接收但忽略。
- 管理页面将 `admin` 显示为“气站管理员”;历史未知编码显示为“未知角色(原编码)”,不自动迁移或提升权限。
- 气站账户没有头像字段和受控头像接口,账户资料不得展示可操作或可持久化的头像入口。
- JWT 客户端固定为 `gas_admin`,与平台总后台会话隔离。
- 登录后由后端 `gas_menu` 接口按 `role_code` 返回静态菜单,前端据此渲染。
- 修改密码必须校验当前密码;新密码仅校验长度不少于 6 位。

View File

@@ -52,6 +52,9 @@ Global:
- 配送点管理员账号由平台或所属气站创建。
- 仅启用、关联启用配送点且 `role_code = admin``delivery_account` 可以登录。
- 平台或所属气站创建配送点账户时固定保存 `role_code = admin`,更新账户时不允许修改角色。
- 三套管理后台统一使用“配送点账户”和“角色”,并将 `admin` 显示为“配送点管理员”;历史未知编码显示为“未知角色(原编码)”。
- 配送点账户没有头像字段和受控头像接口,不展示无法上传或保存的默认头像。
- JWT 客户端固定为 `delivery_admin`,与平台和气站管理端会话隔离。
- 菜单由后端 `delivery_menu` 接口按 `role_code` 返回,前端登录后据此渲染。
- 修改本人密码必须校验当前密码;新密码只要求不少于 6 位。

View File

@@ -0,0 +1,37 @@
# 标准资源编辑页提示精简操作日志
操作时间2026-08-11 01:14:16
操作类型:修改
影响模块:平台总后台标准资源编辑页
## 操作前状态
- 编辑页顶部显示“灰色字段为创建后不可修改的信息,不会提交到更新接口”的蓝色说明条。
- 每个禁用字段旁重复显示“创建后不可修改”,文本会挤压输入框并在窄空间换行。
- 禁用文本输入框在值为空时仍显示“创建后不可修改”占位文字。
## 具体操作
- 修改 `frontend/platform_admin/src/views/resource/ResourceRecordPage.vue`,删除编辑页顶部重复说明条。
- 修改 `frontend/platform_admin/src/views/resource/ResourceFieldForm.vue`,删除禁用字段旁提示和禁用占位文字。
- 修改 `frontend/platform_admin/src/views/resource/ResourceRecordPage.less`,清理说明条已不再使用的样式选择器。
- 保留灰色禁用样式、只读字段展示、允许更新字段计算和更新请求过滤逻辑。
## 操作后状态
- 所有标准资源编辑页直接从字段区域开始,不保留说明条空位。
- 禁用字段和值继续显示,输入框宽度与同列其他字段一致。
- 页面不再重复解释不可修改状态,更新安全边界保持不变。
## 验证结果
- `npm.cmd run type:check`:通过。
- `npm.cmd run build`通过Vite 生产构建完成。
- `npm.cmd run resource-pages:check`:通过,详情 46 类、新建 25 类、编辑 23 类。
- `npm.cmd run contract:check`通过48 个资源契约一致。
- 浏览器回归:气站编辑页顶部说明条、字段旁提示和禁用占位文字均已消失;禁用输入框与普通输入框宽度一致,控制台无警告或错误;未执行保存操作。
## 风险评估
- 本次只删除视觉提示,不改变字段权限、表单值、校验、请求负载或后端接口。
- 新建页、详情页、业务动作弹窗、气站后台 5175 和配送点后台 5176 不受影响。

View File

@@ -0,0 +1,39 @@
# 标准资源详情字段布局优化操作日志
操作时间2026-08-11 01:21:54
操作类型:修改
影响模块:平台总后台标准资源详情页
## 操作前状态
- 详情字段使用固定 `120px` 标签列,短标签和值之间出现明显空白。
- “统一社会信用代码”等长中文标签空间不足,会拆字换行并增加行高。
- 固定标签列在不同字段长度下无法同时兼顾紧凑性和可读性。
## 具体操作
- 修改 `frontend/platform_admin/src/views/resource/ResourceDetailContent.vue`
- 标签列改为按文字自然宽度计算。
- 标签和值之间统一使用 `12px` 间距。
- 标签禁止换行,值区域继续允许收缩和自动换行。
- 小屏不再恢复固定 `100px` 标签列。
- 更新平台需求和标准资源全页管理项目文档。
## 操作后状态
- 短标签后的多余空白消失,字段值紧邻对应标签。
- 长中文标签保持单行,不再出现单字换行。
- 大屏三列、中屏两列、小屏单列及字段分隔线保持不变。
## 验证结果
- `npm.cmd run type:check`:通过。
- `npm.cmd run build`通过Vite 生产构建完成。
- `npm.cmd run resource-pages:check`:通过,详情 46 类、新建 25 类、编辑 23 类。
- `npm.cmd run contract:check`通过48 个资源契约一致。
- 浏览器回归:“唯一标识”和“统一社会信用代码”标签与值的实际间距均为 `12px`,长标签保持单行;`700px` 小屏使用单列且无水平溢出,控制台无警告或错误。
## 风险评估
- 本次仅调整详情字段 CSS不修改字段顺序、格式化、唯一标识复制、接口或权限逻辑。
- 聚合子表、钱包、状态管理、编辑页、新建页及其他管理端保持原状。

View File

@@ -0,0 +1,57 @@
# 操作日志:账户角色中文展示与摘要统一
操作时间2026-08-11 01:47:12
操作类型:修改、扩展
影响模块:平台总后台、气站后台、配送点后台、平台账户接口
## 操作前状态
- 配送点账户曾实现“配送点管理员”中文展示,但标准资源独立页面改造后退回“角色编码 / admin”。
- 气站登录只允许 `admin`,平台创建和更新接口却仍接受任意角色编码,可能产生无法登录的账户。
- 气站、配送点和生产商账户没有头像字段或受控头像接口,平台页面仍展示默认头像占位。
- 平台账户编辑下拉使用角色名称,但列表和详情仍可能显示原始角色编码。
## 具体操作
1. 为气站和配送点账户增加资源级固定角色元数据,统一显示“角色”“气站管理员”“配送点管理员”。
2. 气站账户创建强制写入 `admin`,更新不再修改角色;保留旧请求字段用于兼容但不采纳。
3. 历史未知角色统一显示为“未知角色(原编码)”,不执行数据库迁移,不自动扩大权限。
4. 平台账户列表和详情加载动态角色名称,用角色名称替代裸编码。
5. 无真实头像能力的账户隐藏头像列并使用文字摘要;新建页不展示空的唯一标识和创建时间。具备头像接口的工作人员、用户和平台账户保持原功能。
6. 气站后台和配送点后台的账户管理弹层同步使用中文只读角色,并停止向账户更新接口提交角色字段。
## 代码变更
- `backend/api/internal/logic/platform/gas/account.go`:固定气站管理员角色并禁止更新角色。
- `backend/api/internal/logic/platform/gas/account_test.go`:验证旧角色字段不能改变管理员角色。
- `frontend/platform_admin/src/api/`:增加固定角色、未知角色和动态平台角色显示能力。
- `frontend/platform_admin/src/views/resource/`:按真实头像能力切换头像摘要或文字摘要。
- `frontend/gas_admin/src/``frontend/delivery_admin/src/`:统一账户角色中文名称和只读行为。
- `frontend/platform_admin/scripts/check-account-role-presentation.mjs`:静态检查三套后台的角色与摘要规则。
## 行为变化
| 场景 | 修改前 | 修改后 |
| --- | --- | --- |
| 配送点账户角色 | “角色编码 / admin” | “角色 / 配送点管理员” |
| 气站账户角色 | 可输入任意编码 | 固定“气站管理员”,后端保存 `admin` |
| 历史未知角色 | 直接显示裸编码 | 显示“未知角色(原编码)”,不自动修改 |
| 无头像账户 | 显示不可操作默认头像 | 详情、编辑使用文字摘要;新建直接进入表单 |
| 平台账户角色 | 列表和详情可能显示编码 | 使用动态平台角色名称 |
## 验证结果
- 平台总后台、气站后台、配送点后台 TypeScript 类型检查和生产构建全部通过。
- 三套后台资源契约检查通过;标准资源页面检查通过:详情 46 类、新建 25 类、编辑 23 类。
- 账户角色静态检查通过,确认三套后台中文角色、未知角色和头像摘要规则均已覆盖。
- 后端 `go test ./...` 全量测试通过,包含新增气站管理员角色约束测试。
- 本地浏览器已验证应用可正常进入登录页;数据页视觉回归因当前测试会话未登录而未执行,未使用或提交本地默认密码。
## 风险评估
- 不迁移历史非 `admin` 记录,避免静默赋予管理员权限;管理员需根据“未知角色”提示单独核查。
- 气站账户从本次变更起无法创建新角色,符合当前登录与菜单仅支持 `admin` 的既有约束。
- 生产商角色模型尚未明确,本次不修改其角色写入规则。
- 本次不新增气站、配送点或生产商头像字段,因此不产生数据库迁移和孤儿上传文件。

View File

@@ -69,10 +69,10 @@ platforms/
- 详情页顶部只保留“列表 / 详情”面包屑、编辑和返回操作,不重复展示“详情资源名称”及说明文字。
- 页面网格从顶部按内容自然排列,详情卡片统一使用 `12px` 间距、圆角、标题高度和内容内边距,不随剩余视口高度拉伸。
- 普通资源使用响应式三列信息区金额、状态、日期、布尔和关系字段统一格式化。
- 普通资源使用响应式三列信息区;字段标签按文字自然宽度与值保持 `12px` 间距,长标签保持单行,避免短标签后留白或中文标签拆字换行;金额、状态、日期、布尔和关系字段统一格式化。
- 聚合详情中的数组继续以页签和表格展示,例如合同产品、修订记录和订单轨迹。
- 气站详情保留独立的紧凑启停区域;钱包归属资源保留钱包摘要和钱包详情入口,未开通钱包时显示单行紧凑提示。
- 工作人员、用户和平台账户保留头像、用户名、唯一标识、创建时间的账户摘要。
- 工作人员、用户和平台账户保留头像、用户名、唯一标识、创建时间的账户摘要;气站、配送点和生产商账户仅展示紧凑文字摘要,不显示无数据能力的装饰头像
- 资源专属流程动作继续使用短模态框,危险动作显示风险提示,平台角色菜单分配保留专属适配。
### 4.3 新建与编辑
@@ -80,8 +80,8 @@ platforms/
- 新建和编辑卡片铺满主内容区,卡片内部使用最大 `1440px` 的内容容器控制输入框行长;标题、字段和操作按钮保持同一左基线。
- 表单根据容器实际宽度响应:内容区达到约 `900px` 时使用双列,否则切换为单列;地址、备注、条款、参数和正文等长字段独占整行。
- 页面网格从顶部自然排列;新建、编辑页只保留“列表 / 当前操作”面包屑和右侧返回按钮,不重复展示操作大标题及说明文字;保存和取消按钮位于表单末尾,不吸附浏览器底部。
- 账户类资源继续保留头像和身份摘要的居中结构,详情页布局不受表单优化影响
- 编辑页展示创建后不可修改字段,禁用字段不会进入更新请求。
- 具备受控头像接口的账户继续保留头像和身份摘要;没有头像能力的账户在新建页直接进入表单,在编辑页使用紧凑文字摘要
- 编辑页继续以禁用控件展示创建后不可修改字段,不额外显示说明条、字段旁提示或禁用占位文字;禁用字段不会进入更新请求。
- 必填、密码最短 6 位、关系选项和金额转换复用统一校验与负载构建逻辑。
- 页面检测表单和头像变更;返回、取消或浏览器路由离开时均提示是否放弃未保存内容。
- 机构“账户管理”不再打开二级模态框,而是进入带机构过滤条件的隐藏账户列表及其独立 CRUD 页面。
@@ -91,6 +91,8 @@ platforms/
- 详情始终调用现有受保护资源接口,不使用列表缓存绕过脱敏和对象权限。
- 头像继续通过专用上传与受控读取接口;平台账户补充同等头像读取能力。
- 平台账户普通编辑没有提交头像时保持原值,避免更新其他资料时意外清空头像。
- 气站和配送点账户的 `admin` 分别显示为“气站管理员”和“配送点管理员”,表单只读;历史未知编码保留并显示明确提示,不做自动权限迁移。
- 平台账户列表和详情使用动态平台角色名称,不直接暴露角色编码;无法匹配时显示“未知角色(原编码)”。
- `return_to` 拒绝协议相对地址和站外地址。
- 附件查看未接入:现有通用响应会剥离敏感 URI待受控下载接口完成后再扩展。
@@ -112,6 +114,7 @@ platforms/
```powershell
npm.cmd run resource-pages:check
npm.cmd run account-roles:check
npm.cmd run contract:check
npm.cmd run build
```