wangdl/ios-projects
2
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

IOS-INFO-012：Rust Event → UploadItem 映射 #120

New Issue
Closed
opened 2026-06-10 21:28:12 +08:00 by wangdl · 1 comment
wangdl commented 2026-06-10 21:28:12 +08:00
Owner
Copy Link

目标

将 Rust ReadingEvent V2 映射为 API ReadingEventUploadItem。

依赖说明

  1. 映射依赖 Runtime ReadingEvent V2 输出格式。
  2. UploadItem 中 platform / appVersion / clientTimezoneOffsetMinutes 来自 AppContext。
  3. AppContext 由 IOS-INFO-038 提供。
  4. readingTargetType / knowledgeBaseId 来自 ReadingMaterialContext。

映射表

  • Rust eventId → UploadItem.eventId
  • Rust clientSessionId → UploadItem.clientSessionId
  • Rust materialId → UploadItem.materialId
  • Context readingTargetType → UploadItem.readingTargetType
  • Context knowledgeBaseId → UploadItem.knowledgeBaseId
  • Rust eventType → UploadItem.eventType
  • Rust position → UploadItem.position
  • Rust activeSecondsDelta → UploadItem.activeSecondsDelta
  • Rust timestampMs → UploadItem.clientTimestamp
  • Rust sequence → UploadItem.sequence
  • AppContext platform → UploadItem.platform
  • AppContext appVersion → UploadItem.appVersion
  • AppContext timezone → UploadItem.clientTimezoneOffsetMinutes

验收标准

  1. 所有字段映射完整。
  2. Rust 不提供的业务字段由 ReadingMaterialContext / AppContext 补充。
  3. timestampMs 转 Date 正确。
  4. timezone offset 正确。
  5. position 保持 camelCase。
  6. 缺少 required 字段时映射失败并记录。
  7. 有映射测试。
## 目标 将 Rust ReadingEvent V2 映射为 API ReadingEventUploadItem。 ## 依赖说明 1. 映射依赖 Runtime ReadingEvent V2 输出格式。 2. UploadItem 中 platform / appVersion / clientTimezoneOffsetMinutes 来自 AppContext。 3. AppContext 由 IOS-INFO-038 提供。 4. readingTargetType / knowledgeBaseId 来自 ReadingMaterialContext。 ## 映射表 - Rust eventId → UploadItem.eventId - Rust clientSessionId → UploadItem.clientSessionId - Rust materialId → UploadItem.materialId - Context readingTargetType → UploadItem.readingTargetType - Context knowledgeBaseId → UploadItem.knowledgeBaseId - Rust eventType → UploadItem.eventType - Rust position → UploadItem.position - Rust activeSecondsDelta → UploadItem.activeSecondsDelta - Rust timestampMs → UploadItem.clientTimestamp - Rust sequence → UploadItem.sequence - AppContext platform → UploadItem.platform - AppContext appVersion → UploadItem.appVersion - AppContext timezone → UploadItem.clientTimezoneOffsetMinutes ## 验收标准 1. 所有字段映射完整。 2. Rust 不提供的业务字段由 ReadingMaterialContext / AppContext 补充。 3. timestampMs 转 Date 正确。 4. timezone offset 正确。 5. position 保持 camelCase。 6. 缺少 required 字段时映射失败并记录。 7. 有映射测试。
wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 21:28:12 +08:00
wangdl added the
blocked-by:doc-runtime
 label 2026-06-10 22:15:58 +08:00
wangdl commented 2026-06-12 21:38:57 +08:00
Author
Owner
Copy Link

开发完成评论

完成内容

  • ReadingEventMapper 重构为使用 AppContext（IOS-INFO-038）：
    • map() 和 mapOne() 参数从 appVersion: String 改为 appContext: AppContext
    • platform/appVersion/clientTimezoneOffsetMinutes 统一从 AppContext 读取
    • 每次映射调用 AppContext.refreshed() 更新时区偏移（跨时区安全）
  • 映射表完整：
    • Rust 字段：eventId, clientSessionId, materialId, eventType, position, activeSecondsDelta, timestampMs, sequence
    • Context 字段：readingTargetType, knowledgeBaseId
    • AppContext 字段：platform, appVersion, clientTimezoneOffsetMinutes
  • 新建 AIStudyAppTests/EventMapperTests.swift（8 个测试）：
    • 5 种 eventType → snake_case 字符串
    • AppContext 字段集成验证
    • 无 context 返回 nil
    • 全部 eventType 有映射
    • timezone refresh 每次调用

修改文件

  • Features/MaterialReader/ReadingEventMapper.swift：参数从 appVersion: String 改为 appContext: AppContext
  • AIStudyAppTests/EventMapperTests.swift：新建

验收标准逐项

  1. 所有字段映射完整 — ✅ 13 个字段全部映射
  2. Rust 不提供的由 Context/AppContext 补充 — ✅ readingTargetType/knowledgeBaseId/platform/appVersion/timezone
  3. timestampMs 转 Date 正确 — ✅ clientTimestampMs: Int64 毫秒精度
  4. timezone offset 正确 — ✅ appContext.refreshed().clientTimezoneOffsetMinutes
  5. position 保持 camelCase — ✅ UniFFI enum 自带 camelCase
  6. 缺少 required 字段时映射失败并记录 — ✅ guard let ctx → nil + print log
  7. 有映射测试 — ✅ 8 个测试

是否建议进入 Review

  • 是（需 Xcode 编译验证）
## 开发完成评论 ### 完成内容 - `ReadingEventMapper` 重构为使用 `AppContext`（IOS-INFO-038）： - `map()` 和 `mapOne()` 参数从 `appVersion: String` 改为 `appContext: AppContext` - `platform`/`appVersion`/`clientTimezoneOffsetMinutes` 统一从 `AppContext` 读取 - 每次映射调用 `AppContext.refreshed()` 更新时区偏移（跨时区安全） - 映射表完整： - Rust 字段：eventId, clientSessionId, materialId, eventType, position, activeSecondsDelta, timestampMs, sequence - Context 字段：readingTargetType, knowledgeBaseId - AppContext 字段：platform, appVersion, clientTimezoneOffsetMinutes - 新建 `AIStudyAppTests/EventMapperTests.swift`（8 个测试）： - 5 种 eventType → snake_case 字符串 - AppContext 字段集成验证 - 无 context 返回 nil - 全部 eventType 有映射 - timezone refresh 每次调用 ### 修改文件 - `Features/MaterialReader/ReadingEventMapper.swift`：参数从 `appVersion: String` 改为 `appContext: AppContext` - `AIStudyAppTests/EventMapperTests.swift`：新建 ### 验收标准逐项 1. 所有字段映射完整 — ✅ 13 个字段全部映射 2. Rust 不提供的由 Context/AppContext 补充 — ✅ readingTargetType/knowledgeBaseId/platform/appVersion/timezone 3. timestampMs 转 Date 正确 — ✅ `clientTimestampMs: Int64` 毫秒精度 4. timezone offset 正确 — ✅ `appContext.refreshed().clientTimezoneOffsetMinutes` 5. position 保持 camelCase — ✅ UniFFI enum 自带 camelCase 6. 缺少 required 字段时映射失败并记录 — ✅ `guard let ctx` → nil + print log 7. 有映射测试 — ✅ 8 个测试 ### 是否建议进入 Review - 是（需 Xcode 编译验证）
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:ai
AI对话
area:analysis
分析页
area:auth
认证/Apple登录
area:import
文件导入
area:ios-info
iOS 学习信息采集与上传
area:library
知识库
area:notification
通知推送
area:profile
我的页面
area:quiz
测验/自测
area:review
复习卡片
area:search
搜索
area:study
学习首页
audit:planned
已完成宏观规划
blocked-by:api
等待 API 接口
blocked-by:api-info-core
等待 API 学习信息体系核心
blocked-by:doc-runtime
等待 Rust document runtime
priority:p0
最高优先级
priority:p1
高优先级
priority:p2
中优先级
repo:ios
iOS App 仓库
status:blocked
被阻塞
status:done
已完成
status:partial
部分存在，需补全
status:todo
待执行
type:bug
缺陷修复
type:docs
文档
type:feature
新功能
type:ui
UI/UX
work:adapter
适配器
work:analysis
分析页
work:api-client
API Client
work:api-contract
API 契约
work:architecture
架构
work:auth
认证
work:background
后台
work:bg-task
BGTask
work:compatibility
兼容性
work:context
阅读上下文
work:continue-learning
继续学习
work:debug
调试
work:design
架构设计
work:developer-tool
开发者工具
work:diagnostics
诊断
work:docs
文档
work:dto
DTO/数据传输
work:e2e
端到端
work:error-handling
错误处理
work:event
事件
work:event-chain
事件链路
work:event-export
事件导出
work:ffi
FFI 绑定
work:flush
刷新推送
work:heartbeat
心跳计时
work:heatmap
热力图
work:history
历史
work:home
首页
work:integration
接入
work:lifecycle
生命周期
work:local-cache
本地缓存
work:local-queue
本地队列
work:logging
日志
work:mapping
字段映射
work:marked-as-read
标记已读
work:material-detail
资料详情
work:model
数据模型
work:network
网络
work:offline
离线
work:permission
权限
work:persistence
持久化
work:position
阅读位置
work:queue
队列
work:reader-view
阅读器视图
work:reading-progress
阅读进度
work:records
学习记录
work:recovery
恢复
work:restore
位置恢复
work:retry
重试
work:routing
路由
work:runtime
Runtime 接入
work:rust-runtime
Rust document runtime
work:scheduler
调度器
work:session-manager
会话管理
work:state
状态管理
work:summary
Summary
work:test
测试
work:time-tracking
时长追踪
work:trend
趋势
work:ui
UI
work:upload
上传
No Label
area:ios-info
audit:planned
blocked-by:doc-runtime
priority:p0
repo:ios
status:todo
work:dto
work:mapping
Milestone
No items
No Milestone M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环
Projects
Clear projects
No project
Assignees
Clear assignees
suyun-Claude wangdl
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/ios-projects#120
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?