docs: 添加 apes-Authon-Web 前端剥离方案（HTML + MD）

docs/apes-Authon-Web-剥离方案.md

@@ -0,0 +1,199 @@
+# apes-Authon-Web 前端剥离方案
+
+> 从 saas-web 单体前端中提取纯净账权页面，构建独立的 `apes-Authon-Web` 前端仓库，与后端 `apes-Authon` 配合使用。
+
+- **源仓库**: gitea-upload/web-master
+- **目标仓库**: apes-Authon-Web
+- **技术栈**: Vue 2.7 + Element UI + Vuex + Vue Router
+
+## 概览
+
+| 分类 | 数量 | 说明 |
+|------|------|------|
+| 账权页面保留 | 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 等 |
+
+## Step 1: 保留清单
+
+### 1.1 页面 (views/) — 保留
+
+| 目录 | 文件 | 功能 |
+|------|------|------|
+| login/ | index.vue | 登录页（短信+密码+SSO） |
+| register/ | index.vue | 注册页 |
+| user/ | list.vue, editProfile.vue, info.vue, pwd.vue, sso.vue | 用户管理 |
+| permission/ | menuList.vue, permissionList.vue, roleList.vue | 权限管理 |
+| 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 配置 |
+| ai/ | tool.vue, toolEdit.vue, skill.vue, toolLog.vue, callLog.vue, conversationHistory.vue, chat.vue | AI 工具管理 |
+| home/ | index.vue | 首页看板 |
+| 404.vue | — | 404 错误页 |
+
+### 1.2 API 文件 (api/) — 保留
+
+| 文件 | 功能 |
+|------|------|
+| user.js | 登录/注册/用户管理/获取当前用户 |
+| permissionApi.js | 菜单/权限/角色 CRUD |
+| menuApi.js | 动态路由构建 |
+| appApi.js | 应用管理 CRUD |
+| customerApi.js | 客户管理 CRUD |
+| customerPackageApi.js | 客户套餐管理 |
+| accessTokenApi.js | AccessToken 管理 |
+| organizationApi.js | 组织架构管理 |
+| quotaApi.js | 配额管理 |
+| packagePlanApi.js | 套餐方案管理 |
+| llmAgentApi.js | LLM Agent 管理 |
+| llmAgentSkillApi.js | LLM Agent 技能管理 |
+| llmAgentToolApi.js | LLM Agent 工具管理 |
+| llmModelApi.js | LLM 模型配置 |
+| llmConversationApi.js | LLM 对话管理 |
+| llmToolApi.js | LLM 工具管理 |
+| llmToolLogApi.js | LLM 工具日志 |
+| aiSkill.js | AI 技能管理 |
+
+### 1.3 框架文件 — 全量保留（部分需修改）
+
+| 类别 | 文件 | 说明 |
+|------|------|------|
+| 入口 | main.js, App.vue | 需修改（移除业务引用） |
+| 路由 | router/index.js | 需大幅修改（移除业务路由） |
+| 布局 | layout/index.vue, Sidebar/, TagsView/, TopHeader.vue | 全量保留 |
+| Store | store/index.js, getters.js, modules/user.js, settings.js, tagsView.js | user.js + getters.js 需修改 |
+| Utils | request.js, index.js, validate.js, get-page-title.js, msgUtil.js, public.js, constUtil.js, envUtil.js, autoRefresh.js, uiSizeUtil.js | request.js 需修改 |
+| 组件 | breadcrumb.vue, tagView.vue, pageBox.vue, iframeView.vue, ai/ai_helper.vue | 保留 |
+| 样式 | styles/index.scss, variables.scss, mixin.scss, sidebar.scss, transition.scss, element-ui.scss | 保留（删除 tracing-screen.scss） |
+| 构建配置 | package.json, vue.config.js, babel.config.js, postcss.config.js, jsconfig.json | 需修改 |
+| 静态资源 | public/index.html, public/static/ | 保留 |
+| 图片资源 | assets/404_images/, assets/images/, assets/base.scss | 保留 |
+
+## Step 2: 删除清单（业务相关）
+
+### 2.1 页面删除
+
+| 目录 | 文件数 | 业务域 |
+|------|--------|--------|
+| fei/ | 22 | 智慧农业大屏/可视化 |
+| trace/ | 21 | 溯源管理 |
+| weight/ | 13 | 自助过磅系统 |
+| tracing/ | 6 | 溯源追踪/路线 |
+| irrigation/ | 2 | 灌溉管理 |
+| 其他 | ~18 | base, brain, certify, payment, park, waterFertilizer, fertigationDevice, extLink, preference, agreement, certifyAgreement, web, tracking, huoban |
+
+> **注意**: huoban/ 目录暂不保留，作为后续 Phase 5C 代办。
+
+### 2.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 | 外链/偏好 |
+
+### 2.3 Utils 删除
+
+| 文件 | 原因 |
+|------|------|
+| ezvizConfig.js, ezvizStream.js | 萤石云视频流 |
+| tracingDisplay.js, tracingPermission.js, tracingQualPermission.js, tracingTestCertificate.js | 溯源专用 |
+| huobanAuth.js | 伙伴云鉴权 |
+| markdown.js, wangEditConfig.js | 富文本编辑器 |
+
+### 2.4 组件删除
+
+| 目录/文件 | 原因 |
+|-----------|------|
+| components/brain/ | 大屏组件 |
+| components/tracing/ | 溯源组件 |
+| components/MarkdownContent.vue | 富文本组件 |
+
+### 2.5 样式删除
+
+| 文件 | 原因 |
+|------|------|
+| styles/tracing-screen.scss | 溯源大屏样式 |
+
+### 2.6 Config 删除
+
+| 文件 | 原因 |
+|------|------|
+| config/ezviz.js, config/ezviz.example.js | 萤石云配置 |
+| config/tracingOpenKey.js | 溯源 OpenKey 配置 |
+
+## Step 3: 文件修改清单
+
+### 3.1 router/index.js — 大幅修改
+- 保留: /login, /register, /user/*, /base/*, /customer/*, /system/*, /ai/*, /error/404
+- 删除: /certify, /huoban/*, /weight/*, /tracing/*, /fei_screen, /brain, /tracing_screen, /common
+
+### 3.2 main.js — 修改
+- 移除 echarts 引用
+- 清理 staticPages 数组
+- 保留核心逻辑
+
+### 3.3 utils/request.js — 修改
+- 删除 isHuobanWebApi() 函数
+- 简化 resolveRequestToken()
+- 清理 staticPages
+
+### 3.4 store/modules/user.js — 修改
+- 删除 huobanToken state/mutation/action
+
+### 3.5 store/getters.js — 修改
+- 清理不存在的 module 引用（app/permission/errorLog/common）
+
+### 3.6 vue.config.js — 修改
+- 移除 MonacoWebpackPlugin
+- 移除 n8n 代理
+- 移除 echarts/monaco externals
+- 更新 outputDir 为 "authon-web"
+
+### 3.7 package.json — 修改
+- 移除: @amap/amap-jsapi-loader, @wangeditor/*, echarts, html2canvas, jspdf, monaco-editor/*, marked, highlight.js, qrcodejs2
+- 更新 name 为 "apes-Authon-Web"
+
+### 3.8 public/index.html — 修改
+- 更新 title 为 "apes-Authon"
+
+## Step 4: 与后端对应关系
+
+| 后端 Controller | 前端页面 | API 文件 |
+|----------------|----------|----------|
+| UserController | views/user/ | user.js |
+| PermissionController | views/permission/ | permissionApi.js |
+| CustomerController | views/customer/ | customerApi.js |
+| AppController | views/app/ | appApi.js |
+| MenuController | menuApi.js | menuApi.js |
+| AccessTokenController | views/customer/accessToken.vue | accessTokenApi.js |
+| SSOController | views/user/sso.vue, views/login/ | user.js |
+| CustomerPackageController | views/customer/packages.vue | customerPackageApi.js |
+| SysOrganizationController | views/system/organization/ | organizationApi.js |
+| SysOperationLogController | views/system/operationlog/ | — |
+| SysQuotaController | views/system/quota/ | quotaApi.js |
+| SysPackagePlanController | views/system/packagePlan/ | packagePlanApi.js |
+| LlmModelConfigController | views/system/llmModel/ | llmModelApi.js |
+| LlmAgentConfigController | views/system/llmAgent/ | llmAgentApi.js |
+| AiController | views/system/aiHelper/ | aiSkill.js |
+| LlmToolController | views/ai/tool.vue | llmToolApi.js |
+| LlmChatController | views/ai/chat.vue | — |
+| LlmConversationController | views/ai/conversationHistory.vue | llmConversationApi.js |
+
+## Step 5: 后续代办
+
+| 代办 | 说明 |
+|------|------|
+| Phase 5C: 伙伴云表单 | 7 .vue + 1 API，后端 5 Controller 待提取 |
+| Phase 4: SDK化 | AuthContext 远程调用 SDK |
+| Phase 5: 网关集成 | API 网关统一鉴权 |
+
+---
+
+*方案生成时间: 2026-08-09 | 源码版本: saas-web v1.0.0 | 框架: Vue 2.7 + Element UI 2.15*