112
社区成员
发帖
与我相关
我的任务
分享冰鉴InsightNews——α冲刺总结随笔
| 项目 | 内容 |
|---|---|
| 这个作业属于哪个课程 | 202501福大-软件工程实践-W班 |
| 这个作业要求在哪里 | 团队作业——站立式会议+α冲刺 |
| 这个作业的目标 | 总结 Alpha 冲刺阶段成果，规划与展望beta阶段开发 |
| 其他参考文献 | 《构建之法》、阿里巴巴Java开发手册终极版v1.3.0、华为内部代码规范、Google代码规范 |
目录
- 一、项目预期计划与现实进展
- 1.1 计划与实际对比
- 1.1.1 项目计划与实际完成
- 1.1.2 项目燃尽图
- 1.2 项目成果概览
- 1.3 Alpha 阶段模块完成情况
- 1.3.1 移动端 (Android)
- 1.3.2 Web 端
- 1.3.3 后端
- 1.4 Alpha 阶段尚存问题与未完善功能
- 二、团队协作与成长收获
- 2.1 成员心得体会
- 2.2 组员分工与协作
- 2.3 Alpha 阶段工作量比例
- 三、AI 技术员表现复盘与展望
- 3.1 Alpha 冲刺贡献分析
- 3.2 下一阶段协作展望
- 四、对下一阶段的期望
在此，我们对为期六天的 Alpha 冲刺阶段进行全面复盘。本次冲刺的核心目标是完成 InsightNews 项目的核心功能模块搭建，验证技术架构的可行性，并为下一阶段的开发奠定坚实基础。在团队成员的共同努力与 AI 技术员的高效辅助下，我们不仅成功完成了既定目标，更在多个方面取得了超越预期的成果。
一、项目预期计划与现实进展
1.1 计划与实际对比
1.1.1 项目计划与实际完成
团队的实际进展与计划高度一致，甚至在多个方面超越了预期。我们采用下表进行清晰对比，事实证明，团队在执行中展现了高度的灵活性和卓越的效率。
| 时间线 | 阶段核心目标 | Alpha 冲刺计划 | Alpha 冲刺实际完成情况 | 达成情况 & 分析 |
|---|---|---|---|---|
| Day 1-2 | 项目启动与基础框架搭建 | • 后端: 完成用户认证 (Auth) 与 UserController。• 前端: 搭建 auth, profile 等基础 UI。• Web端: 搭建 Vue 项目，构建登录/注册 Mock 流程。 | • 后端: 完成 auth 认证类及 controller 层的整体骨架。• 前端: 完成 Home, Profile, Explore 等核心页面框架。• Web端: 完成配置系统、API 模块、主题管理及登录界面。 | 100% 达成 团队迅速进入状态，各端均超额完成基础框架搭建，为后续开发奠定坚实基础。 |
| Day 3-4 | 核心功能实现 | • 后端: 实现 DetectionController。• 前端: 搭建 credibility 和 history 模块 UI。• Web端: 构建 Profile 及 EditProfile 界面。 | • 后端: 深入数据层，完成 DAO 层的 mapper 和 entity 构建。• 前端: 完成 credibility 及 detail_topic 页面，实现评论、点赞、收藏等核心交互。• Web端: 仪表盘数据可视化初版完成，增强了用户管理。 | 超越预期 后端策略性地优先构建数据层，更稳健。前端 B 组员郭昀琪大幅提前完成核心任务。Web 端胡喆昶已开始扩展计划外的功能。 |
| Day 5-6 | 功能深化与独立验收准备 | • 后端: 实现 TopicController 与评论/缓存。• 前端: 搭建 explore, detail 模块 UI。• Web端: 完善用户管理 Mock 流程。 | • 后端: 完成 service 和 dto 业务逻辑层，后端主体功能完备。• 前端: 重构和优化已有界面，完成退出登录等闭环功能。 • Web端: 使用 Chart.js 重构仪表盘，实现批量操作等高级功能。 | 超越预期 后端已准备好接口对接。前端不仅完成任务，还进行了优化。Web 端交付了一个功能强大的管理后台雏形，价值远超预期。 |
1.1.2 项目燃尽图
1.2 项目成果概览
经过六天的紧张开发，我们成功交付了 InsightNews 项目的 Alpha 版本，包含三大核心组件的可运行成果。
移动端 (Android):
管理端 (Web):
- 后端服务:
- 代码仓库: https://github.com/YuanaHao/InsightNews-backend
- 成果展示:
- demo安装包：
- 成果展示:
- 成果展示:
1.3 Alpha 阶段模块完成情况
1.3.1 移动端 (Android)
| 主要模块 | 负责人 | 内容项 | 完成情况 |
|---|---|---|---|
| 热点话题模块 | 郭昀琪 | 话题分类显示 | ✔ |
| 话题详情显示 | ✔ | ||
| 链接相关新闻 | ✔ | ||
| 评论、点赞功能 (UI及Mock逻辑) | ✔ | ||
| 话题收藏功能 (本地逻辑) | ✔ | ||
| 个人主页及认证模块 | 蒋嘉会 | 欢迎/注册/登录界面 | ✔ |
| 个人信息显示 | ✔ | ||
| 资料编辑 | ✔ | ||
| 新闻收藏 (本地逻辑) | ✔ | ||
| 历史记录 (本地逻辑) | ✔ | ||
| 话题收藏 (本地逻辑) | ✔ | ||
| 设置 | ✔ | ||
| 问题反馈 | |||
| 退出登录 | ✔ | ||
| 核心检测模块 | 蒋嘉会 | 检测主界面 | ✔ |
| 检测对话 (UI及Mock逻辑) | ✔ | ||
| 检测历史 (本地逻辑) | ✔ | ||
| 具体报告页 | ✔ |
1.3.2 Web 端
| 主要模块 | 功能 | 具体内容 | 完成情况 |
|---|---|---|---|
| 用户管理 | 管理功能 | 查看 | ✔ |
| 编辑 | ✔ | ||
| 删除 | ✔ | ||
| 批量操作 | 查看、删除 | ✔ | |
| 搜索功能 | 基础搜索 | ✔ | |
| 高级搜索 (筛选) | (部分实现) | ||
| 导出功能 | 导出为 xlsx, json | ✔ | |
| 仪表盘 | 用户趋势 | 活跃度、访问趋势、用户分布 | ✔ |
| 今日评论、话题浏览、来源占比 | ✔ | ||
| 用户活动 | ✔ | ||
| 访问管理 | 视图 | 多维度可伸缩查看 | ✔ |
| 搜索功能 | 基础搜索 | ✔ | |
| 高级搜索 (筛选) | (部分实现) | ||
| 导出功能 | 导出为 xlsx, csv | ✔ |
1.3.3 后端
| 主要模块 | 功能层 | 具体内容 | 完成情况 |
|---|---|---|---|
| 用户认证与管理模块 | Controller 层 | UserController (注册/登录/信息) | ✔ |
| Service 层 | UserService (业务逻辑) | ✔ | |
| DAO 层 | UserMapper, User Entity (数据库交互) | ✔ | |
| 核心逻辑 | JWT (Token 生成与验证) | ✔ | |
| 核心检测模块 | Controller 层 | DetectionController (上传/历史) | ✔ |
| Service 层 | DetectionService (对接AI服务, 结果存储) | ✔ | |
| DAO 层 | DetectionMapper, Detection Entity | ✔ | |
| 专题探究模块 | Controller 层 | TopicController (列表/详情/搜索) | ✔ |
| CommentController (评论/点赞) | ✔ | ||
| Service 层 | TopicService, CommentService | ✔ | |
| DAO 层 | TopicMapper, CommentMapper 等 | ✔ | |
| 基础设施 | 数据传输 | DTOs / VOs (各模块数据传输对象) | ✔ |
| 辅助工具 | Converters, Utils | ✔ | |
| 数据库 | 完成核心表结构设计 | ✔ |
1.4 Alpha 阶段尚存问题与未完善功能
| 优先级 | 模块 | 待办事项 |
|---|---|---|
| 高 | 全局 | 接口接入：完成所有前后端 API 的联调对接。 |
| 中 | 客户端 (Android) | • 注册/登录界面：部署专用的返回按键。 • 检测界面：完善界面贴图和视觉元素。 • 历史记录页面：实现批量管理（如批量删除）功能。 • 详细报告页面：实现文字高光及超链接跳转功能。 |
| 中 | Web端 | 管理界面功能尚未完整开发，数据看板有待丰富。 |
| 低 | 客户端 (Android) | • 欢迎界面：增加“找回密码”或“游客模式”等附加功能。 • 主界面：考虑增加快捷菜单以提升操作效率。 |
二、团队协作与成长收获
2.1 成员心得体会
| 团队成员 | 心得体会 |
|---|---|
| 胡喆昶 (Web端) | 从宏观架构到微观实现，我体验了“从0到1”的完整构建过程。 项目伊始，我着手搭建配置系统、API模块等核心架构，这让我深刻认识到，一个健壮的底层设计是项目成功的基石。 在“造轮子”与“用轮子”之间，我学会了明智权衡。 初期尝试用原生 Canvas 绘图，虽锻炼了底层能力，但效率和交互性瓶颈明显。后续果断引入 Chart.js，不仅提升了效率和体验，更让我领悟到：优秀的工程师要懂得借助社区生态的力量，聚焦于业务逻辑创新。整个冲刺过程，是一场生动的敏捷开发实践课。 从发现问题到快速响应，再到迭代优化，这种闭环模式让我深刻体会到敏捷开发的精髓——不仅要埋头写代码，更要抬头看方向，持续反思，不断改进。 |
| 蒋嘉会 (前端) | AI 是重复劳动的加速器，而非创造性工作的替代者。 在生成 UI 草稿、Fragment 跳转等技术含量低的代码时，AI 极具帮助。但当涉及 UI 精细化调整或复杂逻辑时，AI 会逐渐出错，例如因 padding 不当导致布局混乱，此时必须依靠程序员的经验手动排查。缺乏编程训练的人，无法单靠 AI 构建可用程序。 AI 能代替无趣的“搬砖”，但“建房子”的设计和搭建仍需程序员主导。有效的 AI 协作方式是：将任务拆解，提供清晰的上下文和依赖关系，避免因 Token 过多导致效率和精准度下降。 |
| 郭昀琪 (前端) | 技术架构设计是项目成功的性价比投资。 在本次冲刺中，我完成了从界面搭建到功能实现的全过程。前期投入时间规划代码结构，看似耗时，却在后续的功能扩展和问题修复中展现出巨大价值，事半功倍。 开发的核心是关注用户需求。 我们必须站在用户角度思考交互细节，模拟用户的各种操作，充分考虑边界情况，才能打造出真正可用的产品。 集体智慧的加乘效应是无可替代的。 每日站会不仅能及时发现个人难以察觉的问题，更能在思维碰撞中激发出更好的解决方案，让我深刻体会到团队配合的重要意义。 |
| 袁昊 (后端) | 架构先行与编码规范是后端开发的生命线。 采用分层架构保证了代码的清晰和可维护性。在开发过程中，我发现统一接口的命名规范、尽早封装可重用工具类等实践，能有效避免后期大规模返修和集成困难，是保证项目稳步推进的关键。 |
2.2 组员分工与协作
团队分工明确，协作紧密。每日的站立式会议确保了信息的高效流通，成员之间能够灵活互助，共同解决难题，形成了“1+1+1+1 > 4”的合力。
| 角色 | 成员 | Alpha 阶段核心职责 |
|---|---|---|
| 后端开发组 | 袁昊 | 负责后端整体分层架构设计与全部功能实现，确保 API 逻辑正确性。 |
| 前端开发组 (Android) | 蒋嘉会 | 负责认证、个人中心及核心检测流的 UI 与逻辑实现。 |
| 郭昀琪 | 负责专题探究、收藏与互动功能的 UI 与逻辑实现。 | |
| 前端开发组 (Web) | 胡喆昶 | 负责 Web 端整体开发，从项目搭建到高级功能的实现。 |
2.3 Alpha 阶段工作量比例
团队成员在本次冲刺中均投入了饱满的精力，工作量分布均衡。
| 学号 | 姓名 | 分工 | Alpha 阶段贡献度 |
|---|---|---|---|
| 102300433 | 袁昊 | 后端 | 25% |
| 102300316 | 蒋嘉会 | 前端 (Android) | 27.5% |
| 102300203 | 郭昀琪 | 前端 (Android) | 27.5% |
| 102300430 | 胡喆昶 | 前端 (Web) | 20% |
三、AI 技术员表现复盘与展望
3.1 Alpha 冲刺贡献分析
AI 技术员在本次冲刺中扮演了“高效的初级开发伙伴”和“不知疲倦的技术顾问”双重角色，其贡献主要体现在以下方面：
- 开发启动加速器： 在项目初期，AI 在技术方案验证（如
MVVMvs.findViewById）、依赖管理优化、后端DAO层骨架代码生成等方面提供了巨大帮助，显著缩短了项目的冷启动时间。 - 效率提升工具箱： 对于重复性、模板化的编码任务（如 UI 布局草稿、
RecyclerView适配器、DTO类定义），AI 能够快速生成可用代码，将开发者从“搬砖”工作中解放出来，更专注于核心业务逻辑。 - 代码质量“巡查员”： AI 协助识别了代码中的一些潜在问题，如硬编码字符串、缺失的
contentDescription等，对提升代码规范性和可访问性起到了积极作用。
然而，我们也清晰地认识到 AI 技术员的局限性，它是一把双刃剑：
- 缺乏深度理解： 在处理复杂的 UI 布局或业务逻辑时，AI 会出现“想当然”的错误（如
padding错乱），且无法理解整体架构进行有效调试。 - 上下文依赖严重： AI 的表现高度依赖于 Prompt 的质量。上下文信息不足或任务描述不清时，其输出质量会大幅下降。
3.2 下一阶段协作展望
基于 Alpha 阶段的宝贵经验，我们计划在下一阶段更智能、更高效地利用 AI：
- Prompt 工程化： 我们将制定一套 “AI 协作指令模板”，将任务需求（如“生成一个符合 MVVM 架构的 Fragment”）标准化，确保为 AI 提供最充足、最精确的上下文，提升其输出质量。
- 专攻测试用例生成： Beta 阶段的重点是测试。我们将引导 AI 针对后端的 Service 层方法，生成 Junit 单元测试用例，覆盖正常、异常和边界情况，极大地提升测试效率和代码覆盖率。
- 辅助文档撰写： 对于已完成的后端 API 接口，我们将利用 AI 辅助生成初始的 Markdown 格式的接口文档，再由人工进行校对和完善。
- 坚持“人类在环”原则： 我们将始终把 AI 定位为“辅助驾驶”而非“自动驾驶”。所有由 AI 生成的代码，尤其是核心业务逻辑，都必须经过开发者的严格审查和重构，确保最终代码的质量与可维护性。
四、对下一阶段的期望
Alpha 冲刺的成功为我们注入了强大的信心。在接下来的 Beta 冲刺阶段，我们将聚焦于解决当前存在的问题，核心目标如下：
| 序号 | 任务类别 | 具体任务描述 |
|---|---|---|
| 1 | 网络连接 | 最高优先级：完成客户端、管理端与后端 API 的全面对接和联调，实现真实数据的流动。 |
| 2 | 功能完善 | 集中精力完成“尚未完善的功能列表”中所有中高优先级的任务，确保核心业务流程完整可用。 |
| 3 | 测试与稳定 | 为后端核心服务编写单元测试，进行全面的集成测试，修复所有在联调中发现的 Bug，提升系统稳定性。 |
| 4 | UI/UX 打磨 | 对客户端和 Web 端的整体视觉和交互进行一轮优化，提升产品的专业度和用户体验。 |
...全文
请发表友善的回复…
发表回复
