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:
1233
docs/03-业务模块/ASL-AI智能文献/04-开发计划/05-全文复筛前端开发计划.md
Normal file
1233
docs/03-业务模块/ASL-AI智能文献/04-开发计划/05-全文复筛前端开发计划.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -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
|
||||
> **状态**:待开发
|
||||
|
||||
---
|
||||
|
||||
### 债务11:PDF标注功能
|
||||
|
||||
**问题描述**:
|
||||
- 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列表(支持批量)
|
||||
- 调用第三方API(PubMed、Unpaywall、Sci-Hub镜像)
|
||||
- 自动下载PDF并添加到任务
|
||||
|
||||
**优先级**:低
|
||||
**预计耗时**:3-5天
|
||||
**依赖**:第三方PDF获取API
|
||||
**用户价值**:⭐⭐⭐⭐⭐
|
||||
**法律风险**:⚠️ 需评估版权问题
|
||||
|
||||
---
|
||||
|
||||
### 债务15:高亮AI引用的原文片段
|
||||
|
||||
**问题描述**:
|
||||
- AI判断时引用了原文证据
|
||||
- 但在PDF预览中无法自动定位和高亮
|
||||
- 用户需要手动查找对应的文本
|
||||
|
||||
**使用场景**:
|
||||
- 查看AI判断依据时,希望看到原文位置
|
||||
- 点击证据文本,PDF自动跳转并高亮
|
||||
- 验证AI提取是否准确
|
||||
|
||||
**建议方案**:
|
||||
- 在AI判断对比中,证据文本变为可点击
|
||||
- 点击后PDF预览自动跳转到对应页面
|
||||
- 高亮匹配的文本片段(需要坐标信息)
|
||||
- 后端需要返回文本在PDF中的位置坐标
|
||||
|
||||
**优先级**:中
|
||||
**预计耗时**:4-5天
|
||||
**依赖**:PDF提取服务返回文本坐标
|
||||
**用户价值**:⭐⭐⭐⭐⭐
|
||||
**技术难度**:⭐⭐⭐⭐
|
||||
|
||||
---
|
||||
|
||||
### 债务16:WebSocket实时推送替代轮询
|
||||
|
||||
**问题描述**:
|
||||
- 当前使用轮询机制(每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-22(v1.1)
|
||||
**本次更新**:新增全文复筛技术债务(10项)
|
||||
**下次评估**:全文复筛MVP完成后
|
||||
**最后更新**:2025-11-23(v1.2)
|
||||
**本次更新**:新增全文复筛前端技术债务(10项,债务11-20)
|
||||
**下次评估**:全文复筛前端MVP完成后
|
||||
|
||||
|
||||
Reference in New Issue
Block a user