22 lines
762 B
Markdown
22 lines
762 B
Markdown
# ADR-0002：前后端开发与生产托管
|
|
|
|
- 状态：已接受
|
|
- 日期：2026-10-18
|
|
|
|
## 决策
|
|
|
|
开发环境由 Vite 提供 React 页面，并将 `/api` 代理到 `http://127.0.0.1:3000` 的 Axum 服务。
|
|
|
|
生产环境先构建 React 静态资源，再由 Axum 托管构建产物。未知的非 `/api` 路由回退到 `index.html`，以支持 React Router。
|
|
|
|
## 原因
|
|
|
|
- 开发时保留 Vite HMR 和快速反馈。
|
|
- 生产时只发布一个后端可执行程序及静态资源目录，降低 Windows 本地部署复杂度。
|
|
- 同源访问可以减少 CORS 和 Cookie/令牌配置的复杂度。
|
|
|
|
## 影响
|
|
|
|
- 后端必须明确区分 API 404 和前端路由回退。
|
|
- 静态资源托管将在 Phase 6 交付时接入，Phase 1 只完成开发代理。
|