wangjia
d88c1ae647
手动合并 tsk_x7wrlA87orsY（设备管理 + 订阅校验中间件）到 main：
冲突解决：
- server/internal/apierr/apierr.go：保留 tsk_GXDoc3Cs07Rn 版本（New/StatusFor/
Middleware/ErrConflict/改善文档），并入 tsk_x7wrlA87orsY 新增的 ErrAccountBanned
及对应 StatusFor case（→ 403）。
新增文件（来自 tsk_x7wrlA87orsY）：
- server/internal/devices/doc.go package 文档（替换占位 stub）
- server/internal/devices/context.go CtxKeyUserID / Plan / WithPlan / PlanFromCtx
- server/internal/devices/handler.go GET /v1/me/devices · DELETE /v1/me/devices/{id}
- server/internal/devices/middleware.go SubscriptionMiddleware · CheckDeviceQuota · RequirePaidTier
- server/internal/devices/service.go RegisterIfAbsent / DeleteDevice / ResolvePlan + 纯函数 resolveEffectivePlan
- server/internal/devices/store.go MySQL 数据访问层
- server/internal/devices/service_test.go 15 个单测（全通过）
- server/internal/devices/devices_integration_test.go testcontainers 集成测试
OpenAPI 更新（来自 tsk_x7wrlA87orsY）：
- server/api/openapi.yaml：SubscriptionInfo.source 枚举补 free
- design/server/openapi.yaml：SubscriptionInfo.source 枚举补 admin, free
测试：go build ./... ✓；go test ./internal/apierr/... ✓（8 tests）；
go test ./internal/devices/... ✓（15 tests）。
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
19 lines
1.0 KiB
Go
19 lines
1.0 KiB
Go
// Package devices manages user devices (uuid, name, platform, last_seen) and
|
|
// owns subscription resolution for the rest of the API.
|
|
//
|
|
// Devices are registered implicitly on first connect (RegisterIfAbsent) and
|
|
// removed via DELETE /v1/me/devices/{id}. Removal hard-deletes the row, writes
|
|
// an audit_log entry, and triggers per-user data-plane credential recall
|
|
// through the CredentialRevoker interface (satisfied by nodes.Hub in module #5).
|
|
// Because the credential model is per-user (users.dp_uuid; the node side has no
|
|
// device dimension, doc/02 §3.2), "revoke a device" is realised as recalling
|
|
// the owning user's credential.
|
|
//
|
|
// SubscriptionMiddleware resolves the caller's highest-tier non-expired
|
|
// subscription (falling back to the free plan) and injects the plan
|
|
// {plan_code, expires_at, max_devices, daily_minutes, ad_gate} into the request
|
|
// context, where nodes (catalogue filtering / connect) and usage (daily caps)
|
|
// read it via PlanFromCtx. Plan numbers follow design/CLAUDE.md §7:
|
|
// free 1 / pro 5 / team 10 devices.
|
|
package devices
|