platforms/docs/操作日志_气站历史账号角色显式修复_20260817.md

操作日志：气站历史账号角色显式修复

操作时间：2026-08-17 22:12:42（Asia/Shanghai） 操作类型：定向数据修复与展示优化 执行管理员：root

问题拆分

• 气站账户未填写显示名称时，列表和详情使用通用横线，无法区分“未填写”和加载异常。
• 历史账号 019fd0e4-6d29-7c54-b2fd-0e8acb2079e1 保存了非法角色编码 010，不满足气站端仅允许 admin 登录的约束。

修复内容

• 气站账户 display_name 空值统一展示为“未填写”。
• 新增显式维护命令 repair-legacy-gas-account，要求提供平台操作者和目标显示名称。
• 命令仅允许修复唯一一条 role_code = 010 的气站账号；不存在或多条匹配时拒绝执行。
• 账号“薛海”的角色由 010 修复为 admin，显示名称由空字符串补齐为“薛海”。
• 同一数据库事务写入 audit_operation_log，记录操作者、资源标识、修复时间、修复前后 JSON 和原因。

审计快照

项目	修复前	修复后
账号唯一标识	019fd0e4-6d29-7c54-b2fd-0e8acb2079e1	不变
用户名	薛海	不变
显示名称	空字符串	薛海
角色编码	010	admin
执行管理员	root	root
修复时间	-	2026-08-17T22:12:42.6845244+08:00

审计记录唯一标识：01a01011-48ad-7042-b57f-96173f4010d2。

边界

• 不修改普通新增和编辑接口的角色规则；新建仍固定写入 admin，编辑仍不接受角色变更。
• 不根据页面展示自动迁移未知角色，也不把其他历史未知编码升级为管理员。