## ADDED Requirements ### Requirement: 开发期后端端口一致性 项目 SHALL 保证文档化的全栈开发命令中,Vite proxy 目标端口与 Bun 后端监听端口来自同一配置来源。 #### Scenario: 使用默认开发端口 - **WHEN** 开发者未提供端口覆盖并运行文档化的全栈开发命令 - **THEN** Bun 后端 SHALL 监听默认端口,且 Vite SHALL 将 `/api/*` 代理到同一端口 #### Scenario: 使用 PORT 覆盖开发端口 - **WHEN** 开发者通过 `PORT` 覆盖后端端口并运行文档化的全栈开发命令 - **THEN** Bun 后端 SHALL 监听该端口,且 Vite SHALL 将 `/api/*` 代理到同一端口 #### Scenario: 避免代理端口与后端端口分叉 - **WHEN** 开发期脚本需要向 Vite 传递后端端口 - **THEN** 该代理端口 MUST 从文档化的后端端口配置派生,而不是作为独立对外配置导致分叉 ### Requirement: 开发质量命令文档化 项目 SHALL 在前端开发工作流文档中说明日常检查和完整验证命令。 #### Scenario: 查阅开发命令 - **WHEN** 开发者阅读 README 的开发或测试章节 - **THEN** 文档 SHALL 说明 `check` 用于日常开发检查,`verify` 用于提交前或发布前完整验证