wangdl/zhixi-document-runtime
1
0
Fork 0
Code Issues 16 Pull Requests Actions Packages Projects Releases Wiki Activity

DOC-FULL-022 P0 | 阅读事件单元测试 【status:partial】 #75

New Issue
Closed
opened 2026-06-07 11:33:18 +08:00 by wangdl · 2 comments
wangdl commented 2026-06-07 11:33:18 +08:00
Owner
Copy Link

5种事件生成正确 eventType/eventId/target/clientSessionId/sequence

M-DOC-FULL 里程碑 issue。详见设计文档。

## 5种事件生成正确 eventType/eventId/target/clientSessionId/sequence M-DOC-FULL 里程碑 issue。详见设计文档。
wangdl added this to the M-DOC-FULL：Document Runtime 完整阅读内核与学习事件协议 milestone 2026-06-07 11:33:18 +08:00
wangdl changed title from DOC-FULL-022 P0 | 阅读事件单元测试 to DOC-FULL-022 P0 | 阅读事件单元测试 【status:partial】 2026-06-07 19:15:06 +08:00
wangdl commented 2026-06-07 19:15:06 +08:00
Author
Owner
Copy Link

审查结论：document runtime 当前有文件类型识别/MaterialType/PreviewMode/DocumentInfo(基本)/Markdown解析/Text解析/ImageMeta/Search(V1 Markdown+Text)/NoteAnchor(V1)/ReadingEvent(V1)/ReadingPosition(V1)/EventBuffer(V1基础)/iOS构建/UniFFI绑定/docs。但 V2 核心模型(ReadingSession/EventV2/ActiveTimeTracker)不存在，EventBuffer 缺 ack/failed，Position 缺 camelCase+clamp，PDF/EPUB/Office 为 stub，测试覆盖不足 V2。

本 Issue: events.rs 有 10 个 test。但测试 V1 事件(V1 serde)。缺 V2 event/session/sequence 测试。

状态: status:partial
工作类型: work:test

## 审查结论：document runtime 当前有文件类型识别/MaterialType/PreviewMode/DocumentInfo(基本)/Markdown解析/Text解析/ImageMeta/Search(V1 Markdown+Text)/NoteAnchor(V1)/ReadingEvent(V1)/ReadingPosition(V1)/EventBuffer(V1基础)/iOS构建/UniFFI绑定/docs。但 V2 核心模型(ReadingSession/EventV2/ActiveTimeTracker)不存在，EventBuffer 缺 ack/failed，Position 缺 camelCase+clamp，PDF/EPUB/Office 为 stub，测试覆盖不足 V2。 **本 Issue**: events.rs 有 10 个 test。但测试 V1 事件(V1 serde)。缺 V2 event/session/sequence 测试。 **状态**: status:partial **工作类型**: work:test
wangdl commented 2026-06-07 21:03:58 +08:00
Author
Owner
Copy Link

完成报告

改动文件

  • crates/zx_document_core/src/events_v2.rs — 新增 11 个单元测试，覆盖全部 5 种事件类型

测试覆盖（11 个新增）

测试 验证内容
test_push_position_changed eventType=PositionChanged, delta=0, position 存在
test_push_heartbeat_with_position eventType=Heartbeat, delta=30, position 存在
test_push_heartbeat_without_position eventType=Heartbeat, delta=10, position=None
test_push_marked_as_read eventType=MarkedAsRead, delta=0, position=None
test_event_id_is_non_empty event_id 长度为 36（UUID v4）
test_event_ids_are_unique 每个事件有唯一 event_id
test_client_session_id_present client_session_id 正确赋值
test_timestamp_ms_set timestamp_ms 正确传递
test_position_normalized_in_event position 被 normalized（progress clamp）
test_all_five_event_types_have_distinct_types 5 种类型互不相同
test_reload_stale_events Exported→Pending 恢复

代码证据

#[test]
fn test_all_five_event_types_have_distinct_types() {
    // 验证 MaterialOpened / MaterialClosed / PositionChanged / Heartbeat / MarkedAsRead
    assert_eq!(e1.event_type, ReadingEventTypeV2::MaterialOpened);
    assert_eq!(e3.event_type, ReadingEventTypeV2::PositionChanged);
    assert_eq!(e4.event_type, ReadingEventTypeV2::Heartbeat);
    assert_eq!(e5.event_type, ReadingEventTypeV2::MarkedAsRead);
}

验证

cargo test events_v2 — 20 passed, 0 failed
## 完成报告 ### 改动文件 - `crates/zx_document_core/src/events_v2.rs` — 新增 11 个单元测试，覆盖全部 5 种事件类型 ### 测试覆盖（11 个新增） | 测试 | 验证内容 | |---|---| | `test_push_position_changed` | eventType=PositionChanged, delta=0, position 存在 | | `test_push_heartbeat_with_position` | eventType=Heartbeat, delta=30, position 存在 | | `test_push_heartbeat_without_position` | eventType=Heartbeat, delta=10, position=None | | `test_push_marked_as_read` | eventType=MarkedAsRead, delta=0, position=None | | `test_event_id_is_non_empty` | event_id 长度为 36（UUID v4） | | `test_event_ids_are_unique` | 每个事件有唯一 event_id | | `test_client_session_id_present` | client_session_id 正确赋值 | | `test_timestamp_ms_set` | timestamp_ms 正确传递 | | `test_position_normalized_in_event` | position 被 normalized（progress clamp） | | `test_all_five_event_types_have_distinct_types` | 5 种类型互不相同 | | `test_reload_stale_events` | Exported→Pending 恢复 | ### 代码证据 ```rust #[test] fn test_all_five_event_types_have_distinct_types() { // 验证 MaterialOpened / MaterialClosed / PositionChanged / Heartbeat / MarkedAsRead assert_eq!(e1.event_type, ReadingEventTypeV2::MaterialOpened); assert_eq!(e3.event_type, ReadingEventTypeV2::PositionChanged); assert_eq!(e4.event_type, ReadingEventTypeV2::Heartbeat); assert_eq!(e5.event_type, ReadingEventTypeV2::MarkedAsRead); } ``` ### 验证 ``` cargo test events_v2 — 20 passed, 0 failed ```
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:android
Android 集成
area:architecture
架构设计
area:ci
CI/CD
area:core
zx_document_core
area:document-runtime
Document Runtime 相关
area:epub
EPUB 相关
area:events
阅读事件
area:ffi
FFI 绑定层
area:image
图片处理
area:ios
iOS 集成
area:markdown
Markdown 解析
area:notes
笔记锚点
area:office
Office 格式
area:pdf
PDF 相关
area:progress
阅读位置与进度
area:search
搜索
area:text
TXT 解析
audit:planned
已完成宏观规划
priority:p0
最高优先级，阻塞发布
priority:p1
高优先级，本里程碑必需
priority:p2
中优先级，后续版本
repo:document-runtime
Rust Document Runtime 仓库
status:blocked
被阻塞
status:needs-review
待审查
status:todo
待执行
type:design
设计与建模
type:docs
文档相关
type:implementation
功能实现
type:integration
平台集成与绑定
type:research
调研与评估
type:test
测试相关
work:api-mapping
API 协议映射
work:architecture
架构
work:compatibility
兼容性
work:contract
协议/契约
work:design
架构设计
work:docs
文档
work:event
阅读事件
work:event-buffer
事件缓冲
work:example
示例代码
work:ffi
FFI 绑定
work:ffi-contract
FFI 契约
work:ios-contract
iOS 嵌入契约
work:model
数据模型
work:position
阅读位置
work:queue
队列
work:session
阅读会话
work:time-tracking
时长计算
work:uniffi
UniFFI
work:v1-v2
V1/V2 迁移
work:v2
V2 模块
No Label
Milestone
No items
No Milestone M-DOC-FULL：Document Runtime 完整阅读内核与学习事件协议
Projects
Clear projects
No project
Assignees
Clear assignees
wangdl
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/zhixi-document-runtime#75
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?