# 10-static-deployment-nginx:静态资源部署与 Nginx History 托管任务计划 > 对应 Spec:`docs/specs/10-static-deployment-nginx.md`。本文件是“静态资源部署与 Nginx History 托管”的独立执行计划,任务必须按编号串行完成。 ## 模块范围 - 当前实现基线:`frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则。 - 目标实现边界:`admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream。 - 默认验证命令:`npm run build`、`nginx -t`、`curl -i`;本地无 Nginx 时使用容器/测试配置完成真实 HTTP 验证。 - 每个任务均需先写测试并确认 RED,再实现到 GREEN;不得用占位实现、纯回显或静态文本替代真实业务。 ## 模块依赖 - 本模块任务范围:181-200。 - 前置依赖:任务 180;跨模块依赖必须以总计划中的完成状态为准。 - 页面任务依赖壳层和 Session;Java/数据库任务依赖对应现有模块和真实测试环境;最终验收任务依赖全部前置模块。 ## 统一测试与准出规则 每个任务至少包含 8 个测试:3 个正常路径、3 个边界条件、2 个异常/错误处理。涉及 I/O、数据库、文件、Nginx 或外部服务时,除 mock 外至少添加 1 个真实集成/真实请求测试。 ## 任务 181:确认后台 dist 发布目录约定 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:180 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 检查 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream,不得修改无关模块。 ### 测试用例(必须先写,确认 RED) 1. `test_task_181_confirm_dist_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_181_confirm_dist_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_181_confirm_dist_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_181_confirm_dist_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_181_confirm_dist_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_181_confirm_dist_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_181_confirm_dist_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_181_confirm_dist_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 182:确认 Vite base 和 Router base 一致 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:181 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 检查 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 的现状,明确本任务涉及的文件、命令、输入输出和回归边界;将检查结果写入测试或验收记录,确认目标实现为 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream,不得修改无关模块。 ### 测试用例(必须先写,确认 RED) 1. `test_task_182_confirm_vite_base___router_base_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_182_confirm_vite_base___router_base_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_182_confirm_vite_base___router_base_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_182_confirm_vite_base___router_base_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_182_confirm_vite_base___router_base_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_182_confirm_vite_base___router_base_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_182_confirm_vite_base___router_base_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_182_confirm_vite_base___router_base_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 183:定义 index.html 缓存策略 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:182 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 index.html 缓存策略”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_183_define_indexhtml_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_183_define_indexhtml_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_183_define_indexhtml_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_183_define_indexhtml_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_183_define_indexhtml_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_183_define_indexhtml_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_183_define_indexhtml_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_183_define_indexhtml_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 184:定义 hashed assets 缓存策略 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:183 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 hashed assets 缓存策略”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_184_define_hashed_assets_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_184_define_hashed_assets_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_184_define_hashed_assets_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_184_define_hashed_assets_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_184_define_hashed_assets_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_184_define_hashed_assets_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_184_define_hashed_assets_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_184_define_hashed_assets_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 185:定义 /admin 重定向规则 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:184 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 /admin 重定向规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_185_define__admin_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_185_define__admin_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_185_define__admin_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_185_define__admin_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_185_define__admin_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_185_define__admin_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_185_define__admin_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_185_define__admin_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 186:定义 /admin-vue/ 静态 location **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:185 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 /admin-vue/ 静态 location”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_186_define_admin_vue__location_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_186_define_admin_vue__location_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_186_define_admin_vue__location_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_186_define_admin_vue__location_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_186_define_admin_vue__location_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_186_define_admin_vue__location_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_186_define_admin_vue__location_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_186_define_admin_vue__location_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 187:定义 assets 优先匹配规则 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:186 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 assets 优先匹配规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_187_define_assets_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_187_define_assets_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_187_define_assets_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_187_define_assets_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_187_define_assets_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_187_define_assets_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_187_define_assets_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_187_define_assets_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 188:定义 History fallback 规则 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:187 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 History fallback 规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_188_define_history_fallback_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_188_define_history_fallback_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_188_define_history_fallback_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_188_define_history_fallback_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_188_define_history_fallback_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_188_define_history_fallback_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_188_define_history_fallback_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_188_define_history_fallback_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 189:定义静态资源 404 规则 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:188 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义静态资源 404 规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_189_define_404_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_189_define_404_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_189_define_404_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_189_define_404_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_189_define_404_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_189_define_404_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_189_define_404_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_189_define_404_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 190:定义 /api/ Java upstream 代理 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:189 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 /api/ Java upstream 代理”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_190_define__api__java_upstream_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_190_define__api__java_upstream_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_190_define__api__java_upstream_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_190_define__api__java_upstream_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_190_define__api__java_upstream_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_190_define__api__java_upstream_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_190_define__api__java_upstream_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_190_define__api__java_upstream_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 191:定义 Cookie 和转发请求头规则 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:190 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义 Cookie 和转发请求头规则”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_191_define_cookie_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_191_define_cookie_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_191_define_cookie_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_191_define_cookie_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_191_define_cookie_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_191_define_cookie_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_191_define_cookie_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_191_define_cookie_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 192:定义临时发布目录结构 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:191 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义临时发布目录结构”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_192_define_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_192_define_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_192_define_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_192_define_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_192_define_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_192_define_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_192_define_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_192_define_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 193:定义原子切换和回滚结构 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:192 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 为“定义原子切换和回滚结构”建立明确的数据/组件/接口边界,至少写清字段来源、类型、空值、排序、失败语义和调用方;设计必须落在 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 范围内,不能用无类型大对象掩盖边界。 ### 测试用例(必须先写,确认 RED) 1. `test_task_193_define_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_193_define_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_193_define_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_193_define_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_193_define_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_193_define_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_193_define_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_193_define_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 194:实现构建产物清单校验 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:193 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现构建产物清单校验”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_194_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_194_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_194_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_194_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_194_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_194_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_194_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_194_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 195:实现静态资源 MIME 验证 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:194 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现静态资源 MIME 验证”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_195_implement_mime_verify_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_195_implement_mime_verify_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_195_implement_mime_verify_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_195_implement_mime_verify_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_195_implement_mime_verify_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_195_implement_mime_verify_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_195_implement_mime_verify_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_195_implement_mime_verify_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 196:实现桌面路由刷新验收脚本 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:195 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现桌面路由刷新验收脚本”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_196_implement_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_196_implement_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_196_implement_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_196_implement_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_196_implement_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_196_implement_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_196_implement_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_196_implement_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 197:实现不存在资源 404 验收脚本 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:196 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 实现“实现不存在资源 404 验收脚本”:以 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 为落点,明确输入、输出、状态转换、边界和错误反馈;保留 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 中仍被批准的业务语义,禁止 stub、纯回显和硬编码结果。 ### 测试用例(必须先写,确认 RED) 1. `test_task_197_implement_404_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_197_implement_404_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_197_implement_404_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_197_implement_404_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_197_implement_404_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_197_implement_404_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_197_implement_404_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_197_implement_404_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 198:验证生产 base URL 引用完整 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:197 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 对“验证生产 base URL 引用完整”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 与 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 的契约。 ### 测试用例(必须先写,确认 RED) 1. `test_task_198_verify_base_url_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_198_verify_base_url_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_198_verify_base_url_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_198_verify_base_url_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_198_verify_base_url_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_198_verify_base_url_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_198_verify_base_url_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_198_verify_base_url_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 199:验证 Nginx 与 Java API 联通 **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:198 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 对“验证 Nginx 与 Java API 联通”做前后端或迁移前后对比验证,覆盖至少两种有效输入、空/边界输入和依赖异常;验收结果必须能够追溯到 `frontend-vue` 的客户端构建流程、Java 旧静态入口、部署文档和 Nginx 规则 与 `admin-frontend-vue/dist` 独立目录、`/admin-vue/` location、`/admin` redirect 和 Java upstream 的契约。 ### 测试用例(必须先写,确认 RED) 1. `test_task_199_verify_nginx___java_api_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_199_verify_nginx___java_api_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_199_verify_nginx___java_api_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_199_verify_nginx___java_api_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_199_verify_nginx___java_api_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_199_verify_nginx___java_api_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_199_verify_nginx___java_api_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_199_verify_nginx___java_api_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 任务 200:完成真实 Nginx 部署 smoke **所属模块**:静态资源部署与 Nginx History 托管 **依赖**:199 **预估耗时**:8-15 分钟(写测试 + 实现 + 自测) ### 功能点要求 完成“完成真实 Nginx 部署 smoke”的端到端收口:串联本模块真实入口、核心业务调用、错误处理和资源清理,确认输出不是输入纯回显且不产生遗留计时器、请求或敏感日志。 ### 测试用例(必须先写,确认 RED) 1. `test_task_200_completereal_nginx__smoke_normal_primary_path` — 正常主路径:使用最小有效输入,验证功能输出符合目标契约。 2. `test_task_200_completereal_nginx__smoke_normal_variant_input` — 正常变体:使用第二种有效输入或另一种业务分支,验证不是只支持单一样例。 3. `test_task_200_completereal_nginx__smoke_normal_repeated_operation_is_idempotent` — 正常重复:重复相同操作,验证不会重复提交、重复渲染或污染已有状态。 4. `test_task_200_completereal_nginx__smoke_boundary_empty_input` — 边界空值:空列表、空字符串或缺省请求按模块语义处理,不崩溃。 5. `test_task_200_completereal_nginx__smoke_boundary_single_item` — 边界单元素:单条记录/单节点/单次请求的结果和排序正确。 6. `test_task_200_completereal_nginx__smoke_boundary_limit_or_missing_field` — 边界上限:最大页/长度/超时/缺字段输入得到明确、可控的结果。 7. `test_task_200_completereal_nginx__smoke_invalid_input_rejected` — 异常输入:非法类型、非法状态或越权输入被拒绝,并使用预期错误类型。 8. `test_task_200_completereal_nginx__smoke_dependency_failure_returns_actionable_message` — 依赖失败:HTTP、数据库、文件或浏览器依赖不可用时释放资源并返回可操作错误信息。 ### TDD 流程 1. 先写以上全部测试,运行对应命令确认 **RED(目标行为尚未实现时应失败)**;若测试一开始通过,先检查测试是否真正断言了目标行为。 2. 实现本任务功能,重新运行同一测试集确认 **GREEN(全部通过)**。 3. 运行类型检查、lint、format、相关集成测试和真实调用;修复所有失败后才能提交。 ### 验证方法 执行 `npm run build`、Nginx 配置检查和真实 `curl -i`;静态文件和 HTTP 代理任务必须有配置解析/模拟测试与真实 HTTP 请求;禁止只检查文本存在。 ### 准出标准 - 测试、类型检查和格式检查通过;错误路径有明确消息,资源得到释放。 - 真实调用证明结果来自实际业务逻辑,不是硬编码模板或输入原样回显。 - 只修改本任务允许的文件范围,完成后提交包含任务编号的 git commit。 ## 模块完成条件 - 任务 181-200 全部按 TDD 流程完成并有对应 commit。 - 关联 Spec 中的接口、类型、迁移注意事项和验收标准均有测试或真实验证记录。 - 不留下旧后台的无效引用,不改变未授权的客户端版本接口契约。