platforms/docs/项目文档_生产商角色固定_v1.0.md

项目文档：生产商角色固定 v1.0

1. 项目概述

当前系统尚未实现生产商端及其多角色权限体系，因此生产商账户仅支持稳定角色编码 admin，平台页面显示为“生产商管理员”。本次修改不改变数据库结构和历史数据。

2. 目录结构说明

platforms/
├── backend/api/internal/logic/platform/product/
│   ├── producer.go               # 生产商创建与编辑角色规则
│   └── producer_test.go          # 生产商角色回归测试
├── frontend/platform_admin/src/api/
│   ├── resources.ts              # 生产商管理员中文展示配置
│   └── resource-page-rules.ts    # 生产商编辑字段白名单
└── docs/
    ├── 项目文档_生产商角色固定_v1.0.md
    └── 操作日志_生产商角色固定_20260813.md

3. 核心文件说明

• producer.go：newProducerAccount 固定角色为 admin；producerAccountUpdateValues 不生成角色更新值。
• producer_test.go：验证客户端提交其他角色不会影响新建和编辑结果。
• resources.ts：将 admin 映射为“生产商管理员”，新建时只读。
• resource-page-rules.ts：角色不属于生产商可编辑字段。

4. 变更记录

• 新建生产商固定使用 admin。
• 编辑生产商不能修改角色。
• 新建、详情和编辑页面支持“生产商管理员”中文展示。
• 历史未知角色保持数据库原值，不执行 SQL 或迁移。

5. 维护指南

未来若建设生产商端多角色体系，应先设计独立角色、菜单权限、登录鉴权和企业账户关系，再开放角色编辑。不得仅通过放开 role_code 文本输入实现权限扩展。