docs: rename v0.2 user access spec

This commit is contained in:
Codex
2026-05-28 18:09:30 +08:00
parent 5fdfc9f82a
commit c09247fe4d
4 changed files with 12 additions and 10 deletions
+1 -1
View File
@@ -58,7 +58,7 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥
- 用户反馈分流规则:[docs/reference/user-feedback-triage.md](docs/reference/user-feedback-triage.md)
- 文档治理与 docs-spec 本地权威:[docs/reference/documentation-governance.md](docs/reference/documentation-governance.md)
- 架构和 M3 主线:[docs/reference/architecture.md](docs/reference/architecture.md)
- v0.2 用户访问模型、code agent session 归属和 device pod 授权:[docs/reference/multi-user-access.md](docs/reference/multi-user-access.md)
- v0.2 用户和权限管理规格、code agent session 归属和 device pod 授权:[docs/reference/spec-user-access.md](docs/reference/spec-user-access.md)
- DEV 运行态、端口、k3s 和 DB DNS 边界:[docs/reference/dev-runtime-boundary.md](docs/reference/dev-runtime-boundary.md)
- G14 GitOps 发布、SecretRef preflight、runner/host 边界、镜像发布和单纯文档/CLI 直推规则:[docs/reference/g14-gitops-cicd.md](docs/reference/g14-gitops-cicd.md)、[docs/reference/commander-collaboration.md](docs/reference/commander-collaboration.md)
- G14 GitOps CI/CD、Tekton/Argo CD、集群内 registry 和无锁镜像化发布:[docs/reference/g14-gitops-cicd.md](docs/reference/g14-gitops-cicd.md)
+2 -2
View File
@@ -1,12 +1,12 @@
# v0.2 多用户访问迁移计划
本文记录 v0.2 当前源码状态、与目标用户访问模型的差距,以及推荐迁移路径。长期目标和稳定判定标准以 [../reference/multi-user-access.md](../reference/multi-user-access.md) 为准。
本文记录 v0.2 当前源码状态、与目标用户和权限管理规格的差距,以及推荐迁移路径。长期目标和稳定判定标准以 [../reference/spec-user-access.md](../reference/spec-user-access.md) 为准。
## 当前态
从 v0.2 源码看,当前系统还没有真正的多用户访问控制:
- `docs/reference/multi-user-access.md` 已定义 `admin/user`、session owner 和 device pod grant 的目标模型,但还没有对应实现。
- `docs/reference/spec-user-access.md` 已定义 `admin/user`、session owner 和 device pod grant 的目标规格,但还没有对应实现。
- `internal/db/migrations/0001_cloud_core_skeleton.sql` 已有 `projects``gateway_sessions``hardware_operations``audit_events``agent_sessions``worker_sessions``agent_trace_events``evidence_records` 和 migration ledger;没有 `users``user_sessions``device_pods``device_pod_grants``device_leases``agent_sessions` 也没有 `owner_user_id`
- `internal/db/runtime-store.mjs` 支持 memory/postgres runtime store 和 readiness,但主要服务 L1 硬件 runtime 数据;用户身份和授权尚未进入 runtime store。
- `web/hwlab-cloud-web/auth.mjs` 是轻量登录前端,默认 `admin/hwlab2026`,并有 local session fallback;它不是正式用户体系。
+2 -2
View File
@@ -41,10 +41,10 @@ For M3 hardware proof, the required runtime participants are:
能力;正式 profile authority、REST/job 和服务部署规格见
[spec-device-pod.md](spec-device-pod.md)。
`v0.2` 用户访问模型只保留 `admin``user` 两类角色:code agent
`v0.2` 用户和权限管理规格只保留 `admin``user` 两类角色:code agent
session 归属于创建用户,device pod 由 `admin` 管理并按用户授权,授权即全权限;
Kubernetes 只做运行时隔离和资源兜底,不承载最终用户权限。权威口径见
[multi-user-access.md](multi-user-access.md)。
[spec-user-access.md](spec-user-access.md)。
## M3 Trusted Loop
@@ -1,8 +1,10 @@
# v0.2 用户访问模型
# v0.2 用户和权限管理规格
本文是 HWLAB `v0.2` 用户系统的长期参考口径。目标是用最少概念支持真实用户使用 code agent session 和管理员分配 device pod 权限,同时避免把用户体系、Kubernetes 租户、设备授权、硬件证据链和审计系统混成一套复杂门禁。
本文是 HWLAB `v0.2` 用户和权限管理的规格说明。目标是用最少概念支持真实用户使用 code agent session 和管理员分配 device pod 权限,同时避免把用户体系、Kubernetes 租户、设备授权、硬件证据链和审计系统混成一套复杂门禁。
## 设计目标
本规格与 [spec-device-pod.md](spec-device-pod.md) 配套:用户和权限规格定义谁可以看见、创建和使用 device poddevice-pod 规格定义 profile authority、REST/job 和硬件执行边界。
## 规格目标
- 只保留两类角色:`admin``user`
- `code agent session` 直接归属于创建它的用户;普通用户只能查看、继续和取消自己的 session。
@@ -13,9 +15,9 @@
- 普通用户不获得 Kubernetes 用户、kubeconfig、namespace 管理权或直接访问 device pod Service 的权限;所有用户权限判断在 cloud-api 应用层完成。
- v0.2 权限数据必须与 `hwlab-dev`/`hwlab-prod` 运行数据隔离。优先在 `hwlab-v02` namespace 内使用独立 Postgres StatefulSet/PVC;若未来显式复用共享 Postgres 实例,也必须使用独立 database 或 schema、独立 Secret 和独立 migration ledger,不得直接复用 `hwlab-dev` 的 pgdata。
## 简化前后
## 简化边界
| 模块 | 复杂方案 | v0.2 MVP 方案 |
| 模块 | 不采用的复杂方案 | v0.2 规格方案 |
| --- | --- | --- |
| 用户角色 | `platform_admin``device_admin``developer``viewer` | `admin``user` |
| 用户组 | `groups``group_members` | 不引入 |