zsp-project/docs/api/前端路由文档.md

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

作者: 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 转发至后端服务