| 这个作业属于哪个课程 | https://edu.cnblogs.com/campus/gdgy/SoftwareEngineering24 |
|---|---|
| 这个作业要求在哪里 | https://edu.cnblogs.com/campus/gdgy/SoftwareEngineering24/homework/15657 |
| 作业目标 | 对前两次团队作业成果进行总结与改进，完成“寝室管家Agent”的 Alpha 冲刺计划与冲刺总结，展示项目阶段成果、成员分工、过程体会与后续改进方向。 |
| 团队名称 | Gitclub |
| 团队成员 | 3224004535-王广禺 3224004536-谢诗晴 |
一、冲刺计划
在前两次团队作业中，我们已经完成了“寝室管家Agent”的需求分析、项目定位、原型设计、概要设计和数据库设计。项目最初的目标是面向大学生宿舍场景，围绕值日排班、费用分摊、晚归/门禁/查寝提醒、寝室公约、矛盾调解和天气提醒等功能，设计一个轻量化、实用型的微信小程序。
经过前期讨论后，我们发现原先规划的功能较完整，但如果全部在 Alpha 阶段一次性实现，开发压力较大，也不利于快速形成可演示版本。因此，本次冲刺阶段的核心思路是先完成一个可运行的 MVP 版本：优先实现登录、首页、日程、记账、天气、寝室公约、AI 沟通辅助、个人中心等基础功能，让项目从“需求和原型”推进到“可以运行和展示”的阶段。
本次冲刺的改进方向主要有三个。第一，将前期原型中的主要页面落地为微信小程序代码，保证页面之间可以正常跳转，整体视觉风格保持统一。第二，将 AI 能力与具体宿舍场景结合，不单独做一个普通聊天窗口，而是围绕矛盾调解、沟通话术、天气建议等内容进行设计。第三，先采用本地存储和本地后端服务进行功能联调，降低开发复杂度，优先保证演示流程完整，再在后续版本中接入云数据库、正式部署和多人协同能力。
1. 冲刺阶段目标
| 目标编号 | 冲刺目标 | 具体说明 |
|---|---|---|
| 1 | 完成小程序基础页面搭建 | 完成登录页、首页、日程页、记账页、我的页面等基础页面，实现底部 TabBar 和主要页面跳转 |
| 2 | 完成首页信息聚合 | 首页展示问候语、天气信息、今日值日、今日提醒，并提供天气提醒、晚归提醒、寝室公约、矛盾调解等入口 |
| 3 | 完成日程与值日基础功能 | 支持日历展示、日期选择、新建日程、查看选中日期的日程内容 |
| 4 | 完成记账与分摊基础功能 | 支持新增账单，统计本月支出和待分摊金额，并给出分摊提示 |
| 5 | 接入 AI 沟通辅助 | 通过本地 Node.js 服务转发 AI 接口请求，实现输入问题后返回沟通建议 |
| 6 | 接入天气提醒能力 | 通过后端天气接口获取温度和天气状态，前端根据天气给出带伞、关窗、防暑、保暖等建议 |
| 7 | 完成寝室公约模块 | 支持新增、保存、查看和删除寝室公约 |
| 8 | 完成个人中心功能 | 支持设置宿舍信息、查看我的值日记录、查看账单分摊记录和退出登录 |
| 9 | 完成测试与总结 | 对主要流程进行联调测试，整理截图、总结问题并完成冲刺总结博客 |
2. 冲刺阶段安排
| 阶段 | 时间安排 | 主要任务 | 预期产出 |
|---|---|---|---|
| 第一阶段 | 第 1-2 天 | 整理前两次作业成果，确认 Alpha 阶段功能边界，搭建小程序项目结构 | 明确冲刺目标，完成页面目录和基础配置 |
| 第二阶段 | 第 3-6 天 | 开发首页、日程、记账、我的等核心页面 | 可运行的小程序主流程 |
| 第三阶段 | 第 7-9 天 | 开发 AI 沟通辅助、天气接口、寝室公约功能 | AI 对话、天气提醒、公约管理功能 |
| 第四阶段 | 第 10-12 天 | 页面联调、数据本地存储、异常情况处理、界面优化 | 可完整演示的 Alpha 版本 |
| 第五阶段 | 第 13-14 天 | 整理 GitHub 仓库、截图、PPT、vlog 和冲刺总结 | 完成博客、答辩材料和展示准备 |
3. 成员实际承担工作与工作量
| 成员 | 角色定位 | 实际承担工作 | 工作量比例 |
|---|---|---|---|
| 王广禺 | 前端开发、页面设计、文档整理 | 负责微信小程序整体页面结构搭建，完成 app.json 页面配置和 TabBar 配置；开发首页、日程页、记账页、我的页面等主要界面；完成页面跳转、数据展示、本地缓存读取与部分交互逻辑；负责项目截图整理、PPT 展示材料和博客内容整合 |
50% |
| 谢诗晴 | AI 接口、后端联调、业务逻辑测试 | 负责 AI 沟通辅助功能设计与接口联调；编写和调试 Node.js 后端服务，完成 /chat 和 /weather 接口；参与天气提醒、寝室公约、记账分摊等业务逻辑测试；协助完善功能说明、测试过程记录和总结内容 |
50% |
4. 计划中的重点改进
本次冲刺计划中，我们没有继续停留在需求分析和原型设计阶段，而是把重点放在“实现”和“演示”上。相比前两次作业，本阶段重点改进如下：
第一，项目从静态原型推进到微信小程序代码实现。前期原型中的首页、日程、记账、我的等页面已经在小程序中形成实际页面，并可以通过底部导航栏进行切换。
第二，AI 功能不再只停留在概念层面，而是通过本地后端接口进行了实际调用。用户可以在矛盾调解页面输入宿舍沟通问题，系统返回对应的表达建议。
第三，天气提醒从前期设想变成了可演示功能。系统可以获取天气和温度，并结合宿舍生活场景给出带伞、防暑、保暖等提示。
第四，项目的数据流和交互流程更加清晰。日程、账单、公约、宿舍信息等内容先通过本地缓存保存，虽然还不是最终形态，但已经能够支撑 Alpha 阶段的演示和测试。
二、冲刺总结
1. 项目整体完成情况
本次 Alpha 冲刺阶段，我们围绕“寝室管家Agent”的核心宿舍管理场景，完成了一个可以运行和展示的微信小程序版本。项目已经具备登录、首页、日程、记账、我的、天气提醒、寝室公约、AI 沟通辅助等基础功能，整体上实现了冲刺计划中“先完成 MVP 可运行版本”的目标。
从完成情况来看，前期计划中的大部分功能都已经得到实现或初步实现。其中，页面结构、底部导航、首页信息聚合、日程管理、账单记录、寝室公约、个人中心、天气提醒和 AI 沟通辅助已经能够在小程序中运行。与前两次作业中的原型和概要设计相比，本次冲刺最大的进展是项目已经从“文档设计阶段”进入“代码实现阶段”。
不过，部分功能目前仍属于简化版本。例如，费用分摊目前主要实现了账单记录和总额提示，尚未实现按成员自动计算每个人应付金额；值日功能目前更多依赖日程记录，还没有完成完整的自动轮换算法；提醒功能目前以页面提示和弹窗为主，尚未接入微信服务通知或定时推送；数据存储主要依赖本地缓存，还没有完成云数据库和多用户同步。因此，本次 Alpha 版本更适合作为课程展示和功能验证版本，后续仍需要继续迭代。
2. 冲刺计划完成情况对照表
| 计划改进项 | 实现情况 | 说明 |
|---|---|---|
| 小程序基础页面搭建 | 已完成 | 已完成登录页、首页、日程页、记账页、我的页面、天气页、公约页、AI 帮助页、我的值日记录和账单记录等页面 |
| 底部导航栏与页面跳转 | 已完成 | 首页、日程、记账、我的四个主要页面可以通过 TabBar 切换 |
| 首页信息聚合 | 已完成 | 首页可以展示问候语、天气信息、今日值日、今日提醒，并提供主要功能入口 |
| 日程与值日基础功能 | 基本完成 | 已完成日历展示、日期选择、新建日程和日程列表展示；值日自动轮换仍需继续完善 |
| 记账与分摊基础功能 | 部分完成 | 已支持新增账单、本月支出统计和待分摊金额提示；多人精确分摊功能还需加强 |
| AI 沟通辅助 | 基本完成 | 已通过后端 /chat 接口调用 AI 服务，用户输入问题后可以获得回复 |
| 天气提醒 | 基本完成 | 已通过后端 /weather 接口获取天气，并在前端生成宿舍生活建议 |
| 寝室公约 | 基本完成 | 已支持新建、保存、查看和删除公约 |
| 个人中心 | 基本完成 | 已支持宿舍信息设置、值日记录、账单记录和退出登录 |
| 联调测试与展示材料 | 已完成 | 已完成小程序运行截图、PPT 整理和博客总结内容 |
3. 项目亮点
本项目最大的亮点是选题贴近真实大学生宿舍生活。值日、记账、晚归、门禁、查寝、沟通矛盾、天气提醒等问题都是大学生日常生活中经常遇到的场景，因此项目不是单纯为了展示技术，而是围绕真实需求进行设计。
第二个亮点是将 AI 能力和宿舍场景结合起来。项目没有把 AI 做成一个泛泛的聊天功能，而是尝试把它用于宿舍矛盾调解、委婉表达建议和生活提醒，让 AI 功能更贴近实际使用场景。例如，当用户遇到“室友太吵”“值日分配不均”等问题时，可以通过 AI 获取更温和的沟通话术，减少直接冲突。
第三个亮点是小程序形式轻量便捷。微信小程序不需要额外安装 App，适合大学生日常快速使用。本项目采用蓝白色为主的简洁界面风格，页面结构清晰，首页、日程、记账和我的四个主要模块划分明确，降低了使用门槛。
第四个亮点是 Alpha 阶段已经形成了可运行版本。相比前两次作业中的需求分析、原型设计和概要设计，本次冲刺已经有了实际代码、页面截图和联调结果，能够进行完整演示，说明项目已经具备继续迭代的基础。
4. 项目目前存在的不足
第一，后端和数据库实现还不够完整。前期概要设计中规划了较完整的后端分层架构和数据库设计，但 Alpha 阶段为了优先完成可运行演示，暂时采用了 Node.js 本地服务和微信本地缓存。这样的方式便于快速开发，但还不适合正式上线，也无法很好地支持多人宿舍数据同步。
第二，值日排班算法仍需完善。目前日程页面可以添加日程，也能展示选中日期的安排，但值日自动轮换、按成员公平分配、任务完成状态统计等功能还没有完全实现。后续需要补充宿舍成员列表、轮换规则和任务状态字段。
第三，费用分摊功能还比较简化。目前记账模块可以记录消费金额并统计本月总支出，但还没有实现按参与成员、付款人、已付/待付状态进行精确分摊。后续应该支持选择参与人、计算人均金额、生成分摊记录，并能查看个人待付账单。
第四，提醒功能还没有做到真正自动推送。目前天气提醒、晚归提醒更多是页面内弹窗或点击触发，尚未实现服务通知、定时任务或后台自动提醒。后续需要结合微信订阅消息、云函数定时触发等方式完善。
第五，接口安全性和部署方式仍需改进。当前接口主要用于本地调试，后续需要将 API Key 等敏感配置迁移到环境变量或服务器配置中，避免直接出现在代码中。同时，后端服务也需要从本地 IP 调用升级为公网部署或云函数部署，提升稳定性和安全性。
第六，测试覆盖还不够系统。目前主要完成了人工测试和演示流程测试，缺少完整的测试用例表、异常输入测试、真机兼容测试和多人协同测试。后续需要补充测试计划，记录 Bug 修复过程，提高项目可靠性。
5. 每位成员完成内容及工作量比例
| 成员 | 完成内容 | 工作量比例 |
|---|---|---|
| 王广禺 | 完成小程序前端主框架搭建，配置页面路径和底部 TabBar；开发首页、日程、记账、我的等主要页面；完成天气入口、晚归提醒入口、寝室公约入口、AI 帮助入口等页面跳转；参与本地缓存数据读取与展示；整理项目运行截图、PPT 展示内容和博客总结材料 | 50% |
| 谢诗晴 | 完成 AI 沟通辅助功能设计与后端接口联调；开发 Node.js 本地服务，完成 AI 对话接口和天气接口；协助实现天气提醒建议、公约管理、记账分摊等业务逻辑；参与功能测试、问题排查和总结内容整理 | 50% |
6. 成员过程体会
王广禺过程体会
这次 Alpha 冲刺让我更加明显地感受到，从原型设计到代码实现之间还有很长一段距离。前期做原型时，很多页面只需要考虑布局是否清楚、功能入口是否完整，但真正写小程序时，需要处理页面路径、数据存储、事件绑定、页面跳转、状态更新等细节。例如首页要展示今日天气、今日值日和提醒，就需要考虑数据从哪里来、什么时候刷新、没有数据时如何显示。
在开发过程中，我也认识到前端不是简单地把界面画出来，而是要把用户操作流程串起来。日程页、记账页和我的页面看似独立，但它们之间的数据有联系，必须保证用户操作后能看到反馈。通过这次冲刺，我对微信小程序的页面结构、TabBar 配置、本地缓存和基础交互有了更清晰的理解，也体会到团队协作中及时同步进度的重要性。
谢诗晴过程体会
这次冲刺让我对 AI 接口接入和前后端联调有了更具体的认识。前期设想 AI 功能时，感觉只要能调用大模型就可以，但实际开发时发现，还需要考虑请求格式、接口地址、错误处理、返回内容展示等问题。尤其是在小程序请求本地后端服务时，需要不断调试网络地址和接口返回格式，才能让前端页面正常展示 AI 回复。
同时，我也认识到 AI 功能必须服务于具体业务场景。宿舍管家Agent的重点不是单纯聊天，而是帮助用户解决宿舍生活中的沟通问题和提醒问题。因此，在后续优化中，应该继续围绕“宿舍矛盾调解”“寝室公约生成”“天气生活建议”等场景设计提示词和交互方式，让 AI 回复更加稳定、实用、贴近大学生生活。
7. 团队协作总结
本次冲刺过程中，团队主要采用分工协作的方式推进。王广禺主要负责小程序前端页面、界面展示和文档整理，谢诗晴主要负责 AI 接口、后端服务和业务逻辑联调。两人在开发过程中会根据运行结果及时调整功能范围，优先保证主要功能可以演示。
本次协作中做得比较好的地方是目标比较明确。我们没有一开始就追求把所有规划功能全部实现，而是先确定 Alpha 阶段的核心目标：完成可运行、可展示、能体现项目特色的版本。这使得项目能够在有限时间内形成成果。
不足之处是前期任务拆分还可以更细。有些功能在开发时才发现工作量比预期大，例如值日自动轮换、费用多人分摊、提醒自动推送等，都需要更完整的数据结构和后端支持。后续团队需要在每次迭代前进一步拆分任务，明确每个功能的输入、输出、数据结构和验收标准。
8. 后续改进方向
后续我们计划从以下几个方向继续完善项目。
第一，完善后端和数据库。将目前的本地缓存逐步迁移到云数据库或正式后端数据库中，实现宿舍、成员、账单、日程、公约等数据的统一管理。
第二，完善值日自动排班。增加宿舍成员管理、轮换规则设置、任务状态记录和历史值日记录，让值日功能真正做到自动分配和公平轮换。
第三，完善费用分摊。支持选择付款人、参与人、消费类型和备注，自动计算每位室友应付金额，并生成已付/待付状态。
第四，优化 AI 功能。围绕寝室公约生成、矛盾调解、沟通话术、生活建议等场景设计更稳定的提示词模板，让 AI 输出更加符合宿舍生活语境。
第五，完善提醒机制。后续接入微信订阅消息或云函数定时任务，实现值日提醒、晚归提醒、查寝提醒、天气提醒的自动推送。
第六，加强测试和部署。补充测试用例表，进行真机测试、异常输入测试和多人场景测试，同时将后端服务部署到稳定环境中，减少本地 IP 调试带来的限制。
9. 总结
总体来看，本次 Alpha 冲刺基本完成了预期目标。我们将前两次作业中的需求分析、原型设计和概要设计转化为了可以运行的小程序版本，完成了首页、日程、记账、我的、天气、寝室公约和 AI 沟通辅助等功能。虽然当前项目仍有不少不足，例如后端部署、数据库、多用户同步、自动推送和精确分摊等功能还需要继续完善，但本次冲刺已经为项目后续迭代打下了基础。
通过这次冲刺，我们更加明确了项目的核心价值：不是做一个功能堆叠的小程序，而是做一个真正贴近大学生宿舍生活的智能小助手。后续我们会继续围绕“实用、轻量、智能、易用”的方向进行优化，让寝室管家Agent更完整、更稳定，也更符合真实用户需求。
仓库链接
https://github.com/rg3homework/rg3homework/tree/miannian_AIAPI