1. 维护代码健壮

2. 更新项目结构文档

doc/frontend/admin.md

@@ -0,0 +1,54 @@
+# 管理后台前端
+
+`admin` 是平台管理后台，服务于运营、配置、财务和运维人员。
+
+## 基本信息
+
+- 目录：`admin/`
+- 技术栈：Vue 3、Vite、TypeScript、Arco Design、Pinia、axios
+- 页面入口：`/admin`
+- API 前缀：`VITE_APP_BASE_URL + /adminapi`
+- 开发默认后端：`http://127.0.0.1:8787`
+- 开发公共路径：`/admin`
+- 生产公共路径：`/`
+
+## 主要模块
+
+- 商户、商户分组、商户 API 凭证、商户策略
+- 支付方式、支付插件、插件配置、支付通道、轮询组与绑定
+- 路由解析预览
+- 支付订单、退款订单、清算订单
+- 商户账户、资金流水
+- 通道日统计、通道通知日志、支付回调日志、商户通知任务
+- 文件资产、系统菜单、字典、系统配置页面、管理员用户
+
+## 关键目录
+
+```text
+src/api/modules/       接口封装
+src/router/            静态路由和动态路由处理
+src/views/             页面
+src/store/             Pinia 状态
+src/components/        业务与通用组件
+```
+
+## 文件上传
+
+管理后台的文件资产接口是 `/adminapi/file-asset`。系统配置和插件配置中的上传字段仍使用 `type: "upload"`；需要走项目定制的图片/文件选择器时，在 `props.fileUpload` 中声明：
+
+- `selectorType`：`image` 或 `file`
+- `scene`：图片、证书、文本或其他场景
+- `isLocal`：是否强制本地存储
+- `isPublic`：是否公开访问
+- `getKey`：上传成功后回填的响应字段，常用 `url`、`object_key`、`preview_url`、`id`
+
+完整文件资产行为见 [文件资产](../backend/files.md)。
+
+## 常用命令
+
+```bash
+pnpm install
+pnpm dev
+pnpm build:prod
+pnpm preview
+```