docs: add web frontend engineering guide

web/.ai-specs/coding-specs/plugin-module-structure.md

@@ -0,0 +1,26 @@
+# plugin-module-structure
+
+## 适用范围
+
+- 涉及新增插件、修改 `src/plugin/*` 结构、决定插件代码是否上提公共层时必读。
+
+## 标准结构
+
+- 插件目录默认落点：`src/plugin/<plugin>`
+- 插件内部优先自洽，常见子目录包括：
+  - `api`
+  - `view`
+  - `form`
+
+## 强制规则
+
+- 插件自己的页面、表单、接口优先放在插件目录内部，不要一开始就散落到主应用公共目录。
+- 插件必须复用主应用的 `@/utils/request`、`@/pinia`、`@/style`、`@/components` 能力，禁止复制全局基础设施。
+- 只有被多个插件或主应用反复复用的能力，才允许从插件目录上提到公共目录。
+- 插件若接入主应用菜单、权限、路由，必须回查主应用 `router / permission / pinia` 链路。
+
+## 常见错误
+
+- 为插件单独复制一份 request、bus、style 覆盖逻辑。
+- 插件里的组件刚出现一次就提升为全局组件。
+- 插件 API 改了，但没有同步检查插件页面和主应用集成点。