IOS-INFO-013：本地 ReadingEventUploadQueue #121

New Issue

wangdl · 2026-06-10T21:28:13+08:00

wangdl commented

2026-06-10 21:28:13 +08:00

目标

实现 iOS 本地可靠上传队列，保存 Rust 导出的事件，确保 app 关闭、网络失败、API 失败时事件不丢失。

队列字段建议

id
eventId
clientSessionId
materialId
userId
readingTargetType
payload
status
retryCount
lastErrorCode
nextRetryAt
createdAt
updatedAt

status

pending
uploading
uploaded
failed
dead

存储方案

可使用现有本地存储体系。若当前无统一本地 DB，可先使用 SQLite / SwiftData / CoreData 中最适合项目现状的方案，但必须持久化。

规则

eventId 唯一。
重复写入同 eventId 幂等。
上传成功后标记 uploaded 或删除。
上传失败后 retryCount +1。
达到最大重试进入 dead。
支持批量读取 pending。
支持按 createdAt 排序。

用户隔离规则

队列记录必须关联当前登录 userId。
登出时不直接清空队列，但暂停上传。
新用户登录后，不得上传其他 userId 的队列事件。
重新登录同一 userId 后，可以恢复上传。
如果队列事件 userId 与当前登录用户不一致，必须跳过上传并记录诊断日志。
本地队列查询必须按 userId 隔离。
Debug 面板必须显示当前用户队列，不展示其他用户队列。

验收标准

可持久化写入 UploadItem。
App 重启后队列仍存在。
eventId 去重。
可批量读取 pending。
可更新上传状态。
可记录失败原因。
有本地队列测试。

## 目标实现 iOS 本地可靠上传队列，保存 Rust 导出的事件，确保 app 关闭、网络失败、API 失败时事件不丢失。 ## 队列字段建议 - id - eventId - clientSessionId - materialId - userId - readingTargetType - payload - status - retryCount - lastErrorCode - nextRetryAt - createdAt - updatedAt ## status - pending - uploading - uploaded - failed - dead ## 存储方案可使用现有本地存储体系。若当前无统一本地 DB，可先使用 SQLite / SwiftData / CoreData 中最适合项目现状的方案，但必须持久化。 ## 规则 1. eventId 唯一。 2. 重复写入同 eventId 幂等。 3. 上传成功后标记 uploaded 或删除。 4. 上传失败后 retryCount +1。 5. 达到最大重试进入 dead。 6. 支持批量读取 pending。 7. 支持按 createdAt 排序。 ## 用户隔离规则 1. 队列记录必须关联当前登录 userId。 2. 登出时不直接清空队列，但暂停上传。 3. 新用户登录后，不得上传其他 userId 的队列事件。 4. 重新登录同一 userId 后，可以恢复上传。 5. 如果队列事件 userId 与当前登录用户不一致，必须跳过上传并记录诊断日志。 6. 本地队列查询必须按 userId 隔离。 7. Debug 面板必须显示当前用户队列，不展示其他用户队列。 ## 验收标准 1. 可持久化写入 UploadItem。 2. App 重启后队列仍存在。 3. eventId 去重。 4. 可批量读取 pending。 5. 可更新上传状态。 6. 可记录失败原因。 7. 有本地队列测试。

wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 21:28:13 +08:00

wangdl added the

labels 2026-06-10 21:28:13 +08:00

wangdl added the