Appearance
切换后端
前端 不区分 Java 还是 Python,只通过 VITE_API_BASE_URL 指向 API 根地址。
配置方式
Web
在 packages/web 下创建或修改 .env.development:
env
VITE_API_BASE_URL=http://localhost:8080| 后端 | 地址 |
|---|---|
| server-java | http://localhost:8080 |
| server-python | http://localhost:8000 或你自定义的 --port 8080 |
Desktop
packages/desktop/.env.development 同样配置 VITE_API_BASE_URL。
Mobile
packages/mobile 中 API client 的 baseURL 配置(见 mobile 源码 src/api/client.ts)。
契约对齐要求
两个后端必须实现相同的:
- 路径:
/api/v1/auth/login、/api/v1/system/users等 - JSON 字段:camelCase(
accessToken、pageSize) - 响应格式:
{ code, message, data } - 权限码:
system:user:list等 12 个字符串 - 401 / 403 中文错误信息
详见 契约层概览。
对比测试建议
- 用同一套 Web 前端
- 分别指向 Java 8080 和 Python 8000
- 验证:登录、菜单、用户 CRUD、无权限 403