feat: add producer account management

This commit is contained in:
2026-08-04 15:21:39 +08:00
parent fb59e80fd0
commit 402f050b17
21 changed files with 223 additions and 36 deletions

View File

@@ -22,7 +22,7 @@
- 气站管理系统:站点经营、站内库存和日常订单运营仍由后续气站端主责。
- 配送点管理系统:末端调度、配送仓和配送作业仍由后续配送点端主责。
- 生产管理系统:设备生产、质检、序列号注入和出厂追溯尚未在本后台实现
- 生产管理系统:设备生产、质检、序列号注入和出厂追溯仍由独立生产端主责;平台后台仅治理生产商账户主数据及智能气阀的生产商归属
- API 中心:开放 API 产品、调用方、凭证和配额管理尚未实现。
- 用户端与服务端 App本后台不承担用户设备控制、配送员定位采集或现场取证。
@@ -107,7 +107,7 @@
## 6. 已实现功能域
当前资源契约共 47 个资源。下表中的路径均相对于 `/heqi/platform/v1`
当前资源契约共 48 个资源。下表中的路径均相对于 `/heqi/platform/v1`
### 6.1 机构管理
@@ -143,13 +143,14 @@
| 资源 | 路径 | 模式 | 已实现能力 |
| --- | --- | --- | --- |
| 生产商 | `/producer_account` | 可写 | 生产商企业与登录账户新增、查询、编辑、启停和软删除;已被智能气阀引用时禁止删除 |
| 类型 | `/product_type` | 可编辑 | 类型新增、编辑和启停 |
| 库房 | `/product_warehouse` | 可编辑 | 库房新增、编辑和启停 |
| 智能气阀 | `/product_info` | 可编辑 | 档案新增、编辑、启停和专用生命周期流转 |
| 检修记录 | `/product_repair` | 可编辑 | 检修记录新增、编辑和状态调整 |
| 归属记录 | `/product_owner` | 只读 | 查询每次归属变更的动作、操作者、原因和时间 |
智能气阀必须关联类型,可选关联库房、气站、配送点或用户。归属组合由后端校验,不允许形成非法多重归属。生命周期支持待处理、在库、运输中、使用中、维修中和已报废;状态变化使用 `/product_info/:identity/lifecycle`,不能通过通用编辑直接改写。归属变化自动追加归属记录。
智能气阀必须关联生产商和类型,可选关联库房、气站、配送点或用户。生产商登录密码仅保存哈希且不通过资源接口返回;独立生产端登录路由待生产管理系统落地时接入。归属组合由后端校验,不允许形成非法多重归属。生命周期支持待处理、在库、运输中、使用中、维修中和已报废;状态变化使用 `/product_info/:identity/lifecycle`,不能通过通用编辑直接改写。归属变化自动追加归属记录。
### 6.5 配送合同
@@ -275,7 +276,7 @@
1. 匿名用户只能访问健康检查和登录;受保护资源缺少有效 JWT 时被拒绝。
2. 非 root 角色只能访问已分配菜单及其明确依赖资源,不能通过猜测路径访问同级资源。
3. 47 个资源的后端契约、实际路由、前端资源定义和页面加载关系一致。
3. 48 个资源的后端契约、实际路由、前端资源定义和页面加载关系一致。
4. 所有表保留自增 `id` 主键;主资源通过 UUID V7 `identity` 对外访问,前端不依赖内部 ID。
5. 气站必须先审核再启停,驳回原因和审核人可追溯。
6. 智能气阀归属和生命周期变更合法,并自动记录归属历史。