HaHafeng
31d555f7bb
- Add platform infrastructure chapter to frontend-backend architecture design - Update system architecture document with 6 new infrastructure modules - Update AI onboarding guide with infrastructure overview - Link to backend/src/common/README.md for detailed usage guide Key Updates: - Storage service (LocalAdapter + OSSAdapter) - Logging system (Winston + JSON format) - Cache service (Memory + Redis) - Async job queue (Memory + Database) - Health check endpoints - Monitoring metrics - Database connection pool - Environment config management All modules support zero-code switching between local and cloud environments. Related: #Platform-Infrastructure
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
维护人： 技术架构师