docs: specify new product survey step four

dev-QQq
chenyuan 3 weeks ago
parent 8613cf70cc
commit 93ac67967a

@ -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 生产构建。
Loading…
Cancel
Save