1.3 KiB
1.3 KiB
和气平台总后台
基于 Vue 3、Vite、TypeScript、Pinia 和 Arco Design 的平台管理端。前端资源、API 路径和操作能力以后端 resource-contract 为基准。
环境要求
- Node.js >= 20.19.0
- pnpm
- Go（同步后端契约时使用）
常用命令
pnpm install
pnpm dev
pnpm type:check
pnpm lint
pnpm contract:sync
pnpm contract:check
pnpm build
contract:sync 从 backend/api/cmd/cli resource-contract 生成
src/contracts/platform-resources.json。修改后端模型或路由后必须重新同步。
实现约定
- 后端 API 使用扁平资源路径，例如
/product_info、/wallet_basic。 - 浏览器路由按业务域分组，例如
/product/product-info。 - 普通资源复用
views/shared/ResourcePage.vue。 - 产品、钱包、气体配送订单的状态流转通过后端业务动作执行，不直接修改状态字段。
- 关联资源统一提交业务
identity，不提交数据库自增 ID。 - 管理端仅提供中文界面。
环境变量
| 变量 | 说明 |
|---|---|
VITE_API_BASE_URL |
可选覆盖后端 API 地址；开发默认 http://localhost:12426/heqi/platform/v1，生产构建默认 http://rest.heqiapp.com/heqi/platform/v1 |
VITE_ERROR_REPORT_URL |
可选的前端错误上报地址 |