ljwx-health/docs/02-architecture/diagrams

架构图Draw.io源文件

本目录包含LJWX Health系统的3个核心架构图的draw.io源文件。

📁 文件列表

文件名	描述	用途
layered-architecture.drawio	平台分层架构图	说明系统能力边界、逻辑分层、职责划分
data-flow-architecture.drawio	健康数据流架构图	强调数据如何流动、谁产生、谁消费
deployment-architecture.drawio	组件部署架构图	强调真实运行形态、服务拆分、中间件位置

🚀 快速使用

在线编辑

1. 访问 https://app.diagrams.net/
2. 点击 File → Open from → Device
3. 选择本目录下的任一 .drawio 文件
4. 开始编辑

本地编辑

1. 下载并安装 Draw.io Desktop
2. 双击 .drawio 文件即可打开

📤 导出格式

导出为图片用于文档嵌入：

• PNG: 适合网页和文档（推荐分辨率300dpi）
• SVG: 矢量图，适合印刷和缩放
• PDF: 适合技术文档和报告

🔄 版本控制

这些 .drawio 文件是XML格式，适合Git版本控制：

# 提交修改
git add docs/02-architecture/diagrams/*.drawio
git commit -m "docs: update architecture diagrams"

# 同时导出PNG版本
# File → Export as → PNG (300dpi)
git add docs/02-architecture/diagrams/*.png
git commit -m "docs: export architecture diagrams as PNG"

📖 详细说明

完整的架构图说明和绘制指南请参阅： 👉 系统架构图文档

该文档包含：

• 每个架构图的详细绘制指南
• 元素定义表格（形状、颜色、尺寸）
• 连接线规则和样式说明
• Mermaid代码版本（可选）
• 架构决策记录(ADR)

🎨 设计规范

所有架构图遵循统一的颜色方案：

颜色	用途	Hex值
浅蓝色	前端层/用户	#E1F5FE
浅橙色	API层/网关	#FFF3E0
浅紫色	应用层/数据库	#F3E5F5
浅绿色	业务层/Pods	#E8F5E9
浅粉色	基础设施层	#FCE4EC
浅黄色	数据层/存储	#FFF9C4

⚠️ 重要提示

1. 修改后同步导出: 每次修改 .drawio 文件后，请同步导出PNG版本
2. 保持一致性: 使用统一的颜色方案和形状风格
3. 添加版本号: 在图表顶部标注版本号和更新日期
4. 提交说明清晰: Git commit message应说明修改内容

📞 维护者

• 架构组
• 最后更新: 2026-01-25
• 下次评审: 2026-04-25

---

这些架构图基于8个核心模块的深度分析生成，遵循"三大母版"原则：平台分层架构、数据流架构、部署架构，确保每个架构图关注点明确，不混淆视角。