feat: 实现企业设备授权功能并归档 OpenSpec 变更

- 新增企业设备授权模块（Model、DTO、Service、Handler、Store）
- 实现设备授权的创建、查询、更新、删除等完整业务逻辑
- 添加企业卡授权与设备授权的关联关系
- 新增 2 个数据库迁移脚本
- 同步 OpenSpec delta specs 到 main specs
- 归档 add-enterprise-device-authorization 变更
- 更新 API 文档和路由配置
- 新增完整的集成测试和单元测试覆盖

openspec/changes/fix-authorization-remark-permission/.openspec.yaml

@@ -0,0 +1,3 @@
+schema: spec-driven
+created: 2026-01-29
+

openspec/changes/fix-authorization-remark-permission/design.md

@@ -0,0 +1,48 @@
+# 授权记录备注修改权限修复 - 设计
+
+## 目标
+
+1. 代理用户无法修改非本人创建的授权记录备注。
+2. 企业用户无法修改任何授权记录备注。
+3. 平台/超级管理员可修改任意授权记录备注。
+4. 任何情况下都必须满足数据可见性（代理只能在自己店铺企业范围内操作）。
+
+## 现状与风险点
+
+- 备注更新当前仅按 `id` 更新，缺少“创建者/可见性”约束。
+- 现有数据权限 callback 主要作用于 Query，不覆盖 Update，因此必须在业务链路显式校验。
+
+## 方案
+
+### 1) Service 层统一鉴权
+
+在 `AuthorizationService.UpdateRecordRemark` 内新增权限判断：
+
+- 取当前用户信息（user_id/user_type/shop_id/enterprise_id）
+- 先通过 `GetByIDWithJoin` 获取授权记录详情（包含 `authorized_by`、`enterprise_id` 等）
+- 按规则判断：
+  - 平台/超级管理员：允许
+  - 代理：
+    - 必须 `record.AuthorizedBy == 当前 user_id`
+    - 且授权记录对应企业必须属于当前店铺（`enterprise.owner_shop_id == shop_id`，可通过 join 查询或使用现有原生 SQL 结果）
+  - 企业：直接拒绝
+
+### 2) Store 层更新增加约束（防御性）
+
+提供一个“带约束”的更新方法（示例语义）：
+- 平台路径：`UpdateRemarkByID(id, remark)`
+- 代理路径：`UpdateRemarkByIDAndAuthorizedBy(id, remark, userID)`（必要时再加 enterprise 范围约束）
+
+确保即使上层遗漏判断，也难以越权更新成功。
+
+### 3) 错误与返回
+
+- 无权限：返回统一错误码（例如 `CodeForbidden`），错误信息使用中文并可被前端直接展示。
+
+## 验收标准
+
+- 平台用户可修改任意授权记录备注。
+- 代理用户仅可修改自己创建的授权记录备注；修改他人创建的记录必须失败。
+- 企业用户调用修改备注接口必须失败。
+- 新增/更新用例后相关集成测试通过。
+

openspec/changes/fix-authorization-remark-permission/proposal.md

@@ -0,0 +1,25 @@
+# 授权记录备注修改权限修复
+
+## Why
+
+当前“授权记录备注修改”链路缺少明确的权限边界校验：代理用户可能通过接口修改不属于自己创建的授权记录备注；企业用户也需要被明确禁止修改。
+
+该问题会导致越权修改、审计信息失真，属于高风险权限缺陷。
+
+## What Changes
+
+- **权限规则落地**：
+  - 平台/超级管理员：可修改任意授权记录备注
+  - 代理：仅可修改“自己创建的授权记录”的备注（且必须在其可见数据范围内）
+  - 企业：禁止修改授权记录备注
+- **服务端强校验**：在 Service 层统一做权限判断与可见性校验，Store 层更新语句增加必要约束，避免仅凭 `id` 更新造成越权。
+- **补充测试**：新增集成测试覆盖平台/代理/企业三种用户场景，确保规则稳定。
+
+## Impact
+
+涉及文件（预期）：
+- Handler：`internal/handler/admin/authorization.go`
+- Service：`internal/service/enterprise_card/authorization_service.go`
+- Store：`internal/store/postgres/enterprise_card_authorization_store.go`
+- 测试：`tests/integration/authorization_test.go`（或新增对应用例文件）
+

openspec/changes/fix-authorization-remark-permission/tasks.md

@@ -0,0 +1,18 @@
+# 授权记录备注修改权限修复 - 实现任务
+
+## 1. 权限规则实现
+
+- [ ] 1.1 在 `internal/service/enterprise_card/authorization_service.go` 中为 `UpdateRecordRemark` 增加权限校验：平台全量、代理仅本人创建、企业禁止
+- [ ] 1.2 在 `internal/store/postgres/enterprise_card_authorization_store.go` 增加带约束的更新方法（至少支持 `id + authorized_by` 约束）
+- [ ] 1.3 更新 `internal/handler/admin/authorization.go`：将权限失败场景返回统一错误（中文错误消息）
+
+## 2. 测试
+
+- [ ] 2.1 为平台用户新增集成测试：可修改任意授权记录备注
+- [ ] 2.2 为代理用户新增集成测试：可修改本人创建记录、不可修改他人创建记录
+- [ ] 2.3 为企业用户新增集成测试：调用修改备注接口必须失败
+
+## 3. 验证
+
+- [ ] 3.1 运行 `go test ./...` 确保通过
+