Merge branch 'develop' of https://bdgit.educoder.net/hnu202326010204/MuseGuard into develop

doc/process/weekly/week-15/group/meeting-minutes-15.md

@@ -0,0 +1,40 @@
+# 小组会议纪要-第15周
+
+## 会议记录概要
+
+**团队名称：** 2班-深度思考
+**指导老师：** 刘琴
+**主 持 人：** 胡帆
+**记录人员：** 金郅博
+**会议主题：** 第十四周情况总结、第十五周Beta最终收尾与全面测试部署、项目验收准备
+**会议地点：** 中楼211
+**会议时间：** 2025-12-29 11:40-12:20
+**纪录时间：** 2025-12-29 20:00
+**参与人员：** 胡帆、梁浩、杨博文、金郅博、杨逸轩
+
+## 会议内容
+
+### 一、本周核心任务聚焦
+
+本周是项目开发的最后窗口期，下周末即将进行项目验收。经团队讨论，本周必须完成所有开发和测试工作，下周项目将进入稳定运行阶段，不再进行任何代码修改。聚焦以下四大主线任务：
+
+1. **Beta开发收尾**：前端组完成UI最终优化打磨，确保界面视觉效果和交互体验达到交付标准；模型组完成迅疾加噪的完整运行测试；后端组完成与前端和模型组的接口对接工作，确保数据流转顺畅。
+2. **前端UI复核debug**：解决宽比例屏幕页面不居中、日志查看页面浅色模式显示异常、瘦长比例屏幕UI元素被裁切等问题；完成VIP开通页面前后端联调和迅疾加噪前端调用逻辑对接。
+3. **全面测试**：严格对照需求规格说明书和项目测试扣分点逐项验证，采用白盒测试与黑盒测试相结合的策略，编写完整的软件测试文档，测试结束后对代码进行清理工作。
+4. **文档编写复核**：开发工作完成后，进行文档编写复核。更新使用示例和截图使其与实际功能一致，补充鸣谢部分内容，明确License部分的开源许可协议。
+
+### 二、任务分解与执行安排
+
+| 序号 | 任务内容                  | 负责人                     | 关键时间节点 | 主要职责说明                                                                                                                                                                                                                                                                                                                                                                                 |
+| :--- | :------------------------ | :------------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1    | **Beta最后收尾**    | 杨逸轩、胡帆、杨博文、梁浩 | 01.02前      | 前端组负责完成UI的最终优化打磨，确保界面的视觉效果和交互体验达到交付标准，同时完成与后端和模型组的接口对接工作；模型组需要完成迅疾加噪的完整运行测试，确保算法在各种输入场景下都能稳定输出正确结果，并记录运行时间和资源消耗等性能指标；后端组承担着承上启下的关键角色，需要与前端对接页面功能接口、与模型组对接算法调用接口，确保数据流转顺畅无阻                                           |
+| 2    | **前端UI复核debug** | 杨逸轩、胡帆               | 01.02前      | 修复宽比例屏幕（16:9、16:10、21:9等）页面内容不居中、留白过多的问题；修复日志查看页面浅色/白天模式下文字颜色与背景对比度不足、部分元素显示异常的问题；修复瘦长比例屏幕下部分UI元素被裁切或重叠的"吞UI"问题；完成VIP开通页面的前后端联调；对接迅疾加噪的前端调用逻辑                                                                                                                          |
+| 3    | **全面测试**        | 全体人员                   | 01.05前      | 严格对照需求规格说明书中的功能清单和项目测试扣分点逐项进行验证；采用白盒测试与黑盒测试相结合的方式；借助自动化测试框架（如pytest、Jest等）和大模型辅助工具提高测试效率和覆盖率；测试过程中发现的问题及时记录并分配给相应负责人修复，修复后需进行回归测试；编写完整的软件测试文档，记录测试用例、测试结果、缺陷列表、修复情况等内容；对代码进行清理工作，删除测试桩代码、调试日志、临时注释等 |
+| 4    | **文档编写复核**    | 杨博文、金郅博             | 01.05前      | 更新使用示例和截图使其与实际功能一致；补充鸣谢部分内容，对开源项目、第三方库、参考资料等进行致谢说明；明确License部分的开源许可协议；确保文档内容与最终交付版本完全一致                                                                                                                                                                                                                      |
+
+### 三、上周总结+本周待改进问题
+
+1. **Beta版本开发基本完成**：上周完成了Beta 0.5收尾、VIP充值界面开发、整体UI优化、软件测试报告编写、前后端规范化重构等核心任务，系统已达到可正式交付的标准。本周需完成最后的UI适配问题修复和功能对接工作。
+2. **全面测试**：测试工作将严格对照需求规格说明书和项目测试扣分点进行，确保每一个功能点都经过充分测试、每一个潜在扣分项都得到妥善处理。测试过程中发现的问题需及时修复并进行回归测试。
+3. **文档工作需与最终版本一致**：文档复核工作安排在测试之后进行，确保文档内容与最终交付版本完全一致，避免出现文档与实际功能脱节的情况。
+4. **时间节点严格把控**：本周是Beta版本开发的最后冲刺期，团队需严格把控时间节点——周四前完成所有开发工作，周日前完成测试和文档等收尾工作，确保项目完整落地。下周项目将进入稳定运行阶段，不再进行代码修改，为验收做最后准备。本周恰逢元旦假期，希望团队成员合理安排时间，在保证任务进度的前提下注意劳逸结合，尽早高质量完成各项工作。

doc/process/weekly/week-15/group/weekly-summary-14.md

@@ -0,0 +1,29 @@
+# 小组周总结-第14周
+
+## 团队名称和起止时间
+
+**团队名称：** 2班-深度思考队
+**开始时间：** 2025-12-22
+**结束时间：** 2025-12-29
+
+## 本周任务完成情况
+
+| `<span style="display:inline-block;width:40px">`序号 | `<span style="display:inline-block;width:70px">`总结内容 | `<span style="display:inline-block;width:70px">`是否完成 | `<span style="display:inline-block;width:500px">`情况说明                                                                                                                                                                                                                                                                                                                                       |
+| ------------------------------------------------------ | ---------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1                                                      | Beta 0.5收尾工作                                           | 完成                                                       | 杨逸轩完成了前端表格UI的视觉优化和交互细节调整，提升了数据展示的清晰度和用户体验。梁浩完成了下载接口的更新与测试，确保用户能够顺利导出处理结果。前后端完成了剩余功能模块的联调测试，排查并修复了数据传输、格式转换等问题，Beta 0.5已具备完整的功能闭环。                                                                                                                                          |
+| 2                                                      | Beta剩余基础功能开发                                       | 部分完成                                                   | 杨逸轩和梁浩完成了VIP充值界面的前后端开发（模拟功能），实现了充值流程的完整闭环。整体UI优化设计工作顺利推进，胡帆与杨逸轩共同完成了黑白两种KT风格组件的开发，对原有UI进行了完整重构，提升了产品的专业度和美观度。但管理员系统（资源管理与CRUD）由于后端对管理员权限校验逻辑进行了重构，且数据库E-R图在管理员关联项上有所调整，导致API接口未能按时交付，前端已完成静态布局，待下周接口稳定后联调。 |
+| 3                                                      | 后端规范化重构                                             | 完成                                                       | 杨博文与梁浩借助Vibe Coding等工具，对后端代码进行了系统性的规范化重构。完成了代码结构的分层调整，统一了命名规范，提取了公共逻辑为工具函数，优化了异常处理和日志记录机制，添加了必要的代码注释和文档说明。重构过程中确保了对外接口的向后兼容，未影响已完成对接的前端功能。                                                                                                                         |
+| 4                                                      | 前端规范化重构                                             | 完成                                                       | 杨逸轩与金郅博配合完成了前端代码的深度规范化重构。建立了清晰的项目目录结构，统一了组件命名和代码风格，抽取了可复用的UI组件和业务逻辑模块，规范化了状态管理和API调用方式。重构过程中保持了与后端已有对接的稳定性，未出现功能退化或兼容性问题。                                                                                                                                                     |
+| 5                                                      | UI设计风格探索                                             | 部分完成                                                   | 前端对网站设计风格进行了初步的重构探索实验，对比了不同设计风格的优劣，选定了项目的美术风格，详细的ui设计需留至下周补充完成。                                                                                                                                                                                                                                                                      |
+| 6                                                      | 前后端技术考核                                             | 完成                                                       | 全体成员顺利通过了周三的前后端技术考核。团队合理安排了复习时间，在保证项目进度的前提下，优先为考试准备预留了充足时间，注意劳逸结合，以良好状态完成了考试。                                                                                                                                                                                                                                        |
+| 7                                                      | 文档编写与整理                                             | 完成                                                       | 金郅博完成了多项文档编写任务：完善了前端项目的README文档，编写了第13周团队周总结，撰写了第14周会议纪要，尝试编写了MuseGuard项目的整体README文档。在文档编写过程中与前后端负责人对接，确保了内容的准确性和专业性。                                                                                                                                                                                 |
+
+## 小结
+
+**1. Beta版本开发进入收尾阶段：** 本周是Beta版本开发的关键冲刺周，团队在前后端技术考核的压力下，依然保持了高效的工作节奏。Beta 0.5的所有收尾工作顺利完成，包括表格UI优化、下载接口对接、功能联调测试等。VIP充值界面、整体UI优化等Beta正式版核心功能已完成，胡帆与杨逸轩共同完成了黑白两种KT风格组件的开发。但管理员系统由于后端权限校验逻辑重构和数据库E-R图调整，接口未能按时交付，需在下周完成联调。
+
+**2. 前后端规范化重构成效显著：** 本周的规范化重构工作取得了显著成效。后端方面，杨博文和梁浩完成了代码结构的分层调整和编码规范的统一；前端方面，杨逸轩和金郅博完成了项目目录结构的优化和组件的模块化改造。重构后的代码具备了更好的可读性、可维护性和扩展性，为后续的团队协作和功能迭代奠定了良好基础。整个重构过程中，团队严格遵循向后兼容原则，确保了现有功能的稳定性。
+
+**3. 考试与项目任务平衡兼顾：** 面对周三前后端技术考核的时间压力，团队采取了灵活务实的策略，允许成员根据自身情况调整工作节奏。全体成员在保证项目关键任务推进的同时，合理安排了复习时间，最终顺利通过了技术考核。这种平衡兼顾的工作方式体现了团队良好的时间管理能力和协作精神。
+
+**4. 文档工作持续完善：** 金郅博继续主导文档编写，完成了前端README、团队周总结、会议纪要、项目整体README等多项文档任务。文档工作的持续推进确保了项目知识的有效沉淀和团队信息的顺畅流通，为项目的最终交付提供了完整的文档支撑。

doc/process/weekly/week-15/members/jinzhibo-weekly-plan-15.md

@@ -0,0 +1,32 @@
+# 个人周计划-第15周
+
+## 姓名和起止时间
+
+---
+
+**姓　　名：** 金郅博
+
+**团队名称：** 2班-深度思考
+
+**开始时间：** 2025-12-29
+
+**结束时间：** 2026-01-05
+
+本周任务计划安排
+
+---
+
+| 序号 | 计划内容                 | 协作人   | 情况说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| ---- | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1    | **全面测试**       | 全体成员 | 在全体成员的协作下，我将与杨博文主导Beta版本的全面测试任务。测试工作将严格对照需求规格说明书中的功能清单和项目测试扣分点逐项进行验证，确保每一个功能点都经过充分测试。采用**白盒测试**与**黑盒测试**相结合的方式：白盒测试主要针对代码逻辑、分支覆盖、边界条件等进行验证，尽量借助自动化测试框架和大模型辅助工具提高测试效率；黑盒测试则从用户视角出发，对各项功能进行手工操作验证，关注用户体验和业务流程的完整性。测试过程中发现的问题需及时记录并分配给相应负责人修复。 |
+| 2    | **文档编写复核**   | 杨博文   | 在Beta收尾和全面测试工作完成后，对项目文档进行最终的完善和复核工作。主要任务包括：更新使用示例和截图使其与实际功能一致；补充鸣谢部分内容，对开源项目、第三方库、参考资料等进行致谢说明；明确License部分的开源许可协议。确保文档内容与最终交付版本完全一致。                                                                                                                                                                                                                            |
+| 3    | **代码清理与收尾** | 全体成员 | 测试结束后对代码进行清理工作，删除测试桩代码、调试日志、临时注释等，确保交付代码的整洁性。同时协助团队完成Beta版本的最终收尾工作，确保所有工作在周日前全部完成。                                                                                                                                                                                                                                                                                                                       |
+
+小结
+----
+
+**1.全面推进测试工作**：目前Beta版本功能已基本落实，完善测试工作是收尾阶段的重要任务，需要严格对比需求规格说明书逐项验证功能点，采用白盒与黑盒相结合的测试策略，确保测试覆盖率和测试质量。
+
+**2. 文档工作收尾完善**：在测试工作完成后，需要集中精力完成软件测试文档的编写和项目文档的最终复核。确保所有文档内容准确、完整、规范，与最终交付版本保持一致，为项目画上圆满的句号。
+
+**3. beta版本收尾冲刺，严格把控时间节点**：本周是项目开发的最后窗口期，所有功能开发和bug修复必须在本周内全部完成，以确保下周项目将进入稳定运行阶段。因此本周的测试和文档工作必须高质量完成，严格按照小组的时间规划进行冲刺收尾，确保项目以最佳状态迎接验收。

doc/process/weekly/week-15/members/jinzhibo-weekly-summary-14.md

@@ -0,0 +1,37 @@
+个人周总结-第14周
+=================
+
+姓名和起止时间
+--------------
+
+姓　　名： 金郅博
+
+团队名称： 2班-深度思考
+
+开始时间： 2025-12-22
+
+结束时间： 2025-12-29
+
+本周任务完成情况
+----------------
+
+| **序号** | **计划内容（总结内容）** | **是否完成** | **情况说明**                                                                                                                                                                                                                                                                                                                                                        |
+| -------------- | ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1              | **前端规范化重构**       | 完成               | 配合杨逸轩完成了Beta 0.5前端代码的深度规范化重构工作。借助Vibe Coding等工具辅助，参与了前端代码的层次化和模块化改造，协助建立了清晰的项目目录结构，统一了组件命名和代码风格，抽取了可复用的UI组件和业务逻辑模块。重构过程中确保了与后端已有对接的稳定性，未出现功能退化或兼容性问题。                                                                                     |
+| 2              | **UI设计风格探索与重构** | 部分完成           | 协助杨逸轩/胡帆进行UI设计风格探索重构工作，借助kiro工具复刻现有网站的高级感设计，初步选定前端风格样式，具体ui细节还未落实，需要留给下周进行                                                                                                                                                                                                                               |
+| 3              | **文档编写与整理工作**   | 完成               | 完成了多项文档编写任务：完善了前端项目的README文档，详细说明了项目结构、技术栈选择、环境配置步骤、开发规范等内容；编写了第13周的团队周总结，全面回顾了上周工作进展、遇到的问题和解决方案；撰写了第14周会议纪要，记录了重要会议的讨论内容、决策结果和行动计划；尝试编写了MuseGuard项目的整体README文档，从产品概述、功能特性、技术架构、部署指南等宏观层面进行了全面介绍。 |
+| 4              | **准备本周考试**         | 完成               | 周三顺利完成了前后端技术考核。在保证项目进度的前提下，合理安排了复习时间，注意劳逸结合，保证了充足休息，以良好的状态完成了考试。                                                                                                                                                                                                                                          |
+
+**对团队工作的建议  **
+
+1. **加强文档与项目的一致性复核**：建议团队成员可以参考已有文档内容对项目进行复核，或者主动查找文档中存在的问题，确保文档描述与项目实际实现保持一致。这样既能及时发现文档的遗漏或错误，也能帮助成员更深入地理解项目，提升团队整体的文档质量和项目规范性。
+
+小结
+----
+
+1. **前端重构工作圆满完成**：本周作为前端规范化重构的协作者，与杨逸轩紧密配合，顺利完成了代码的模块化改造工作，项目代码结构更加清晰，可维护性显著提升。
+2. **UI设计探索初步推进**：本周与杨逸轩开展了UI设计风格的初步探索，借鉴了苹果和安卓官网的设计理念进行了部分重构实验，但由于时间有限，完整的风格对比和Vuebits组件库的深度评估尚未完成，将在后续迭代中继续推进。
+3. **文档工作全面推进**：本周集中完成了前端README、团队周总结、会议纪要及项目整体README等多项文档任务，确保了项目文档的完整性和时效性，为团队知识沉淀做出了贡献。
+4. **考试与项目任务平衡兼顾**：在繁忙的项目任务中合理安排时间，顺利通过了前后端技术考核，实现了考试复习与项目工作的良好平衡。
+
+---