zyc/lty
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
123 Commits 3 Branches 0 Tags
Commit Graph

13 Commits

Author SHA1 Message Date
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
pmc
f26e78c545 feat(affinity-P2): service 层落地 — 唯一写入入口 + Redis 计数器 + 等级映射 + 跨级奖励 + WS 推送 (P2-01~P2-05) 
新增 6 个模块，把好感度变化的全部副作用收敛到一个调用入口：

- counters.py (P2-02)：Redis 三类计数器
  - affinity💿{device_id}:{rule_key} 冷却
  - affinity:daily:{device_id}:{rule_key}:{YYYYMMDD} 单规则日上限
  - affinity:daily:{device_id}:_global:{YYYYMMDD} 全局正向日上限
  - 自然日按 AffinitySetting.timezone (Asia/Shanghai 默认) 通过 zoneinfo 计算
  - cache.add + cache.incr 实现 set-if-not-exists + atomic-incr 语义，TTL 48h
  - event_id 60s 去重防客户端重复上报

- levels.py (P2-03)：等级映射
  - map_value_to_level / update_device_level / progress_to_next_level
  - update_device_level 仅 level 变化时 save(update_fields=['affinity_level'])

- ws.py (P2-05)：WebSocket 推送 helper
  - 3 类事件 affinity_update / level_up / level_down
  - asgiref.async_to_sync 包装 channel_layer.group_send
  - 推送故障 fire-and-forget 仅日志记录，不阻塞主流程

- rewards.py (P2-04)：跨级奖励发放（A3 方案 B）
  - grant_levels(user_device, from_level, to_level) 逐级独立事务
  - UserLevelRewardGrant 唯一约束保证幂等（决策 11：衰减回升不补发）
  - _dispatch_reward_to_external_systems 是 STUB，P3/P4 接虚拟货币/道具 app 时实现

- services.py (P2-01)：AffinityService 主入口
  - apply(user_id, device_id, rule_key, source, event_id, metadata, operator_admin_id, reason)
  - 10 步流水线 [event_id 去重 → 取规则 → 冷却 → 取 UserDevice.active → 计算 + single_cap 钳位 → 规则日上限 → 全局日上限 → 原子写库 → Redis 累加 → 奖励 → WS 推送]
  - admin_adjust 绕过 rule 与冷却，但走 [0, max_affinity] 钳位 + log + 等级缓存 + 奖励 + WS
  - 返回 ApplyResult dataclass 含 ApplyOutcome 枚举（applied / noop_no_rule / noop_cooldown / noop_*_daily_cap / noop_event_duplicate / noop_value_boundary / error）

- permissions.py：IsAdminUserStaff 复用 IsAuthenticated + is_staff 检查

Smoke test 6 项全 PASS：no_rule / chat applied / event_id 去重 / 冷却拦截 / admin_adjust / max_affinity 钳位。
AffinityLog 写库 / UserLevelRewardGrant 幂等 / level 缓存更新 均经事务原子保证。

设计依据：docs/好感度系统功能与规则设计.md §4.3 触发流程 + §6 等级规则 + §9 数据契约。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-05-14 09:35:53 +08:00
pmc
61e8374e6a fix(affinity-P1): WR-002~WR-009 + IN-001~IN-006 综合改进收尾 
WR-002 UserLevelRewardGrant.device on_delete CASCADE → SET_NULL，加 device_snapshot_id，
  unique 改为 partial（device 非空时唯一），与 AffinityLog.device SET_NULL 对齐
WR-003 AffinityLog 删除 3 个低价值索引（user/rule_key/source -created_at 复合）
WR-004 event_id 改为 null=True，partial unique 用 isnull=False；RunPython '' → NULL
WR-005 seed 加 companion_30min 默认规则
WR-006 description 显式 default=''；DEFAULT_LEVELS 全部补 description
WR-007 seed_affinity 每条 spec 独立事务，部分失败可重跑
WR-008 ParadiseUser.favorability 字段保留 + UserInfoSerializer 移除暴露 + [DEPRECATED] 标记
WR-009（见 Commit B：AffinityLevel.clean + save full_clean 多层兜底）
IN-001 5 个弃用字段 help_text 加 [DEPRECATED — 计划于 P2 完成后删除]
IN-002 DEFAULT_RULES/LEVELS/SETTING 抽到 userapp/affinity/defaults.py
IN-003 AffinitySetting.daily_cap RenameField → global_daily_cap（区分 AffinityRule.daily_cap）
IN-004 AffinityLog.__str__ 用 pk or 'new' 兜底 None
IN-005（见 Commit A：is_active → is_bound 改名）
IN-006（见 Commit C：0006 print 前缀改为 [migration 0006_...]）

迁移 0009 手工修正：daily_cap 改名用 RenameField（保留数据），不是 Remove+Add；
event_id '' → NULL 数据兜底；UserLevelRewardGrant on_delete + conditional unique 重建。

详见 docs/REVIEW-affinity-P1.md WR-* / IN-* 与 FIX-REPORT.md。
 2026-05-13 10:18:47 +08:00
pmc
2a28aa8b28 fix(affinity-P1): CR-003 修正 0006 数据迁移幂等性 
旧 forward 用 target.favorability == 10 判断"未迁移"，10 既是初始值也是衰减
常见值，重跑会覆盖合法数据；backward 用 != 10 反向判断会丢衰减回 10 的数据。

改用 AffinityLog source='data_migration' 标记做幂等：
  - forward 写入新值时同步写一条 audit log，metadata 含原 ParadiseUser 值
  - backward 遍历 audit log 反向恢复并删除标记，保证 forward/backward 可循环

同步：AffinityLog.SOURCE_CHOICES 追加 'data_migration' + 0008 AlterField 迁移
更新 Python 端 choices 校验。

option B 选择：直接重写 0006（dev 已跑过但 migrate_count=0 等于未动数据，
django_migrations 表已记录完成不会再跑）。生产部署前需确认 prod 未跑过 0006，
否则需 fake-reverse 流程，详见迁移文件 docstring 与 FIX-REPORT。

详见 docs/REVIEW-affinity-P1.md CR-003。
 2026-05-13 10:13:31 +08:00
pmc
9a87f5e2b5 fix(affinity-P1): CR-002 + WR-001 加 Affinity 模型 DB CHECK 约束 + 单例硬约束 
AffinityRule / AffinityLevel / AffinitySetting 三表共 13 条 CheckConstraint
覆盖 min ≤ max / 各类 cap > 0 / cooldown ≥ 0 / companion_time 配套字段必填 /
decay 区间合法 / initial ≤ max 等不变量。

AffinitySetting 加 pk=1 单例硬约束（CR-002 + WR-001 联动）+ save() 强制 pk=1，
形成事实单例防御并发首次插入重复行。

模型 clean() 提供 Python 级兜底（给 DRF / admin 友好错误信息）；
AffinityLevel.save() 自动 full_clean 触发跨行区间不重叠校验（为 WR-009 铺路）。

详见 docs/REVIEW-affinity-P1.md CR-002 / WR-001。
 2026-05-13 10:12:01 +08:00
pmc
33b302c773 fix(affinity-P1): CR-001 + IN-005 修复 UserDevice 软删语义 + is_bound 改名 
UserDevice.is_active 改名为 is_bound（消除与 Device.is_active 的命名冲突），
新增 ActiveUserDeviceManager（active manager），4 处控制权解析调用点
（MAC 登录、bind_status、绑定校验、RTC token、绑定 endpoint）切换到
UserDevice.active.filter(...)，避免 P2 软删后旧绑定者被签发 user-token、
WS 分组路由错误、RTC 房间归属错乱等安全 / 越权风险。

base_manager_name='objects' 保证 admin 默认 queryset 不受 active 过滤影响。

详见 docs/REVIEW-affinity-P1.md CR-001 / IN-005。
 2026-05-13 10:10:14 +08:00
pmc
9d020218d2 feat(02-01): 注册 /api/v1/admin/credential-slot/ 路由 
- path('credential-slot/', CredentialSlotAdminView.as_view(), name='admin_credential_slot')
- 与 admin_login / admin_logout 在同一 admin namespace 注册块
- 路由汇总点单一：仅 userapp/admin_urls.py 注册，aiapp/urls.py 不重复
- reverse('admin_credential_slot') = /api/v1/admin/credential-slot/
- python manage.py check 通过（唯一 W004 STATICFILES_DIRS 与本 plan 无关）
 2026-05-07 22:54:25 +08:00
pmc
2d82b2ef7f feat: implement affinity (favorability) system
All checks were successful
Build and Deploy LTY / build-and-deploy (push) Successful in 8m44s
Details 
- Add affinity level/setting models and migrations
- Migrate favorability data to UserDevice
- Add management commands for userapp
- Add admin CLAUDE.md and docs
- Update affinity system design doc and task checklist
- Update device_interaction and userapp models

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-06 17:18:30 +08:00
pmc
e57f681040 feat: update userapp views
All checks were successful
Build and Deploy LTY / build-and-deploy (push) Successful in 1h9m26s
Details 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 18:48:04 +08:00
pmc
90c6feb5a5 feat: update userapp utils
All checks were successful
Build and Deploy LTY / build-and-deploy (push) Successful in 11m52s
Details 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-13 11:05:23 +08:00
pmc
afa88c142b feat: 实现设备动态绑定方案（步骤1-5） 
- 步骤1: MacAddressLoginView 增强，返回 code=4010(未绑定)/4011(不存在)，支持自动激活
- 步骤2: 新增 bind_status 接口，设备端轮询查询绑定状态（无需认证）
- 步骤3: 新增 register 设备自注册接口，首次开机自动注册（无需认证）
- 步骤4: UserDeviceSerializer 增加 mac_address 字段
- 步骤5: WebSocket 新增 device_info 消息类型，支持设备状态上报和广播

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-20 15:53:33 +08:00
pmc
bd95ba470c feat: update admin panel, API modules, and add migrations 
- Update food, outfits, props, home-decor pages and components
- Add permissions page and sidebar updates
- Update API client and all API modules (auth, food, dances, etc.)
- Add card model migrations for optional fields
- Update Django views, serializers, and authentication
- Add affinity level migrations and user app updates
- Add project documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-20 13:06:50 +08:00
zyc
0c610c1e49 first commit 2026-03-17 13:17:02 +08:00