docs(h5): 更新 README 技术栈与环境依赖

- 简介修正为实际技术栈 (Vite8/Vue3.5/Vant4, 非 vben/antd)

- 环境依赖更新为 Node 22/24 LTS + pnpm >=10

- 新增技术栈表与环境配置说明

- 补充 type:check/lint 命令
This commit is contained in:
bootx
2026-06-23 17:55:17 +08:00
parent fdad827349
commit 7aa186f165

View File

@@ -1,27 +1,59 @@
# DaxPay移动H5端
# DaxPay 移动 H5
## 简绍
DaxPay 开源版支付系统的移动端网关应用,基于 vue3-vant4-mobile 模板搭建。
vite5 + vue3.4 + vben admin2 + antd vue4 搭建
## 技术栈
| 技术 | 版本 | 说明 |
| ---------- | ---- | ---------------------------------------------- |
| Vue | 3.5 | 前端框架 |
| Vite | 8.x | 构建工具 |
| TypeScript | 5.9 | 开发语言 |
| Vue Router | 5.x | 路由hash 模式) |
| Pinia | 3.x | 状态管理pinia-plugin-persistedstate 持久化) |
| Vant | 4.x | 移动端 UI 组件库 |
| UnoCSS | 66.x | 原子化 CSS |
| @vueuse | 14.x | 组合式工具集 |
| Axios | 1.x | HTTP 请求 |
| vconsole | 3.x | 移动端调试面板(仅 dev 动态加载) |
## 环境依赖
| 环境 | 版本 | 备注 |
| ---- | -------- | -------------------------------- |
| Node | >=20.9.0 | 低版本无法进行构建 |
| pnpm | >=9.0.2 | 低版本会导致 pnpm-lock.yaml 失效 |
| 环境 | 版本 | 备注 |
| ---- | --------------------- | ------------------------------------ |
| Node | ^22.13.0 \|\| ^24.0.0 | 仅支持 LTS22/24低版本无法构建 |
| pnpm | >=10.0.0 | 包管理器,强制 pnpm禁用 npm/yarn |
> 项目通过 `packageManager` 字段锁定 pnpm@10.32.1,启用 corepack 后会自动切换到对应版本。
## 启动命令
```shell
# 安装项目依赖
pnpm install
# 启动项目
# 启动开发服务器(端口 9100
pnpm run dev
# 构建打包
pnpm build
# 类型检查
pnpm run type:check
# 代码检查 / 自动修复
pnpm run lint
pnpm run lint:fix
```
## 环境配置
| 文件 | 说明 |
| ------------------ | -------------------------------------------------------------------- |
| `.env` | 应用基础信息(标题、端口) |
| `.env.development` | 开发环境(代理 `/server``http://127.0.0.1:19999`、vconsole 开启) |
| `.env.production` | 生产环境(接口前缀、压缩配置) |
## License
本项目基于 [GNU LGPL v3.0](./LICENSE) 协议开源,同时受[《用户授权使用协议》](./USER-AGREEMENT.txt)约束。在使用前请阅读上述协议,如果不同意请勿进行使用。