Files
AIclinicalresearch/docs/00-系统总体设计/00-阅读指南.md
HaHafeng beb7f7f559 feat(asl): Implement full-text screening core LLM service and validation system (Day 1-3)
Core Components:
- PDFStorageService with Dify/OSS adapters
- LLM12FieldsService with Nougat-first + dual-model + 3-layer JSON parsing
- PromptBuilder for dynamic prompt assembly
- MedicalLogicValidator with 5 rules + fault tolerance
- EvidenceChainValidator for citation integrity
- ConflictDetectionService for dual-model comparison

Prompt Engineering:
- System Prompt (6601 chars, Section-Aware strategy)
- User Prompt template (PICOS context injection)
- JSON Schema (12 fields constraints)
- Cochrane standards (not loaded in MVP)

Key Innovations:
- 3-layer JSON parsing (JSON.parse + json-repair + code block extraction)
- Promise.allSettled for dual-model fault tolerance
- safeGetFieldValue for robust field extraction
- Mixed CN/EN token calculation

Integration Tests:
- integration-test.ts (full test)
- quick-test.ts (quick test)
- cached-result-test.ts (fault tolerance test)

Documentation Updates:
- Development record (Day 2-3 summary)
- Quality assurance strategy (full-text screening)
- Development plan (progress update)
- Module status (v1.1 update)
- Technical debt (10 new items)

Test Results:
- JSON parsing success rate: 100%
- Medical logic validation: 5/5 passed
- Dual-model parallel processing: OK
- Cost per PDF: CNY 0.10

Files: 238 changed, 14383 insertions(+), 32 deletions(-)
Docs: docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/05-寮€鍙戣褰?2025-11-22_Day2-Day3_LLM鏈嶅姟涓庨獙璇佺郴缁熷紑鍙?md
2025-11-22 22:21:12 +08:00

4.4 KiB
Raw Blame History

系统总体设计 - 阅读指南

文档日期: 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分钟

  1. 00-今日架构设计总结 - 5分钟
  2. 08-架构设计全景图 - 10分钟
  3. 99-下一步行动决策建议 - 5分钟

路径2全面理解1-2小时

  1. 00-今日架构设计总结 - 10分钟
  2. 01-系统架构分层设计 - 30分钟
  3. 05-Schema隔离方案与成本分析 - 20分钟
  4. 07-Monorepo架构评估 - 15分钟
  5. 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隔离

📝 今日成果

完成的文档:

  1. 00-核心问题解答.md
  2. 01-系统架构分层设计.md900+行)
  3. 02-文档体系重构方案v2.0.md790+行)
  4. 03-数据库架构说明.md434+行)
  5. 04-运营管理端架构设计.md859+行)
  6. 05-Schema隔离方案与成本分析.md1042+行)
  7. 06-模块独立部署与单机版方案.md1541+行)
  8. 07-Monorepo架构评估.md555+行)
  9. 08-架构设计全景图.md
  10. 99-下一步行动决策建议.md

总计: 6000+行详细设计


最后更新: 2025-11-06
维护人: 技术架构师