WmsLite.Web
Umi Max 4 + Ant Design 5 + ProComponents 前端,负责 WMS 主数据、库存、单据和作业工作台体验。后端见 WmsLite.Api,仓库总览见 ../README.md。
技术栈
- React 18、TypeScript
@umijs/max4、Ant Design 5、ProComponentsreact-activation多标签 Keep-Alive
路由与模块
| 路径 | 说明 |
|---|---|
/login |
登录页,无业务 Layout |
/home |
作业工作台,展示单据与库存入口 |
/base/* |
仓库、库区、分区、库位、物料、容器 |
/inventory/* |
库存余额、库存流水 |
/orders/* |
入库单、出库单、移库单、盘点单 |
/templates |
系统模板 |
路由配置在 config/config.ts,标签标题映射在 src/constants/routeTabTitles.ts。
认证与请求
- 登录接口:
POST /api/Auth/login,成功后写入localStorage:wmslite-token:JWTwmslite-user:用户摘要 JSON
services/api.ts和app.tsx会自动携带Authorization: Bearer <token>。- HTTP 401 会清除本地登录状态,并跳转到
/login?redirect=...。 - 前端不再向业务接口传
tenantId/ownerCode,租户和货主由后端从 JWT 解析。 - 全局字典由
DictionaryProvider在已登录状态加载/api/SysDictionary/map。
默认开发账号:admin / admin123。
布局与多标签
- 使用 ProLayout
mix布局:侧边菜单 + 顶部工作区标签。 - 标签栏由
LayoutHeaderTabs渲染,采用浅色轨道 + 胶囊标签样式,和顶部 Header 融为一个整体。 - 首页标签固定显示 Home 图标,且不可关闭。
- 标签 key 使用归一化后的
pathname + search:/会归一化为/home,避免点击左上角图标后生成“页面”标签。- 最多打开 12 个标签;超过上限时优先关闭最早的非首页标签。
- 右侧更多按钮提供:关闭当前、关闭其他、关闭全部。
- 关闭全部或关闭最后一个业务标签后,保留并跳转到
/home。 - 页面内容由
LayoutKeepAliveOutlet包裹,尽量保留列表筛选、表单状态和滚动位置。
主要页面体验
Home:作业工作台,展示入库、出库、移库、盘点统计卡片、作业优先级和常用入口。OrderPage:四类单据统一页面。- 入库、出库支持先创建 Draft 单头,再在详情抽屉中追加明细。
- 出库物料明细无需填写单位,由物料主数据单位自动带出。
- 出库详情展示拣货任务,支持单任务确认拣货后再确认出库。
- 单据状态使用颜色标签,详情抽屉顶部展示单据概要。
CrudPage:主数据通用 CRUD 页面。
本地开发
1. 启动后端
cd ../WmsLite.Api
dotnet run --launch-profile http
后端默认地址:http://localhost:9901。
2. 启动前端
cd WmsLite.Web
pnpm install
pnpm run dev
前端通常监听 http://localhost:8000 或 Umi 自动分配的下一个可用端口;/api 会代理到 http://localhost:9901。
3. 质量检查
pnpm run typecheck
pnpm run build
pnpm run lint
当前项目约定不新增自动化测试任务,阶段验收以 typecheck、build、lint 和人工业务场景为主。
目录结构
WmsLite.Web/
├── config/config.ts # Umi 配置、路由、代理
├── src/
│ ├── app.tsx # 布局、request、initialState、退出登录
│ ├── services/api.ts # HTTP 封装、401 处理、业务 API
│ ├── utils/auth.ts # Token / 用户本地存储
│ ├── contexts/ # 字典、多标签状态
│ ├── components/ # CrudPage、OrderPage、Layout*
│ ├── pages/ # 业务页面
│ └── types/ # 前端 DTO 类型
├── .eslintrc.js
└── .stylelintrc.js
关键源码
| 主题 | 文件 |
|---|---|
| 运行时布局与请求拦截 | src/app.tsx |
| 标签状态与关闭逻辑 | src/contexts/TabLayoutContext.tsx |
| 顶部标签栏 UI | src/components/LayoutHeaderTabs.tsx |
| Keep-Alive 内容容器 | src/components/LayoutKeepAliveOutlet.tsx |
| 单据页面 | src/components/OrderPage.tsx |
| HTTP 封装 | src/services/api.ts |
| 全局视觉样式 | src/global.less |
注意事项
- 若 API 未启动,前端代理会报
ECONNREFUSED,请先启动WmsLite.Api。 - 同一路径如需打开多个实例,需要通过 query 增加实例标识,否则会复用同一个标签 key。
react-activation对深层弹窗或 Portal 场景可能存在边界问题;若单页异常,可针对该路由调整缓存策略。