# 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 只完成开发代理。