task_pilot/docs/decisions/0002-static-hosting.md

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