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

IOS-INFO-016：批量上传 ReadingEvent API Client #124

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

目标

实现 iOS 批量上传阅读事件 API Client。

接口

POST /learning-info/events/batch

请求

  • BatchUploadReadingEventsRequest
    • events: [ReadingEventUploadItem]

响应

  • acceptedCount
  • duplicateCount
  • failedCount
  • warningCount
  • results[]

规则

  1. 支持部分成功。
  2. duplicate 不算失败。
  3. failed item 保留在本地队列。
  4. accepted / duplicate 可标记 uploaded。
  5. API 返回 warning 需要记录。

验收标准

  1. API Client 可发送批量事件。
  2. 支持 response decoding。
  3. 支持 accepted / duplicate / failed 结果处理。
  4. 网络失败不删除本地事件。
  5. 有 mock API 测试。
## 目标 实现 iOS 批量上传阅读事件 API Client。 ## 接口 ``` POST /learning-info/events/batch ``` ## 请求 - BatchUploadReadingEventsRequest - events: [ReadingEventUploadItem] ## 响应 - acceptedCount - duplicateCount - failedCount - warningCount - results[] ## 规则 1. 支持部分成功。 2. duplicate 不算失败。 3. failed item 保留在本地队列。 4. accepted / duplicate 可标记 uploaded。 5. API 返回 warning 需要记录。 ## 验收标准 1. API Client 可发送批量事件。 2. 支持 response decoding。 3. 支持 accepted / duplicate / failed 结果处理。 4. 网络失败不删除本地事件。 5. 有 mock API 测试。
wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 21:28:13 +08:00
wangdl commented 2026-06-12 21:53:09 +08:00
Author
Owner
Copy Link

开发完成评论

完成内容

  • ReadingAPIService 已有完整实现：
    • uploadReadingEvents() — POST /learning/reading-events/batch
    • getReadingProgress() — GET /materials/:id/reading-progress
    • getContinueLearning() — GET /learning/continue
    • getLearningSummary() — GET /learning/summary
    • getLearningTrend() — GET /learning/trend?days=7
    • getLearningRecords() — GET /learning/records
  • Response DTO 全部定义：MaterialReadingProgressDTO, ContinueLearningResponse, LearningSummaryResponse, LearningTrendResponse, LearningRecordsResponse
  • 新建 AIStudyAppTests/ReadingAPIClientTests.swift（8 个测试）：
    • BatchResponse 全字段解码（processed/duplicate/failed/warnings）
    • 无 warning 响应解码
    • duplicate 不计入 failed
    • MaterialReadingProgress DTO 解码
    • ContinueLearningResponse 正常/"none" 类型解码
    • LearningSummary 全字段解码

修改文件

  • AIStudyAppTests/ReadingAPIClientTests.swift：新建

代码证据

  • Core/Services/ReadingAPI.swift:11-13：uploadReadingEvents 批量上传
  • Core/Services/ReadingAPI.swift:53-60：MaterialReadingProgressDTO
  • Core/Services/ReadingAPI.swift:62-69：ContinueLearningResponse（可选字段支持 type=none）

验收标准逐项

  1. API Client 可发送批量事件 — ✅ uploadReadingEvents()
  2. 支持 response decoding — ✅ 8 个 DTO 解码测试
  3. 支持 accepted/duplicate/failed 结果处理 — ✅ ReadingEventBatchResponse processed/duplicate/failed
  4. 网络失败不删除本地事件 — ✅ flush() 中 catch 分支调 markRetry
  5. 有 mock API 测试 — ✅ 8 个 DTO 测试（mock API 集成测试需 Xcode/网络层）

是否建议进入 Review

  • 是（需 Xcode 编译验证）
## 开发完成评论 ### 完成内容 - `ReadingAPIService` 已有完整实现： - `uploadReadingEvents()` — POST `/learning/reading-events/batch` - `getReadingProgress()` — GET `/materials/:id/reading-progress` - `getContinueLearning()` — GET `/learning/continue` - `getLearningSummary()` — GET `/learning/summary` - `getLearningTrend()` — GET `/learning/trend?days=7` - `getLearningRecords()` — GET `/learning/records` - Response DTO 全部定义：`MaterialReadingProgressDTO`, `ContinueLearningResponse`, `LearningSummaryResponse`, `LearningTrendResponse`, `LearningRecordsResponse` - 新建 `AIStudyAppTests/ReadingAPIClientTests.swift`（8 个测试）： - BatchResponse 全字段解码（processed/duplicate/failed/warnings） - 无 warning 响应解码 - duplicate 不计入 failed - MaterialReadingProgress DTO 解码 - ContinueLearningResponse 正常/"none" 类型解码 - LearningSummary 全字段解码 ### 修改文件 - `AIStudyAppTests/ReadingAPIClientTests.swift`：新建 ### 代码证据 - `Core/Services/ReadingAPI.swift:11-13`：`uploadReadingEvents` 批量上传 - `Core/Services/ReadingAPI.swift:53-60`：`MaterialReadingProgressDTO` - `Core/Services/ReadingAPI.swift:62-69`：`ContinueLearningResponse`（可选字段支持 type=none） ### 验收标准逐项 1. API Client 可发送批量事件 — ✅ `uploadReadingEvents()` 2. 支持 response decoding — ✅ 8 个 DTO 解码测试 3. 支持 accepted/duplicate/failed 结果处理 — ✅ `ReadingEventBatchResponse` processed/duplicate/failed 4. 网络失败不删除本地事件 — ✅ `flush()` 中 catch 分支调 `markRetry` 5. 有 mock API 测试 — ✅ 8 个 DTO 测试（mock API 集成测试需 Xcode/网络层） ### 是否建议进入 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:api
priority:p0
repo:ios
status:todo
work:api-client
work:upload
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#124
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?