双前端对齐清单（Vue / React）
本仓库提供两套管理端前端，对接同一 /api/admin（及平台 /api/platform）契约。
主从约定
| 角色 | 目录 | 说明 |
|---|---|---|
| 主发货 UI（shipping） | html/（Vue 3） | 默认上线前端；文档截图、生产 Docker BUILD_FRONTEND=1、历史功能与 codegen Vue 模板以此为准 |
| 对等展示实现（peer showcase） | html-react/（React 19） | 与 Vue 同仓库维护的 React 展示端；CI 独立 type-check / test / build，新功能优先落在 Vue |
新功能、修 Bug、改请求约定时：先 Vue（html/），再跟进 React（html-react/）。理想情况两端同 PR；若短期只能改一端，在 PR 中注明另一端跟进项。
改动时检查
- [ ] API 路径、query、body 字段与后端一致
- [ ] 权限 slug / 菜单路由两端都有对应页面或隐藏逻辑（Vue 先合入即可）
- [ ]
X-Tenant-ID/tenant_code公共资源 query（applyTenantHeader/withTenantQuery）行为一致 - [ ] i18n 文案键两端都有（或共用后端
error_code） - [ ] 模块开关（
orders_enabled/payments_enabled等）前端默认与后端一致 - [ ] 能走代码生成器的 CRUD：优先生成 Vue；React 模板可同批或随后补齐
- [ ] 新增纯工具函数：两端各加最小 vitest（参考
src/utils/tenant.test.*）
代码生成
后端 app/services/templates/ 含 Vue 与 React 列表/表单模板。优先用生成器，再手工补差异（树形、仪表盘等）。