71 lines
2.9 KiB
Markdown
Executable File
71 lines
2.9 KiB
Markdown
Executable File
# 中尚鹏管理系统 - 前端路由文档
|
||
|
||
```
|
||
作者: 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` 转发至后端服务
|