生成式大模型辅助编程与软件工程实践 · 正式交付文档

软件规格说明书

项目名称: 汤甜甜 · AI 编程实践作品集
项目负责人: 汤甜甜
文档版本: V2.0
实训依据:《生成式大模型辅助编程与软件工程实践实训方案》(2026034版)

1 项目背景与目标

围绕实训方案提出的“需求澄清—方案设计—迭代开发—测试审查—版本管理—部署交付”,制作个人课程作品集网站,并提供可交互的进阶待办、Markdown笔记和天气查询模块。验收以实际网页操作、源代码检查、测试记录与部署证据为依据。

2 用户与使用场景

主要用户为学生本人及教师。教师通过浏览器查看个人项目与验收文档;学生通过待办记录任务,通过笔记整理课程知识,通过天气功能查询城市天气。无需注册账户,操作保持为单浏览器本地数据。

3 功能需求清单

编号 功能 验收判据
F01 作品集首页 展示汤甜甜姓名、课程项目、三个可交互模块和文档入口
F02 基础待办 可以新建、查看、完成任务
F03 进阶待办 能修改、删除、设置优先级与截止日期,支持查询和筛选
F04 任务统计 能展示总任务、待完成、已完成和完成比例
F05 数据持久化 刷新页面后数据仍在,可用JSON导入导出备份
F06 Markdown笔记 新建、修改、删除、预览、自动保存和导出.md文件
F07 天气查询 查询城市当前天气和预报,网络异常显示失败原因
F08 移动端兼容 适配窄屏,导航与主要交互可用
F09 项目资料查看 公开网站可直接打开实训报告、五类工程文档与代码库

4 非功能需求

稳定性: 页面模块加载正常,合法输入与异常输入均有处理;易用性: 主要功能无需教程即可操作,删除等高风险操作有确认;隐私性: 待办与笔记不上传到服务器;可测试性: 核心业务规则提供自动化测试;可部署性: 前端静态资源使用相对路径,可放入GitHub Pages。

5 数据处理与边界

任务与笔记保存在当前浏览器的localStorage,不支持跨设备账户同步;换浏览器、清理网站数据会导致原本地数据不可见。天气使用Open-Meteo公共接口,请求需联网;“实时天气”指接口提供的最近观测/模型数据,不保证实时刷新频率。Markdown为基础语法安全子集。

6 验收结论口径

“功能完成”由页面行为和测试支持;零代码平台课堂使用、Cursor个人操作、现场问卷、考勤,以及尚未获得证据的步骤,不应以网站上线代替。