diff --git a/code/fms/fms-vue/docs/module-management-code-refactor-plan.md b/code/fms/fms-vue/docs/module-management-code-refactor-plan.md new file mode 100644 index 00000000..46186e21 --- /dev/null +++ b/code/fms/fms-vue/docs/module-management-code-refactor-plan.md @@ -0,0 +1,303 @@ +# `/system/module-management` 代码重构计划(还债专项) + +> 本文是**纯代码重构**计划:不改任何行为、UI 文案、API 调用和保存协议。 +> 与 `docs/module-management-refactor-plan.md`(功能改造历史记录)无关,请勿混淆。 +> 执行前请先通读本文第 1、2 节和第 8 节(禁改清单)。 + +## 1. 背景与问题 + +模块管理功能已基本完成,但代码存在三类结构性债务: + +1. **巨型文件**:`ModuleFormEditPanel.vue` 3709 行、`ModuleTableEditPanel.vue` 2962 行、 + `index.vue` 1522 行,全模块约 1.2 万行。 +2. **三处复制的"同源"逻辑**:分组树推导在面板与结构树组件间整段复制(注释自述 + "与面板 bandMeta 同源");两个编辑面板共享约 20 个同名函数。靠人肉同步,改一处漏 + 一处就是 bug。 +3. **index.vue 职责过重**:树管理、草稿加载、保存编排、删除级联、i18n 协调、确认弹窗 + 全部平铺在一个 `