lty/affinity at 8e7b87cbd2c1c33f041d2dfa0ecf9a1bca657186 - lty

zyc/lty

History

pmc 7c79b72544 feat(affinity-P2): admin API — Rule/Level CRUD + Setting + Logs + Stats + Devices + Adjust (P2-06~P2-12)

新增 admin 管理端完整 API，挂载在 /api/v1/admin/affinity/ 路径下：

- serializers.py：9 个序列化器
  - AffinityRuleSerializer / AffinityLevelSerializer / AffinitySettingSerializer
    含跨字段 validate（min/max 关系、区间重叠、衰减区间、companion_time 字段必填等）
  - AffinityLogSerializer 只读 + 关联字段展开（user_username/device_code/rule_name）
  - UserDeviceAffinitySerializer 含 device_code/mac/status/level_name
  - AffinityAdjust + AffinityAdjustBatch 用 Serializer 而非 ModelSerializer
  - permissions.py 中 IsAdminUserStaff 复用，所有 view 默认 RedisTokenAuthentication + IsAdminUserStaff

- views.py：7 个视图
  - AffinityRuleAdminViewSet (P2-06)：ModelViewSet + 软删 (is_deleted+is_enabled=False) + restore action；?include_deleted=true 返回全集
  - AffinityLevelAdminViewSet (P2-07)：同上软删；serializer 跨字段校验区间重叠
  - AffinitySettingView (P2-08)：APIView 单例 GET/PUT/PATCH；pk=1 硬约束
  - AffinityLogListView (P2-09)：过滤 user_id/device_id/rule_key/source/date_from/date_to；分页 page_size 上限 200；select_related 防 N+1
  - AffinityStatsView (P2-10)：avg/max/top_count/active_7d/total_devices/today_interactions/today_change_sum/rule_freq_top/level_distribution；全部基于 UserDevice.active 聚合；今日按 AffinitySetting.timezone 取 local date
  - UserAffinityDevicesView (P2-11)：?user_id= 必传 + 404 校验；?include_unbound=true 含历史；默认仅 is_bound=True
  - AffinityAdjustView + AffinityAdjustBatchView (P2-12)：委托 AffinityService.admin_adjust；批量遍历 UserDevice.active 逐台调用，返回 per-device 结果数组

- urls.py：DRF DefaultRouter 注册 rules/levels CRUD + 5 个独立 path 挂 settings/logs/stats/devices/adjust*
- admin_urls.py：引入 include 并新增 path('affinity/', include('userapp.affinity.urls'))

Django check 通过，6 URL reverse 全部解析正确：
  /api/v1/admin/affinity/settings/
  /api/v1/admin/affinity/logs/
  /api/v1/admin/affinity/stats/
  /api/v1/admin/affinity/devices/
  /api/v1/admin/affinity/adjust/
  /api/v1/admin/affinity/adjust-batch/

旧的 /api/user/affinity-rules/ 与 /affinity-levels/ 暂保留兼容，前端切到 admin 后即可清理。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-14 09:36:11 +08:00

__init__.py

fix(affinity-P1): WR-002~WR-009 + IN-001~IN-006 综合改进收尾

2026-05-13 10:18:47 +08:00

counters.py

feat(affinity-P2): service 层落地 — 唯一写入入口 + Redis 计数器 + 等级映射 + 跨级奖励 + WS 推送 (P2-01~P2-05)

2026-05-14 09:35:53 +08:00

defaults.py

fix(affinity-P1): WR-002~WR-009 + IN-001~IN-006 综合改进收尾

2026-05-13 10:18:47 +08:00

levels.py

feat(affinity-P2): service 层落地 — 唯一写入入口 + Redis 计数器 + 等级映射 + 跨级奖励 + WS 推送 (P2-01~P2-05)