u

code/g3soft-erp/docs/前端架构设计.md

@@ -113,6 +113,11 @@ web/src/
 
 4. **布局壳的样式不加 `scoped`**（`LayoutSidebar.vue` 等），因为需要被子元素感知尺寸；业务组件必须加 `scoped`。
 
+5. **不兼容历史持久化数据**
+   `localStorage` 里存过的偏好设置（`g3erp:preferences`）、页签（`g3erp:app`）等，**不做版本迁移、不做字段兜底**。
+   删字段或改字段名时直接删，不要写 `if (oldField)` 这类兼容分支——`store.ts` 的 `mergePreferences` 只遍历 `defaultPreferences` 的键，旧数据里多出来的键自然被忽略。
+   **理由**：开发期数据结构还在变，为一次性数据写迁移是纯负债。用户清一次 localStorage 即可。
+
 ## 4. 菜单与路由：单一数据源
 
 **这是骨架的核心设计。**