diff --git a/docs/superpowers/specs/2026-08-07-new-product-survey-step4-design.md b/docs/superpowers/specs/2026-08-07-new-product-survey-step4-design.md new file mode 100644 index 0000000..51a4f27 --- /dev/null +++ b/docs/superpowers/specs/2026-08-07-new-product-survey-step4-design.md @@ -0,0 +1,35 @@ +# 新产品调查与分析:第四步 AI 应用价值分析 + +## 范围 + +仅调整学生端“新产品调查与分析”(`new-product-survey`)的第四步,以及支持最终提交完整度校验的学生接口。保留前 1 至 3 步、案例资料下载、教师端、管理端和既有答案表结构。 + +## 页面与交互 + +第四步标题为“AI应用价值分析”。页面按原型展示说明“结合上面实训,针对AI技术在产品中的应用价值进行分析,回答以下问题。”,随后依次提供三个多行文本框: + +1. 核心层:AI技术是否实现产品功能突破?是否形成差异化卖点? +2. 有形层:AI技术是否影响产品形态?如产品外形包装、电商主图设计、参数配置、价格带定位。 +3. 延伸层:AI技术如何通过服务升级、内容更新提升用户粘性,推动付费服务? + +学生可随时保存草稿,草稿不强制填写。点击“提交任务”时,前端去除首尾空白后检查三项均非空;任一为空则阻止提交并提示缺少的层级。通过本地校验后调用后端校验,后端确认通过才复用既有答案保存接口以 `SUBMIT` 方式提交。 + +## 数据与接口 + +答案继续保存在既有 `StudentTrainingAnswer.step4Answer`,结构保持兼容: + +```json +{ + "coreValue": "核心层分析", + "tangibleValue": "有形层分析", + "extendedValue": "延伸层分析" +} +``` + +后端新增仅学生可调用的 `POST /api/student-training-answers/new-product-survey/step-4/validate`。请求使用同一结构,校验学生身份及三项文本去首尾空白后均非空;成功返回 `{ "valid": true, "message": "校验通过" }`。该接口不评判分析内容,不新增表或标准答案。 + +演示模式不调用后端,执行同样的本地规则。旧版已保存的第 4 步 JSON 继续由现有兼容逻辑读取。 + +## 验证 + +后端测试覆盖三项均填写、任一缺失和非学生访问,以及控制器透传。前端测试覆盖原型问题文案、提交前调用第四步校验接口与 `step4Answer` 的持久化;完成后运行完整 Maven 测试、前端静态测试和 Vite 生产构建。