将产品展示、购物管理、资金管理等功能相结合，并提供了简易的操作、丰富的功能和完善的权限管理，为用户提供了一个低成本、高效率的网上商城建设方案包含PowerEasy CMS普及版，主要功能模块：文章频道、下载频道、图片频道、留言频道、采集管理、商城模块、商城日常操作模块500个订单限制（超出限制后只能查看和删除，不能进行其他处理） 无订单处理权限分配功能（只有超级管理员才能处理订单）
该进，但必须和代码解耦。架构图应作为衍生品由代码自动生成，只存生成逻辑（如 generate_arch.py）和模板（如 arch.dot.j2），不存 png/svg 文件；通过 ast 静态分析提取依赖关系，用 dot 渲染并上传至带版本标记的存储，以 arch_version.json 为版本锚点。
架构图该不该进 Git？
该进，但必须和代码解耦。Python 项目里直接用 pydot 或 graphviz 自动生成的架构图，本质是「衍生品」，不是源码。放 Git 里会污染提交历史——每次模型微调、函数重命名，图就变，diff 全是无意义的坐标偏移或 ID 变更。
建议只存生成逻辑（如 generate_arch.py）和模板（如 arch.dot.j2），不存 architecture.png 或 system.svg。
怎么让架构图自动随代码更新？
靠静态分析 + 模板渲染，别手动画。用 ast 解析 Python 文件，提取模块依赖、类继承、函数调用关系，再喂给 graphviz 渲染。关键不是画得美，而是「改了 api/router.py 就触发重绘」。
- 用
importlib.util.spec_from_file_location动态加载模块，避免硬编码路径 - 依赖关系优先采信
__init__.py中的__all__，而不是盲目扫描所有import - 生成命令统一走
make arch或python -m tools.gen_arch，别散落在 README 里
为什么用 DOT 而不是 Mermaid？
mermaid-cli 渲染不稳定，尤其在 CI 环境里常因字体缺失报 SVG render failed；而 dot 是纯计算，输入确定，输出确定，适合做版本比对。更重要的是：DOT 支持子图分组、rankdir 控制流向、node URL 关联源码位置——这些对追踪真实调用链有用。
立即学习“Python免费学习笔记（深入）”；
示例片段：
subgraph cluster_api {
label="API Layer";
node [style=filled, fillcolor="#e6f7ff"];
"api.main" -> "api.router";
"api.router" -> "services.user";
}
CI 里生成图但不提交，怎么防丢失？
图不是文档附件，是构建产物。CI 完成后必须上传到带版本标记的存储（如 S3 的 artifacts/python-arch/v1.2.0/），同时把本次构建的 SHA 和图 URL 记进 ARCH_VERSION.json。本地开发时，make arch 默认读这个 JSON 拉最新图，不重新渲染。
容易漏的一点：.gitignore 里要明确排除 *.png、*.svg，但保留 ARCH_VERSION.json —— 它才是图的「版本锚点」。
