26 lines
1.5 KiB
Markdown
26 lines
1.5 KiB
Markdown
|
|
# 用户产品归属查询
|
|||
|
|
|
|||
|
|
操作时间:2026-09-11
|
|||
|
|
操作类型:新增
|
|||
|
|
影响模块:用户 App API
|
|||
|
|
|
|||
|
|
## 行为与接口
|
|||
|
|
|
|||
|
|
新增受用户端 JWT 和客户端类型校验保护的 `GET /heqi/client/v1/user/owned-products`。
|
|||
|
|
只读取当前登录用户拥有且启用、未软删除的 `product_info`,不使用历史归属授予访问权,也不接受请求参数指定其他用户。
|
|||
|
|
|
|||
|
|
返回 `items`、`page`、`page_size`、`has_more`。默认每页 30 条,显式分页沿用现有范围校验,最多 100 条。
|
|||
|
|
每项仅含 `identity`、`name`、`code`、`product_status`、`control_available`、`telemetry_available`。
|
|||
|
|
两个能力标志均为 false;产品档案同时涵盖钢瓶和瓶阀,不能据此宣称存在可控制设备或实时遥测。
|
|||
|
|
|
|||
|
|
## 代码和验证
|
|||
|
|
|
|||
|
|
- `backend/api/internal/logic/client/user/owned_products.go`:新增当前归属查询和分页响应。
|
|||
|
|
- `backend/api/internal/routers/client.go`:新增一个鉴权路由。
|
|||
|
|
- `backend/api/internal/logic/client/user/owned_products_test.go`:校验登录用户隔离、默认和显式分页、响应白名单及未开放能力。
|
|||
|
|
- `go test ./internal/logic/client/user ./internal/routers` 通过。
|
|||
|
|
|
|||
|
|
## 当前限制
|
|||
|
|
|
|||
|
|
此轮仅完成接口基础,不代表“我的设备”页面完成或通过设计验收。尚未接入前端、重启 API 或进行远程数据和浏览器联调。未改动远程数据库结构或数据,也没有启动本地数据库。设备类型分类和真实遥测来源还需继续核对现有协议与实现。
|