Features: - Backend statistics API (cloud-native Prisma aggregation) - Results page with hybrid solution (AI consensus + human final decision) - Excel export (frontend generation, zero disk write, cloud-native) - PRISMA-style exclusion reason analysis with bar chart - Batch selection and export (3 export methods) - Fixed logic contradiction (inclusion does not show exclusion reason) - Optimized table width (870px, no horizontal scroll) Components: - Backend: screeningController.ts - add getProjectStatistics API - Frontend: ScreeningResults.tsx - complete results page (hybrid solution) - Frontend: excelExport.ts - Excel export utility (40 columns full info) - Frontend: ScreeningWorkbench.tsx - add navigation button - Utils: get-test-projects.mjs - quick test tool Architecture: - Cloud-native: backend aggregation reduces network transfer - Cloud-native: frontend Excel generation (zero file persistence) - Reuse platform: global prisma instance, logger - Performance: statistics API < 500ms, Excel export < 3s (1000 records) Documentation: - Update module status guide (add Week 4 features) - Update task breakdown (mark Week 4 completed) - Update API design spec (add statistics API) - Update database design (add field usage notes) - Create Week 4 development plan - Create Week 4 completion report - Create technical debt list Test: - End-to-end flow test passed - All features verified - Performance test passed - Cloud-native compliance verified Ref: Week 4 Development Plan Scope: ASL Module MVP - Title Abstract Screening Results Cloud-Native: Backend aggregation + Frontend Excel generation
4.4 KiB
4.4 KiB
系统总体设计 - 阅读指南
文档日期: 2025-11-06
文档目的: 快速导航,找到您需要的文档
🎯 如果您想...
快速了解今天的成果
👉 必读: 00-今日架构设计总结
- 7个核心文档总览
- 关键决策总结
- 下一步建议
了解整个系统架构
👉 必读: 08-架构设计全景图
- 一图看懂完整架构
- 四种部署模式
- 代码组织结构
👉 详细了解: 01-系统架构分层设计
- 三层架构详细设计
- 8个业务模块
- 5个通用能力
- 依赖关系分析
做出下一步行动决策
👉 必读: 99-下一步行动决策建议
- 3个方案对比(立即开发 vs 先改造 vs 折中)
- 成本收益分析
- 明确的建议和实施计划
了解数据库架构
👉 先看: 03-数据库架构说明
- PostgreSQL是Docker部署的
- 您有自己独立的数据库
- 与Dify数据库的关系
👉 深入了解: 05-Schema隔离方案与成本分析
- 逻辑隔离 vs 物理隔离
- 改造成本对比(现在1周 vs 未来3-5周)
- 实施方案
了解如何模块独立部署
👉 必读: 06-模块独立部署与单机版方案
- 完整打包方案(独立产品)
- 共享服务方案(平台内模块)
- Electron单机版架构
- 代码复用率分析(85%+)
了解运营管理端
👉 必读: 04-运营管理端架构设计
- 15个功能模块
- 3阶段实施计划
- 对系统的6大影响
了解是否需要Monorepo
👉 必读: 07-Monorepo架构评估
- 当前阶段需要吗?
- 成本对比(现在2-3天 vs 未来7-11天)
- 实施方案
了解文档体系如何重构
👉 必读: 02-文档体系重构方案v2.0
- 新文档结构设计
- 8个模块的标准文档模板
- 迁移计划
了解所有架构问题的答案
👉 必读: 00-核心问题解答
- 部署模式调整(3种,不考虑混合部署)
- 审稿系统独立性分析
- 数据库架构澄清
📊 文档阅读顺序建议
路径1:快速了解(20分钟)
- 00-今日架构设计总结 - 5分钟
- 08-架构设计全景图 - 10分钟
- 99-下一步行动决策建议 - 5分钟
路径2:全面理解(1-2小时)
- 00-今日架构设计总结 - 10分钟
- 01-系统架构分层设计 - 30分钟
- 05-Schema隔离方案与成本分析 - 20分钟
- 07-Monorepo架构评估 - 15分钟
- 99-下一步行动决策建议 - 10分钟
路径3:深入研究(3-4小时)
按顺序阅读所有10个文档
🎯 关键结论速查
Schema隔离
- 建议: 现在做 ⭐⭐⭐⭐⭐
- 成本: 1周 vs 未来3-5周
- ROI: 300-500%
Monorepo
- 建议: 现在转换 ⭐⭐⭐⭐⭐
- 成本: 2-3天 vs 未来7-11天
- ROI: 300-400%
- 触发条件: 近期开发运营管理端,必须转换
下一步行动
- 方案A: 立即开发ASL(累积技术债)
- 方案B: 先改造架构,再开发ASL(强烈推荐)⭐⭐⭐⭐⭐
- 方案C: 只做Monorepo,延后Schema隔离
📝 今日成果
完成的文档:
- ✅ 00-核心问题解答.md
- ✅ 01-系统架构分层设计.md(900+行)
- ✅ 02-文档体系重构方案v2.0.md(790+行)
- ✅ 03-数据库架构说明.md(434+行)
- ✅ 04-运营管理端架构设计.md(859+行)
- ✅ 05-Schema隔离方案与成本分析.md(1042+行)
- ✅ 06-模块独立部署与单机版方案.md(1541+行)
- ✅ 07-Monorepo架构评估.md(555+行)
- ✅ 08-架构设计全景图.md
- ✅ 99-下一步行动决策建议.md
总计: 6000+行详细设计
最后更新: 2025-11-06
维护人: 技术架构师