# PRD｜汤甜甜个人作品集与学习效率平台

> 产品需求文档 · V1.0 · 2026-10-16  
> 项目：TTT-homework · 课程：生成式大模型辅助编程与软件工程实践

## 1. 产品定位

面向课程教师和同学，建立一个可公开访问的个人作品展示网站，集中呈现个人介绍、项目成果、学习技能、学习博客及课程文档；同时让访客实际体验待办管理、Markdown 笔记、天气查询、倒计时与随机点名等功能。网站兼顾“作品展示”和“真实可操作的软件”。

**用户角色：** 访客浏览作品与博客、使用效率工具；内容维护者通过内容管理页编辑展示文案。课程作业以实际网页、源代码、文档及可复现的功能测试为验收依据。

## 2. MVP 核心功能与验收

| 编号 | 模块 | 用户需求与验收标准 |
| --- | --- | --- |
| FR-01 | 个人主页 | 展示姓名、个人简介、作品介绍，进入各功能页 |
| FR-02 | 项目展示 | 展示待办、笔记、天气、倒计时、点名五个可体验项目，入口可用 |
| FR-03 | 技能展示 | 展示技能标签及学习方向，可由管理页调整 |
| FR-04 | 学习博客 | 在首页展示文章标题、日期及简介，内容可以维护 |
| FR-05 | 任务管理 | 新增、修改、完成、删除、筛选、搜索、排序、导入导出任务 |
| FR-06 | Markdown 笔记 | 新建、编辑、预览、删除、自动保存、导出笔记 |
| FR-07 | 天气查询 | 按城市查询天气及短期预报，处理请求失败和超时 |
| FR-08 | 倒计时 | 自定义时间、开始、暂停、恢复、重置 |
| FR-09 | 随机点名 | 管理名单、单轮不重复抽取、查看与重置记录 |
| FR-10 | 内容管理 | 通过 /admin/ 修改个人展示文案、技能、项目介绍和博客条目，保存后刷新主页可见 |
| FR-11 | 交付文档 | 提供 PRD.md、TECH_DESIGN.md、AGENTS.md 以及原有工程文档 |
| FR-12 | 多端体验 | 桌面与手机均可访问，主要操作无明显溢出或遮挡 |

## 3. 优先级与产品边界

**MVP：** FR-01、02、05—09、11、12；**课程扩展：** FR-03、04、10。产品优先保障现有功能稳定，随后补全个人展示内容与可视化管理。

本项目部署为**静态站点**。待办、笔记、点名以及本次新增的内容管理修改保存在当前浏览器的 localStorage。**内容管理属于本地演示模式，不是带服务器账号、数据库和跨设备同步的真实运营后台**；不同浏览器不能自动共享修改。需要所有访客同步看到更新内容时，应修改仓库的默认内容并重新发布，或后续接入经认证的后端/CMS。

## 4. 交互与视觉规范

延续已有深蓝色侧边栏、卡片式项目展示和浅色主界面；顶部导航清晰，页面中提供作品、技能、博客与文档入口。后台编辑界面使用独立布局，字段有标签、保存反馈、重置确认及数据导入导出。所有用户输入在展示时采用安全文本渲染，不将任意输入当作 HTML 执行。

## 5. 非功能需求

- **可用性：** 不登录也可浏览首页和使用现有工具；保存与删除有反馈。
- **兼容性：** 现代 Chrome/Edge 浏览器，适配桌面及移动端。
- **安全与隐私：** 个人任务/笔记不上传服务器；管理页不应被描述为真实安全认证后台；禁止在前端写入密码或 API Token。
- **性能：** 核心页面可快速加载，避免新增重型前端依赖。
- **可维护性：** 新增功能模块化，不修改原有任务、笔记、计时和点名的关键算法。
- **验收：** 测试页面路由、个人信息保存后刷新、博客/项目渲染、手机布局及原功能回归测试。

## 6. 交付清单

1. GitHub 源代码仓库与项目根目录三份开发文档。
2. 三份 Markdown 文档的内容截图。
3. 已部署网站的真实浏览器截图，展示首页及内容管理页。
4. 已实际验证能够访问的公网部署地址。

> 部署要求参考课程课件：首选 Vercel 或 Cloudflare Pages；GitHub Pages 也属于静态托管，但是否满足本次指定平台要求以教师要求为准。