Alpha 冲刺总结
| 项目 | 内容 |
|---|---|
| 课程 | 软件工程双学位 2026 |
| 作业 | 团队第三次作业 — Alpha 冲刺 |
| 团队名称 | 【Language for Life】 |
| 团队成员 | 王振妃、关欣玥 |
| 作业目标 | 完成 Alpha 冲刺阶段的项目开发与总结，展示项目前端实现、团队协作过程与阶段性成果 |
一、冲刺计划改进实现情况
本次冲刺我们严格按照 7 天计划推进，并在计划基础上完成了前后端合并与后端能力补全，主要成果如下。
1. 前端页面实现
对照墨刀原型完成微信小程序页面搭建，并完成与后端的业务联调（非纯静态演示）。除登录、首页、院校三步流程（选方向 / 列表 / 详情）、番茄计时、数据统计、AI 答疑外，还实现：
- 备考计划（配置 → 生成动画 → 三阶段结果展示）
- 作文 AI 批改（提交批改、维度评分、修改建议、历史记录）
- 学习进度（任务列表、状态切换、完成率环形进度）
- 个人中心、管理后台（登录 + 数据概览）
底部自定义 tab-bar 组件完成主导航，页面跳转与原型主流程一致。
2. 后端与数据库设计
按《数据库设计说明书》完成集合规划，主要包括：users、universities、focus_sessions、qa_logs、study_plans、essay_reviews 等。
搭建统一 API 网关 backendApi（20 个 action），覆盖：
| 模块 | 主要 action |
|---|---|
| 用户 | getOrCreateUser、getUserProfile、updateProfile |
| 院校 | listDirections、listUniversities、getUniversityDetail、seedUniversities |
| 专注 | addFocusSession、listFocusSessions、getWeeklyStats |
| AI 答疑 | addQaLog、listQaLogs |
| 备考计划 | generateStudyPlan、getStudyPlan、listStudyTasks、updateStudyTask、addStudyTask |
| 作文批改 | submitEssayReview、listEssayReviews |
| 管理后台 | adminLogin、getAdminStats |
实现 utils/api.js 双环境适配：
- 配置
miniprogram/config/cloud.js并填写云环境 ID 后，走云函数 + 云数据库； - 未配置云环境时自动本地降级（
wx.storage），答辩现场可稳定演示。
另部署 cozeChat 云函数，用于云端代理 Coze Token（本地模式可走 coze.config.local.js 直连）。
3. AI 功能接入
完成 Coze「考研英语小助手」智能体配置（提示词优化 + 考研知识库），在小程序侧实现：
- 备考画像自动注入（方向、院校、水平、每日学习时长）
- 多轮对话（
conversationId维护） - 问答记录落库（
addQaLog/listQaLogs，AI 页可恢复历史） - 备考计划生成：优先调用 Coze 输出 JSON 三阶段计划，失败则回退规则模板（
planBuilder） - 作文批改：云函数 / 本地 API 内统一调 Coze，解析 JSON 结构化评分，失败则规则兜底
- 「本周计划」：联动
getStudyPlan，无计划时再向 Coze 询问
形成 「画像 → Coze → 结构化结果 / 日志存储」 业务闭环。
4. 项目完善与交付物准备
- 完成页面调试与前后端联调优化；
- Alpha 可演示主路径：登录（快速体验 / 微信快捷登录）→ 选方向 / 院校 → 首页 → 备考计划生成 → 番茄专注（4 种模式）→ 复盘统计 → AI 答疑 → 作文批改 → 学习进度（可选：管理后台
admin/123456）； - 录制并剪辑 3–5 分钟 Vlog；
- 完善 GitHub 仓库文档（
BACKEND_ALPHA.md、前后端合并说明.md、前端同学对接说明.md）； - 准备答辩 PPT。
说明：云开发函数与库表已在项目中实现；当前团队答辩演示以 本地存储模式 为主，全量上云部署留待 Beta 阶段。
二、项目亮点与不足
项目亮点
- 前端完整复刻墨刀原型，核心页面均已完成 UI + 业务联调，视觉效果与设计稿高度一致。
- 后端 统一 API 网关（20 action）+ 本地 / 云双模式，适配答辩现场「无云环境也能完整演示」的需求。
- AI 形成多场景闭环：智能答疑、备考计划生成、作文批改，均支持画像注入与记录追溯。
- 院校模块从手写输入升级为 6 大方向 + 15 所推荐院校 结构化选择与筛选（
catalog.js）。 - 管理后台提供用户 / 专注 / 答疑等概览统计，并具备 Token 鉴权。
- 团队分工明确，前端、后端、文档、视频制作同步推进，按计划完成冲刺阶段任务。
项目不足
- 云开发部署：代码已支持云开发，但当前以本地降级演示为主；环境 ID 配置、集合权限、索引优化等需在 Beta 完善。
- 数据可视化：统计页为基础按日 / 按模式聚合，ECharts 等 richer 图表 待 Beta 迭代。
- AI 稳定性：计划与批改依赖 Coze 返回 JSON；Token 未配置或网络异常时会回退模板 / 规则评分，效果弱于专用工作流。
- 账号体系：演示账号 +
wx.login创建用户，尚未实现完整微信开放平台账号 / 权限体系。 - 部分页面在不同机型上的 响应式与细节适配 仍有优化空间。
三、每位成员的过程体会
关欣玥（前端 / Vlog）
本次冲刺让我对微信小程序开发流程有了完整实践：从页面搭建、样式优化到与 api 的交互联调，一步步把墨刀原型变成了可运行的小程序。同时完成了 Vlog 的拍摄与剪辑，体会到软件工程迭代节奏和前后端协作的重要性。
王振妃（后端 / AI / 文档）
通过本次冲刺，完成了数据库设计、backendApi 网关（20 个 action）、Coze 接入（画像注入、JSON 解析、本地降级）以及前后端合并联调。对 API 设计与 AI 落库有了更直观的理解，也熟悉了 GitHub 维护、Release 发布和答辩文档编写，感受到联调时接口约定与降级方案的重要性。
四、成员工作量与完成内容
| 成员 | 完成内容 | 工作量占比 |
|---|---|---|
| 关欣玥 | 前端页面搭建（含计划 / 作文 / 进度 / 管理等页面）、样式与交互、tab-bar 导航、与后端联调、Vlog 拍摄与剪辑、冲刺计划与总结博客撰写 |
50% |
| 王振妃 | 数据库与云开发方案设计、backendApi 统一网关（20 action）、cozeChat 与端侧 Coze 接入、备考计划 / 作文 / 管理接口、本地降级方案、前后端合并与文档、GitHub 维护与 Release、答辩 PPT |
50% |
五、相关链接
- 冲刺计划：https://www.yuque.com/g/willow-fihmg/qipgk6/zo1zv1hax0gdbnt0/collaborator/join?token=1CNPlsafMTIgKkJt&source=doc_collaborator# 《冲刺计划》
- 项目 GitHub 仓库：https://github.com/willowwanglala-glitch/Software-Engineering-Assignment-2026
- 原型在线预览：https://b6smkq1g.site.modao.ink