6bcde94388
统一平台、气站和配送点后台的服务关系业务名称展示。 新增气站、配送点、服务人员三级联动及暂未分配语义。 后端补充组织归属、人员角色和启用状态的严格校验。 补充前后端测试、项目文档、操作日志及本机日志忽略规则。
和气平台总后台
基于 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 |
可选的前端错误上报地址 |