# apes-Authon-Web 剥离历史与说明

> 本文档记录从 saas-web 单体前端剥离纯净账权页面的执行过程、变更明细和框架修改说明。

- **源仓库**: saas-web（单体前端，含 120+ 页面）
- **目标仓库**: apes-Authon-Web（纯净账权前端，40 页面）
- **剥离时间**: 2026-08-09
- **提交**: `8ebd1ca` — 176 files changed, +222/-60093

---

## 一、剥离概览

| 分类 | 数量 | 说明 |
|------|------|------|
| 账权页面保留 | 24 | login、register、user、permission、customer、app |
| 系统配置保留 | 9 | organization、operationlog、quota、packagePlan |
| AI/LLM 页面保留 | 11 | llmModel、llmAgent、aiHelper、ai 工具管理 |
| 业务页面删除 | ~82 | fei、trace、weight、tracing、irrigation 等 |
| 框架文件修改 | 8 | router、main.js、request.js、store 等 |
| 代码变更量 | +222 / -60093 | 净减约 6 万行业务代码 |

---

## 二、保留清单

### 2.1 页面 (views/)

| 目录 | 文件 | 功能 |
|------|------|------|
| login/ | index.vue | 登录页（短信验证码 + 密码 + SSO） |
| register/ | index.vue | 注册页 |
| user/ | list.vue, editProfile.vue, info.vue, pwd.vue, sso.vue | 用户管理（5 个页面） |
| permission/ | menuList.vue, permissionList.vue, roleList.vue | 权限管理（3 个页面） |
| customer/ | index.vue, detail.vue, editCustomer.vue, employee.vue, user.vue, myCustomer.vue, packages.vue, packageOverview.vue, quotaChangeLog.vue, uiConfig.vue, accessToken.vue, extendApplyList.vue | 客户管理（12 个页面） |
| app/ | appList.vue, appDetail.vue | 应用管理 |
| system/ | organization/, operationlog/, quota/, packagePlan/, llmModel/, llmAgent/, aiHelper/ | 系统配置 + AI/LLM 配置（8 个页面） |
| ai/ | tool.vue, toolEdit.vue, skill.vue, toolLog.vue, callLog.vue, conversationHistory.vue, chat.vue | AI 工具管理（7 个页面） |
| home/ | index.vue | 首页看板 |
| base/ | imageUpload.vue | 图片上传 |
| 404.vue | — | 404 错误页 |

### 2.2 API 文件 (api/) — 19 个

| 文件 | 功能 |
|------|------|
| user.js | 登录/注册/用户管理/获取当前用户 |
| permissionApi.js | 菜单/权限/角色 CRUD |
| menuApi.js | 动态路由构建（require.context） |
| appApi.js | 应用管理 CRUD |
| customerApi.js | 客户管理 CRUD |
| customerPackageApi.js | 客户套餐管理 |
| accessTokenApi.js | AccessToken 管理 |
| organizationApi.js | 组织架构管理 |
| quotaApi.js | 配额管理 |
| packagePlanApi.js | 套餐方案管理 |
| baseApi.js | 基础接口（文件上传等） |
| llmModelApi.js | LLM 模型配置 |
| llmAgentApi.js | LLM Agent 管理 |
| llmAgentSkillApi.js | LLM Agent 技能管理 |
| llmAgentToolApi.js | LLM Agent 工具管理 |
| llmToolApi.js | LLM 工具管理 |
| llmToolLogApi.js | LLM 工具日志 |
| llmConversationApi.js | LLM 对话管理 |
| aiSkill.js | AI 技能管理 |

### 2.3 组件 (components/) — 6 个

| 文件 | 功能 | 备注 |
|------|------|------|
| breadcrumb.vue | 面包屑导航 | 原样保留 |
| tagView.vue | 标签页缓存 | 原样保留 |
| pageBox.vue | 页面容器 | 原样保留 |
| iframeView.vue | 通用 iframe 组件 | **重写**（见下文） |
| MarkdownContent.vue | Markdown 渲染 | **新建**（见下文） |
| ai/ai_helper.vue | AI 助手浮窗 | 原样保留 |

### 2.4 工具函数 (utils/) — 10 个

| 文件 | 功能 | 备注 |
|------|------|------|
| request.js | Axios 封装 | **修改**（见下文） |
| index.js | 通用工具函数 | 原样保留 |
| validate.js | 校验工具 | 原样保留 |
| msgUtil.js | 消息提示 | 原样保留 |
| public.js | 公共方法 | 原样保留 |
| constUtil.js | 常量 | 原样保留 |
| envUtil.js | 环境变量 | 原样保留 |
| autoRefresh.js | 自动刷新 | 原样保留 |
| uiSizeUtil.js | UI 尺寸 | 原样保留 |
| get-page-title.js | 页面标题 | 原样保留 |

---

## 三、删除清单

### 3.1 页面删除

| 目录 | 文件数 | 业务域 |
|------|--------|--------|
| fei/ | 22 | 智慧农业大屏/可视化 |
| trace/ | 21 | 溯源管理 |
| weight/ | 13 | 自助过磅系统 |
| tracing/ | 6 | 溯源追踪/路线 |
| irrigation/ | 2 | 灌溉管理 |
| brain/ | 3 | AI 大脑 |
| certify/ | 5 | 认证管理 |
| certifyAgreement/ | 1 | 认证协议 |
| payment/ | 1 | 支付 |
| park/ | 2 | 园区管理 |
| waterFertilizer/ | 2 | 水肥一体化 |
| fertigationDevice/ | 2 | 施肥设备 |
| extLink/ | 1 | 外部链接 |
| preference/ | 1 | 偏好设置 |
| agreement/ | 1 | 协议管理 |
| web/ | 1 | Web iframe |
| tracking/ | 1 | 追踪 |
| huoban/ | 1 | 伙伴云（Phase 5C 代办） |
| 其他 | ~3 | PAGECODE.md 等 |

### 3.2 API 删除

| 文件/目录 | 业务域 |
|-----------|--------|
| fei/ 目录 | 智慧农业 |
| trace/, traceabilityApi.js, trackingConfigApi.js | 溯源 |
| weightApi.js | 过磅 |
| huobanTableApi.js | 伙伴云 |
| farmPlan.js, inspection.js, inputMaterial.js, irrigation.js, park.js, fertigationDevice.js, cameraInfo.js | 农业/设备 |
| n8nApi.js | N8N 工作流 |
| extLink.js, userPreference.js | 外链/偏好 |

### 3.3 工具函数删除

| 文件 | 原因 |
|------|------|
| ezvizConfig.js, ezvizStream.js | 萤石云视频流配置 |
| tracingDisplay.js, tracingPermission.js, tracingQualPermission.js, tracingTestCertificate.js | 溯源专用工具 |
| huobanAuth.js | 伙伴云鉴权 |
| markdown.js | 富文本编辑器封装（被 MarkdownContent.vue 替代） |
| wangEditConfig.js | wangEditor 富文本配置 |

### 3.4 组件删除

| 目录/文件 | 原因 |
|-----------|------|
| components/brain/ | 大屏专用组件 |
| components/tracing/ | 溯源专用组件 |
| components/MarkdownContent.vue（原版） | 依赖已删除的 markdown.js，由新版替代 |

### 3.5 配置删除

| 文件 | 原因 |
|------|------|
| config/ezviz.js, config/ezviz.example.js | 萤石云配置 |
| config/tracingOpenKey.js | 溯源 OpenKey 配置 |
| styles/tracing-screen.scss | 溯源大屏样式 |

---

## 四、框架文件修改详情

### 4.1 router/index.js — 路由重构

**修改内容**：
- 移除所有业务路由（certify、huoban、weight、tracing、fei_screen、brain、tracing_screen）
- 保留核心路由：`/login`、`/register`、`/user/*`、`/base/*`、`/customer/*`、`/error/404`、`/`（首页）
- 新增 `/common` 路由作为动态菜单路由的容器：

```javascript
{
  path: '/common',
  component: LayoutBox,
  name: 'common',
  children: []  // 动态路由运行时注入
}
```

**原因**：`menuApi.js` 通过 `router.addRoute('common', ...)` 动态注册菜单路由，需要一个名为 `common` 的命名路由作为父容器。

### 4.2 main.js — 入口精简

**移除内容**：
- `import * as echarts from 'echarts'` 和 `Vue.prototype.$echarts = echarts`（首页看板不再使用 echarts 图表）
- `import userPreferenceApi from '@/api/userPreference'` 及相关调用（用户偏好功能已删除）
- `staticPages` 数组精简为 `['/register']`（移除了其他静态页面路径）

**保留内容**：
- Token 从 URL 参数读取（SSO 支持）
- `getCurrentUser` → `setLoginUser` → `getMyApps` → `loadAppMenus` → `matchCurrentPath` 核心启动流程

### 4.3 utils/request.js — 请求层简化

**移除内容**：
- `isHuobanWebApi()` 函数（判断是否为伙伴云 API 请求）
- `resolveRequestToken()` 辅助函数（根据请求类型解析不同 token）
- 伙伴云 token 相关逻辑

**简化后**：Token 统一从 `localStorage.getItem('_token')` 获取：

```javascript
config.headers = {
  ...config.headers,
  time: new Date().getTime(),
  version: '1.1',
  token: localStorage.getItem('_token') || ''
}
```

### 4.4 store/modules/user.js — 状态清理

**移除内容**：
- `huobanToken` state 字段
- `SET_HUOBAN_TOKEN` mutation
- `setHuobanToken` action

**保留的 State**：`loginUser`、`menuList`、`currentMenuId`、`currentCustomer`、`appList`、`currentApp`、`currentAppMenus`、`allAppMenus`

### 4.5 store/getters.js — 清理不存在模块

**移除内容**：对 `app`、`permission`、`errorLog`、`common` 模块的 getter 引用（这些模块不存在于本项目中）

**修改后**：

```javascript
const getters = {
  visitedViews: state => state.tagsView.visitedViews,
  cachedViews: state => state.tagsView.cachedViews,
  loginUser: state => state.user.loginUser,
  currentCustomer: state => state.user.currentCustomer,
  menuList: state => state.user.menuList,
  appList: state => state.user.appList,
  currentApp: state => state.user.currentApp,
  currentAppMenus: state => state.user.currentAppMenus
}
```

### 4.6 vue.config.js — 构建配置更新

**移除内容**：
- `MonacoWebpackPlugin` require 和插件注册
- n8n 工作流代理配置
- `echarts`、`monaco-editor` 的 externals 配置
- monaco/echarts/wangEditor 的 splitChunks cacheGroups

**修改内容**：
- `outputDir`: `"saas-web"` → `"authon-web"`
- `name`: 添加 `'apes-Authon'`

### 4.7 package.json — 依赖清理

**移除的依赖**：
- `@amap/amap-jsapi-loader`（高德地图）
- `@wangeditor/core`、`@wangeditor/editor`、`@wangeditor/editor-for-vue`（富文本编辑器）
- `echarts`（图表库）
- `html2canvas`（截图）
- `jspdf`（PDF 生成）
- `qrcodejs2`（二维码）

**保留的特殊依赖**：
- `monaco-editor` — AI 工具编辑器使用（`views/ai/toolEdit.vue`）
- `vue-monaco` — Monaco Editor 的 Vue 封装
- `marked` — AI 对话中的 Markdown 渲染
- `highlight.js` — AI 对话中的代码高亮

### 4.8 public/index.html — CDN 清理

**移除内容**：
- echarts CDN script
- monaco-editor CDN scripts（loader、nls、editor.main）

**保留内容**：
- Vue、VueRouter、Vuex、ElementUI、Axios 的 CDN externals

### 4.9 iframeView.vue — 重写

**原版**：为每种 iframe 类型（web/payment/huoban）分别导入对应的 view 组件。

**新版**：统一为单个通用 `<iframe>` 组件，适用于所有 menuType 2/3/4：

```vue
<template>
  <div class="iframe-container">
    <iframe :src="frameUrl" frameborder="0" style="width:100%;height:100%"></iframe>
  </div>
</template>
```

### 4.10 menuApi.js — 路由注册统一

**修改内容**：menuType 2/3/4 统一使用 `@/components/iframeView` 组件，不再为每种类型分别导入 view。

### 4.11 MarkdownContent.vue — 新建

**背景**：原版 `MarkdownContent.vue` 导入了已删除的 `@/utils/markdown.js`，导致构建失败。

**新版**：直接使用 `marked` + `highlight.js`，自包含无外部依赖：

```javascript
import { marked } from 'marked'
import hljs from 'highlight.js'
import 'highlight.js/styles/github.css'
```

---

## 五、业务引用清理

以下文件中移除了对已删除模块的引用，替换为空操作或简化逻辑：

| 文件 | 移除的引用 | 替代方案 |
|------|-----------|----------|
| TopHeader.vue | `weightApi`、`clearTracingPermissionCache`、`clearHuobanToken` | 移除调用，保留方法结构 |
| login/index.vue | `weightApi`、`clearHuobanToken` | 移除调用 |
| home/index.vue | `extLinkApi` | `loadExtLinks()` 改为空操作 |
| customer/index.vue | `huobanTableApi` | `upsetOne()` 改为设置 skip 状态 |
| customer/uiConfig.vue | `weightApi` | `loadConfig()` / `handleSave()` / `handleReset()` 改为成功提示 |
| permissionApi.js | `TRACING_OPEN_KEY` | 移除 `getTrackingConfigByCustomerId()` 方法 |

---

## 六、构建验证

```bash
npm run build:prod
# DONE  Compiled successfully
# Build complete. The authon-web directory is ready to be deployed.
```

构建产物输出到 `authon-web/` 目录，可直接部署到 Nginx 或其他 Web 服务器。

---

## 七、后续代办

| 代办 | 说明 | 状态 |
|------|------|------|
| Phase 5A: AI/LLM 后端提取 | ~54 Java 文件从源码同步到 apes-Authon | 待办 |
| Phase 5B: 系统配置页面补充 | 后端已有 Controller，前端已保留页面 | 基本完成 |
| Phase 5C: 伙伴云表单配置 | 5 Controller + 7 .vue + 1 API | 待办 |

---

*文档更新时间: 2026-08-09 | 仓库: https://gitea.apescale.com/APES/apes-Authon-Web*