# 中尚鹏管理系统 - 前端路由文档

```
作者: rovina
最近修订: 2026/3/2
```

---

## 一、路由结构概览

前端基于 Vue 3 + Vue Router，采用扁平化二级路由结构。路由模块位于 `frontend/pure-admin-thin/src/router/modules/`。

---

## 二、合同管理模块路由

| 路径 | 名称 | 组件 | 说明 |
|------|------|------|------|
| `/system/contract` | 合同管理 | - | 父级重定向到业务合同管理 |
| `/system/contract/add-contract/index` | AddContract | AddContract.vue | **业务合同管理**：单合同录入、批量上传归档 |
| `/system/contract/zhongshangpeng/index` | ZhongshangpengContract | ZhongshangpengContract.vue | **中尚鹏合同管理**：公司合同文件夹、合同文件、详情表格 |
| `/system/contract/company-info/index` | CompanyInfo | CompanyInfo.vue | **公司信息管理** |

### 2.1 业务合同管理（AddContract）

- **单合同管理**：左侧按合同类型筛选（全部/采购/上游/下游），右侧合同列表，支持新增、编辑、删除
- **批量上传**：左侧批量归档文件夹，右侧批量记录列表，支持新建文件夹、批量上传文件

### 2.2 中尚鹏合同管理（ZhongshangpengContract）

- 文件夹归类、合同上传、合同详情（商品/数量/单价/已提货/未提货等）
- Excel 导入导出合同详情
- **前后端已对接**：数据从 `/api/zsp-contract` 接口加载

### 2.3 公司信息管理（CompanyInfo）

- 管理公司相关文件（营业执照、税务登记证、开票信息等）
- 文件夹分类、文件上传、查看、下载、删除
- **前后端已对接**：数据从 `/api/company` 接口加载

---

## 三、其他模块路由（简要）

| 模块 | 路径前缀 | 说明 |
|------|----------|------|
| 首页 | `/`, `/welcome` | 首页 |
| 提货管理 | `/system/delivery/*` | 我要提货、提货明细、库存、货权转移 |
| 财务管理 | `/system/finance/*` | 货代费用、杂费、服务费、成本构成、利润、结算、发票、对账单 |
| 查询报表 | `/system/query-report/*` | 合同执行、营业明细、其它明细、商品基础资料 |
| 采购管理 | `/system/purchase/*` | 采购报单、采购运踪、国外供应商、采购预算 |
| 更新看板 | `/system/changelog/index` | **更新内容看板**：展示系统更新记录 |

---

## 四、路由配置说明

- 路由定义：`src/router/modules/contract.ts` 等
- 自动导入：`src/router/index.ts` 通过 `import.meta.glob` 自动加载 `modules/**/*.ts`（排除 remaining.ts）
- 菜单渲染：`constantMenus` 用于侧边栏菜单展示

---

## 五、API 请求前缀

合同相关接口统一使用 `/api` 前缀，经 Vite 代理转发至后端：

- 开发环境：`/api/*` → `http://127.0.0.1:8080/api/*`
- 生产环境：需配置 Nginx 或同类反向代理将 `/api` 转发至后端服务