docs(asl): Add fulltext screening frontend development plan and technical debt

- Create comprehensive frontend development plan (05-全文复筛前端开发计划.md)
  - 4 core pages design (Settings, Progress, Workbench, Results)
  - 10 feature components and 3 reused components
  - Detailed UI/UX specifications with wireframes
  - 2.5-day development schedule (Day 6-8)
  - Technical implementation guide (PDF upload, progress polling, PDF preview)
  - Testing plan (functional, performance, compatibility)

- Update technical debt list (v1.1 -> v1.2)
  - Add 10 frontend-related technical debts (debt 11-20)
  - PDF annotation feature (medium priority)
  - Literature note-taking (medium priority)
  - Knowledge base integration (low priority)
  - Auto-fetch PDF by PMID/DOI (low priority)
  - Highlight AI-cited text in PDF (medium priority)
  - WebSocket real-time push (low priority)
  - Virtual scrolling optimization (low priority)
  - Batch operations (low priority)
  - Offline PDF preview (low priority)
  - Mobile responsive design (lowest priority)
This commit is contained in:
2025-11-23 11:17:33 +08:00
parent 88cc049fb3
commit e28617ab89
2 changed files with 1501 additions and 7 deletions

View File

@@ -1,9 +1,9 @@
# AI智能文献模块 - 技术债务清单
> **文档版本:** v1.1
> **文档版本:** v1.2
> **创建日期:** 2025-11-21
> **维护者:** AI智能文献开发团队
> **最后更新:** 2025-11-22
> **最后更新:** 2025-11-23
> **文档目的:** 记录MVP完成后需要优化的技术问题
---
@@ -1065,6 +1065,265 @@ const estimate = estimateCost(literatures);
---
## 🎨 全文复筛 - 前端技术债务
> **模块**:全文复筛前端
> **创建时间**2025-11-23
> **状态**:待开发
---
### 债务11PDF标注功能
**问题描述**
- MVP版本只支持PDF预览翻页、缩放
- 无法在PDF上进行标注、高亮、添加批注
- 用户希望在审核时标记关键信息
**使用场景**
- 审核工作台查看原文时,标记关键证据
- 高亮冲突的文本片段
- 添加个人审核笔记
**建议方案**
- 集成PDF标注库如 react-pdf-highlighter
- 支持文本高亮、下划线、批注
- 标注数据保存到数据库,可导出
**优先级**:中
**预计耗时**3-4天
**依赖**PDF预览功能完成
**用户价值**:⭐⭐⭐⭐
---
### 债务12文献笔记功能
**问题描述**
- 无法为每篇文献添加审核笔记
- 人工复核时的思考过程无法记录
- 不便于后续回溯决策依据
**使用场景**
- 记录为什么纳入/排除某篇文献
- 记录需要进一步核查的问题
- 团队协作时的沟通记录
**建议方案**
- 在文献详情抽屉添加"笔记"Tab
- 支持富文本编辑器Markdown
- 支持@提及团队成员
- 笔记保存到数据库
**优先级**:中
**预计耗时**2-3天
**依赖**:详情抽屉完成
**用户价值**:⭐⭐⭐⭐
---
### 债务13从知识库选择文献
**问题描述**
- MVP版本只支持本地上传PDF
- 无法从已有知识库中选择文献
- 需要重复上传已存在的PDF
**使用场景**
- 用户在个人知识库中已保存大量文献
- 希望直接选择现有文献进行全文复筛
- 避免重复上传和存储
**建议方案**
- 在"添加文献"弹窗添加"知识库"Tab
- 显示用户的所有PDF文献列表
- 支持搜索、筛选、多选
- 选中后自动关联到当前任务
**优先级**:低
**预计耗时**2天
**依赖**个人知识库模块PKB
**用户价值**:⭐⭐⭐
---
### 债务14通过PMID/DOI自动获取全文
**问题描述**
- 用户只有PMID或DOI没有PDF文件
- 需要手动去PubMed等网站下载PDF
- 增加操作成本和时间
**使用场景**
- 用户有文献的PMID列表
- 希望系统自动获取全文PDF
- 自动批量下载并关联
**建议方案**
- 在"添加文献"弹窗添加"自动获取"Tab
- 输入PMID/DOI列表支持批量
- 调用第三方APIPubMed、Unpaywall、Sci-Hub镜像
- 自动下载PDF并添加到任务
**优先级**:低
**预计耗时**3-5天
**依赖**第三方PDF获取API
**用户价值**:⭐⭐⭐⭐⭐
**法律风险**:⚠️ 需评估版权问题
---
### 债务15高亮AI引用的原文片段
**问题描述**
- AI判断时引用了原文证据
- 但在PDF预览中无法自动定位和高亮
- 用户需要手动查找对应的文本
**使用场景**
- 查看AI判断依据时希望看到原文位置
- 点击证据文本PDF自动跳转并高亮
- 验证AI提取是否准确
**建议方案**
- 在AI判断对比中证据文本变为可点击
- 点击后PDF预览自动跳转到对应页面
- 高亮匹配的文本片段(需要坐标信息)
- 后端需要返回文本在PDF中的位置坐标
**优先级**:中
**预计耗时**4-5天
**依赖**PDF提取服务返回文本坐标
**用户价值**:⭐⭐⭐⭐⭐
**技术难度**:⭐⭐⭐⭐
---
### 债务16WebSocket实时推送替代轮询
**问题描述**
- 当前使用轮询机制每3秒请求一次
- 增加服务器负载和网络流量
- 进度更新有延迟最多3秒
**使用场景**
- 任务进度监控页面
- 长时间运行的LLM任务
- 希望实时看到处理日志
**建议方案**
- 后端实现WebSocket服务
- 前端建立WebSocket连接
- 任务进度变化时主动推送
- 降级策略WebSocket不可用时回退到轮询
**优先级**:低
**预计耗时**3-4天
**依赖**后端WebSocket实现
**用户价值**:⭐⭐⭐
**性能提升**:⭐⭐⭐⭐
---
### 债务17虚拟滚动优化大列表性能
**问题描述**
- 当文献数量>100篇时表格渲染变慢
- 所有行都渲染到DOM占用大量内存
- 滚动时可能出现卡顿
**使用场景**
- 大规模全文复筛200+篇文献)
- 审核工作台和结果页面
- 需要流畅的滚动体验
**建议方案**
- 使用虚拟滚动库react-window / react-virtualized
- 只渲染可见区域的行
- 优化Ant Design Table性能
- 添加性能监控
**优先级**:低
**预计耗时**2天
**条件触发**:文献数量>100篇
**用户价值**:⭐⭐⭐
**性能提升**:⭐⭐⭐⭐⭐
---
### 债务18批量操作功能
**问题描述**
- 结果页面只能单个文献操作
- 无法批量修改决策
- 无法批量导出选中的文献
**使用场景**
- 批量标记为"纳入"或"排除"
- 批量导出选中文献的PDF
- 批量删除错误上传的文献
**建议方案**
- 表格添加复选框列
- 添加批量操作工具栏
- 支持:批量修改决策、批量导出、批量删除
- 添加操作确认提示
**优先级**:低
**预计耗时**2天
**用户价值**:⭐⭐⭐⭐
---
### 债务19离线PDF预览支持
**问题描述**
- PDF预览依赖在线CDN加载pdf.js worker
- 网络不好时加载失败
- 内网环境无法使用
**使用场景**
- 内网部署环境
- 网络不稳定的用户
- 需要完全离线使用
**建议方案**
- 将pdf.js worker打包到项目中
- 支持本地加载和CDN加载两种模式
- 自动检测网络并选择最优方式
**优先级**:低
**预计耗时**1天
**条件触发**:内网部署需求
**用户价值**:⭐⭐⭐
---
### 债务20响应式设计适配移动端
**问题描述**
- 当前设计只考虑桌面端1920x1080
- 在平板和手机上显示效果差
- 表格宽度固定,小屏幕下无法使用
**使用场景**
- 用户希望在平板上审核文献
- 移动场景下查看任务进度
- 外出时临时处理审核
**建议方案**
- 使用响应式布局Tailwind CSS
- 小屏幕下表格改为卡片视图
- 优化触摸交互体验
- 添加移动端导航
**优先级**:极低
**预计耗时**5-7天
**条件触发**:用户明确需求
**用户价值**:⭐⭐
---
## 📚 相关文档
**标题摘要初筛**:
@@ -1074,9 +1333,11 @@ const estimate = estimateCost(literatures);
- [今日工作总结](../05-开发记录/2025-11-18-今日工作总结.md) - 边界问题诊断
**全文复筛**:
- [全文复筛开发计划](../04-开发计划/04-全文复筛开发计划.md) - 开发进度和计划
- [全文复筛开发计划](../04-开发计划/04-全文复筛开发计划.md) - 后端开发进度和计划
- [全文复筛前端开发计划](../04-开发计划/05-全文复筛前端开发计划.md) - 前端开发详细计划
- [全文复筛质量保障策略](../02-技术设计/08-全文复筛质量保障策略.md) - 质量策略设计
- [Day 2-3开发记录](../05-开发记录/2025-11-22_Day2-Day3_LLM服务与验证系统开发.md) - 已完成工作
- [Day 2-3开发记录](../05-开发记录/2025-11-22_Day2-Day3_LLM服务与验证系统开发.md) - LLM服务开发
- [Day 5开发记录](../05-开发记录/2025-11-23_Day5_全文复筛API开发.md) - 后端API开发
---
@@ -1085,7 +1346,7 @@ const estimate = estimateCost(literatures);
- 每次解决技术债务后标记状态
- 定期评估优先级(每月)
**最后更新**2025-11-22v1.1
**本次更新**新增全文复筛技术债务10项
**下次评估**全文复筛MVP完成后
**最后更新**2025-11-23v1.2
**本次更新**:新增全文复筛前端技术债务10项债务11-20
**下次评估**:全文复筛前端MVP完成后