feat(dc): Complete Phase 1 - Portal workbench page development

Summary: - Implement DC module Portal page with 3 tool cards - Create ToolCard component with decorative background and hover animations - Implement TaskList component with table layout and progress bars - Implement AssetLibrary component with tab switching and file cards - Complete database verification (4 tables confirmed) - Complete backend API verification (6 endpoints ready) - Optimize UI to match prototype design (V2.html) Frontend Components (~715 lines): - components/ToolCard.tsx - Tool cards with animations - components/TaskList.tsx - Recent tasks table view - components/AssetLibrary.tsx - Data asset library with tabs - hooks/useRecentTasks.ts - Task state management - hooks/useAssets.ts - Asset state management - pages/Portal.tsx - Main portal page - types/portal.ts - TypeScript type definitions Backend Verification: - Backend API: 1495 lines code verified - Database: dc_schema with 4 tables verified - API endpoints: 6 endpoints tested (templates API works) Documentation: - Database verification report - Backend API test report - Phase 1 completion summary - UI optimization report - Development task checklist - Development plan for Tool B Status: Phase 1 completed (100%), ready for browser testing Next: Phase 2 - Tool B Step 1 and 2 development
2025-12-02 21:53:24 +08:00
parent f240aa9236
commit d4d33528c7
83 changed files with 21863 additions and 1601 deletions
--- a/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-01-23_全文复筛前端逻辑调整.md
+++ b/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-01-23_全文复筛前端逻辑调整.md
@@ -0,0 +1,300 @@
+# 全文复筛前端逻辑调整 - Settings页面优化
+
+**日期**: 2025-01-23  
+**调整原因**: 用户反馈逻辑错误，需要区分"文献列表导入"和"PDF上传"两个独立步骤  
+**状态**: ✅ 已完成
+
+---
+
+## 🔴 **问题发现**
+
+### 原始错误设计：
+
+```
+步骤1: 导入待复筛文献
+├── Tab1: 从标题摘要初筛导入
+├── Tab2: 手动上传Excel ❌ 错误设计
+│   └── 上传包含文献信息的Excel（混淆了元信息和PDF）
+└── Tab3: 从知识库选择
+```
+
+**错误点**：
+- Tab2暗示可以通过Excel导入PDF，但Excel不可能包含PDF文件
+- 没有区分"文献元信息"和"PDF全文"两个概念
+- 流程不清晰，用户容易混淆
+
+---
+
+## ✅ **调整后的正确逻辑**
+
+### 三步流程：
+
+```
+步骤1: 获取待复筛的文献列表（只获取元信息）
+├── Tab1: 从标题摘要初筛导入
+│   └── 导入上一环节"已纳入"的文献元信息
+└── Tab2: 手动上传Excel
+    └── 上传包含文献元信息的Excel（Title, Abstract, PMID等）
+    └── 不包含PDF文件
+
+步骤2: 上传全文文献（为每篇文献上传PDF）
+├── 显示文献列表表格
+├── 每行显示PDF状态（待上传/上传中/已就绪/失败）
+└── 操作列提供两种方式：
+    ├── (1) 手动上传PDF（MVP当前方式）
+    └── (2) 从知识库选择（技术债务）
+
+步骤3: 启动全文复筛
+└── 要求：至少1篇文献的PDF已就绪
+```
+
+---
+
+## 📝 **详细修改内容**
+
+### **1. 步骤1改名：获取待复筛的文献列表**
+
+**修改前**：
+```
+步骤1: 导入待复筛文献
+```
+
+**修改后**：
+```
+步骤1: 获取待复筛的文献列表
+说明：首先导入文献的基本信息（标题、摘要、作者等），PDF全文将在下一步上传
+```
+
+**改动理由**：
+- 明确说明这一步只获取"文献列表"（元信息）
+- 不包含PDF文件
+
+---
+
+### **2. Tab2改名：手动上传Excel（只含元信息）**
+
+**修改前**：
+```jsx
+Tab2: 手动上传Excel
+描述：上传包含文献列表的Excel文件（❌ 没有说明不含PDF）
+```
+
+**修改后**：
+```jsx
+Tab2: 手动上传Excel
+说明：上传包含文献元信息的Excel文件（标题、摘要、PMID等），不包含PDF文件。PDF全文将在下一步上传。
+
+Excel模板字段说明：
+必填字段：
+  • Title（标题）
+  • Abstract（摘要）
+
+可选字段：
+  • PMID、DOI、Authors（作者）、Journal（期刊）、Year（年份）
+```
+
+**改动理由**：
+- 明确说明"不包含PDF文件"
+- 提供Excel模板字段说明
+- 添加"下载Excel模板"按钮
+
+---
+
+### **3. 删除Tab3：从知识库选择**
+
+**修改前**：
+```
+Tab3: 从知识库选择
+```
+
+**修改后**：
+```
+（删除Tab3，知识库功能移到步骤2）
+```
+
+**改动理由**：
+- 知识库选择应该在"上传PDF"环节，而不是"获取文献列表"环节
+- 简化Tab数量（2个Tab更清晰）
+
+---
+
+### **4. 步骤2重命名：上传全文文献**
+
+**修改前**：
+```
+步骤2: 全文获取与管理
+```
+
+**修改后**：
+```
+步骤2: 上传全文文献
+说明：为每篇文献上传对应的PDF全文。您可以手动上传本地PDF文件，或从知识库选择已有PDF（开发中）。
+```
+
+**改动理由**：
+- "上传全文文献"比"全文获取与管理"更明确
+- 明确说明这一步的目的是"上传PDF"
+
+---
+
+### **5. 操作列增强：支持两种上传方式**
+
+**修改前**：
+```jsx
+操作列：
+- 未上传：[上传PDF]按钮
+- 已就绪：显示"已就绪"
+```
+
+**修改后**：
+```jsx
+操作列：
+- 未上传/失败：
+  ├── [上传PDF]按钮（手动上传本地PDF）
+  └── [知识库]按钮（从知识库选择，暂禁用）
+
+- 已就绪：
+  ├── ✓ 已完成
+  └── [重新上传]按钮（允许替换PDF）
+```
+
+**改动理由**：
+- 提供两种上传方式选项
+- 已就绪的文献也可以重新上传
+
+---
+
+### **6. 批量操作工具栏**
+
+**新增**：
+```jsx
+步骤2顶部工具栏：
+- 左侧：已选择 X 篇 | [批量删除]按钮
+- 右侧：[从知识库批量导入]按钮（暂禁用）
+```
+
+**改动理由**：
+- 支持批量操作
+- 为未来的知识库批量导入预留入口
+
+---
+
+### **7. 提示信息优化**
+
+**修改前**：
+```
+提示：至少需要1篇文献的PDF已就绪才能启动复筛任务。
+```
+
+**修改后**：
+```
+未上传任何PDF：
+  提示：至少需要1篇文献的PDF已就绪才能启动复筛任务。请点击表格中的【上传PDF】按钮为文献上传全文。
+
+部分PDF已就绪：
+  提示：已有 X 篇文献的PDF就绪，还有 Y 篇待上传。您可以继续上传剩余PDF，或直接启动复筛（未上传PDF的文献将被跳过）。
+
+全部PDF已就绪：
+  提示：已有 X 篇文献的PDF就绪，可以启动全文复筛任务
+```
+
+**改动理由**：
+- 根据不同状态显示不同提示
+- 明确告知操作步骤
+
+---
+
+## 🎯 **核心改进点**
+
+### **概念分离**：
+```
+文献元信息（步骤1）
+  ↓
+PDF全文文件（步骤2）
+  ↓
+启动筛选（步骤3）
+```
+
+### **流程清晰化**：
+1. **步骤1**：获取文献列表（只要标题、摘要等元信息）
+2. **步骤2**：为每篇文献上传PDF（一对一关联）
+3. **步骤3**：启动全文复筛（要求至少1篇PDF就绪）
+
+---
+
+## 📊 **修改统计**
+
+```
+修改文件：1个
+- FulltextSettings.tsx (621行)
+
+修改内容：
+- 删除代码：~50行（删除Tab3知识库选择）
+- 修改代码：~150行（重写步骤说明、提示信息）
+- 新增代码：~30行（批量操作工具栏、重新上传按钮）
+
+Linter错误：0个
+```
+
+---
+
+## ✅ **验收标准**
+
+### **UI展示**：
+- ✅ 步骤1有2个Tab（从初筛导入 / 手动上传Excel）
+- ✅ 步骤1的Excel上传明确说明"不包含PDF"
+- ✅ 步骤2标题为"上传全文文献"
+- ✅ 步骤2每行有"上传PDF"和"知识库"按钮
+- ✅ 步骤2的提示根据PDF状态动态变化
+
+### **逻辑正确**：
+- ✅ Excel只导入文献元信息
+- ✅ PDF通过表格中的"上传PDF"按钮逐个上传
+- ✅ 知识库功能在步骤2，不在步骤1
+- ✅ 允许部分文献没有PDF也可以启动任务
+
+---
+
+## 🚀 **后续工作**
+
+### **优先级P1（必须）**：
+1. ✅ 前端逻辑调整（已完成）
+2. ⏳ 实现Excel解析功能（解析文献元信息）
+3. ⏳ 实现PDF上传API对接
+
+### **优先级P2（建议）**：
+1. PDF批量上传（拖拽多个PDF文件）
+2. 从知识库选择PDF功能
+3. Excel模板下载功能
+
+---
+
+## 📝 **备注**
+
+### **关键设计原则**：
+1. **概念分离**：文献元信息 ≠ PDF文件
+2. **流程清晰**：三步流程，逐步推进
+3. **灵活性**：允许部分文献无PDF也可启动
+
+### **用户体验优化**：
+- 每一步都有清晰的说明
+- 不同状态有不同的提示
+- 支持重新上传PDF
+- 预留知识库入口
+
+---
+
+**文档版本**: v1.0  
+**最后更新**: 2025-01-23  
+**相关文档**: [2025-01-23_全文复筛前端开发完成.md](./2025-01-23_全文复筛前端开发完成.md)
+
+
+
+
+
+
+
+
+
+
+