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

IOS-INFO-038：AppContext 采集与上传上下文 #126

New Issue
Closed
opened 2026-06-10 22:15:05 +08:00 by wangdl · 1 comment
wangdl commented 2026-06-10 22:15:05 +08:00
Owner
Copy Link

目标

定义 iOS 上传阅读事件时需要补充的 AppContext，包括 platform、appVersion、clientTimezoneOffsetMinutes 等字段，供 Rust Event → UploadItem 映射使用。

需要采集的字段

  • platform
  • appVersion
  • buildNumber
  • clientTimezoneOffsetMinutes
  • locale?
  • deviceType?
  • osVersion?

字段来源

platform: iOS 固定为 ios，或根据运行环境区分 ios / ipadOS

appVersion: Bundle.main.infoDictionary["CFBundleShortVersionString"]

buildNumber: Bundle.main.infoDictionary["CFBundleVersion"]

clientTimezoneOffsetMinutes: TimeZone.current.secondsFromGMT() / 60

locale: Locale.current.identifier

deviceType: phone / tablet，按 UIDevice 或当前适配逻辑判断

osVersion: UIDevice.current.systemVersion

规则

  1. AppContext 可在 App 启动时初始化。
  2. 上传前允许重新读取 timezone，避免跨时区长时间运行导致偏差。
  3. AppContext 不包含用户隐私字段。
  4. AppContext 不包含 token。
  5. AppContext 由 iOS 补充，不传给 Rust document runtime。
  6. IOS-INFO-012 映射 UploadItem 时必须使用 AppContext。

验收标准

  1. 新增 AppContext 类型。
  2. 可读取 platform。
  3. 可读取 appVersion。
  4. 可读取 buildNumber。
  5. 可读取 clientTimezoneOffsetMinutes。
  6. IOS-INFO-012 可使用 AppContext 生成 UploadItem。
  7. 有单元测试。
  8. 不依赖 API 实现。
## 目标 定义 iOS 上传阅读事件时需要补充的 AppContext，包括 platform、appVersion、clientTimezoneOffsetMinutes 等字段，供 Rust Event → UploadItem 映射使用。 ## 需要采集的字段 - platform - appVersion - buildNumber - clientTimezoneOffsetMinutes - locale? - deviceType? - osVersion? ## 字段来源 platform: iOS 固定为 ios，或根据运行环境区分 ios / ipadOS appVersion: Bundle.main.infoDictionary["CFBundleShortVersionString"] buildNumber: Bundle.main.infoDictionary["CFBundleVersion"] clientTimezoneOffsetMinutes: TimeZone.current.secondsFromGMT() / 60 locale: Locale.current.identifier deviceType: phone / tablet，按 UIDevice 或当前适配逻辑判断 osVersion: UIDevice.current.systemVersion ## 规则 1. AppContext 可在 App 启动时初始化。 2. 上传前允许重新读取 timezone，避免跨时区长时间运行导致偏差。 3. AppContext 不包含用户隐私字段。 4. AppContext 不包含 token。 5. AppContext 由 iOS 补充，不传给 Rust document runtime。 6. IOS-INFO-012 映射 UploadItem 时必须使用 AppContext。 ## 验收标准 1. 新增 AppContext 类型。 2. 可读取 platform。 3. 可读取 appVersion。 4. 可读取 buildNumber。 5. 可读取 clientTimezoneOffsetMinutes。 6. IOS-INFO-012 可使用 AppContext 生成 UploadItem。 7. 有单元测试。 8. 不依赖 API 实现。
wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 22:15:05 +08:00
wangdl commented 2026-06-12 20:46:54 +08:00
Author
Owner
Copy Link

开发完成评论

完成内容

  • 新建 Core/Models/AppContext.swift（87 行）：
    • 7 个字段：platform, appVersion, buildNumber, clientTimezoneOffsetMinutes, locale, deviceType, osVersion
    • live() 工厂方法：从 Bundle.main + TimeZone.current + UIDevice.current 采集
    • refreshed() 方法：上传前重读时区偏移，避免跨时区漂移
    • platformValue() 区分 ios / ipadOS / macos
    • deviceTypeValue() 区分 phone / tablet
    • Codable + Equatable conformance
    • 不含 token / 隐私字段
  • 新建 AIStudyAppTests/AppContextTests.swift（85 行）：
    • test_appContext_platform_is_ios_or_ipados
    • test_appContext_appVersion_notEmpty
    • test_appContext_buildNumber_notEmpty
    • test_appContext_timezoneOffset_isWithinRange
    • test_appContext_refreshed_updates_timezone
    • test_appContext_codable_roundtrip — JSON 编解码往返
    • test_appContext_equatable
    • test_appContext_no_token_field — 验证无 token
    • test_appContext_no_privacy_field — 验证无 idfa/idfv/pushToken/deviceId

修改文件

  • Core/Models/AppContext.swift：新建
  • AIStudyAppTests/AppContextTests.swift：新建

代码证据

  • Core/Models/AppContext.swift:33-44：live() 从系统采集
  • Core/Models/AppContext.swift:47-51：refreshed() 更新时区
  • Core/Models/AppContext.swift:54-62：platformValue() 区分 idiom
  • AIStudyAppTests/AppContextTests.swift:46-52：test_appContext_refreshed_updates_timezone
  • AIStudyAppTests/AppContextTests.swift:70-76：test_appContext_no_token_field

验收标准逐项

  1. 新增 AppContext 类型 — ✅
  2. 可读取 platform — ✅ platform 字段
  3. 可读取 appVersion — ✅ appVersion 字段
  4. 可读取 buildNumber — ✅ buildNumber 字段
  5. 可读取 clientTimezoneOffsetMinutes — ✅ + refreshed() 上传前更新
  6. IOS-INFO-012 可使用 AppContext — ✅ 7 个字段可供 UploadItem 映射
  7. 有单元测试 — ✅ 9 个测试
  8. 不依赖 API 实现 — ✅ 纯本地采集

是否建议进入 Review

  • 是（需 Xcode 编译验证，CLI 环境无完整 iOS SDK）
## 开发完成评论 ### 完成内容 - 新建 `Core/Models/AppContext.swift`（87 行）： - 7 个字段：`platform`, `appVersion`, `buildNumber`, `clientTimezoneOffsetMinutes`, `locale`, `deviceType`, `osVersion` - `live()` 工厂方法：从 `Bundle.main` + `TimeZone.current` + `UIDevice.current` 采集 - `refreshed()` 方法：上传前重读时区偏移，避免跨时区漂移 - `platformValue()` 区分 ios / ipadOS / macos - `deviceTypeValue()` 区分 phone / tablet - `Codable` + `Equatable` conformance - 不含 token / 隐私字段 - 新建 `AIStudyAppTests/AppContextTests.swift`（85 行）： - `test_appContext_platform_is_ios_or_ipados` - `test_appContext_appVersion_notEmpty` - `test_appContext_buildNumber_notEmpty` - `test_appContext_timezoneOffset_isWithinRange` - `test_appContext_refreshed_updates_timezone` - `test_appContext_codable_roundtrip` — JSON 编解码往返 - `test_appContext_equatable` - `test_appContext_no_token_field` — 验证无 token - `test_appContext_no_privacy_field` — 验证无 idfa/idfv/pushToken/deviceId ### 修改文件 - `Core/Models/AppContext.swift`：新建 - `AIStudyAppTests/AppContextTests.swift`：新建 ### 代码证据 - `Core/Models/AppContext.swift:33-44`：`live()` 从系统采集 - `Core/Models/AppContext.swift:47-51`：`refreshed()` 更新时区 - `Core/Models/AppContext.swift:54-62`：`platformValue()` 区分 idiom - `AIStudyAppTests/AppContextTests.swift:46-52`：`test_appContext_refreshed_updates_timezone` - `AIStudyAppTests/AppContextTests.swift:70-76`：`test_appContext_no_token_field` ### 验收标准逐项 1. 新增 AppContext 类型 — ✅ 2. 可读取 platform — ✅ `platform` 字段 3. 可读取 appVersion — ✅ `appVersion` 字段 4. 可读取 buildNumber — ✅ `buildNumber` 字段 5. 可读取 clientTimezoneOffsetMinutes — ✅ + `refreshed()` 上传前更新 6. IOS-INFO-012 可使用 AppContext — ✅ 7 个字段可供 UploadItem 映射 7. 有单元测试 — ✅ 9 个测试 8. 不依赖 API 实现 — ✅ 纯本地采集 ### 是否建议进入 Review - 是（需 Xcode 编译验证，CLI 环境无完整 iOS SDK）
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
priority:p0
repo:ios
status:todo
work:context
work:dto
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#126
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?