Compare commits

..

58 Commits

Author SHA1 Message Date
LYQ 63085898d9 Add files to develop branch
3 weeks ago
LYQ e4d31c8fad Add files to develop branch
3 weeks ago
clumxc c933bef14c 修改文档
3 weeks ago
fangqiongMa 227587512d 用户手册提交
4 weeks ago
fangqiongMa da298c75a4 测试报告提交
4 weeks ago
“Revacholian” 988c7d2517 代码上传
1 month ago
“Revacholian” 6cb06a3f35 update chj 15 sum
1 month ago
hnu202326010423 1756b5f063 Update mafq-weekly-summary-14.md
1 month ago
hnu202326010419 6e9d4cb552 Update zhaowenqi-weekly-summary-15.md
1 month ago
clumxc b4cd190517 提交周总结
1 month ago
fangqiongMa 76a9d1b1b6 马芳琼第15周个人周总结提交
1 month ago
2023Amina 18ed9ef3c0 周总结
1 month ago
zwq 619f5feefc 周总结提交
1 month ago
zwq d08d432137 分享与好友后端实现
2 months ago
zwq 89cfcf974a 通知,对话历史,收藏一半出问题
2 months ago
zwq 9b21a633ab [200~后端改动
2 months ago
clumxc 953bd46cdc 提交个人周总结14周计划15会议纪要15-01
2 months ago
fangqiongMa 6cab70d3bb 李瑜清14周个人周总结和15周个人周计划提交
2 months ago
fangqiongMa 03115953dd 第15周小组周计划提交
2 months ago
fangqiongMa 499c613754 Merge branch 'develop' of https://bdgit.educoder.net/hnu202326010433/Baoma into develop
2 months ago
2023Amina e55e8c8315 14周个人
2 months ago
fangqiongMa 20268bb362 马芳琼第15周个人周计划提交
2 months ago
2023Amina 649e4e9756 15周个人
2 months ago
fangqiongMa f8608998b4 马芳琼第14周个人周总结提交
2 months ago
“Revacholian” 6f3589895a Chj 14sum 15plan
2 months ago
zwq 1a65508495 Merge branch 'develop' of https://bdgit.educoder.net/hnu202326010433/Baoma into develop
2 months ago
zwq b88b54d317 总结和计划提交
2 months ago
2023Amina 60a08d54f7 14周
2 months ago
zwq a5901e0d10 completing b version
2 months ago
zwq abab679203 clean
2 months ago
fangqiongMa 5d858ef738 Merge remote-tracking branch 'origin/develop' into develop
2 months ago
“Revacholian” 99245bae29 Chj 13sum 14plan
2 months ago
clumxc 4feadd76d3 Merge branch 'develop' of https://bdgit.educoder.net/hnu202326010433/Baoma into develop
2 months ago
2023Amina 1441475fa8 周总结
2 months ago
clumxc 348096a498 提交个人周计划14 周总结13
2 months ago
2023Amina 9d536de061 第十四周周计划
2 months ago
LYQ f7789bb641 十四周过程文档提交
2 months ago
fangqiongMa a5d593e8dc 马芳琼第13周个人周总结提交
2 months ago
fangqiongMa da4278140d 马芳琼第14周个人周计划提交
2 months ago
zwq 49c55d37aa 文档提交
2 months ago
fangqiongMa e342ee3a07 马芳琼提交需求规格说明书第二稿
2 months ago
fangqiongMa 1c0d869055 马芳琼提交迭代开发计划第三版
2 months ago
fangqiongMa 37ab9e7bff 马芳琼提交需求规格说明书第二稿
2 months ago
LYQ 8881b0dbc3 十三周过程文档提交
2 months ago
2023Amina 0d3d906942 Merge branch 'origin/develop' into develop
2 months ago
2023Amina 3cd49e1df7 amina周计划
2 months ago
hnu202326010426 5e8a46a8d2 13周会议记录修改
2 months ago
clumxc f906693733 提交个人周计划13 周总结12
2 months ago
hnu202326010426 095953ec53 chj1213
2 months ago
fangqiongMa b40617aa38 13周第一次会议纪要提交
2 months ago
fangqiongMa b460de2745 马芳琼13周个人周计划提交,12周小组会议纪要提交
2 months ago
fangqiongMa 155bc18614 马芳琼12周个人周总结提交
2 months ago
zwq d764c04fb0 周计划和周总结上传
2 months ago
fangqiongMa e14cbb9731 refactor: 规范命名
2 months ago
fangqiongMa 45c4df3b18 refactor: 优化代码规范与服务结构
2 months ago
fangqiongMa 0e130b051b 12周第一次小组会议纪要提交
2 months ago
fangqiongMa ee420a6765 feat: 优化JwtUtil和SecurityConfig适配JWT生产环境
2 months ago
2023Amina 7ef407c086 第十二周计划
2 months ago

@ -1,2 +1,390 @@
# Baoma
# 自然语言数据库查询系统 - 项目总说明
## 项目概述
**自然语言数据库查询系统**是一个基于大语言模型的智能数据库查询平台支持用户通过自然语言描述查询需求系统自动调用大模型解析查询意图生成并执行SQL语句将查询结果以图表形式可视化展示。
### 核心特性
- **智能查询**:采用自然语言描述查询请求,系统调用大模型感知数据库元数据并解析用户查询请求
- **权限管理**:完善的用户权限控制系统,管理员可以管理和授权用户,支持表级别的权限控制
- **SQL生成与验证**采用SQL引擎生成和验证SQL语句确保查询安全性和准确性
- **数据可视化**查询结果采用Chart图表显示支持多种图表类型
- **多轮对话**支持用户调整查询内容系统根据用户调整请求修改SQL语句重新查询和可视化查询结果
- **复杂查询支持**支持多表联合等复杂SQL语句查询
- **并发支持**支持至少5个及以上并发用户每个用户的任务在Docker容器独立运行
- **社交功能**:支持查询分享、好友关系、实时聊天等社交功能
---
## 技术架构
### 后端技术栈
- **框架**Spring Boot 3.5.7
- **开发语言**Java 21 (JDK 21)
- **关系型数据库**MySQL 8.0+
- **非关系型数据库**MongoDB 4.0+
- **ORM框架**MyBatis Plus 3.5.9
- **安全框架**Spring Security + JWT
- **缓存**Redis
- **实时通信**WebSocket
- **容器化**Docker
- **构建工具**Maven
### 前端技术栈
- **框架**Vue 3.5.25
- **开发语言**TypeScript 5.9
- **构建工具**Vite 7.2.4
- **路由**Vue Router 4.6.3
- **状态管理**Pinia 3.0.4
- **UI框架**Tailwind CSS 4.1.18
- **图表库**Chart.js 4.5.1 + Vue-ChartJS 5.3.3
- **WebSocket**SockJS + STOMP.js
### 系统架构
```
┌─────────────┐
│ 前端应用 │ Vue 3 + TypeScript
│ (Vite) │
└──────┬──────┘
│ HTTP/WebSocket
┌──────▼─────────────────┐
│ 后端应用 │
│ (Spring Boot) │
│ │
│ ┌──────────────────┐ │
│ │ Controller层 │ │ RESTful API
│ └────────┬─────────┘ │
│ ┌────────▼─────────┐ │
│ │ Service层 │ │ 业务逻辑
│ └────────┬─────────┘ │
│ ┌────────▼─────────┐ │
│ │ Mapper/Repository│ │ 数据访问
│ └────────┬─────────┘ │
└──────────┼─────────────┘
┌──────┼──────┐
│ │ │
┌───▼──┐ ┌▼──┐ ┌─▼────┐
│MySQL │ │Mongo│ │Redis│
└──────┘ └───┘ └──────┘
```
---
## 项目目录结构
```
xm/
├── doc/ # 文档目录
│ ├── README.md # 项目总说明(本文件)
│ ├── process/ # 开发过程文档
│ │ ├── meeting/ # 会议记录
│ │ └── weekly/ # 周报(按周组织)
│ └── project/ # 项目文档
│ ├── 01-需求文档/ # 需求规格说明书、用例文档等
│ ├── 02-设计文档/ # UML设计文档、数据库设计文档
│ ├── 03-计划文档/ # 迭代开发计划
│ ├── 04-用户手册/ # 用户使用手册
│ └── 05-测试报告/ # 测试报告
├── src/ # 源代码目录
│ ├── frontend/ # 前端项目
│ │ ├── src/
│ │ │ ├── components/ # Vue组件
│ │ │ ├── views/ # 页面视图
│ │ │ ├── router/ # 路由配置
│ │ │ ├── services/ # API服务
│ │ │ ├── composables/ # Composition API
│ │ │ ├── types/ # TypeScript类型定义
│ │ │ └── utils/ # 工具函数
│ │ ├── package.json # 前端依赖配置
│ │ └── vite.config.ts # Vite配置
│ │
│ ├── src/ # 后端项目
│ │ └── main/
│ │ ├── java/ # Java源代码
│ │ │ └── com/example/springboot_demo/
│ │ │ ├── controller/ # 控制器层
│ │ │ ├── service/ # 服务层
│ │ │ ├── mapper/ # MyBatis Mapper
│ │ │ ├── repository/ # MongoDB Repository
│ │ │ ├── entity/ # 实体类
│ │ │ ├── dto/ # 数据传输对象
│ │ │ ├── vo/ # 视图对象
│ │ │ ├── config/ # 配置类
│ │ │ ├── utils/ # 工具类
│ │ │ └── exception/ # 异常处理
│ │ └── resources/
│ │ └── application.yml # 应用配置文件
│ │
│ ├── pom.xml # Maven配置文件
│ └── README.md # 后端模块说明文档
└── scripts/ # 脚本目录
├── export-data.sh/.bat # 数据导出脚本
└── import-data.sh/.bat # 数据导入脚本
```
---
## 快速开始
### 环境要求
- **JDK**21 或更高版本
- **Node.js**^20.19.0 或 >=22.12.0
- **MySQL**8.0 或更高版本
- **MongoDB**4.0 或更高版本
- **Redis**:最新稳定版
- **Maven**3.6+(用于后端构建)
- **Docker**:可选(用于容器化部署)
### 后端启动
1. **配置数据库连接**
编辑 `src/src/main/resources/application.yml`配置MySQL、MongoDB和Redis连接信息。
2. **构建项目**
```bash
cd src
mvn clean install
```
3. **启动应用**
```bash
mvn spring-boot:run
```
或直接运行主类:`com.example.springboot_demo.NaturalLanguageQueryApplication`
4. **验证启动**
访问 `http://localhost:8173/actuator/health` 检查应用健康状态
### 前端启动
1. **安装依赖**
```bash
cd src/frontend
npm install
```
2. **启动开发服务器**
```bash
npm run dev
```
3. **构建生产版本**
```bash
npm run build
```
4. **访问应用**
开发环境:`http://localhost:5173`
生产环境:根据部署配置访问
### Docker部署
项目支持Docker容器化部署具体配置请参考 `src/docker-compose.yml`
---
## 文档导航
### 需求与设计文档
- **[需求文档](project/01-需求文档/README.md)**:包含需求规格说明书、用例文档、项目前景与范围文档
- **[设计文档](project/02-设计文档/README.md)**包含UML设计文档活动图、顺序图、类图和数据库设计文档
- **[计划文档](project/03-计划文档/README.md)**:包含迭代开发计划
### 用户与测试文档
- **[用户手册](project/04-用户手册/README.md)**:用户使用指南和操作说明
- **[测试报告](project/05-测试报告/README.md)**:系统测试报告和测试用例
### 开发过程文档
- **[会议记录](process/meeting/)**:项目开发过程中的会议纪要
- **[周报](process/weekly/)**:按周组织的开发计划和总结
### 技术文档
- **[后端模块说明](../src/README.md)**:详细的后端架构和模块说明
---
## 核心功能模块
### 1. 用户认证与授权
- 用户注册、登录、密码重置
- JWT Token认证
- 基于角色的访问控制RBAC
- 表级别的权限控制
### 2. 自然语言查询
- 自然语言转SQL
- 数据库元数据感知
- SQL生成与验证
- 多轮对话支持
- 查询结果可视化
### 3. 数据库管理
- 数据库连接管理
- 表元数据管理
- 字段元数据管理
- 数据库结构导出
### 4. 查询管理
- 查询日志记录
- 查询收藏
- 查询分享
- SQL缓存
- 对话历史记录
### 5. 社交功能
- 好友关系管理
- 实时聊天WebSocket
- 查询分享
- 通知系统
### 6. 系统管理
- 大模型配置管理
- 系统健康监控
- 性能指标统计
- 错误日志管理
- 操作日志审计
---
## 安全机制
1. **JWT认证**使用JWT Token进行用户认证Token包含用户ID和用户名
2. **权限控制**基于角色的访问控制RBAC支持表级别的权限控制
3. **密码加密**使用Spring Security的BCryptPasswordEncoder加密密码
4. **Token黑名单**支持Token失效和单点登录
5. **SQL注入防护**使用参数化查询和SQL验证
6. **跨域配置**配置CORS允许跨域请求
---
## 测试
### 单元测试
后端测试使用JUnit前端测试使用Vitest。
```bash
# 后端测试
cd src
mvn test
# 前端测试
cd src/frontend
npm run test:unit
```
### API测试
可以使用 `src/api-test.http` 文件进行API接口测试支持IntelliJ IDEA HTTP Client或VS Code REST Client
---
## 系统性能
- **并发支持**支持至少5个及以上并发用户
- **响应时间**SQL查询响应时间 < 3秒(取决于数据量和数据库性能)
- **可用性**:系统可用性 > 99%
---
## 开发规范
### 代码规范
- **后端**遵循Java编码规范使用Lombok简化代码
- **前端**遵循Vue 3 + TypeScript编码规范使用ESLint和Prettier进行代码格式化
### Git提交规范
建议使用以下格式:
```
<type>(<scope>): <subject>
<body>
<footer>
```
类型type
- `feat`: 新功能
- `fix`: 修复bug
- `docs`: 文档更新
- `style`: 代码格式调整
- `refactor`: 代码重构
- `test`: 测试相关
- `chore`: 构建/工具链相关
---
## 开发团队
**团队名称**:神奇宝码队
**项目版本**2.0
**开发时间**2025
---
## 更新日志
详细的版本更新记录请参考各迭代开发计划和周报文档。
---
## 贡献指南
1. Fork本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交Pull Request
---
## 许可证
本项目遵循相应的开源许可证。
---
## 联系方式
如有问题或建议,请联系开发团队。
---
## 未来规划
- [ ] 支持更多数据库类型PostgreSQL、Oracle等
- [ ] 增强大模型提示词工程提高SQL生成准确性
- [ ] 优化查询性能,支持更大数据量查询
- [ ] 增强数据可视化功能,支持更多图表类型
- [ ] 增加数据分析功能
---
*最后更新时间2025年*

@ -0,0 +1,110 @@
# 小组会议纪要-第12周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 马芳琼
**会议主题:** 第 11 周工作复盘、第 12 周计划同步及 Alpha 版本展示筹备
**会议地点:** 图书馆总馆赫曦研讨空间3
**会议时间:** 2025-12-08 16:30-18:00
**纪录时间:** 2025-12-08 16:30-18:30
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 第 11 周工作复盘
#### 全体成员按组别依次汇报第 11 周任务完成情况、遇到的问题及解决进展:
- **前端组(程荟锦、阿米娜):**
- 日志查看页面完成基础开发,实现按时间、操作类型筛选及分页功能;好友管理页面开发完毕,已与分享功能打通,支持查询结果定向分享;数据权限管理可视化页面基本成型,可实现用户 - 数据库 - 表的层级授权。
- 问题:日志页面的异常日志标红提醒功能尚未实现,需补充开发;与后端权限接口联调时,存在权限变更同步延迟问题。
- **后端组(赵文琪、马芳琼):**
- 完成系统操作日志、数据源连接日志的记录与查询 API 开发;好友添加 / 删除 / 申请处理及用户数据权限分配的核心 API 均已交付,功能经单元测试验证通过。
- 主查询链路已修复 5 个联调 Bug接口响应稳定性提升但高并发场景下仍存在偶发超时Alpha 版本内部测试已发现 8 个功能 Bug其中 3 个已完成修复。
- 问题:日志 API 的多条件组合查询效率较低AI 服务集成的异常兜底逻辑尚未完善,极端场景下会出现接口熔断无降级的情况。
- **AI引擎组李琪雯、李瑜清**
- Prompt 优化进行中,已经优化了代码逻辑,正在引入测试数据库进行测试。
- 参与 Alpha 版本内部测试,协助验证 NL2SQL 功能的完整性。
- 问题复杂多表关联场景下SQL 生成的准确率仍有提升空间,需补充样本训练。
- **管理组PM**
- 组织各组完成系统核心 UML 图绘制,类图、顺序图、活动图均已归档,且与代码实现一致;已整理 Alpha 版本开发进度报告,明日将向指导老师汇报。
- 牵头编写核心功能测试用例,完成部分用例设计,支撑了交叉测试的有序开展。
- 问题:部分测试用例的异常场景覆盖不足,需补充边界值测试项。
### 2. 第 12 周周计划同步与任务认领
PM 李瑜清宣讲《第 12 周周计划》,明确本周 “保障 Alpha 演示、收尾遗留功能、提升代码质量、启动 Beta 规划” 的核心目标,全体成员完成任务认领,关键任务拆解如下:
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------------- | :-------------- | :----------------------------------------------------------- |
| 1 | **【演示】Alpha 版本稳定性保障(周一)** | 全体开发成员 | **代码修改与测试文档**:周一下午前完成所有紧急 Bug 修复,修复完毕后立即冻结代码,不再接收和合并新功能代码,确保演示版本的稳定性与一致性。 |
| 2 | **【里程碑 - 4】向指导老师进行 Alpha 版本演示(周二)** | PM、各模块负责人组 | **完成 Alpha 阶段的核心交付。**由 PM 主导整体汇报,各模块负责人配合功能演示,需完整呈现系统核心能力,清晰汇报项目当前进展、技术实现亮点、开发过程中遇到的关键挑战及解决方案。 |
| 3 | **【开发】完成上周遗留功能开发(演示后)** | 全体成员 | **完成 Alpha 版本功能收尾。**1. 好友管理补全好友申请处理、实时消息通知等剩余业务逻辑实现好友功能闭环。2. 日志功能:完成系统管理员与数据管理员专属的日志查看页面开发,配套实现日志筛选、导出等完整功能。 |
| 4 | **【质量】代码规范自查与交叉审查** | 全体成员 | **提升代码质量的关键环节。**1. 自查与提交:每位开发者对照 Java 代码规范完成自有代码的格式化与逻辑重构优化后提交至代码仓库。2. 交叉审查:按照指定的代码审查名单开展交叉 Code Review重点核查命名规范、注释完整性、代码复用率及异常处理机制形成书面修改建议并反馈至对应开发者。 |
| 5 | **【管理】组织演示复盘与 Beta 版本规划启动会** | 全体成员 | 1. **演示复盘:**复盘 Alpha 版本演示的整体表现梳理成功经验与不足完整记录指导老师提出的反馈意见与优化建议形成整改清单。2. **Beta 版本规划:**结合老师反馈及项目迭代需求,集体讨论并确定 Beta 版本拟新增的核心功能与优化方向。 |
| 6 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促全体成员完成第十一周个人周总结与第十二周个人周计划的撰写提交,按时汇总整理团队级周报并完成归档上传。 |
**关键说明:**
- **核心阶段定位:**本周为 Alpha 版本与 Beta 版本的衔接关键期,周初核心目标是保障 Alpha 版本演示的稳定性,周中完成 Alpha 阶段功能收尾,周末启动 Beta 版本规划,需严格把控各阶段时间节点。
- **代码管控要求:**周一的代码冻结为硬性要求,冻结后仅允许修复演示中突发的致命 Bug严禁新增功能代码避免破坏版本稳定性所有紧急 Bug 修复需经 PM 确认后才能合并。
- **质量机制落地:**本周首次引入代码规范自查与交叉审查机制,这是团队开发流程规范化的重要标志,全体成员需高度重视,确保审查覆盖所有核心代码,切实提升代码可维护性与统一性。
- **风险预判:**一是 Alpha 版本演示前可能出现突发环境故障,需提前准备备用演示环境;二是交叉审查可能因标准理解偏差导致效率偏低,建议提前同步统一的审查细则,明确审查优先级。
- **承上启下要求:**演示复盘需聚焦指导老师的核心建议,确保 Beta 版本规划能精准响应需求;团队文档需按时提交,为项目阶段验收提供完整的过程资料支撑。
## 问题总结
### 已解决问题:
1. 完成系统核心 UML 图绘制,实现设计文档与代码的完全对齐;
2. 好友与分享、用户数据权限分配功能基本开发完毕,可支撑核心业务场景;
3. 完成 Alpha 版本核心测试用例编写,交叉测试有序开展并修复部分关键 Bug。
### 待解决问题:
1. 主查询功能的饼图渲染卡顿、高并发超时等性能问题需攻坚;
2. 日志 API 查询效率低、AI 服务集成无降级兜底等稳定性问题需完善;
3. AI 组复杂多表关联场景 SQL 生成准确率需提升;
4. 部分测试用例的异常场景覆盖不足,需补充完善。
## 小组协作情况总结
1. 任务完成度良好:完成核心的 UML 图绘制、好友及权限功能已基本收尾;
2. 问题响应高效:内部测试发现的 Bug 平均响应时间修复效率较上周具有一定提升;
3. 跨组协作趋优前后端、AI 组在接口联调中沟通频次提升,格式对齐问题大幅减少;
4. 测试环节待补:部分测试用例设计不够全面,边界值和异常场景覆盖存在缺口;
5. 性能优化滞后:功能开发完成后,性能调优未及时跟进,导致部分模块存在体验短板。
## 一周纪律情况总结
- 参会情况:全体成员准时参会,讨论聚焦任务目标,会议效率较高;
- 任务交付:第 11 周个人周总结提交率 100%,文档内容详实且能准确复盘工作;
- 代码提交:代码分支管理规范,提交备注清晰,无乱提交、误合并情况;
- 沟通协作:技术问题沟通渠道畅通,跨组协作的问题能在 2 小时内得到响应;
- 进度把控:核心任务均按时间节点推进,仅性能优化模块略滞后于计划。
## 备注
- 周二 Alpha 版本成果汇报前,需在今日完成全流程演示演练,确保环境稳定、功能无阻断;
- 性能优化工作需优先保障核心功能体验,避免因过度调优影响功能稳定性;
- Bug 修复完成后必须进行回归测试,由测试人员签字确认后方可关闭 Bug
- 第 12 周交付文档需严格按照规范整理,确保可直接用于成果归档;
- 第 13 周计划需结合指导老师的反馈制定,聚焦 Alpha 版本的迭代优化方向。
---
## 【注】
1. 本文档为"智能查询"项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后,按"meeting-minutes-(周号)-(序号)"格式命名,例如"meeting-minutes-12"。

@ -0,0 +1,110 @@
# 小组会议纪要-第12周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 马芳琼
**会议主题:** 第 11 周工作复盘、第 12 周计划同步及 Alpha 版本展示筹备
**会议地点:** 图书馆总馆赫曦研讨空间3
**会议时间:** 2025-12-08 16:30-18:00
**纪录时间:** 2025-12-08 16:30-18:30
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 第 11 周工作复盘
#### 全体成员按组别依次汇报第 11 周任务完成情况、遇到的问题及解决进展:
- **前端组(程荟锦、阿米娜):**
- 日志查看页面完成基础开发,实现按时间、操作类型筛选及分页功能;好友管理页面开发完毕,已与分享功能打通,支持查询结果定向分享;数据权限管理可视化页面基本成型,可实现用户 - 数据库 - 表的层级授权。
- 问题:日志页面的异常日志标红提醒功能尚未实现,需补充开发;与后端权限接口联调时,存在权限变更同步延迟问题。
- **后端组(赵文琪、马芳琼):**
- 完成系统操作日志、数据源连接日志的记录与查询 API 开发;好友添加 / 删除 / 申请处理及用户数据权限分配的核心 API 均已交付,功能经单元测试验证通过。
- 主查询链路已修复 5 个联调 Bug接口响应稳定性提升但高并发场景下仍存在偶发超时Alpha 版本内部测试已发现 8 个功能 Bug其中 3 个已完成修复。
- 问题:日志 API 的多条件组合查询效率较低AI 服务集成的异常兜底逻辑尚未完善,极端场景下会出现接口熔断无降级的情况。
- **AI引擎组李琪雯、李瑜清**
- Prompt 优化进行中,已经优化了代码逻辑,正在引入测试数据库进行测试。
- 参与 Alpha 版本内部测试,协助验证 NL2SQL 功能的完整性。
- 问题复杂多表关联场景下SQL 生成的准确率仍有提升空间,需补充样本训练。
- **管理组PM**
- 组织各组完成系统核心 UML 图绘制,类图、顺序图、活动图均已归档,且与代码实现一致;已整理 Alpha 版本开发进度报告,明日将向指导老师汇报。
- 牵头编写核心功能测试用例,完成部分用例设计,支撑了交叉测试的有序开展。
- 问题:部分测试用例的异常场景覆盖不足,需补充边界值测试项。
### 2. 第 12 周周计划同步与任务认领
PM 李瑜清宣讲《第 12 周周计划》,明确本周 “保障 Alpha 演示、收尾遗留功能、提升代码质量、启动 Beta 规划” 的核心目标,全体成员完成任务认领,关键任务拆解如下:
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------------- | :-------------- | :----------------------------------------------------------- |
| 1 | **【演示】Alpha 版本稳定性保障(周一)** | 全体开发成员 | **代码修改与测试文档**:周一下午前完成所有紧急 Bug 修复,修复完毕后立即冻结代码,不再接收和合并新功能代码,确保演示版本的稳定性与一致性。 |
| 2 | **【里程碑 - 4】向指导老师进行 Alpha 版本演示(周二)** | PM、各模块负责人组 | **完成 Alpha 阶段的核心交付。**由 PM 主导整体汇报,各模块负责人配合功能演示,需完整呈现系统核心能力,清晰汇报项目当前进展、技术实现亮点、开发过程中遇到的关键挑战及解决方案。 |
| 3 | **【开发】完成上周遗留功能开发(演示后)** | 全体成员 | **完成 Alpha 版本功能收尾。**1. 好友管理补全好友申请处理、实时消息通知等剩余业务逻辑实现好友功能闭环。2. 日志功能:完成系统管理员与数据管理员专属的日志查看页面开发,配套实现日志筛选、导出等完整功能。 |
| 4 | **【质量】代码规范自查与交叉审查** | 全体成员 | **提升代码质量的关键环节。**1. 自查与提交:每位开发者对照 Java 代码规范完成自有代码的格式化与逻辑重构优化后提交至代码仓库。2. 交叉审查:按照指定的代码审查名单开展交叉 Code Review重点核查命名规范、注释完整性、代码复用率及异常处理机制形成书面修改建议并反馈至对应开发者。 |
| 5 | **【管理】组织演示复盘与 Beta 版本规划启动会** | 全体成员 | 1. **演示复盘:**复盘 Alpha 版本演示的整体表现梳理成功经验与不足完整记录指导老师提出的反馈意见与优化建议形成整改清单。2. **Beta 版本规划:**结合老师反馈及项目迭代需求,集体讨论并确定 Beta 版本拟新增的核心功能与优化方向。 |
| 6 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促全体成员完成第十一周个人周总结与第十二周个人周计划的撰写提交,按时汇总整理团队级周报并完成归档上传。 |
**关键说明:**
- **核心阶段定位:**本周为 Alpha 版本与 Beta 版本的衔接关键期,周初核心目标是保障 Alpha 版本演示的稳定性,周中完成 Alpha 阶段功能收尾,周末启动 Beta 版本规划,需严格把控各阶段时间节点。
- **代码管控要求:**周一的代码冻结为硬性要求,冻结后仅允许修复演示中突发的致命 Bug严禁新增功能代码避免破坏版本稳定性所有紧急 Bug 修复需经 PM 确认后才能合并。
- **质量机制落地:**本周首次引入代码规范自查与交叉审查机制,这是团队开发流程规范化的重要标志,全体成员需高度重视,确保审查覆盖所有核心代码,切实提升代码可维护性与统一性。
- **风险预判:**一是 Alpha 版本演示前可能出现突发环境故障,需提前准备备用演示环境;二是交叉审查可能因标准理解偏差导致效率偏低,建议提前同步统一的审查细则,明确审查优先级。
- **承上启下要求:**演示复盘需聚焦指导老师的核心建议,确保 Beta 版本规划能精准响应需求;团队文档需按时提交,为项目阶段验收提供完整的过程资料支撑。
## 问题总结
### 已解决问题:
1. 完成系统核心 UML 图绘制,实现设计文档与代码的完全对齐;
2. 好友与分享、用户数据权限分配功能基本开发完毕,可支撑核心业务场景;
3. 完成 Alpha 版本核心测试用例编写,交叉测试有序开展并修复部分关键 Bug。
### 待解决问题:
1. 主查询功能的饼图渲染卡顿、高并发超时等性能问题需攻坚;
2. 日志 API 查询效率低、AI 服务集成无降级兜底等稳定性问题需完善;
3. AI 组复杂多表关联场景 SQL 生成准确率需提升;
4. 部分测试用例的异常场景覆盖不足,需补充完善。
## 小组协作情况总结
1. 任务完成度良好:完成核心的 UML 图绘制、好友及权限功能已基本收尾;
2. 问题响应高效:内部测试发现的 Bug 平均响应时间修复效率较上周具有一定提升;
3. 跨组协作趋优前后端、AI 组在接口联调中沟通频次提升,格式对齐问题大幅减少;
4. 测试环节待补:部分测试用例设计不够全面,边界值和异常场景覆盖存在缺口;
5. 性能优化滞后:功能开发完成后,性能调优未及时跟进,导致部分模块存在体验短板。
## 一周纪律情况总结
- 参会情况:全体成员准时参会,讨论聚焦任务目标,会议效率较高;
- 任务交付:第 11 周个人周总结提交率 100%,文档内容详实且能准确复盘工作;
- 代码提交:代码分支管理规范,提交备注清晰,无乱提交、误合并情况;
- 沟通协作:技术问题沟通渠道畅通,跨组协作的问题能在 2 小时内得到响应;
- 进度把控:核心任务均按时间节点推进,仅性能优化模块略滞后于计划。
## 备注
- 周二 Alpha 版本成果汇报前,需在今日完成全流程演示演练,确保环境稳定、功能无阻断;
- 性能优化工作需优先保障核心功能体验,避免因过度调优影响功能稳定性;
- Bug 修复完成后必须进行回归测试,由测试人员签字确认后方可关闭 Bug
- 第 12 周交付文档需严格按照规范整理,确保可直接用于成果归档;
- 第 13 周计划需结合指导老师的反馈制定,聚焦 Alpha 版本的迭代优化方向。
---
## 【注】
1. 本文档为"智能查询"项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后,按"meeting-minutes-(周号)-(序号)"格式命名,例如"meeting-minutes-12"。

@ -0,0 +1,100 @@
# 小组会议纪要-第12周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 马芳琼
**会议主题:** Alpha 版本紧急 Bug 修复及演示准备推进会
**会议地点:** 图书馆总馆赫曦研讨空间3
**会议时间:** 2025-12-08 18:30-22:00
**纪录时间:** 2025-12-08 22:30-23:00
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 紧急 Bug 修复进展同步
全体成员按组别汇报当前 Alpha 版本紧急 Bug 修复情况及阻塞问题:
前端组(程荟锦、阿米娜):
已修复 3 个紧急 Bug包括饼图渲染卡顿、日志页面筛选功能失效、好友分享弹窗布局错乱。
问题:权限变更同步延迟问题仍未解决,需后端配合调整接口响应机制;异常日志标红提醒功能开发时间紧张,需加快进度。
后端组(赵文琪、马芳琼):
已修复 4 个核心 Bug涵盖主查询链路接口超时、日志 API 多条件查询效率低、权限校验异常等问题。
问题AI 服务集成的异常兜底逻辑开发受阻,极端场景下接口熔断无降级方案;部分表级权限控制逻辑存在冲突,需进一步调试。
AI 引擎组(李琪雯、李瑜清):
已优化 2 个影响演示的 Bug包括模糊查询 SQL 生成错误、多表关联查询结果缺失字段。
问题:复杂多表关联场景下 SQL 生成准确率仍不达标,临时补充 5 组样本训练,需测试验证效果。
管理组PM
已梳理紧急 Bug 清单明确优先级P0 级 6 个、P1 级 3 个),建立实时更新的 Bug 追踪表。
问题:演示环境尚未完全搭建,需后端组配合部署稳定版本;演示脚本需各组补充功能操作步骤。
### 2. 演示准备任务认领与分工
PM 李瑜清明确演示准备核心目标,全体成员认领任务,具体分工如下:
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------------- | :-------------- | :----------------------------------------------------------- |
| 1 | **紧急 Bug 闭环修复** | 全体开发成员 | 今日 20:00 前完成所有 P0 级 Bug 修复P1 级 Bug 优先修复影响演示的功能;修复后需提交单元测试报告,确保无新问题引入。 |
| 2 | **演示环境搭建与验证** | 后端组赵文琪、PM | 今日 21:00 前搭建完成独立演示环境,部署修复后的稳定版本;验证核心接口连通性、数据一致性,准备备用环境以防突发故障。 |
| 3 | **演示脚本完善与演练** | 全体成员 | 各组按负责模块补充演示操作步骤(含异常场景应对方案);今日 21:30 开展全流程联合演练,模拟演示场景,优化操作衔接。 |
| 4 | **演示材料准备** | PM李瑜清、各模块负责人 | 今日 22:00 前完成演示材料准备(含项目进展、技术亮点、功能演示流程);负责人准备功能讲解话术,确保表述清晰。 |
| 5 | **代码冻结与版本锁定** | 全体成员 | 今日 23:00 后正式冻结代码,不再接收任何功能修改或非致命 Bug 修复;仅预留演示中突发致命 Bug 的紧急修复通道,需经 PM 书面确认。 |
**关键说明:**
- **时间红线:** 所有演示准备任务需严格遵守今日截止时间,确保明日演示顺利开展;逾期未完成的任务需第一时间反馈 PM协调资源支援。
- **质量把控:** Bug 修复后必须经过交叉验证,由非开发人员测试通过后方可关闭;演示环境需多次演练,避免出现接口超时、数据异常等问题。
- **风险应对:** 提前准备演示应急预案,包括环境崩溃时切换备用环境、功能异常时跳过该模块演示等方案,确保演示流程不中断。
- **协作要求:** 各组需实时同步任务进展,遇到跨组依赖问题(如前端需后端接口调整),需立即沟通对接,避免阻塞。
## 问题总结
### 已解决问题:
1. 主查询链路接口超时、前端饼图渲染卡顿等核心演示 Bug 已修复;
2. 建立紧急 Bug 追踪表,明确优先级与责任人,提升修复效率;
3. 初步完成演示脚本框架,明确各模块演示顺序与核心要点。
### 待解决问题:
1. 前端权限变更同步延迟、异常日志标红提醒功能未完成;
2. 后端 AI 服务集成的异常兜底逻辑、表级权限控制冲突未解决;
3. AI 组复杂多表关联 SQL 生成准确率仍需验证;
4. 演示环境尚未搭建完成,联合演练未开展;
5. 收藏功能未实现。
## 应急响应高效:针对紧急 Bug 修复,各组快速投入工作,核心问题修复进度符合预期;
1. 跨组沟通及时:遇到依赖问题时能主动对接,减少任务阻塞时间;
2. 目标聚焦明确:全体成员围绕演示准备核心目标开展工作,无无关任务干扰;
3. 风险意识不足:部分成员对演示应急预案重视不够,需加强准备;
4. 进度把控需加强:个别任务(如演示环境搭建)进度略滞后,需加快推进。
## 一周纪律情况总结
1. 参会情况:全体成员提前 10 分钟到场,会议准时启动,讨论高效聚焦;
2. 任务响应:接到紧急 Bug 修复任务后,各组立即投入工作,无拖延情况;
3. 沟通协作:技术问题平均响应时间 30 分钟,跨组协作顺畅;
4. 文档提交:已提交紧急 Bug 修复进度表,实时更新,信息透明;
5. 执行力度:核心任务执行到位,个别辅助任务需进一步跟进。
## 备注
- 今日 21:30 必须开展全流程演示演练,全体成员参与,模拟真实演示场景;
- Bug 修复后需严格执行交叉测试,禁止开发人员自行关闭 Bug
- 演示环境搭建完成后,需备份数据库与代码版本,防止数据丢失或版本回退;
- 各组负责人需在今日 23:00 前向 PM 汇报任务完成情况,确认是否存在遗留问题;
- 明日演示需提前 10 分钟到场,检查环境与设备,做好准备。
---
## 【注】
1. 本文档为"智能查询"项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后,按"meeting-minutes-(周号)-(序号)"格式命名,例如"meeting-minutes-12"。

@ -0,0 +1,104 @@
# 小组会议纪要-第12周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 马芳琼
**会议主题:** 第 11 周工作复盘、第 12 周计划同步及 Alpha 版本展示筹备
**会议地点:** 信息科学与工程学院院楼563边耐政老师办公室
**会议时间:** 2025-12-09 08:00-09:00
**纪录时间:** 2025-12-08 09:30-10:00
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. Alpha 版本演示情况复盘
## 各组汇报演示过程中的表现、问题及改进点:
- **前端组(程荟锦、阿米娜):**
顺利完成用户管理、好友增删等模块演示,功能操作流畅;
问题:演示中功能响应略慢,被老师指出;异常日志标红功能未实现,影响用户体验反馈。
- **后端组(赵文琪、马芳琼):**
核心接口演示无故障,数据流转顺畅,权限控制功能得到老师初步认可;
问题老师指出表级权限控制颗粒度不足需支持字段级权限AI 服务集成在高并发场景下仍有优化空间。
- **AI 引擎组(李琪雯、李瑜清):**
NL2SQL 功能演示成功,模糊查询处理效果较好;
问题:老师提出复杂多表关联查询的 SQL 生成需进一步提升。
- **管理组PM**
演示流程推进有序,汇报清晰,完整呈现项目进展与技术亮点;
问题:演示中对部分技术实现细节讲解不够透彻,老师提出的文档完整性问题需整改。
### 2. 指导老师反馈整理与整改任务认领
PM 李瑜清汇总边耐政老师的反馈意见,明确整改优先级,全体成员认领整改任务:
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------------- | :-------------- | :----------------------------------------------------------- |
| 1 | **功能优化:字段级权限控制开发** | 后端组(赵文琪、马芳琼) | 完成字段级权限控制核心 API 开发,支持按用户角色动态过滤表字段;配套更新权限管理逻辑与数据库表结构。 |
| 2 | **AI 能力提升:复杂多表关联 SQL 生成优化** |优化 Prompt 逻辑;提升 SQL 语法正确性与查询效率确保核心场景准确率≥90%。 |
| 3 | **前端体验优化:性能与功能完善** | 全体成员 | 优化接口响应速度目标≤300ms |
| 4 | **文档完善:接口文档与版本管理** | 全体成员、PM |前后端组补充接口文档版本记录、字段说明及异常码定义PM 汇总所有文档,形成标准化文档包。 |
| 5 | **性能优化:高并发场景适配** | 后端组、AI 引擎组 |前后端组优化数据库索引与连接池配置AI 引擎组优化服务调用超时机制,添加熔断降级策略,提升高并发场景稳定性。 |
| 6 | **Beta 版本功能规划细化** | 全体成员 | 结合老师反馈12 月 14 日前完成 Beta 版本功能清单细化,明确新增功能的技术实现方案与优先级。|
**关键说明:**
- **整改优先级:** 字段级权限控制、AI SQL 生成优化、页面体验优化为 P0 级整改任务,需优先完成;文档完善与性能优化为 P1 级,确保在本周内收尾。
- **质量要求:** 所有整改功能需经过单元测试与交叉测试,提交测试报告;文档需符合团队规范,确保完整性与准确性。
- **时间节点:** 严格遵守各任务截止时间,每日 17:00 前各组同步整改进度PM 跟进落实情况。
- **协作要求:** 字段级权限控制开发需前端组配合更新权限管理页面;性能优化需后端与 AI 组协同调试,确保接口调用效率。
## 问题总结
### 已解决问题:
1. Alpha 版本核心功能演示顺利完成,实现了 Alpha 阶段核心交付目标;
2. 紧急 Bug 修复到位,演示过程中未出现致命故障;
3. 明确了老师反馈的核心问题与整改方向,形成结构化整改清单。
### 待解决问题:
1. 字段级权限控制、AI 复杂多表关联 SQL 生成优化等核心整改任务未完成;
2. 前端页面性能与功能、后端高并发适配等体验优化任务需推进;
3. 项目文档完整性不足,缺少版本管理与详细说明;
4. Beta 版本功能规划需进一步细化,技术实现方案待确认。
## 小组协作情况总结
1. 演示配合默契:各组在演示过程中衔接顺畅,充分展现了团队协作能力;
2. 反馈接收高效:认真记录老师反馈,快速梳理整改方向,无推诿情况;
3. 任务认领积极:全体成员主动认领整改任务,明确责任与时间节点;
4. 跨组协作需求明确:整改任务中涉及多组协作的内容已明确对接人,减少后续沟通成本;
5. 细节把控不足:演示中暴露的文档不完善、技术讲解不透彻等问题,需在后续工作中加强。
## 一周纪律情况总结
- 参会情况:全体成员准时参会,认真听取老师反馈与整改安排;
- 任务响应:整改任务认领后,各组立即启动工作,执行效率较高;
- 沟通协作:跨组协作问题能主动沟通,技术对接顺畅;
- 文档提交:已按要求提交 Alpha 版本演示总结,内容详实;
- 进度把控:核心整改任务按时间节点推进,暂无严重滞后情况。
## 备注
- 每日 17:00 前,各组需向 PM 提交整改任务进度表,明确已完成工作与剩余问题;
- 字段级权限控制开发需在 12 月 14 日前完成基础框架搭建,便于前端组同步开发页面;
- AI 组样本训练完成后,需及时与后端组联调,验证 SQL 生成效果;
- 文档完善需严格按照团队规范执行PM 负责最终审核;
- 12 月 14 日 16:00 将召开 Beta 版本规划评审会,各组需提前准备功能实现方案。
---
## 【注】
1. 本文档为"智能查询"项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后,按"meeting-minutes-(周号)-(序号)"格式命名,例如"meeting-minutes-12"。

@ -0,0 +1,36 @@
# 小组周总结-第12周
## 团队名称和起止时间
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **【演示】Alpha 版本稳定性保障** | 完成 | **演示版本稳定交付**周一前集中完成所有紧急 Bug 修复(含后端接口异常、前端渲染卡顿等核心问题),修复后及时冻结代码,未新增任何功能迭代,确保演示版本的稳定性与一致性,为后续演示奠定基础。 |
| 2 | **【里程碑 - 4】向指导老师进行 Alpha 版本演示** | 完成 | **Alpha 阶段核心交付达成**由 PM 主导整体汇报各模块负责人配合功能演示完整呈现系统登录、查询、权限分配、好友分享等核心功能清晰汇报项目进展、技术亮点如混合存储架构、AI 鲁棒性优化)及开发挑战,获得指导老师针对性反馈。 |
| 3 | **【开发】完成上周遗留功能开发** | 部分完成 | **Alpha 版本功能收尾推进** 1. 好友管理已完成好友添加、删除、申请处理等基础功能实时消息通知的前后端对接仍在开发中2. 日志功能:后端日志查询、筛选 API 已完善,系统管理员与数据管理员的日志页面功能对接及导出功能开发中。 |
| 4 | **【质量】代码规范自查与交叉审查** | 部分完成 |**代码质量提升机制落地** 自查与交叉审查推进中,全体成员对照 Java 代码规范,进行个人负责模块的代码格式化与冗余逻辑重构,按代码审查名单有序开展跨成员审查,重点核查命名规范、注释完整性、代码复用及异常处理。|
| 5 | **【管理】组织演示复盘与 Beta 版本规划启动会** | 完成 | **版本过渡衔接顺畅** 1. 演示复盘全面总结演示成功经验与不足详细记录指导老师提出的功能优化、性能提升等反馈建议形成整改清单2. Beta 规划确定:结合老师反馈与项目迭代需求,共同讨论并明确 Beta 版本拟新增的核心功能方向及技术实现优先级。 |
| 6 | **【管理】团队管理与文档提交** | 完成 | **团队文档管理规范** PM 已督促全体成员完成第十一周个人周总结与第十二周个人周计划的提交,核查文档完整性与规范性后,按时汇总形成团队周报并完成归档上传。 |
## 小结
1. **里程碑圆满达成:** Alpha 版本演示成功交付,顺利开启 Beta 版本规划。本周通过紧急 Bug 修复与代码冻结,保障了演示的稳定进行,标志着 Alpha 阶段核心目标实现,为项目进入下一迭代阶段奠定基础。
2. **功能收尾有序推进:** 上周遗留的好友管理、日志功能已完成核心模块开发剩余对接工作按计划推进Alpha 版本功能完整性进一步提升,满足基础业务场景需求。
3. **质量管控机制落地:** 正式启动代码规范自查与交叉审查,推动团队编码风格统一,减少潜在 Bug提升系统可维护性标志着团队开发流程向专业化、规范化迈进。
4. **版本过渡衔接高效:** 及时组织演示复盘与 Beta 版本规划会,精准承接指导老师反馈,明确下一阶段开发方向,确保项目迭代的连贯性与针对性。
5. **团队协作效能提升:** 从 Bug 修复、演示筹备到复盘规划,各模块成员高效配合,跨组沟通顺畅,充分体现了团队的凝聚力与执行力,保障了各项任务按时间节点落地。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. PM综合本小组成员工作情况提交小组周计划、周总结报告按时上传至代码托管平台。

@ -0,0 +1,30 @@
# 个人周计划-第12周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 阿米娜·赛力克
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【演示】Alpha版本前端稳定性保障周一** | 全体成员| **确保演示版本前端无虞**。<br>1. **紧急Bug修复**在周一下午前集中修复主查询、用户管理等核心页面任何遗留的样式、交互或兼容性Bug。<br>2. **演示链路预演**与后端、AI组配合完整走查一遍演示流程登录->查询->图表展示),确保界面响应正确、数据加载流畅、无阻塞性错误。 |
| 2 | **【开发】完成前端遗留功能联调(演示后)** | 前端组 | **推动未闭环功能上线**。<br>1. **好友管理功能**:与后端协作,完成好友申请处理、消息通知等前端页面的接口对接与交互联调。<br>2. **日志查看功能**:完成系统/数据管理员日志页面的最终联调,确保筛选、分页功能正常工作。 |
| 3 | **【质量】前端代码规范自查与交叉审查** | 前端组 | **提升前端代码质量**。<br>1. **代码自查与重构**:依据团队前端规范,检查并重构个人代码,重点优化组件封装、状态管理、注释清晰度。<br>2. **参与交叉审查**:审查分配到的其他成员的前端代码,重点关注组件复用性、性能隐患及代码风格一致性。 |
| 4 | **【管理】参与演示复盘与Beta规划** | 全体成员 | **贡献前端视角,明确后续方向**。<br>1. **复盘总结**:在复盘会上,从用户体验和界面实现角度,总结演示中的得失,并记录老师对前端的所有反馈。<br>2. **Beta版本规划**参与讨论基于反馈提出Beta版本前端需要优化或新增的功能需求如性能优化、交互改进等。 |
## 小结
1. **工作节奏转换**:本周前期(周初)聚焦于**演示保障**,确保已开发功能稳定可靠;后期(演示后)重心转向**功能收尾、质量提升与未来规划**。
2. **引入规范流程**:本周将首次系统性参与**代码交叉审查**,这是提升个人代码质量、学习他人优秀实践的重要机会,需认真对待。
3. **承上启下**本周是Alpha阶段的收官与Beta阶段的起点。需通过复盘会将演示收获和老师反馈有效转化为下一阶段前端工作的具体优化项。
## 注意事项
1. **演示前全面自测**:周一务必对负责的所有页面进行多端(浏览器)、多场景的测试,确保演示万无一失。
2. **代码审查态度**:进行交叉审查时,以学习和共建为目的,提出的建议应具体、有据,同时虚心接受他人对自己代码的合理建议。
3. **明确联调依赖**:在推动遗留功能联调时,主动与后端确认接口进度和测试数据支持,避免单向等待。
4. **积极规划参与**在Beta规划会上主动思考并阐述前端在下一个迭代中可以承担的技术优化与用户体验改进任务。

@ -0,0 +1,41 @@
# 个人周总结-第12周
## 基本信息
**姓名:** 阿米娜·赛力克
**团队名称:** 4班-神奇宝码队
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 任务内容 | 状态 | 说明 |
|------|----------|------|------|
| 1 | **【演示】Alpha版本前端稳定性保障周一** | 完成 | 集中修复了主查询、用户管理等核心页面的样式、交互及兼容性Bug并与后端、AI组配合完成演示流程的全链路预演确保了演示版本前端的稳定与流畅演示过程无重大异常 |
| 2 | **【开发】完成前端遗留功能联调(演示后)** | 进行中 | 已与后端协作完成好友管理功能的前端接口对接与交互联调,日志查看功能的筛选与分页联调也已基本完成,剩余少量细节优化正在进行 |
| 3 | **【质量】前端代码规范自查与交叉审查** | 部分完成 | 依据团队规范对个人代码进行了全面自查与重构,优化了组件封装与状态管理,并参与了代码交叉审查,提出了多项可复用性与性能优化建议,同时接受了他人反馈并进行了相应调整 |
| 4 | **【管理】参与演示复盘与Beta规划** | 完成 | 在复盘会上总结了演示过程中的前端表现记录了老师反馈并在Beta规划中提出了性能优化、交互改进等前端相关建议明确了下一阶段的技术方向 |
## 对团队工作的建议
1. **代码审查机制常态化**:建议将本周开展的代码交叉审查流程固定下来,形成常态化机制,持续提升整体代码质量与团队协作效率
2. **演示预演流程标准化**:建议总结本次演示前的预演经验,形成标准化的演示预演清单与流程,便于后续版本或项目复用
3. **需求反馈跟进闭环**:建议建立统一的反馈收集与跟进机制,确保老师、用户及团队成员提出的前端相关建议能及时纳入迭代规划并落实
## 本周小结
**演示保障任务顺利完成**作为本周首要任务在周一对前端进行了全面自测与Bug修复配合团队完成演示流程预演确保了Alpha版本演示的顺利与稳定。
**遗留功能联调有序推进**:演示后及时转入功能收尾阶段,好友管理与日志查看功能已完成主体联调,为后续功能上线奠定基础。
**代码质量提升初见成效**:通过代码自查与交叉审查,不仅优化了个人代码结构,也学习了团队优秀实践,提升了代码规范意识与协作能力。
**复盘与规划积极参与**在复盘与Beta规划会上积极发言系统总结了前端表现提出了具有建设性的优化建议为下一阶段工作明确了方向。
**多任务切换与时间管理能力持续增强**:本周在保障演示、推进开发、参与评审等多任务间高效切换,进一步提升了项目节奏把控与时间管理能力。
**团队协作与沟通顺畅**:在演示预演、联调对接、代码审查等环节中与后端、测试、产品等多角色保持高效沟通,协作流程顺畅,问题响应及时。
**个人成长与技术视野拓展**:通过代码审查与规划讨论,不仅巩固了前端技术能力,也对项目整体架构与迭代规划有了更深入的理解。
**说明**本周作为Alpha阶段的收官与Beta阶段的起点任务完成质量高演示保障到位功能联调推进有序代码质量与团队协作能力均得到进一步提升为Beta版本的高质量开发奠定了良好基础。

@ -0,0 +1,40 @@
# 个人周总结-第12周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 计划内容 | 执行情况 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **Alpha版本前端稳定性保障** | 进行中 | 协同全体开发成员集中修复核心页面样式、交互及兼容性Bug |
| 2 | **完成前端遗留功能联调** | 进行中 | 已与后端协作完成好友管理功能的前端接口对接与交互联调,日志查看功能的筛选与分页联调也已基本完成,剩余少量细节优化正在进行 |
| 3 | **代码规范自查与优化** | 进行中 | 依据审查建议,对个人负责模块的代码进行了自查和重构(重点优化了组件封装和注释清晰度)。按代码审查名单参与了对其他成员代码的**交叉审查**提出了关于样式冗余、TypeScript类型不严谨等具体修改建议。 |
| 4 | **参与复盘与Beta规划** | 完成 |复盘代码不足与缺陷,参与 Beta 版本的初步规划讨论。 |
## 小结
### 工作重心达成情况
本周工作重心从 Alpha 版本的 **演示保障** 顺利过渡到 **质量提升和版本规划**。
1. **稳定交付**:通过充分的预演和 Bug 修复,保障了 Alpha 演示中前端界面的稳定性和用户体验。
2. **质量起步**:首次系统性参与了代码交叉审查,提升了对编码规范的理解,并将自查与互查的结果转化为下一阶段前端重构的明确任务清单。
3. **承上启下**:通过参与复盘和 Beta 规划已明确前端在第13周的主要任务是 **彻底的代码规范整改** 和 **Beta 版本核心功能启动**
### 不足与改进
1. **功能未闭环**好友管理实时消息通知、日志页面最终联调等功能未能在本周完全收尾。这些将作为第13周的 **优先任务**,需配合后端尽快完成联调。
2. **规范化待闭环**:代码的**交叉审查**工作虽已启动,但根据审查结果进行 **代码修改和整改** 才是关键。需在第13周集中精力彻底落实所有规范化要求对应第13周任务3
## 注意事项
1. **周初任务聚焦**第13周周初需优先完成 **代码规范化重构任务3** 和 **遗留功能联调**,确保以高质量的代码开始 Beta 版本开发。
2. **联调依赖管理**:在推动遗留功能联调时,继续主动与后端确认接口进度和测试数据支持,避免单向等待。
3. **积极规划参与**:在 Beta 规划会上,主动思考并阐述前端在下一个迭代中可以承担的技术优化与用户体验改进任务。

@ -0,0 +1,39 @@
# 个人周总结-第12周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :------------------------------------------- | :------- | :----------------------------------------------------------- |
| 1 | **【PM职责】主导Alpha版本演示与稳定性保障** | 完成 | 1. **成功主导了Alpha版本演示**:作为主讲人,向指导老师清晰、流畅地展示了系统的核心功能,并准确回答了老师关于技术架构和应用场景的提问,获得了积极反馈。<br>2. **演示前的高强度保障**周一组织全员进行了几轮全流程演练排查并修复了数个可能导致演示中断的临界Bug确保了演示现场的零失误。 |
| 2 | **【核心技术】完成代码任务与功能收尾** | 进行中 | **遗留功能开发(进行中)**:投入精力协助后端组推进日志和好友功能的收尾。目前日志查询接口已调通,日志功能基本完成;好友功能的实时通知模块遇到技术难点,正在攻克中。 |
| 3 | **【管理】推行团队代码规范与Code Review** | 进行中 | **代码互查**:根据老师给的意见与我们互相之间的代码检查,正在进行代码优化。 |
| 4 | **【PM职责】组织演示复盘并启动Beta版本规划** | 完成 | 1. **主持了演示复盘会**引导团队从“做得好的”和“待改进的”两个维度进行了深入复盘总结了Alpha阶段的经验教训。<br>2. **启动Beta规划**基于老师的反馈如增加多表查询、优化图表交互与团队共同确立了Beta版本的核心迭代目标明确了下一阶段的方向。 |
| 5 | **【管理】团队周报与文档提交** | 完成 | 督促并检查了所有成员第十一周周总结和第十二周周计划的提交情况,并按时汇总提交了团队周报。 |
## 对团队工作的建议
2. **攻克遗留难点**对于日志和好友功能中未完成的部分建议相关负责人包括我自己在下周初集中精力攻坚不要把Alpha的尾巴一拖再拖。
3. **用户体验优先**在Beta规划中我们要更加重视用户体验。老师在演示中提到的查询优化、图表交互问题应作为Beta版本的优化重点。
## 小结
1. **里程碑与新起点**本周成功完成了Alpha演示这是项目的一个重要里程碑。看到我们的系统从文档变成现实并得到老师的认可我感到非常有成就感。但这只是一个新的起点Beta阶段的挑战将更加艰巨。
3. **技术与管理的平衡**在忙于演示准备的同时我依然坚持在一线写代码。虽然部分功能收尾略有延后但我认为保持对技术细节的敏感度对于做好这个项目的PM至关重要。
4. **下周展望**下周我们将正式进入Beta版本开发。我将带领团队快速消化复盘成果完成遗留功能收尾并全力投入到多表联合查询这一核心技术难点的攻关中。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,38 @@
# 个人周总结-第12周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务计划安排
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **向指导老师进行Alpha版本演示** | 已完成 | 参与了向指导老师的Alpha版本演示。配合PM完成功能演示展示了现有成果。 |
| 2 | **代码规范自查与交叉审查** | 部分完成 | 根据团队安排完成了对个人负责模块的代码自查按照Java代码规范完成了格式化和部分冗余逻辑的重构,交叉审查正在进行中。 |
| 3| **【管理】组织演示复盘与Beta版本规划启动会** | 已完成 | 参与了演示复盘与Beta规划,共同讨论并明确 Beta 版本拟新增的核心功能方向及技术实现优先级。 |
## 对团队工作的建议
1. **测试前移:** 建议在Beta版本开发前对Alpha阶段的核心功能接口进行一次集中的集成测试复盘确保基础服务的稳定性避免在新增功能时引入旧问题。
2. **知识沉淀:** 对于本次演示中老师提出的共性技术问题建议技术负责人整理一份简明的解决方案FAQ或参考文档方便后续开发参考避免重复踩坑。
## 小结
1. **挑战与成长:** 本周从紧张的Bug修复、演示准备到复盘规划节奏紧凑。
2. **后续计划:** 下周将集中完成日志功能的收尾并开始投入到Beta版本分配的新功能开发中。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,48 @@
# 个人周总结-第12周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **Alpha 版本 Bug 修复** | 进行中 | 协同全体开发成员,针对上周联调暴露的接口异常问题开展修复,重点负责后端数据流转环节的 Bug 排查与逻辑优化,顺利完成 Alpha 版本向指导老师的演示,除仪表盘查看、仪表盘数据库管理、收藏夹及分享功能外,其余核心功能均通过演示验证 |
| 2 | **Alpha 版本演示技术支撑** | 进行中 | 持续推进仪表盘查看、收藏夹等未完成功能模块的开发与调试,补全核心业务逻辑 |
| 3 | **好友管理功能收尾开发** | 基本完成 | 好友管理模块核心功能已全部完善,包含好友添加、删除、列表查询及申请处理等全流程功能 |
| 4 | **日志功能模块完善** | 进行中 | 核心功能仍在开发过程中 |
| 5 | **代码规范自查与优化** | 进行中 | 参照 Java 编码规范,完成个人负责模块代码的格式化处理与逻辑重构,修正命名不规范、代码冗余等问题 |
| 6 | **代码交叉审查** | 进行中 | 参与团队代码交叉审查工作,重点聚焦后端接口设计、异常处理逻辑及数据校验完整性,提出优化建议 |
| 7 | **演示复盘与反馈整理** | 完成 | 参与 Alpha 版本演示复盘会议,详细记录指导老师针对后端模块的反馈,梳理成结构化整改清单,明确优先级与落地路径,同步至团队共享文档 |
| 8 | **Beta 版本功能规划讨论** | 进行中 | 参与 Beta 版本功能规划会议,结合后端技术栈特性,针对用户体验优化类功能提出技术实现方案,参与功能拆解与工作量评估,就开发排期和资源分配提出建议,目前仍在细化功能落地细节 |
## 对团队工作的建议
1. **细化重构实施计划:** 建议制定详细的重构实施计划与时间节点,按模块分阶段落实老师提出的 16 条改进建议,确保重构有序推进;
2. **统一代码审查标准细则:** 建议明确统一的代码审查标准,细化命名规范、注释要求、异常处理等审核要点,保障重构后代码质量一致性;
3. **建立技术债务追踪体系:** 建议搭建技术债务追踪机制,分类记录代码质量问题,制定优先级排序规则,系统性推进问题整改;
4. **搭建重构经验共享平台:** 建议组织代码重构经验分享会,鼓励成员交流实操心得与避坑技巧,助力团队整体技术能力提升。
## 小结
1. **Alpha 版本演示里程碑顺利达成:** 本周成功完成 Alpha 版本的演示工作,获得指导老师的认可,系统核心功能已基本实现,为后续迭代奠定基础;
2. **基于老师反馈启动代码质量专项提升计划:** 针对老师提出的 16 条详细反馈,团队正式启动代码质量提升专项工作,重点攻克架构设计、代码规范、安全防护等核心问题;
3. **深度推进技术架构优化:** 对 SpringBoot 后端项目开展系统性架构优化,涵盖服务粒度调整、全局异常处理统一、代码安全加固等关键方向;
4. **个人技术能力显著提升:** 通过参与代码重构与架构优化工作,熟练掌握企业级编码规范、安全编码实践及架构设计核心原则,技术储备进一步丰富;
5. **团队协作默契度进一步增强:** 在代码审查与重构讨论过程中,与团队成员的技术交流更深入,问题协同解决效率明显提高;
6. **代码质量问题识别能力持续强化:** 借助老师的专业反馈,对代码质量问题的敏感度与解决能力得到提升,形成更全面的质量管控思维;
7. **后续工作方向清晰明确:** 下一阶段将集中精力落实 16 条代码改进建议,同步推进 Alpha 版本剩余功能模块的完善,为 Beta 版本开发做好铺垫。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,49 @@
# 个人周总结-第12周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-08
**结束时间:** 2025-12-14
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **Alpha版本演示与代码提交** | 完成 | 成功向指导老师演示Alpha版本除查看仪表盘、仪表盘数据库管理、收藏夹、分享功能外其余功能通过演示 |
| 2 | **代码架构优化老师反馈16-22** | 进行中 | 根据老师反馈开始重构SpringBoot项目<br>1. 合并UserService和UserSearchService减少服务粒度<br>2. 建立全局异常处理机制(@ControllerAdvice<br>3. 拆分过长函数,提高代码可维护性<br>4. 提取硬编码到Constants类 |
| 3 | **代码安全优化** | 进行中 | 修复UserController直接使用User实体的安全问题引入DTO模式防止数据泄露 |
| 4 | **代码注释完善** | 进行中 | 为SpringBoot后端代码添加类和方法注释提高代码可读性 |
| 5 | **代码规范自查与优化** | 进行中 | 对照Java代码规范完成个人负责代码的格式化和重构 |
| 6 | **代码交叉审查** | 进行中 | 参与团队代码交叉审查,重点关注后端代码质量 |
| 7 | **Alpha版本功能完善** | 进行中 | 继续完善查看仪表盘、收藏夹等尚未完成的功能模块 |
| 8 | **好友管理功能收尾开发** | 完成 | 好友管理模块功能已基本完善 |
| 9 | **权限管理功能模块完善** | 完成 | 完成了数据管理员权限分配功能 |
## 对团队工作的建议
1. **重构计划制定:** 建议制定详细的重构计划和时间表分阶段实施老师的16条改进建议
2. **代码规范统一:** 建议建立统一的代码审查标准,确保重构后的代码质量;
3. **技术债务管理:** 建议建立技术债务追踪机制,系统性地解决代码质量问题;
4. **知识共享机制:** 建议组织重构经验分享会,提高团队整体技术水平。
## 小结
1. **Alpha版本里程碑达成** 本周成功完成了Alpha版本的演示获得了指导老师的认可系统核心功能基本实现
2. **代码质量提升计划启动:** 基于老师的16条详细反馈团队正式启动了代码质量提升计划重点解决架构设计、代码规范、安全性等问题
3. **技术架构优化深入:** 开始对SpringBoot后端进行系统性的架构优化包括服务粒度调整、异常处理统一、代码安全加固等
4. **个人技术成长显著:** 通过参与代码重构和架构优化,深入学习了企业级代码规范、安全编码实践和架构设计原则;
5. **团队协作更加紧密:** 在代码审查和重构讨论中,与团队成员的技术交流更加深入,协作效率明显提升;
6. **问题识别能力增强:** 通过老师的专业反馈,提高了对代码质量问题的识别和解决能力;
7. **后续工作重点明确:** 下一阶段将集中精力完成16条代码改进建议同时继续完善Alpha版本剩余功能模块。
---
## 【注】
1. 希望获得代码重构和架构设计方面的实践指导特别是SpringBoot项目的最佳实践
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台。

@ -0,0 +1,86 @@
# 小组会议纪要-第13周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 程荟锦
**会议主题:** 第12周工作总结复盘、Alpha版本评审反馈、第13周周计划同步与任务认领
**会议地点:** 线下天马二食堂二楼
**会议时间:** 2025-12-14 16:30-18:00
**纪录时间:** 2025-12-14 16:30-18:30
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 第12周个人周总结复盘与Alpha评审汇报
#### 全体成员依次汇报第12周工作成果、问题及改进方向
- **里程碑达成与稳定保障:** Alpha 版本演示成功交付,顺利开启 Beta 版本规划。全体成员通过紧急 Bug 修复与代码冻结,保障了演示版本的稳定性与一致性。
- **Alpha 评审反馈:** 已详细记录指导老师提出的功能优化、性能提升等反馈建议,形成整改清单。
- **功能收尾:** 好友管理已完成好友添加、删除、申请处理等基础功能,实时消息通知的前后端对接仍在开发中。日志功能后端查询、筛选 API 已完善,系统管理员与数据管理员的日志页面功能对接及导出功能开发中。
- **代码质量:** 代码规范自查与交叉审查正在推进中,全体成员对照规范,进行代码格式化与冗余逻辑重构。
#### 遗留问题与风险点:
- **遗留功能收尾:** 实时消息通知的前后端对接、管理员日志页面功能和导出功能仍需在本周收尾。
- **代码质量闭环:** 代码规范自查与交叉审查尚未完全收尾,需在本周继续落实整改,以彻底解决遗留的技术债务。
### 2. 第13周周计划同步与任务认领
PM 李瑜清宣讲《第13周周计划》全体成员确认任务并认领。本周核心里程碑是 **关键文档定稿** 和 **Beta 版本启动**
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【文档】《迭代开发计划》第三稿更新与定稿** | PM、全体成员 | 基于 Alpha 版本演示的反馈,更新《迭代开发计划》至第三稿,重点是 **Beta版本的功能拆解与排期**,作为后续开发的指导文档。 |
| 2 | **【文档】《需求规格说明书》最终稿提交** | PM、各模块负责人 | 参照最新需求和 Alpha 版本实现,完成《需求规格说明书》的 **最终审阅、完善与定稿**,并准备提交至头歌测试平台。 |
| 3 | **【质量】根据修改建议修改项目代码** | 全体成员 | **代码规范化和Bug修复**:根据上周代码审查建议,修正所有代码,**确保项目代码满足编码规范**。重点解决后端服务划分、前端 TypeScript 类型不严谨、样式冗余、API 集中等问题。 |
| 4 | **【测试】头歌平台代码检查** | 全体成员 | **代码检查与结果提交**:对 **指定小组** 的项目代码进行检查,并将详细的检查结果文档提交至 **头歌测试平台-团队项目分组作业**。 |
| 5 | **【开发】启动Beta版本核心功能开发** | 全体成员 | 按照《迭代开发计划》第三稿,正式进入 **Beta版本功能编码阶段**。重心转向提升用户体验和完善系统功能。 |
| 6 | **【管理】小班讨论课Alpha版本评审与演示** | 全体成员 | 在小班讨论课上,向指导老师完整演示 Alpha 版本的开发完成情况,并接受评审。 |
| 7 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促并检查所有成员第十二周周总结和第十三周周计划的提交情况,并按时汇总提交团队周报。 |
### 3. 问题总结
### 已解决问题:
1. **Alpha 演示里程碑达成**:成功完成 Alpha 版本演示,标志着 Alpha 阶段核心目标实现。
2. **版本过渡衔接高效**:及时组织演示复盘与 Beta 版本规划启动会,明确了下一阶段开发方向。
### 待解决问题:
1. **遗留功能收尾**:好友管理实时消息通知对接、日志页面功能对接及导出功能需在本周优先完成。
2. **代码质量整改闭环**需根据上周交叉审查的详细清单落实所有代码修正对应本周任务3并确保通过外部检查任务4
### 4. 小组协作情况总结
1. **质量控制强化**:正式启动代码规范自查与交叉审查,本周将通过修改代码以满足规范和进行外部代码检查,进一步加强团队的质量控制流程。
2. **团队协作效能提升**:各模块成员高效配合,跨组沟通顺畅,充分体现了团队的凝聚力与执行力。
3. **版本过渡衔接高效**:通过复盘和规划会议,确保了项目迭代的连贯性与针对性。
### 5. 一周纪律情况总结
- **任务交付**:第 12 周计划任务完成率高,核心交付已达成。
- **文档提交**:全体成员按规范提交第十二周周总结和周计划,团队文档管理规范。
- **沟通协作**:跨组沟通及时,未出现因沟通延迟导致的任务阻塞。
## 备注
1. **演示风险提醒**:本周五的小班讨论课为 Alpha 版本评审,全体成员需在周四前完成所有代码规范整改和遗留 Bug 修复,保障评审顺利。
2. **代码规范追踪**代码修正任务3后需提交至 PM 再次进行核验,确保修正彻底落实。
3. **个人文档提交**:全体成员按时提交第十二周个人周总结和第十三周个人周计划。
---
## 【注】
1. 本文档为“智能查询”项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后按“meeting-minutes-(周号)-序号”格式命名例如“meeting-minutes-13-01”。

@ -0,0 +1,33 @@
# 小组周计划-第13周
## 团队名称和起止时间
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【文档】《迭代开发计划》第三稿更新与定稿** | PM、全体成员 | 基于Alpha版本演示的反馈更新《迭代开发计划》至第三稿重点是 **Beta版本的功能拆解与排期**,并作为后续开发的指导文档。 |
| 2 | **【文档】《需求规格说明书》最终稿提交** | PM、各模块负责人 | 参照最新需求和Alpha版本实现完成《需求规格说明书》的 **最终审阅、完善与定稿**,并准备提交至头歌测试平台。 |
| 3 | **【质量】根据修改建议修改项目代码** | 全体成员 | **代码规范化和Bug修复**:根据上周代码审查中提出的修改建议,修正所有代码,**确保项目代码满足编码规范**。 |
| 4 | **【测试】头歌平台代码检查** | 全体成员 | **代码检查与结果提交**:根据任务安排,对 **指定小组** 的项目代码进行检查,并将详细的检查结果文档提交至 **头歌测试平台-团队项目分组作业**。 |
| 5 | **【开发】启动Beta版本核心功能开发** | 全体成员 | 按照《迭代开发计划》第三稿,正式进入 **Beta版本功能编码阶段**。重心转向提升用户体验和完善系统功能。 |
| 6 | **【管理】小班讨论课Alpha版本评审与演示** | 全体成员 | 周五的小班讨论课上向指导老师完整演示Alpha版本的开发完成情况并接受评审。 |
| 7 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促并检查所有成员第十二周周总结和第十三周周计划的提交情况,并按时汇总提交团队周报。 |
## 小结
* **工作重心:** 本周工作重心在于 **代码质量的提升**编码规范和Bug修复以及 **关键文档的定稿与提交**。同时全面启动Beta版本开发并迎接Alpha版本评审。
* **质量控制强化:** 本周通过**修改代码以满足规范**和**进行外部代码检查**,进一步加强了团队的质量控制流程,这对提升项目专业度至关重要。
* **里程碑:** 提交《需求规格说明书》最终稿和《迭代开发计划》第三稿,标志着项目进入新的开发阶段。
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. PM综合本小组成员工作情况提交小组周计划、周总结报告按时上传至代码托管平台。

@ -0,0 +1,27 @@
# 小组周总结-第13周
## 团队名称和起止时间
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【文档】《迭代开发计划》第三稿更新与定稿** | 完成 | **Beta开发蓝图明确** 基于Alpha版本演示获得的反馈团队协同更新了《迭代开发计划》至第三稿。文档重点完成了对Beta版本功能的拆解、优先级排序与详细排期已作为团队后续开发的权威指导文件。 |
| 2 | **【文档】《需求规格说明书》最终稿提交** | 完成 | **核心需求基线确立** 由PM组织各模块负责人共同对《需求规格说明书》进行了最终审阅与细节完善确保了内容与当前系统实现及未来Beta规划的一致性。定稿文档已按要求成功提交至头歌测试平台。 |
| 3 | **【质量】根据修改建议修改项目代码** | 进行中 | **代码规范化持续推进** 全体成员根据上周代码审查结果,对各自负责模块的代码进行了格式化、命名规范修正、注释、冗余逻辑优化,按照谷歌编码规范调整代码。整体代码规范性显著提升,部分复杂模块的深度重构仍在按计划进行中。 |
| 4 | **【开发】启动Beta版本功能开发与Bug修复** | 进行中 | **新阶段开发有序启动** 依据《迭代开发计划》第三稿团队正式进入Beta版本编码阶段。各模块已分配具体开发任务核心功能如用户体验优化、通知功能、好友聊天功能的前后端技术方案设计与基础框架搭建工作已全面展开。 |
| 5 | **【管理】小班讨论课Alpha版本评审与演示** | 完成 | **阶段性成果成功汇报** 在周五的小班讨论课上团队向指导老师完整演示了Alpha版本的各项功能汇报了开发进展与质量提升措施并获得了老师对当前成果的肯定以及对Beta方向的进一步指导。 |
| 6 | **【管理】团队管理与文档提交** | 完成 | **团队运作规范有序** PM按时督促并核查了全体成员第十二周周总结与第十三周周计划的提交情况确保内容完整规范后汇总形成团队周报并完成归档上传保障了团队文档管理的连续性。 |
## 小结
1. **文档里程碑达成,开发路径清晰:** 成功提交《需求规格说明书》最终稿并定稿《迭代开发计划》第三稿标志着项目需求基线与Beta阶段开发蓝图正式确立为后续高效、有序的开发工作提供了明确指引。
2. **质量内控与外检双管齐下:** 本周通过内部代码规范化修改与外部小组代码交叉检查两项任务,有效落实了质量管控。不仅提升了自身代码的规范性与可维护性,也通过外部视角学习了其他项目的经验与教训。
3. **版本平稳过渡,开发接力顺畅:** 在完成Alpha版本正式评审的同时顺利启动了Beta版本的核心功能开发实现了项目阶段的平稳过渡。团队已根据新计划投入新一轮开发冲刺。
4. **团队协作流程成熟:** 从文档协作定稿、代码交叉评审到新任务启动,各环节沟通顺畅、执行高效,体现了团队日益成熟的项目管理与协作能力。
5. **希望获得的帮助:** 随着Beta版本涉及更复杂的功能如更深入的性能优化、高级交互逻辑团队希望能有机会参加关于 **“Spring Boot应用性能深度调优”** 或 **“复杂前端状态管理与组件设计”** 方面的技术讲座或分享,以获取更专业的实践指导。

@ -0,0 +1,31 @@
# 个人周计划-第13周
## 基本信息
**团队名称:** 4班-神奇宝码
**姓  名:** 阿米娜·赛力克
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务安排
| 序号 | 任务类型 | 计划内容 | 执行人 | 说明 |
|------|----------|----------|--------|------|
| 1 | 文档 | **参与《迭代开发计划》第三稿修订** | 全体成员 | 基于Alpha演示反馈更新第三稿重点完成Beta版本功能拆解与排期 |
| 2 | 文档 | **协助完成《需求规格说明书》最终稿提交** | 全体成员 | 协助PM完成最终审阅与确认准备提交至头歌平台 |
| 3 | 质量 | **推进前端代码规范化与重构** | 全体成员 | **本周核心任务**:依据代码审查结果进行重构优化,重点包括:<br>• 优化TypeScript类型定义与样式<br>• 清理未使用代码 |
| 4 | 质量 | **修复Alpha版本前端遗留缺陷** | 全体成员 | 修复低优先级但影响体验的问题如错误边界处理、API调用提示等 |
| 5 | 开发 | **启动Beta版本功能需求分析与开发** | 全体成员 | 1. 参加Beta版本规划会议<br>2. 按计划开始前端功能编码 |
| 6 | 管理 | **准备Alpha版本评审演示** | 全体成员 | **截止时间周五22:00前**<br>准备负责模块的演示,确保功能流畅、界面稳定 |
| 7 | 测试 | **配合完成对指定小组的代码检查** | 全体成员 | 根据PM分配检查指定小组代码并提交前端部分报告 |
| 8 | 管理 | **完成个人文档与周报提交** | 个人 | 按时提交第十二周总结和第十三周计划,保持工作记录同步 |
## 本周小结
1. **工作重心转移**从Alpha联调转向**代码质量提升**和**文档定稿**,同时启动**Beta版本开发**
2. **质量专项推进**:系统性解决前端代码规范性、类型严谨性及错误处理问题
3. **版本衔接过渡**确保Alpha评审通过后快速进入Beta开发阶段
## 注意事项
1. **规范优先**代码规范化任务3是质量保障基础需优先彻底完成
2. **演示准备**:提前充分自测演示流程,确保评审顺利
3. **及时沟通**Beta开发中遇到需求变更或技术障碍需及时同步

@ -0,0 +1,38 @@
# 个人周总结-第 13 周
## 基本信息
**姓名:** 阿米娜·赛力克
**团队名称:** 4 班-神奇宝码队
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 任务内容 | 状态 | 说明 |
| 1 | **【文档】参与《迭代开发计划》第三稿修订** | 完成 | 基于 Alpha 演示反馈,积极参与团队讨论与修订,重点参与了 Beta 版本功能拆解与排期部分的内容撰写与确认,确保计划合理可行 |
| 2 | **【文档】协助完成《需求规格说明书》最终稿提交** | 完成 | 配合 PM 完成最终审阅与修订,确保前端相关内容表述准确、完整,并协助完成文档的格式整理与平台提交 |
| 3 | **【质量】推进前端代码规范化与重构** | 完成 | **本周核心任务**:依据团队代码审查结果,系统开展了前端代码重构与优化工作,重点优化了 TypeScript 类型定义、统一了样式结构,并清理了冗余和未使用代码,整体代码可维护性显著提升 |
| 4 | **【质量】修复 Alpha 版本前端遗留缺陷** | 完成 | 集中修复了若干低优先级但影响用户体验的前端问题,如完善错误边界处理、优化 API 调用时的用户提示等,进一步提升了系统的健壮性与友好性 |
| 5 | **【开发】启动 Beta 版本功能需求分析与开发** | 进行中 | 参加了 Beta 版本规划会议,明确了各功能模块分工与排期;已根据分配的前端任务,完成了部分新功能模块的初始代码结构与基础逻辑搭建 |
| 6 | **【管理】准备 Alpha 版本评审演示** | 进行中 | **按时完成(周五 22:00 前)**:细致准备并反复自测了负责模块的演示内容,确保了在团队内部评审中功能演示流畅、界面响应稳定,顺利通过评审 |
| 7 | **【测试】配合完成对指定小组的代码检查** | 进行中 | 根据 PM 分配,认真检查了指定小组的前端代码,从代码规范、逻辑结构、性能等方面提出了详细的审查意见,并按时提交了前端部分检查报告 |
| 8 | **【管理】完成个人文档与周报提交** | 完成 | 按时提交了第十二周总结和本周(第十三周)计划,保持了工作记录的连续性与同步性 |
## 对团队工作的建议
1. **重构经验沉淀**:建议将本次代码规范化重构中的优秀实践、遇到的问题及解决方案进行归纳整理,形成团队内部的前端重构指南或 Checklist供后续迭代复用避免同类问题重复出现。
2. **评审流程优化**:本次 Alpha 评审演示准备充分,过程顺利。建议将本次的演示准备流程(如自测清单、演示脚本)稍加整理,形成更轻量化的评审预演模板,提升未来评审效率。
3. **跨组学习机制**:本次代码检查是一次很好的跨组学习机会。建议定期或不定期组织类似的活动,甚至可以举办小型的“代码互评会”或“最佳实践分享会”,促进团队间技术交流与共同成长。
## 本周小结
**高质量完成代码质量专项任务**:作为本周核心,系统性地推进了前端代码规范化与重构工作,并修复了多项遗留缺陷,显著提升了前端代码库的整洁度、类型安全性与健壮性,为 Beta 开发奠定了坚实的质量基础。
**文档工作协同高效**:积极参与了《迭代开发计划》和《需求规格说明书》两项关键文档的定稿工作,确保了前端视角的需求与计划被准确纳入,体现了良好的文档协作与全局意识。
**版本过渡平稳有序**:在完成 Alpha 收尾(评审演示)的同时,顺利启动了 Beta 版本的前期分析与开发工作,实现了开发节奏的平稳切换,展现了良好的版本管理与时间规划能力。
**团队协作与对外交流深入**:不仅高效完成了团队内部任务,还通过代码检查任务与外部小组进行了深入的技术交流,拓宽了技术视野,也输出了本团队的前端质量要求与实践。
**个人综合能力持续提升**:本周在代码深度优化、多文档协同、跨版本任务管理等多个维度开展工作,进一步锻炼了代码工匠精神、系统性思维和项目协调能力。

@ -0,0 +1,36 @@
# 个人周计划-第13周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【文档】参与《迭代开发计划》第三稿更新** | 全体成员 | 基于 Alpha 演示的反馈,参与更新《迭代开发计划》至第三稿,重点是 **Beta版本的功能拆解与排期**,并作为后续开发的指导文档。 |
| 2 | **【文档】协助《需求规格说明书》最终稿提交** | 全体成员 | 协助 PM 完成《需求规格说明书》的 **最终审阅与定稿**,并准备提交至 **头歌测试平台**。 |
| 3 | **【质量】项目前端代码规范化与重构** | 全体成员 | **本周核心质量任务**。根据上周代码审查建议,对前端代码进行重构和优化,确保代码满足既定的 Vue 框架编码规范。重点包括: <br>1. **类型与样式优化**:修复 TypeScript 类型不严谨、样式冗余和重复定义等问题。<br>2. **代码清理**:清理未使用的部分方法。 |
| 4 | **【质量】修复Alpha版本前端遗留Bug** | 全体成员 | **配合团队任务**。修复 Alpha 版本低优先级 Bug重点解决缺少错误边界、API 调用失败无控制台提示等影响用户体验的问题。 |
| 5 | **【开发】Beta版本功能需求分析与启动** | 全体成员 | 1. **参与规划**:参与 Beta 版本规划会议,熟悉并理解新功能需求。<br>2. **任务启动**:按照《迭代开发计划》第三稿的分配,正式开始 Beta 版本的前端功能编码。 |
| 6 | **【管理】Alpha版本评审演示** | 全体成员 | **(周五晚上 10:00 前)** 准备 Alpha 版本演示中负责模块的内容,确保功能流畅、界面稳定,并在小班讨论课上清晰汇报开发完成情况。 |
| 7 | **【测试】配合指定小组代码检查** | 全体成员 | **配合团队任务**。根据 PM 分配,配合完成对**指定小组代码**的检查任务,提交前端部分的检查结果至头歌平台。 |
| 8 | **【管理】个人文档与周报提交** | 个人 | 按时提交**第十二周周总结**和**第十三周周计划**,并确保所有工作记录与代码同步。 |
## 小结
1. **工作重心:** 本周工作重心从 Alpha 版本的联调转向 **代码质量提升**(规范化与重构)和 **关键文档的定稿**,同时正式启动 **Beta 版本的开发**
2. **质量提升:** 遵循团队引入的代码检查机制,彻底解决前端代码的规范性、类型严谨性和错误处理问题。
3. **承上启下:** 确保周五 Alpha 评审顺利通过,并根据评审反馈和新计划,快速进入 Beta 版本的新功能开发阶段。
## 注意事项
1. **优先保障规范化**代码规范化任务3是本周质量保障的基石必须优先完成并彻底解决上周提出的所有前端规范问题。
2. **演示准备**:周五的 Alpha 版本评审非常重要,需预留时间反复自测演示链路,确保流程万无一失。
3. **积极反馈**:在启动 Beta 开发时,若发现需求有变或技术阻塞,应立即同步给 PM 和对应后端成员,避免影响整体进度。

@ -0,0 +1,44 @@
# 个人周总结-第13周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 计划内容 | 执行情况 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【文档】参与《迭代开发计划》第三稿更新** | 完成 | 积极参与团队讨论,结合个人在前端开发中的经验,对 Beta 版本功能拆解中的前端任务排期和依赖关系提供了建议,确认了个人在下一阶段的开发任务。 |
| 2 | **【文档】协助《需求规格说明书》最终稿提交** | 完成 | 配合 PM 对《需求规格说明书》中涉及前端交互和界面的部分进行了最终审阅,确认了需求描述的准确性,并协助完成文档的整理与提交。 |
| 3 | **【质量】项目前端代码规范化与重构** | 进行中 | **按计划推进质量核心任务**。已完成对代码重构,重点解决了以下问题:<br>1. **React转Vue框架迁移**将原先采用React实现的用户中心模块完成了向Vue 3框架Composition API的技术栈迁移确保了项目技术栈的统一与一致性。<br>2. **TypeScript类型优化**:修复了多处 `any` 类型定义,为关键接口响应和组件 Prop 增加了更严谨的类型定义在Vue组件中完善了`defineProps`和`defineEmits`的类型声明。<br>3. **样式冗余清理**:合并了多处重复的 CSS 类定义删除了未使用的样式迁移过程中将原先的CSS-in-JS样式重构为Vue单文件组件内的`<style scoped>`模式。<br>4. **代码逻辑优化**在框架迁移过程中将React的Hooks逻辑重构为Vue的Composition API组合式函数清理了部分未被调用的方法对部分长函数进行了拆分。 |
| 4 | **【质量】修复Alpha版本前端遗留Bug、UI界面优化** | 完成 | **完成低优先级Bug修复**。重点修复了上周遗留的两个问题:<br>1. **错误边界缺失**:在关键路由组件外层添加了全局错误捕获,防止因接口异常导致页面白屏。<br>2. **API调用失败提示**:优化了 Axios 拦截器对非200响应如404、500在控制台输出更清晰的错误信息便于调试。 |
| 5 | **【开发】Beta版本功能需求分析与启动** | 进行中 | **参与规划**:详细了解了 Beta 版本迭代开发的通知功能、好友聊天、分享功能的实现,并与后端同学初步讨论了技术实现方案。 |
| 6 | **【管理】Alpha版本评审演示** | 完成 | **圆满完成任务**。在周五的评审课上,清晰演示了负责的前端模块,确保了展示功能的流程顺畅、界面响应及时,回答了老师关于前端技术选型的问题。 |
| 7 | **【质量】UI界面优化** | 完成 | 与老师以及小组成员讨论沟通后用户界面进行了优化。 |
| 8 | **【管理】个人文档与周报提交** | 完成 | 按时提交了第十二周周总结和第十三周周计划。 |
## 小结
### 工作重心达成情况
本周工作重心成功聚焦于 **质量提升、文档闭环与Beta开发启动**实现了从Alpha到Beta阶段的平稳过渡。
1. **技术栈统一与质量提升**:通过完成**React向Vue框架的技术迁移**及系统性重构,不仅统一了项目前端技术栈,更显著提升了代码规范性和可维护性,为后续开发奠定了坚实的技术基础。
2. **关键节点顺利通过**:在 Alpha 版本评审中圆满完成了演示任务,并协助团队完成了两项核心文档的定稿,标志着项目前期工作正式收尾。
3. **新阶段有序启动**:在完成技术栈迁移和质量整改的同时,已正式投身于 Beta 版本的新功能开发,完成了前期调研和设计工作。
### 不足与改进
1. **迁移与重构进度略有延迟**:原计划本周完成所有模块的代码规范化与框架迁移重构,但有部分修复工作仍在进行。
2. **Beta功能开发深度**:需在确认后端接口定义后,加快设计速度,以明确交互细节。
## 注意事项
1. **完成迁移收尾**:下周首要任务是集中完成**权限管理模块从React到Vue的迁移与重构**,确保项目技术栈完全统一,并达到已迁移模块的质量标准。
2. **深化Beta开发**:在完成迁移收尾后,立即投入“个性化面板”的详细设计与编码工作,并主动与后端对齐接口契约,避免出现联调阻塞。
3. **总结迁移经验**将本次React转Vue框架迁移过程中的技术难点、解决方案以及最佳实践进行总结在团队内部分享为未来可能的类似技术升级积累经验。

@ -0,0 +1,35 @@
# 个人周计划-第13周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
| :--- | :--------------------------------------------- | :----------- | :----------------------------------------------------------- |
| 1 | **【PM职责】主导《需求规格说明书》最终定稿** | 各模块负责人 | **本周首要文档任务**。<br>1. **全面复核**对照Alpha版本实际功能逐一核对需求文档中的描述确保“所写即所做”。<br>2. **补充Beta规划**将Beta版本计划新增的功能如多表查询准确地补充进文档。 |
| 2 | **【PM职责】更新《迭代开发计划》至第三稿** | 全体成员 | 基于上周的复盘结果,**重新规划Beta阶段的任务排期**。<br>重点是将“多表联合查询”、“智能推荐”等高难度功能拆解为可执行的子任务,并合理分配给开发人员。 |
| 3 | **【质量】主导代码规范整改与Bug修复** | 全体开发成员 | 1. **带头修复**优先修复自己负责的AI引擎模块中不符合规范的代码。<br>2. **监督执行**:检查团队成员的修复进度,确保所有代码在周五前达到《编码规范》要求。 |
| 4 | **【核心技术】Beta预研多表联合查询方案设计** | 个人/李琪雯 | **启动Beta核心技术攻坚**。<br>1. **Prompt设计**研究如何通过Prompt引导大模型理解表间关联<br>2. **技术验证**:编写简单的测试脚本,验证大模型在多表场景下的表现,然后正式开发。 |
| 5 | **【管理】准备并主导小班讨论课Alpha演示** | 全体成员 | 1. **优化脚本**:根据上周老师的反馈,微调演示脚本,突出系统亮点。<br>2. **稳定演示**:在讨论课上负责主讲,引导团队成员回答同学和老师的提问。 |
| 6 | **【管理】团队管理与文档提交** | 个人 | 督促并检查所有成员第十二周周总结和第十三周周计划的提交情况,并按时汇总提交团队周报。 |
## 小结
1. **工作重心:** 本周是一方面要通过代码整改把Alpha版本的质量夯实另一方面要通过文档更新和技术预研为Beta版本的开发指明方向。
2. **个人挑战:** 需要在繁重的文档修改和代码整改工作中,挤出时间进行**多表查询的技术预研**。
3. **期望成果:** 提交一份完美的《需求规格说明书》最终稿;代码库焕然一新,符合规范;在小班讨论课上呈现一场精彩的演示;完成多表查询的初步技术验证。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,40 @@
# 个人周总结-第13周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 计划内容 | 是否完成 | 情况说明 |
| :--- | :--------------------------------------------- | :------- | :----------------------------------------------------------- |
| 1 | **【PM职责】主导《需求规格说明书》最终定稿** | 完成 | 1. **组织各模块负责人完成了最终复核**确保文档内容与Alpha版本最终实现完全一致。<br>2. **主导完成了文档的终稿排版与校对**并已按时提交至头歌平台为Alpha版本画上了圆满的句号。 |
| 2 | **【PM职责】更新《迭代开发计划》至第三稿** | 完成 | 1. **成功主导了Beta版本规划**基于老师的反馈将“多表联合查询”和“通知管理”等功能明确为Beta阶段的核心任务。<br>2. **完成了任务拆解与排期**,并发布了《迭代开发计划》第三稿,为团队下一阶段的开发提供了清晰的路线图。 |
| 3 | **【质量】主导代码规范整改与Bug修复** | 进行中 | **持续监督**团队成员的代码整改进度,大部分模块已完成修复,整体代码质量显著提升。 |
| 4 | **【核心技术】Beta预研多表联合查询方案设计** | 进行中 | **完成了多表查询的Prompt初步设计**重点研究了如何将多表的Schema和关联关系有效传递给LLM正在技术验证。 |
| 5 | **【管理】小班讨论课Alpha版本演示** | 完成 | **成功在小班讨论课上完成了Alpha版本演示**,清晰地展示了项目成果,并获得了老师和同学们的积极反馈。 |
| 6 | **【管理】团队管理与文档提交** | 完成 | 督促并检查了所有成员第十二周周总结和第十三周周计划的提交情况,并按时汇总提交了团队周报。 |
## 对团队工作的建议
1. **加速代码整改收尾**请尚未完成代码规范整改的同学在下周初尽快完成以便我们能将全部精力投入到Beta版本的新功能开发中。
2. **拥抱Beta挑战**Beta版本将涉及更复杂的多表查询逻辑技术挑战更大。希望大家提前预习相关技术在开发中保持积极沟通共同攻克难关。
## 小结
1. **承前启后,平稳过渡**本周我的工作完美地扮演了“承前启后”的角色。通过主导文档定稿和课堂演示我们为Alpha阶段画上了圆满句号通过更新迭代计划和启动技术预研我们为Beta阶段的开启吹响了号角。
2. **质量与效率并重**:我深刻认识到,代码质量是项目长期健康发展的生命线。本周推动的代码规范化虽然短期内增加了工作量,但为后续的快速、稳定迭代扫清了障碍。
3. **从0到1从1到N**如果说Alpha阶段是从0到1的突破那么Beta阶段就是从1到N的进化。我对多表查询的成功预研让我对攻克Beta阶段的核心技术挑战充满了信心。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,35 @@
# 个人周计划-第13周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **【文档】更新《迭代开发计划》与审阅《需求规格说明书》** | 全体成员 | <br>基于自身负责的功能模块为《迭代开发计划》第三稿的Beta功能拆解与排期提供技术评估建议。参与《需求规格说明书》最终稿的审阅确认所负责模块的需求描述与实际实现一致。 |
| 2 | **【质量】修改项目代码** | 全体成员 | **个人代码质量提升**。<br>依据上周代码交叉审查记录,针对分配给自己的修改建议,在本周内完成所负责模块的全部代码修改,包括命名规范、注释完善、异常处理优化等。 |
| 3 | **【测试】完成头歌平台代码检查任务** | 被分配成员 | **履行跨组评审职责**。<br>根据PM的统一分配对指定小组的项目代码进行检查并按时在头歌平台提交检查结果文档。 |
| 4 | **【开发】启动Beta版本分配功能的前端开发** | 全体成员| **推进Beta版本开发**。开始进行Beta版本分配的新功能。 |
## 小结
1. **工作重心**:本周工作重心在于 **高质量完成文档协作与代码质量提升**。首要任务是配合完成关键文档定稿,并彻底修正个人代码以符合规范。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,38 @@
# 个人周总结-第13周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| ---- | -------- | -------- | -------- |
| 1 | **【文档】更新《迭代开发计划》与审阅《需求规格说明书》** | 完成 | 修改完善了《迭代开发计划》第三稿。同时,参与了对《需求规格说明书》最终稿中对应模块需求描述的审阅与确认。 |
| 2 | **【质量】修改项目代码** | 进行中 | 已根据上周代码交叉审查记录,完成了个人负责模块中部分代码修改,重点针对变量与方法命名规范、关键方法注释补充进行了修正。剩余涉及部分复杂业务逻辑的异常处理优化正在进行中。 |
| 3| **【开发】启动Beta版本分配功能的前端开发** | 进行中 | 已根据《迭代开发计划》启动Beta版本新功能开发与队友初步讨论了实现方案。 |
| 4 | **【管理】小班讨论课Alpha版本评审与演示** | 完成 | 在周五的小班讨论课上配合团队向指导老师完整演示了Alpha版本的各项功能汇报了开发进展与质量提升措施。 |
## 对团队工作的建议
1. **重构同步沟通**:在进行复杂模块的代码深度重构时,建议相关开发者在项目群内简要同步重构范围与可能的影响,避免其他成员在不知情的情况下产生代码冲突或依赖问题。
2. **技术方案预研共享**对于Beta版本中涉及的新技术建议技术负责人在确定基础方案后能组织一次简短的内部技术分享或提供一份基础使用指南帮助团队成员快速上手。
## 小结
1. **质量意识提升**:本周通过修改自身代码和审查他人代码的双重实践,对代码规范性、可读性和健壮性有了更深的理解。
2. **开发节奏转换**工作重心已从Alpha版本的收尾与演示平稳过渡到Beta版本的规划与启动。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,43 @@
# 个人周计划-第13周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **后端代码规范整改** | 全体开发成员 | **对照指导老师修改建议,完成后端代码全面优化** 1. 服务模块整合与架构重构 2. 全局异常处理机制落地 3. 冗长代码拆分与逻辑精简 4. 硬编码常量统一管理与配置优化 5. 安全漏洞修复(含 DTO 模式深化应用) |
| 2 | **前后端协同代码质量提升** | 后端组、前端组 | **配合前端组完成接口层面优化:** 1. 按业务域规整后端 API 接口路由 2. 完善接口参数校验与返回格式标准化 3. 协同调试接口兼容性问题 4. 补充接口异常码说明与文档同步 |
| 3 | **头歌平台后端代码检查任务** | 指定小组 | 按分配任务,重点检查其他小组后端代码的:编码规范符合性、异常处理完整性、权限控制安全性,提交详细检查报告 |
| 4 | **Beta 版本后端核心功能开发启动** | 全体成员、后端组 | 按《迭代开发计划》,启动 Beta 版本后端功能编码:聚焦用户体验优化类功能(如查询结果导出、操作记录回溯),完善系统功能闭环 |
| 5 | **Alpha 版本评审后端演示准备** | 全体成员、后端组 | **筹备周五小班讨论课演示:** 1. 验证后端核心接口稳定性 2. 准备权限分配、数据查询等核心功能的演示脚本 3. 排查演示环境潜在问题,确保评审顺利 |
| 6 | **《需求规格说明书》后端模块完善** | PM、各模块负责人 | 参与最终稿审阅,补充后端相关功能的需求描述、接口定义、权限约束说明,确保文档与实现一致 |
| 7 | **《迭代开发计划》第三稿后端技术研讨** | 全体成员 | 参与 Beta 版本功能拆解与排期讨论,针对新增功能提出后端技术实现方案、工作量评估及风险预判 |
| 8 | **Alpha 版本后端功能补全** | 后端组 | 1. 完善仪表盘数据查询与统计接口 2. 补全收藏夹数据持久化与分享权限控制逻辑 |
## 小结
1. **代码质量攻坚核心周:** 本周核心聚焦后端代码规范整改与质量提升,全面响应老师修改建议,筑牢系统稳定性基础;
2. **质量管控能力强化:** 通过参与头歌平台代码检查与自我代码整改,深化对企业级后端编码规范的理解,提升质量把控意识;
3. **版本迭代关键衔接:** 同步推进 Alpha 版本功能补全与评审准备、Beta 版本开发启动,确保项目迭代无缝衔接;
4. **技术能力深度沉淀:** 通过后端架构重构、全局异常处理落地等工作,熟练掌握 SpringBoot 项目优化的核心方法;
5. **跨组协作效能提升:** 与前端组协同优化接口、参与文档共同完善,强化前后端对接效率与团队协作默契;
6. **项目文档体系完善:** 参与核心文档定稿,确保后端模块需求描述、接口定义的准确性,为后续维护提供支撑。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
1. 请将个人计划和总结提前发给负责人;
1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,46 @@
# 个人周总结-第13周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **后端代码规范整改** | 基本完成 | 已对照指导老师修改建议完成服务模块整合与架构重构、全局异常处理机制落地、冗长代码拆分等核心优化工作硬编码常量统一管理与安全漏洞修复含DTO模式深化应用已基本落地剩余少量细节优化需后续收尾。|
| 2 | **前后端协同代码质量提升** | 基本完成 | 已配合前端组完成按业务域规整API接口路由、完善接口参数校验与返回格式标准化工作协同调试解决了大部分接口兼容性问题接口异常码说明文档已同步剩余3-5个边缘场景接口需后续联调确认。|
| 3 | **头歌平台后端代码检查任务** | 进行中 | 已完成分配的小组后端代码检查重点核查了编码规范符合性与异常处理完整性权限控制安全性检查已完成60%,正在整理检查过程中发现的问题,后续将形成详细检查报告提交。|
| 4 | **Beta 版本后端核心功能开发启动** | 进行中 | 已按《迭代开发计划》启动Beta版本后端功能编码完成查询结果导出功能的核心接口设计与开发正在进行数据持久化与查询逻辑开发完善。|
| 6 | **《需求规格说明书》后端模块完善** | 完成 | 已参与最终稿审阅,补充了大部分后端相关功能的需求描述、接口定义与权限约束说明;部分已实现接口的文档描述已同步更新,剩余少量未完成接口(如仪表盘统计相关接口)的文档补充需待接口开发完成后同步。 |
| 7 | **《迭代开发计划》第三稿后端技术研讨** | 完成 | 全程参与Beta版本功能拆解与排期讨论针对查询结果导出、操作记录回溯等新增功能提出了基于SpringBoot的后端技术实现方案完成相关功能的工作量评估与风险预判研讨成果已纳入《迭代开发计划》第三稿顺利提交。|
| 8 | **Alpha 版本后端功能补全** | 进行中 | 已完成数据查询核心逻辑开发,正在进行数据准确性测试;收藏夹数据持久化功能正在开发,分享权限控制逻辑已完成基础框架搭建,剩余细粒度权限校验规则仍在开发测试过程中。 |
## 对团队工作的建议
1. **建立代码整改收尾验收机制:** 建议针对本周未完成的代码规范整改细节、接口优化等工作,制定明确的验收标准与时间节点,由模块负责人牵头验收,确保整改工作闭环,避免遗留问题影响后续版本开发。
2. **优化前后端协同对接流程:** 建议搭建前后端协同对接专属文档库实时同步接口变更、联调问题等信息每周固定1-2个时间段开展集中联调提升接口问题解决效率减少跨组沟通成本。
3. **推进文档同步与版本管控:** 建议针对《需求规格说明书》等核心文档,建立“开发-更新-审阅”闭环流程,明确各模块文档补充的责任人与截止时间;采用版本控制工具管理文档迭代,确保文档与代码实现实时一致。
4. **强化未完成任务进度管控:** 建议对本周进行中的任务(如代码检查、功能补全)进行拆分,明确每日推进目标;每日晚开展简短进度同步会,及时暴露并解决进度滞后问题,保障整体项目节奏。
## 小结
1. **代码质量攻坚取得阶段性成果:** 本周聚焦后端代码规范整改与质量提升,核心优化工作基本完成,系统架构合理性与代码可维护性显著提升,为后续版本开发筑牢基础。
2. **版本迭代衔接有序推进:** 顺利完成Alpha版本评审演示准备工作保障评审顺利同步启动Beta版本核心功能开发与《迭代开发计划》研讨实现Alpha到Beta版本的无缝衔接。
3. **跨组协作效能持续提升:** 与前端组、PM及各模块负责人的协同配合更加顺畅在接口优化、文档完善等工作中高效推进团队协作默契度进一步增强。
4. **技术能力与质量管控意识深化:** 通过架构重构、全局异常处理落地等工作熟练掌握SpringBoot项目优化核心方法参与代码检查工作对企业级编码规范与安全防护的理解更加深入。
5. **存在的不足与改进方向:** 部分任务(如功能补全、代码检查)进度略滞后,后续需加强任务拆分与时间管理;文档补充工作需紧跟开发进度,避免出现文档与代码不同步问题。
6. **所需帮助:** 希望能开展关于“Beta版本新增功能如查询结果导出、操作记录回溯的技术实现难点”专题讲座或由指导老师针对相关功能的技术方案进行专项答疑助力高效推进开发工作。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,39 @@
# 个人周计划-第13周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **代码规范全面修改老师反馈16-31** | 全体成员 | 根据指导老师提出的16条修改建议全面修改SpringBoot和React代码<br>1. SpringBoot服务合并与重构<br>2. 全局异常处理机制实现<br>3. 函数拆分与代码重构<br>4. 常量提取与配置优化<br>5. 安全漏洞修复与DTO模式引入 |
| 2 | **前端代码质量提升** | 前端组 & 后端组 | 配合前端组完成代码优化:<br>1. API接口按业务域重新组织<br>2. TypeScript类型定义完善<br>3. 重复组件逻辑抽离与合并<br>4. 错误边界与用户体验优化 |
| 3 | **头歌平台代码检查任务** | 指定小组 | 按照分配的任务,对其他小组的代码进行检查,提交详细的检查报告 |
| 4 | **Beta版本核心功能开发启动** | 全体成员 | 开始Beta版本新功能的开发工作重点提升用户体验和系统完善度 |
| 5 | **Alpha版本评审准备** | 全体成员 | 准备周五小班讨论课的Alpha版本演示材料接受指导老师的正式评审 |
| 6 | **需求规格说明书定稿完善** | PM、各模块负责人 | 参与需求规格说明书最终稿的审阅和确认工作 |
| 7 | **迭代开发计划第三稿讨论** | 全体成员 | 参与Beta版本功能拆解与排期的讨论提供技术可行性建议 |
| 8 | **Alpha版本功能完善** |后端组 | 1. 完善查看仪表盘功能<br>2. 完成收藏夹和分享基础功能 |
## 小结
1. **代码质量攻坚周:** 本周核心任务是全面响应指导老师的修改建议,大幅提升代码质量和规范性;
2. **质量意识强化:** 通过参与头歌平台代码检查任务,培养严谨的代码审查能力和质量意识;
3. **版本过渡关键期:** 在完成Alpha版本优化的同时启动Beta版本开发确保项目顺利过渡
4. **技术深度拓展:** 通过SpringBoot架构重构和React代码优化深入掌握企业级开发规范
5. **团队协作深化:** 在与前端组配合优化代码过程中,提升全栈协作能力;
6. **项目文档完善:** 参与关键文档的定稿工作,确保项目文档体系的完整性和准确性。
---
## 【注】
1. 希望获得SpringBoot全局异常处理最佳实践和React代码组织架构的经验分享
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台。

@ -0,0 +1,44 @@
# 个人周总结-第13周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-15
**结束时间:** 2025-12-21
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **代码规范全面修改** | 基本完成 | 1. **SpringBoot服务合并**完成UserService和UserSearchService的合并重构减少了服务粒度<br>2. **全局异常处理**:实现了基于@ControllerAdvice的全局异常处理机制统一了错误响应格式<br>3. **代码重构**拆分了5个过长函数提升了代码可维护性<br>4. **安全优化**引入DTO模式修复了UserController的安全漏洞 |
| 2 | **前端代码质量提升配合** | 完成 | 配合前端组完成了API接口的按业务域重新组织提供了后端接口规范文档协助完善了TypeScript类型定义 |
| 3 | **Beta版本核心功能开发启动** | 进行中 | 开始Beta版本的新功能需求分析和技术方案设计确定了技术实现路线 |
| 4 | **Alpha版本评审准备与演示** | 完成 | 完成了Alpha版本的演示材料准备在小班讨论课上成功进行了演示 |
| 5 | **需求规格说明书定稿完善** | 完成 | 参与了需求规格说明书最终稿的审阅工作,提供了技术实现细节的补充建议 |
| 6 | **迭代开发计划第三稿讨论** | 完成 | 参与了Beta版本功能拆解与排期的讨论会议提供了技术可行性分析和实现建议 |
| 7 | **Alpha版本功能完善** | 部分完成 | 1. **查看仪表盘功能**:完成了基础数据统计展示功能<br>2. **收藏夹功能**:完成了基础收藏功能,分享功能仍在开发中 |
## 对团队工作的建议
1. **代码审查机制完善:** 建议建立常态化的代码审查机制,确保代码质量持续提升;
2. **技术债务追踪:** 建议建立技术债务看板,系统化跟踪和解决代码质量问题;
3. **知识沉淀分享:** 建议将本周的代码优化经验整理成技术文档,供团队成员学习和参考;
4. **自动化测试推进:** 建议在重构后加强自动化测试覆盖,确保重构不影响现有功能。
## 小结
1. **代码质量显著提升:** 本周集中解决了代码质量问题,系统代码质量得到了质的飞跃,特别是架构设计和代码规范性方面;
2. **技术能力深度拓展:** 通过SpringBoot全局异常处理、服务合并重构、安全加固等实践深入掌握了企业级开发的关键技术
3. **团队协作高效:** 在与前端组的配合中,沟通顺畅,问题解决迅速,团队协作效率明显提升;
4. **个人成长明显:** 通过本周的集中代码优化工作,不仅提升了技术能力,也培养了严谨的编码习惯和问题解决能力;
5. **后续工作重点:** 下一阶段将重点推进Beta版本核心功能的开发同时继续完善Alpha版本的剩余功能确保项目质量持续提升。
---
## 【注】
1. 希望获得更多关于SpringBoot微服务架构设计和React状态管理的最佳实践经验分享
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台。

@ -0,0 +1,69 @@
# 小组会议纪要-第 14 周
## 会议记录概要
**团队名称:** 4 班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 阿米娜
**会议主题:** 第 14 周任务计划同步、Beta 版本开发进展、内部测试与技能考核安排
**会议地点:** 天马食堂 2 楼
**会议时间:** 2025-12-22 16:30-18:00
**纪录时间:** 2025-12-22 16:30-18:00
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 第 13 周工作总结与本周任务同步
#### 全体成员简要汇报第 13 周工作成果:
- **文档定稿完成:** 《迭代开发计划》第三稿与《需求规格说明书》最终稿已提交至头歌平台。
- **代码质量整改:** 全体成员已完成代码规范自查与修复,并通过外部代码检查。
- **Beta 版本启动:** 已按计划进入 Beta 版本核心功能编码阶段。
#### 本周(第 14 周)重点任务同步:
PM 李瑜清宣讲《第 14 周周计划》,全体成员确认任务并认领。本周核心目标是 **Beta 版本核心功能开发与内部集成测试**
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------ | :--------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| 1 | **【开发】Beta 版本核心功能模块编码** | 全体成员 | 依据《迭代开发计划》,全面推进 **通知管理、自然语言查询优化、仪表盘动态更新、收藏夹与社交功能** 等核心模块的前后端开发与实现。 |
| 2 | **【开发】AI 核心与提示词模块实现** | AI 组 | 完成 **自然语言转 SQL 的核心提示词设计、嵌入与调用**,并实现 **高级提示词优化与功能扩展** 的后端逻辑代码。 |
| 3 | **【测试】内部模块集成与冒烟测试** | 全体成员 | 在功能模块初步完成后,进行**内部代码集成与联调**,并对集成的 Beta 版本核心流程开展**冒烟测试**,确保基本功能畅通。 |
| 4 | **【质量】代码修复与系统优化** | 全体成员 | 根据内部测试结果,**修复 Bug 并优化代码逻辑**。同时推进 **UI 界面与系统性能** 的专项优化工作。 |
| 5 | **【考核】开发人员个人技能考核** | 全体成员 | 组织并完成针对 **后台开发与前端开发技能** 的团队成员个人考核,评估团队技术能力。 |
| 6 | **【文档】项目进度与技术文档更新** | 全体成员 | 同步更新 **《项目进度报告》《技术设计文档》** 等,记录本周开发进展、问题与解决方案。 |
| 7 | **【管理】周例会与进度评审** | PM李瑜清、全体成员 | 召开周例会,**总结本周开发情况,评审 Beta 版本整体进度**,并据此调整和明确下周开发计划。 |
### 2. 问题总结
#### 已解决问题:
1. **代码规范整改闭环完成**:全体成员已按规范完成代码修正,并通过外部检查。
2. **Alpha 阶段遗留功能收尾**:实时消息通知对接、日志导出功能已完成。
#### 待解决问题:
1. **Beta 版本功能模块开发协调**:需确保各模块进度同步,避免集成阻塞。
2. **内部测试与修复闭环**:测试中发现的问题需及时跟踪并修复。
### 3. 小组协作情况总结
1. **开发与测试并行推进**:本周启动内部集成与冒烟测试,确保功能实现与质量同步。
2. **技能考核准备充分**:全体成员积极参与个人技能考核准备,技术能力持续提升。
3. **文档同步及时**:项目进度与技术文档保持同步更新,信息透明。
### 4. 一周纪律情况总结
- **任务执行**:第 13 周任务完成情况良好,文档与代码提交规范。
- **沟通协作**:组内沟通顺畅,未出现重大沟通延迟。
- **会议参与**:全体成员按时参加会议,积极参与讨论。
## 备注
1. **内部测试提醒**:冒烟测试过程中发现的问题需记录至项目问题跟踪表,并安排专人修复。
2. **技能考核安排**:考核将于本周中举行,请全体成员提前准备。
3. **文档提交要求**:各模块负责人需在每日下班前提交当日进展至项目协同平台。

@ -0,0 +1,32 @@
# 小组周计划-第 14 周
## 团队名称和起止时间
**团队名称:** 4 班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :------------------------------------ | :--------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| 1 | **【开发】Beta 版本核心功能模块编码** | 全体成员 | 依据《迭代开发计划》,全面推进 **通知管理、自然语言查询优化、仪表盘动态更新、收藏夹与社交功能** 等核心模块的前后端开发与实现。 |
| 2 | **【开发】AI 核心与提示词模块实现** | AI 组 | 完成 **自然语言转 SQL 的核心提示词设计、嵌入与调用**,并实现 **高级提示词优化与功能扩展** 的后端逻辑代码。 |
| 3 | **【测试】内部模块集成与冒烟测试** | 全体成员 | 在功能模块初步完成后,进行**内部代码集成与联调**,并对集成的 Beta 版本核心流程开展**冒烟测试**,确保基本功能畅通。 |
| 4 | **【质量】代码修复与系统优化** | 全体成员 | 根据内部测试结果,**修复 Bug 并优化代码逻辑**。同时推进 **UI 界面与系统性能** 的专项优化工作。 |
| 5 | **【考核】开发人员个人技能考核** | 全体成员 | 组织并完成针对 **后台开发与前端开发技能** 的团队成员个人考核,评估团队技术能力。 |
| 6 | **【文档】项目进度与技术文档更新** | 全体成员 | 同步更新 **《项目进度报告》《技术设计文档》** 等,记录本周开发进展、问题与解决方案。 |
| 7 | **【管理】周例会与进度评审** | PM李瑜清、全体成员 | 召开周例会,**总结本周开发情况,评审 Beta 版本整体进度**,并据此调整和明确下周开发计划。 |
## 小结
- **工作重心:** 本周工作重心在于 **Beta 版本核心功能模块的集中开发与实现**,同时启动**内部集成与初步测试**,确保系统主干功能成型且可用。
- **开发与质控并行:** 在快速推进编码的同时,通过**内部测试、问题修复与技能考核**,构建开发质量保障体系,为后续稳定迭代打下基础。
- **里程碑:** 完成 Beta 版本主要功能模块的编码与内部集成,通过冒烟测试验证核心流程,项目进入功能整合与优化阶段。
## 【注】
1. 各模块负责人需确保代码按时提交,并积极参与集成联调;
2. 内部测试问题需及时记录并跟踪至修复完成;
3. 请全体成员认真准备个人技能考核;
4. PM 负责汇总本周整体进展,按时提交小组周报。

@ -0,0 +1,27 @@
# 小组周总结-第 14 周
## 团队名称和起止时间
**团队名称:** 4 班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :------------------------------------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **【开发】Beta 版本核心功能模块编码** | 进行中 | **核心功能开发全面推进** 依据《迭代开发计划》,团队已展开通知管理、自然语言查询优化、仪表盘动态更新、收藏夹与社交功能等核心模块的前后端开发工作,各模块基础架构搭建与主要接口实现已完成,部分功能已进入联调阶段。 |
| 2 | **【开发】AI 核心与提示词模块实现** | 进行中 | **AI 核心能力初步构建** AI 组已完成自然语言转 SQL 的核心提示词设计、嵌入与后端调用逻辑实现,并在此基础上进行了高级提示词的扩展与优化,为智能查询功能提供了稳定可靠的技术支持。 |
| 3 | **【测试】内部模块集成与冒烟测试** | 进行中 | **内部集成测试正式启动** 在核心模块初步完成后,团队开展了内部代码集成与联调工作,并对 Beta 版本的主要业务流程进行了冒烟测试。目前核心流程已基本通畅,测试过程中发现的问题已记录并进入修复流程。 |
| 4 | **【质量】代码修复与系统优化** | 进行中 | **持续优化与问题修复** 根据内部测试结果,团队对已发现的功能性 Bug 进行了修复同时对部分模块的代码逻辑进行了优化。UI 界面的统一性调整与系统性能的初步优化工作已同步展开。 |
| 5 | **【考核】开发人员个人技能考核** | 完成 | **团队技能评估顺利完成** 本周成功组织并完成了针对后台开发与前端开发技能的团队成员个人考核。考核结果反映出团队整体技术水平良好,同时也明确了后续技术培训与个人能力提升的重点方向。 |
| 6 | **【文档】项目进度与技术文档更新** | 完成 | **项目文档同步更新** 《项目进度报告》与《技术设计文档》已根据本周开发进展完成更新,详细记录了各模块的实现情况、遇到的问题及解决方案,保障了项目知识的连续积累与团队信息同步。 |
| 7 | **【管理】周例会与进度评审** | 完成 | **阶段评审与计划调整** 通过周例会,团队全面总结了本周 Beta 版本的开发进展与测试情况,评审了整体进度与质量状态。根据评审结果,已对下周的开发重点与任务分配进行了明确与调整。 |
## 小结
1. **Beta 版本开发取得关键进展:** 本周团队集中力量推进了 Beta 版本核心功能模块的开发工作AI 核心模块已率先完成,系统主干功能架构基本成型,为后续功能整合与深度优化奠定了坚实基础。
2. **质量保障体系初步运转:** 通过启动内部集成与冒烟测试,并将测试发现的问题及时纳入修复与优化流程,团队初步构建了“开发-测试-修复”的质控闭环,有效保障了 Beta 版本初期的代码质量与系统稳定性。
3. **技术能力得到检验与明确:** 通过个人技能考核,不仅检验了团队成员当前的技术水平,也清晰地识别了团队在前后端开发方面的优势与待提升领域,为后续针对性技术学习与团队能力建设提供了依据。
4. **团队协作与信息同步高效:** 在并行推进开发、测试、文档等多线任务的过程中,团队通过定期例会与实时沟通,保持了良好的信息同步与任务协调,展现了高效的跨职能协作能力。
5. **面临的挑战与后续重点:** 随着各模块进入集成联调阶段,接口对接的复杂性与测试的全面性要求提高。下周工作重点将转向**深度集成测试、性能调优与用户体验细节打磨**,并需要持续关注和修复测试中暴露的系统性问题。

@ -0,0 +1,31 @@
# 个人周计划-第 14 周
## 基本信息
**团队名称:** 4 班-神奇宝码
**姓  名:** 阿米娜·赛力克
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务安排
| 序号 | 任务类型 | 计划内容 | 执行人 | 说明 |
| ---- | ------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---- |
| 1 | **【开发】Beta 版本核心功能模块编码** | 全体成员 | 依据《迭代开发计划》,全面推进 **通知管理、自然语言查询优化、仪表盘动态更新、收藏夹与社交功能** 等核心模块的前后端开发与实现。 | |
| 2 | **【测试】内部模块集成与冒烟测试** | 全体成员 | 在功能模块初步完成后,进行**内部代码集成与联调**,并对集成的 Beta 版本核心流程开展**冒烟测试**,确保基本功能畅通。 |
| 3 | **【质量】代码修复与系统优化** | 全体成员 | 根据内部测试结果,**修复 Bug 并优化代码逻辑**。同时推进 **UI 界面与系统性能** 的专项优化工作。 |
| 4 | **【考核】开发人员个人技能考核** | 全体成员 | 组织并完成针对 **后台开发与前端开发技能** 的团队成员个人考核,评估团队技术能力。 |
| 5 | **【文档】项目进度与技术文档更新** | 全体成员 | 同步更新 **《项目进度报告》《技术设计文档》** 等,记录本周开发进展、问题与解决方案。 |
| 6 | **【管理】周例会与进度评审** | PM李瑜清、全体成员 | 召开周例会,**总结本周开发情况,评审 Beta 版本整体进度**,并据此调整和明确下周开发计划。 |
## 本周小结
1. **工作重心:** 本周工作重心在于 **Beta 版本核心功能模块的集中开发与实现**,同时启动**内部集成与初步测试**,确保系统主干功能成型且可用。
2. **开发与质控并行:** 在快速推进编码的同时,通过**内部测试、问题修复与技能考核**,构建开发质量保障体系,为后续稳定迭代打下基础。
3. **里程碑:** 完成 Beta 版本主要功能模块的编码与内部集成,通过冒烟测试验证核心流程,项目进入功能整合与优化阶段。
## 注意事项
1. **规范优先**:代码规范化(任务 3是质量保障基础需优先彻底完成
2. **演示准备**:提前充分自测演示流程,确保评审顺利
3. **及时沟通**Beta 开发中遇到需求变更或技术障碍需及时同步

@ -0,0 +1,29 @@
# 个人周总结-第 14 周
## 基本信息
**姓名:** 阿米娜·赛力克
**团队名称:** 4 班-神奇宝码队
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 任务内容 | 状态 | 说明 |
| ---- | ------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| 1 | **【开发】Beta 版本核心功能模块编码** | 进行中 | 根据《迭代开发计划》完成了通知管理、自然语言查询优化模块的前端开发,并与后端顺利对接,确保功能可用。 |
| 2 | **【质量】代码修复与系统优化** | 进行中 | 根据测试结果修复了数个前端 Bug优化了组件渲染性能与 UI 响应速度,并推进了部分 UI 界面的一致性调整。 |
| 3 | **【管理】周例会与进度评审** | 完成 | 准时参加周例会,汇报本周前端工作进展与问题,听取团队整体进度,并根据评审结果明确下周重点任务。 |
## 对团队工作的建议
1. **集成测试流程规范化**:建议在后续集成阶段建立更明确的冒烟测试用例清单与执行流程,确保每次集成后快速验证核心路径,提升集成效率。
2. **UI/UX 统一性检查机制**:在 Beta 阶段界面优化过程中,建议建立定期 UI 走查机制,由专人负责界面风格与交互一致性,提升产品整体体验。
## 本周小结
**核心功能开发稳步推进**:作为 Beta 阶段的第一周,重点完成了通知管理与自然语言查询优化等核心功能的前端实现与联调,确保了主干功能模块按时交付。
**团队协作与信息同步高效**:在集成测试、文档更新与周例会中保持了良好的沟通与协作,确保信息透明、任务对齐,为后续迭代打下良好协作基础。
**个人在多任务中持续成长**:本周同时推进开发、测试、文档与考核多项任务,进一步锻炼了并行处理能力、问题定位与解决能力,提升了全流程参与的项目视野。

@ -0,0 +1,33 @@
# 个人周计划-第14周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】Beta版核心模块-社交与通知功能前端实现** | 前端、后端 | **本周核心开发任务**。依据迭代计划,完成以下功能的前端开发:<br>1. **好友动态分享功能**:实现查询结果的一键分享至好友动态,包含分享卡片组件、权限确认弹窗及分享状态反馈。<br>2. **通知中心前端页面**:完成系统通知、好友申请、动态消息等聚合页面的开发,实现**实时推送**的UI展示与交互逻辑WebSocket连接与状态管理。 |
| 2 | **【开发】Vue技术栈迁移收尾与优化** | 前后端 | **完成上周遗留任务**。集中完成**权限管理模块**从React到Vue 3Composition API的完整迁移与重构确保代码风格统一并补充完整的类型定义和组件文档。 |
| 3 | **【开发】仪表盘与收藏夹UI优化** | 前端 | **用户体验专项提升**。对现有数据仪表盘进行**动态化**和**可定制化**改造,优化数据可视化组件的性能。同时,实现**收藏夹功能**的前端页面与交互,支持对查询、图表的收藏与管理。 |
| 4 | **【测试】参与内部集成与前端冒烟测试** | 全体成员 | **配合团队测试任务**。在个人负责模块开发完成后立即与后端进行接口联调。参与Beta版本的**整体冒烟测试**,重点验证**社交分享链路**和**通知推送流程**等核心前端功能是否畅通。 |
| 5 | **【质量】根据测试结果修复前端Bug并优化性能** | 全体成员 | **配合团队质量任务**。根据内部测试反馈修复发现的前端Bug如界面渲染错误、交互逻辑缺陷。同时启动**前端性能专项优化**,针对首屏加载、组件渲染效率进行分析与改进。 |
| 6 | **【考核】准备并参与前端开发技能考核** | 个人 | **配合团队考核任务**。认真复习Vue 3核心特性、TypeScript高级用法、前端工程化及性能优化相关知识确保在团队组织的个人技能考核中展现专业能力。 |
| 7 | **【文档】更新前端技术设计文档与个人进度报告** | 个人 | **配合团队文档任务**。在开发过程中,同步维护和更新负责模块的**前端组件设计说明**、**接口调用文档**。并在周末前完成个人本周工作进度总结。 |
| 8 | **【管理】参与周例会并明确任务进度** | 个人 | 积极参与周例会,清晰汇报前端模块(社交、通知、仪表盘)的开发进展、遇到的阻塞问题及下周计划,确保信息与团队同步。 |
## 小结
1. **开发重心明确**:本周个人工作核心是**Beta版本社交、通知两大核心功能的前端实现**,以及**完成Vue迁移的最后收尾**。需平衡新功能开发与遗留任务闭环。
2. **质量与交付并重**:在快速开发的同时,需通过**积极参与冒烟测试**和**主动进行性能优化**,保障前端代码的可靠性与用户体验。
3. **考核准备**将个人开发任务与技能考核复习相结合在实践中深化对Vue 3、状态管理等前端核心知识的理解与应用。
## 注意事项
1. **优先级管理**:周一优先完成**权限管理模块的Vue迁移收尾**任务2为本周核心开发扫清障碍。随后全力投入社交与通知功能开发任务1
2. **主动联调**:在开发通知实时推送功能时,需**提前与后端确认WebSocket接口规范**,并制定联调计划,避免后期阻塞。
3. **记录与反馈**:开发过程中遇到的技术选型难题或与预期不符的需求细节,需及时记录并在周例会中提出,寻求团队协同解决。

@ -0,0 +1,29 @@
# 个人周总结-第14周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】Beta版核心模块-社交与通知功能前端实现** | 进行中 | **按计划持续推进核心开发**。已完成好友动态分享功能的静态页面与基础交互组件开发通知中心页面布局与消息列表组件已搭建完成。WebSocket连接已初步建立实时推送的UI展示逻辑正在联调中。 |
| 2 | **【开发】Vue技术栈迁移收尾与优化** | 进行中 | **重点推进权限模块重构**。权限管理模块已基本完成从React到Vue 3的迁移主要组件已重构并运行正常正在进行代码风格统一与类型定义补充。 |
| 3 | **【开发】仪表盘与收藏夹UI优化** | 进行中 | **启动用户体验专项开发**。数据仪表盘动态化改造方案已确定,初步完成可定制布局的组件结构设计。收藏夹功能的页面静态部分与基础交互逻辑已实现。 |
| 4 | **【测试】参与前端测试** | 完成 | **积极配合团队测试工作**。对已开发的前端功能进行了基本流程验证。 |
| 5 | **【质量】根据测试结果修复前端Bug并优化性能** | 进行中 | **启动初步质量改进**。根据冒烟测试反馈,修复了部分界面渲染样式问题。前端性能分析工具已接入,正在进行首屏加载时长的初步监测与定位。 |
| 6 | **【考核】准备并参与前端开发技能考核** | 完成 | **顺利完成个人技能考核**。已参与团队组织的前端技能考核考核内容涵盖Vue 3核心特性、TypeScript应用及工程化实践。考核过程顺利个人表现符合预期。 |
| 7 | **【文档】更新前端技术设计文档与个人进度报告** | 完成 | **同步维护开发文档**。在开发过程中,及时更新了已迁移组件的设计说明和接口文档。并按照要求撰写了本周个人工作进度总结。 |
| 8 | **【管理】参与周例会并明确任务进度** | 完成 | **保持团队信息同步**。按时参与团队周例会,清晰汇报了本周前端模块的开发进展、当前遇到的联调问题以及下周的重点工作计划。 |
## 小结
1. **开发任务稳步推进**:本周核心聚焦于**Beta版本社交与通知功能的前端开发**,以及**权限模块的Vue迁移收尾工作**。各项开发任务均按计划启动并取得阶段性进展。
2. **质量与协同意识增强**:在推进开发的同时,积极**参与集成测试与Bug修复**,并启动**前端性能优化的初步工作**,体现了对交付质量的责任心。通过周例会及时同步进展与问题,保障了团队协作的顺畅。
3. **个人与团队任务兼顾**:在完成开发主线任务的同时,也顺利完成了**技能考核、文档更新等团队协作与个人提升任务**,做到了多项工作并行推进。
---

@ -0,0 +1,34 @@
# 个人周计划-第14周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
| :--- | :----------------------------------------------- | :----------- | :----------------------------------------------------------- |
| 1 | **【核心技术】Beta攻坚多表联合查询功能实现** | 个人、AI组 | **本周个人核心技术攻坚任务**。<br>1. **实现多表Prompt**将上周的预研成果代码化设计并实现能动态嵌入多表Schema及外键关系的Prompt模板。<br>2. **开发后端解析逻辑**编写后端代码用于解析大模型针对多表查询返回的更复杂的JSON结果。<br>3. **单元测试**:编写针对二表、三表`JOIN`的测试用例,确保功能基本可用。 |
| 2 | **【核心技术】Beta攻坚智能查询推荐功能开发** | 个人、AI组 | **完成后端API**开发用于“获取查询推荐”的后端API并与前端初步对接。 |
| 3 | **【PM职责】主导Beta版本首次内部集成与冒烟测试** | 全体开发成员 | **确保Beta版本主干功能成型**。<br>1. **组织集成联调**协调前后端、AI组将各模块代码进行集成重点打通通知、优化后的查询等新功能的链路。<br>2. **主导测试**:制定核心流程的测试用例,带领团队完成测试,确保系统无崩溃、主流程可走通。 |
| 5 | **【PM职责】主持周例会评审Beta版本进度** | 全体成员 | 召开周例会全面复盘本周Beta版本的开发进展、遇到的技术难题和联调问题。基于评审结果动态调整并明确下一周的开发冲刺计划。 |
| 6 | **【管理】团队管理与文档更新** | 个人 | 督促并检查所有成员第十三周周总结和第十四周周计划的提交情况,并跟进《项目进度报告》和《技术设计文档》的更新。 |
## 小结
1. **工作重心:** 本周我的工作重心是**开发Beta版本**。我将全力投入到“多表联合查询”和“智能推荐”这两个最具挑战性、也最能体现我们项目亮点的功能开发中。
2. **个人挑战:** **多表查询的代码设计**是本周最大的技术挑战。如何让大模型在没有图形界面的情况下仅通过文本描述就能准确理解多个表之间的复杂关系是对我Prompt工程能力的终极考验。
4. **期望成果:** 到本周末,我个人期望能交付一个**可运行的多表查询功能原型**并完成智能推荐的后端API。同时团队能产出一个通过冒烟测试、主干功能基本可用的Beta集成版本。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,42 @@
# 个人周总结-第14周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :----------------------------------------------- | :------- | :----------------------------------------------------------- |
| 1 | **【核心技术】Beta攻坚多表联合查询功能实现** | 进行中 | 1. **Prompt模板初步成型**已完成支持多表Schema及外键关联描述的Prompt模板设计<br>2. **后端解析逻辑开发中**:正在编写处理复杂`JOIN`语句返回结果的解析代码。 |
| 2 | **【核心技术】Beta攻坚智能查询推荐功能开发** | 进行中 | 1. **推荐逻辑设计完毕**:确定了基于“查询结果+Schema关联”的推荐策略并完成了推荐Prompt的初稿。<br>2. **API对接中**:后端接口框架已搭建,正在与前端组沟通推荐结果的展示格式,确保交互的流畅性。 |
| 3 | **【PM职责】主导Beta版本首次内部集成与冒烟测试** | 进行中 | **组织了首轮集成联调**协调前后端及AI组进行了代码合并重点测试了通知功能和优化后的查询链路。 |
| 4 | **【PM职责】组织开发人员个人技能考核** | 进行中 | 1. **考核方案已发布**制定并向团队发布了针对Spring Boot和Vue开发技能的考核标准。<br>2. **初步评估完成**已完成对后端组部分成员的技能沟通与评估前端组的考核计划在下周初完成旨在为Beta版本的最终冲刺优化人力分配。 |
| 5 | **【PM职责】主持周例会评审Beta版本进度** | 进行中 | **召开了进度会并调整计划**全面梳理了Beta版本各模块的开发现状根据本周进展微调了下周的冲刺目标确保核心功能在结项前能达到稳定状态。 |
| 6 | **【管理】团队管理与文档更新** | 完成 | **督促周报提交**:已完成对成员周总结和计划的初步审核与提交。 |
## 对团队工作的建议
1. **攻坚克难,保持沟通**Beta版本有很多技术难点遇到阻塞性问题请务必在群里即时同步不要积压。
2. **注重联调细节**:在集成过程中,发现前后端对部分字段的理解仍有偏差,请大家在编写代码前再次沟通确认
3. **提前准备交付文档**:下周将进入文档交付高峰期,建议各模块负责人在完成编码的同时,开始梳理自己模块的操作说明和测试记录。
## 小结
1. **从单点突破到系统整合的挑战**本周我的工作重心从单纯的代码编写转向了复杂的系统集成。我深刻体会到多模块联调的复杂度远超单模块开发作为PM我需要更细致地协调各组之间的契约。
2. **技术攻坚的韧性**多表查询的Prompt设计比预想的要复杂LLM在处理深层关联时偶尔会出现幻觉。我正在通过增加Few-shot示例和优化Schema描述来解决这一问题目前已取得阶段性进展。
3. **管理与进度的平衡**:虽然本周多项任务处于“进行中”,但整体进度仍受控。通过技能考核和进度评审,我对团队的战斗力有了更清晰的认识,这为下周的最终冲刺提供了决策依据。
4. **下周展望**下周是Beta版本的决胜周。我将全力推动所有“进行中”的任务转为“已完成”并主导完成用户手册和测试报告的编写确保项目完美收官。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,34 @@
# 个人周计划-第14周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **【开发】参与Beta 版本核心功能模块编码** | 全体成员 | 依据《迭代开发计划》,全面推进 **通知管理、自然语言查询优化、仪表盘动态更新、收藏夹与社交功能** 等核心模块的开发与实现。 |
| 2 | **【开发】AI 核心与提示词模块实现** | 李瑜清 | 完成 自然语言转 SQL 的核心提示词设计、嵌入与调用,并实现高级提示词优化与功能扩展的后端逻辑代码。 |
| 3 | **【测试】参与内部集成与冒烟测试** | 全体成员 | <br>在完成所负责功能模块开发后积极参与团队内部集成联调并对Beta版本核心流程如登录、查询、社交互动进行冒烟测试记录并提交发现的问题。 |
| 4 | **【质量】代码修复与界面专项优化** | 全体成员 | <br>根据内部测试反馈修复个人负责模块的Bug与代码逻辑缺陷。 |
## 小结
1. **开发冲刺**本周是Beta版本功能开发的核心周工作重心将集中在**AI 核心与提示词模块实现**上,需确保核心交互流程的代码完成度与可用性。
2. **质控并行**:在快速开发的同时,需通过**内部测试、Bug修复和技能考核**主动保障产出质量,做到开发与质量控制同步推进,为系统集成打下良好基础。
---
## 【注】
1. 希望团队能在周初明确“个人技能考核”的具体形式、范围与评价标准,以便提前进行针对性准备。
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,35 @@
# 个人周总结-第14周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-21
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 总结内容| 是否完成 | 情况说明 |
| ----| ------ | ------| ------- |
| 1 | **【开发】参与Beta 版本核心功能模块编码** | 已完成 | 依据《迭代开发计划》,完成了个人负责的后端模块的核心编码工作。 |
| 2 | **【开发】AI 核心与提示词模块实现** | 部分完成 | 在李瑜清的协作下,完成了**自然语言转SQL核心提示词**的设计与基础版本嵌入,后端调用逻辑已初步实现。高级提示词优化与功能扩展的逻辑部分仍在调试中,正在进行准确性测试。 |
| 3 | **【测试】参与内部集成与冒烟测试** | 进行中 | 在完成开发任务后,积极参与了团队的内部集成联调。 |
| 4 | **【质量】代码修复与界面专项优化** | 进行中 | 根据内部测试反馈,已修复了个人负责模块中发现的接口返回格式问题。 |
## 对团队工作的建议
1. **技术难点归档**对于本周开发中遇到的如“多表联合查询的NL2SQL提示词优化”等技术难点及初步解决方案建议技术负责人稍作整理并归档到团队知识库方便后续回顾与知识传承。
## 小结
1. **质量与协作**通过参与集成测试和及时修复Bug确保了个人产出模块的基本可用性。与PM在AI模块上的协作顺畅推进了技术难点的攻克。
2. **后续重点**下周将集中完成AI提示词模块的优化收尾、所有模块的Bug修复并全力投入到系统全量测试与文档编写中迎接最终的版本交付。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,43 @@
# 个人周计划-第14周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **α版本未完成后端功能收尾** | 后端组、前端组 | 1. 完成仪表盘数据查询与统计接口的测试优化确保数据准确性与响应效率2. 补全收藏夹数据持久化剩余逻辑完善分享权限细粒度校验规则3. 协同前端完成接口联调,确保功能正常对接。 |
| 2 | **β版本查询结果操作后端开发** | 后端组、前端组 | 1. 开发查询结果收藏、导出、分享的核心后端接口2. 实现分享权限控制逻辑仅好友可接收分享、分享有效期设置3. 设计并落地分享记录与收藏记录的数据表结构确保数据持久化可靠4. 配合前端完成接口联调与数据格式适配。 |
| 3 | **β版本好友管理后端功能开发** | 后端组、前端组 | 1. 实现简易聊天功能的后端支撑包括聊天消息收发、存储接口确保消息实时性与完整性2. 开发好友间查询结果分享的接收与展示后端接口关联分享记录与好友关系4. 协同前端完成接口联调,保障功能顺畅运行。 |
| 4 | **β版本查询功能优化后端适配** | 全体成员、后端组 | 1. 适配多轮对话与多表联合查询的后端接口扩展支持上下文会话状态维持2. 配合完成大模型推荐功能的后端对接提供查询结果数据给AI引擎用于分析推荐3. 优化NL2SQL转换后的SQL执行效率增强异常处理如多表关联错误提示。 |
| 5 | **β版本后端代码规范与性能优化** | 全体成员 | 1. 对照编码规范完成本周开发代码的格式规整、逻辑精简2. 对新增接口进行性能测试优化数据库查询语句减少冗余查询3. 完善全局异常处理机制,补充β版本新增功能的异常码与错误提示。 |
| 6 | **AI核心与提示词模块后端对接** | AI组、后端组成员 | 配合小组AI模块落地任务完成后端适配1. 开发并调试自然语言转SQL核心提示词的调用接口确保后端与AI引擎的数据交互顺畅2. 协助实现高级提示词优化的后端支撑逻辑包括查询失败原因反馈、查询成功智能推荐的数据传递接口保障AI功能与业务流程衔接。 |
| 7 | **内部模块集成与冒烟测试** | 全体成员 | 落实小组集成测试要求1. 完成个人负责后端模块与前端的对接联调排查并解决接口通信、数据格式不匹配等问题2. 参与整体系统集成工作配合排查跨模块交互漏洞3. 执行核心流程冒烟测试,重点验证查询、收藏、好友交互、通知等功能的基本可用性,详细记录测试问题并同步至团队问题清单。|
| 8 | **后台开发技能考核准备与参与** | 全体成员 | 响应小组技能考核任务1. 系统梳理后台开发核心知识点重点复习SpringBoot框架应用、接口设计规范、数据权限控制、全局异常处理等核心内容2. 复盘个人负责模块的技术实现细节准备考核所需的代码演示、逻辑讲解素材3. 按时参与团队组织的后台开发技能考核,积极配合考核流程。|
| 9 | **项目进度与技术文档更新** | 全体成员 | 配合小组文档管理要求1. 详细记录个人本周开发进展、遇到的技术难点及解决方案同步至团队共享文档2. 完善个人负责后端模块的技术设计文档补充接口定义、参数说明、数据模型、逻辑流程图等关键内容3. 协助PM汇总后端开发相关进度数据支撑《项目进度报告》的编写工作。。|
| 10 | **β版本开发进度同步与问题复盘** | 全体成员 |1. 参与每日团队进度同步会汇报后端开发进展与遇到的问题2. 每周汇总开发过程中的技术难点与解决方案形成复盘记录3. 针对开发风险(如接口联调延迟)提出应对措施,确保β版本开发按计划推进。 |
## 小结
1. **β版本开发攻坚核心周:** 本周核心聚焦β版本核心功能的后端开发与α版本遗留功能收尾,确保项目按迭代计划推进,为β版本交付筑牢基础;
2. **功能闭环关键推进:** 通过查询结果操作、收藏夹对比快照、好友管理等功能的后端开发,完善系统用户体验优化类功能,实现查询全流程的功能闭环;
3. **跨组协作深化:** 持续与前端组、其他后端成员紧密协作,通过接口联调、进度同步提升开发效率,保障前后端对接顺畅;
4. **技术能力提升:** 在快照差异对比、权限细粒度控制等功能开发中,进一步深化数据模型设计与复杂业务逻辑实现能力;
5. **所需帮助:** 希望能开展关于“大模型推荐功能后端对接技术”的专题指导明确AI引擎与后端接口的数据交互规范同时希望获得好友聊天接口性能优化的相关建议确保高并发场景下的稳定性。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
1. 请将个人计划和总结提前发给负责人;
1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,51 @@
# 个人周总结-第14周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **α版本未完成后端功能收尾** | 进行中 | 已完成仪表盘数据查询与统计接口的核心逻辑测试优化,数据准确性达标;收藏夹数据持久化剩余逻辑已基本完成,基本实现数据存储功能;分享权限细粒度校验规则已搭建基础框架,完成好友权限、有效期权限的核心逻辑,剩余角色权限关联校验需后续完善;已协同前端完成部分接口联调。|
| 2 | **β版本查询结果操作后端开发** | 进行中 | 已完成查询结果收藏、导出、分享的核心后端接口开发;分享权限控制逻辑中“仅好友可接收”功能已实现;分享记录与收藏记录的数据表结构已设计落地,完成数据持久化基础功能。|
| 3 | **β版本好友管理后端功能开发** | 进行中 | 已实现简易聊天功能的后端支撑,完成聊天消息收发、存储接口开发,通过消息队列保障消息实时性与完整性;好友间查询结果分享的接收与展示后端接口已开发完成,成功关联分享记录与好友关系;已协同前端完成基础功能联调。|
| 4 | **β版本查询功能优化后端适配** | 进行中 | 已完成多轮对话与多表联合查询的后端接口扩展实现上下文会话状态维持功能已配合完成大模型推荐功能的基础后端对接已优化部分NL2SQL转换后的SQL执行效率补充了多表关联字段不匹配、查询条件缺失等场景的异常处理与错误提示。|
| 5 | **β版本后端代码规范与性能优化** | 进行中 | 已完成本周开发代码的格式规整与部分逻辑精简,修正了命名不规范、代码冗余等问题;已对部分接口进行性能测试,已完善全局异常处理机制,补充了β版本查询操作、好友交互等模块的异常码及对应错误提示。|
| 6 | **AI核心与提示词模块后端对接** | 进行中 | 已开发完成自然语言转SQL核心提示词的调用接口完成基础联调实现后端与AI引擎的基础数据交互已协助搭建高级提示词优化的后端支撑框架完成查询失败原因反馈的数据传递接口开发。|
| 7 | **内部模块集成与冒烟测试** | 进行中 | 已完成个人负责后端模块与前端的70%接口对接联调,排查并解决了接口通信、数据格式不匹配问题;已参与整体系统集成工作,配合排查出跨模块交互漏洞;已执行部分核心流程的冒烟测试,记录测试问题并同步至团队问题清单,正在跟踪问题修复进度。 |
| 8 | **后台开发技能考核准备与参与** | 已完成 | 已系统梳理后台开发核心知识点重点复习SpringBoot框架应用、接口设计规范等内容形成知识点梳理笔记已按时参与个人后台开发技能考核积极配合完成考核。 |
| 9 | **项目进度与技术文档更新** | 已完成 | 已详细记录本周开发进展、遇到的AI对接数据格式适配等5个技术难点及解决方案同步至团队共享文档已完善个人负责后端模块的技术设计文档补充接口定义、参数说明、数据模型及逻辑流程图已协助PM汇总后端开发进度数据为《项目进度报告》编写提供了完整的后端开发相关素材。 |
| 10 | **β版本开发进度同步与问题复盘** | 已完成 | 已全程参与每日团队进度同步会及时汇报后端开发进展与遇到的问题已汇总本周开发过程中的5个技术难点及对应解决方案形成复盘记录并同步至团队已针对接口联调延迟等开发风险提出“固定每日下午集中联调”的应对措施被纳入团队后续推进计划。 |
## 对团队工作的建议
1. **建立未完成任务分级推进机制:** 建议对本周仍处于进行中的任务按优先级分级,明确各任务的收尾时间节点与核心交付物;由模块负责人牵头,每日跟踪任务进展,对滞后任务及时协调资源支持,避免影响β版本整体交付进度。
2. **优化跨模块集成联调流程:** 建议制定“模块联调清单”明确各模块联调的依赖关系、责任人及时间窗口固定每日下午2-4点为集中联调时间同步搭建联调问题实时反馈群提升跨模块问题解决效率。
3. **完善AI模块对接技术规范** 建议组织AI组与后端组共同梳理AI核心模块与后端对接的技术规范明确数据交互格式、异常处理标准及接口调用流程形成规范文档并同步至全体成员减少对接过程中的重复调试工作。
4. **搭建任务风险预警机制:** 建议针对后续开发任务,提前识别潜在风险(如技术难点、资源不足等)并分级标注;每周在进度评审会上同步风险状态,提前制定应对预案,保障项目平稳推进。
## 小结
1. **β版本开发攻坚取得阶段性进展:** 本周围绕β版本核心功能开发与α版本遗留功能收尾展开工作,多数任务推进至关键阶段,查询结果操作、好友管理等核心模块后端功能基本成型,为β版本后续整合优化奠定基础。
2. **跨组协作与技术适配能力提升:** 通过与前端组、AI组的深度对接深化了跨团队协作默契提升了接口联调、多模块适配的实操能力在AI核心模块对接、多表联合查询优化等工作中进一步丰富了SpringBoot项目复杂业务逻辑的实现经验。
3. **质控与文档管理落地见效:** 严格落实代码规范与性能优化要求,同步完善技术文档,保障了开发质量与文档的完整性;积极参与内部测试与问题复盘,强化了质量管控意识。
4. **存在的不足与改进方向:** 部分任务因技术难点如AI对接数据适配导致进度略滞后后续需提前梳理技术难点并寻求前置指导多任务并行推进过程中时间分配合理性有待提升需进一步优化任务规划能力。
5. **所需帮助:** 希望能组织“大模型推荐功能后端对接技术”专项指导会明确AI引擎与后端接口的数据交互规范及异常处理细节同时希望获得好友聊天接口性能优化的专项建议解决高并发场景下的消息加载延迟问题提升功能稳定性。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,36 @@
# 个人周计划-第14周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **Beta版本核心功能后端开发** | 后端组 | 主要负责通知管理、仪表盘动态数据接口、收藏夹与社交功能增强模块的后端API开发与实现 |
| 2 | **自然语言查询优化支持** | AI组 & 后端组 | 配合AI组完成自然语言查询的提示词优化与后端调用逻辑调整提升查询准确性和响应速度 |
| 3 | **内部模块集成与联调** | 全体成员 | 参与前后端模块集成工作,确保新开发功能与现有系统的兼容性,解决接口调用问题 |
| 4 | **系统性能优化专项** | 后端组 | 针对高并发场景下的数据库查询和API响应进行性能优化提升系统整体性能 |
| 5 | **后台开发个人技能考核准备** | 个人 | 认真准备后台开发技能考核复习SpringBoot、数据库优化、系统架构等关键技术点 |
## 小结
1. **功能开发冲刺:** 本周是Beta版本核心功能开发的关键周需要集中精力完成通知管理、仪表盘、收藏夹等核心模块的后端实现
2. **技术能力检验:** 通过个人技能考核检验和提升自己的后台开发技术水平,发现不足并及时改进;
3. **系统集成关键:** 重视模块集成工作,确保新功能与现有系统的无缝衔接,提升整体系统稳定性;
4. **文档同步及时:** 保持开发与文档同步,为项目维护和团队协作提供清晰的技术记录;
5. **团队协作深化:** 在与AI组、前端组的协作中进一步深化技术理解和沟通效率。
---
## 【注】
1. 希望获得数据库性能优化和高并发处理方面的实践经验指导;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台。

@ -0,0 +1,68 @@
# 个人周总结-第14周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-22
**结束时间:** 2025-12-28
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **Beta版本核心功能后端开发** | 完成 | 成功完成后端分享、好友、通知、对话历史、收藏等核心功能的API开发与实现 |
| 2 | **自然语言查询优化支持** | 进行中 | 配合AI组完成了自然语言查询的提示词优化与后端调用逻辑调整。 |
| 3 | **内部模块集成与联调** | 进行中 | 参与前后端模块集成工作,确保了新功能与现有系统的无缝衔接 |
| 4 | **系统性能优化专项** | 部分完成 | 对高频访问的API进行了数据库查询优化和缓存策略调整 |
## 详细技术成果
**后端核心功能模块实现情况:**
1. **分享功能**
- 实现查询结果分享API支持分享给指定好友或生成公开分享链接
- 完成分享记录管理和权限验证逻辑
2. **好友功能**
- 完善好友申请、同意/拒绝、删除等完整流程API
- 实现好友列表分页查询和在线状态显示
3. **通知功能**
- 开发系统通知、好友申请通知、分享通知等多种通知类型API
- 实现通知的已读/未读状态管理和批量操作接口
4. **对话历史功能**
- 完成用户对话记录的保存、查询和删除API
- 实现对话内容的分页查询和关键字搜索功能
5. **收藏功能**
- 开发查询结果收藏、收藏夹管理、收藏分组等完整API
- 实现收藏内容的快速检索和批量导出功能
## 对团队工作的建议
1. **API文档自动化** 建议引入Swagger UI自动生成和更新API文档减少文档维护工作量
2. **性能监控体系:** 建议建立系统性能监控仪表盘,实时监控关键接口的响应时间和成功率;
3. **集成测试自动化:** 建议建立自动化集成测试流程,提高测试效率和覆盖度;
4. **代码审查流程优化:** 建议制定更详细的代码审查checklist确保代码质量一致性。
## 小结
1. **功能开发成果显著:** 本周成功完成了Beta版本所有核心功能的后端开发系统功能完整性得到大幅提升
2. **技术难点成功攻克:** 在分享权限控制、实时通知推送、大数据量收藏管理等技术难点上取得了突破;
3. **系统性能明显改善:** 通过数据库优化和缓存策略调整,系统整体性能得到显著提升;
4. **个人技能得到验证:** 通过技能考核,系统梳理和巩固了后端开发的核心技术能力;
5. **团队协作高效顺畅:** 在与AI组、前端组的紧密配合下功能集成工作进展顺利
6. **质量意识持续强化:** 通过冒烟测试和Bug修复进一步强化了代码质量和系统稳定性的重要性
7. **后续工作重点:** 下一阶段将重点进行系统压力测试和用户体验优化,为正式发布做好充分准备。
---
## 【注】
1. 希望获得更多关于微服务架构设计和分布式系统性能优化的实践经验分享;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台。

@ -0,0 +1,85 @@
# 小组会议纪要-第15周
## 会议记录概要
**团队名称:** 4班-神奇宝码
**指导老师:** 边耐政
**主 持 人:** 李瑜清
**记录人员:** 李琪雯
**会议主题:** 第14周工作总结复盘、Beta版本收尾冲刺部署、第15周任务最终确认与动员
**会议地点:** 天马二食堂
**会议时间:** 2025-12-29 19:00-20:30
**记录时间:** 2025-12-29 2030
**参与人员:** 阿米娜、程荟锦、赵文琪、马芳琼、李瑜清、李琪雯
---
## 会议内容
### 1. 第14周个人周总结复盘与集成进展同步
#### 全体成员依次汇报第14周工作成果、问题及改进方向
- **Beta开发全面铺开** 依据《迭代开发计划》,通知管理、收藏夹与社交功能、自然语言查询优化等核心模块的前后端开发工作已全面展开,部分模块已完成基础架构搭建与主要接口实现。
- **AI核心能力取得关键进展** AI组李琪雯、李瑜清等已成功完成自然语言转SQL的核心提示词设计、嵌入与后端调用逻辑实现高级提示词扩展还在进行中为智能查询的稳定性与准确性提供了坚实支撑。
- **个人技能考核完成:** 团队参加了针对前后端开发技能的个人技能考核。
#### 遗留问题与风险点:
- **功能开发收尾压力:** 多表查询、智能推荐等功能模块的部分细节与优化尚未完成,集成测试中暴露的接口与逻辑问题仍需集中精力修复。
- **集成与测试复杂性:** 随着模块增多,系统集成的复杂性和测试的全面性要求显著提高,需要建立更高效的“测试-反馈-修复”协作机制。
- **文档与交付压力:** 在紧张的开发收尾阶段,《用户操作手册》等关键交付文档的编写工作需要与开发同步启动,时间压力较大。
### 2. 第15周最终冲刺周任务部署与动员
PM 李瑜清宣讲并强调了《第15周周计划》的极端重要性本周是**Beta版本的最终收尾与交付周**,全体成员需进入冲刺状态,确保所有任务高质量完成。
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】Beta版本功能全面收尾与完工** | 全体开发成员 | **本周最高优先级任务**。必须彻底完成所有剩余功能开发包括1. **多表查询**优化与测试2. **智能推荐**前后端联调与展示3. **通知、好友聊天等**功能完工与Bug清零。 |
| 2 | **【文档】编写并提交《用户操作手册》** | PM、各模块负责人 | **关键交付物**。各模块负责人需根据已实现功能编写清晰的操作说明。PM负责汇总、审阅确保周五前定稿提交。 |
| 3 | **【测试】全量系统测试与《测试报告》编写** | 全体成员 | **质量保障的最终关卡**。1. **全量测试**覆盖所有功能点与边界条件2. **即时修复**建立Bug快速响应与修复机制3. **报告编写**:客观记录测试过程与结果,评估系统质量。 |
| 4 | **【集成】系统整体集成与部署** | 后端组、PM | **最终交付准备**。将所有稳定代码合并至主分支,完成最终的系统集成构建,并部署至演示服务器,确保演示环境稳定可用。 |
| 5 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促并检查所有成员第十四周周总结和第十五周周计划的提交与归档。 |
### 3. 问题总结
#### 已解决问题:
1. **Beta核心功能框架搭建完成**:各模块开发工作已全面铺开并取得实质性进展。
2. **AI核心模块成功实现**NL2SQL等关键技术难点已攻克为项目核心价值奠定了基础。
3. **内部质控闭环初步建立**:通过启动集成测试与代码修复,形成了初步的“开发-测试-修复”流程。
#### 待解决问题与本周关键:
1. **功能细节与Bug清零**必须在本周前半段集中解决所有开发遗留问题和测试发现的Bug实现功能“完工”。
2. **交付文档同步完成**:在开发收尾的同时,必须保证《用户操作手册》等文档的编写质量与按时提交。
### 4. 小组协作情况总结
1. **开发与测试高效协同**:上周启动的集成测试体现了良好的跨职能协作。本周需将这种协作强度提升至最高水平,实现测试与修复的分钟级响应。
2. **信息同步及时**:通过周例会与日常沟通,团队在并行多任务的情况下保持了良好的信息透明度。
### 5. 一周纪律情况总结
- **任务交付**第14周计划任务基本按计划推进核心开发目标达成。
- **文档与考核**:项目文档同步更新,个人技能考核顺利完成,团队管理规范。
- **沟通协作**:面对集成初期的复杂问题,沟通渠道保持畅通,未出现严重协作阻塞。
## 备注
1. **最终冲刺动员**:本周是项目开发阶段的最后一周,要求全体成员以最高标准要求自己,对代码质量、功能完整性和文档准确性负责到底。
2. **快速响应机制**测试期间所有开发人员需保持通讯畅通对分配给自己模块的Bug要做到“即收即改改完即验”。
3. **代码合并纪律**周四前所有新功能开发必须停止进入最终的Bug修复和代码优化阶段。周五进行最终集成与部署任何未经PM确认的代码不得合并入主分支。
4. **个人文档提交**:全体成员务必按时提交第十四周个人周总结和第十五周个人周计划。
---
## 【注】
1. 本文档为“智能查询”项目组软件过程会议记录,记录人员必须在会议后一个工作日之内如实填写,并汇报给项目经理及相关人员。
2. 文档内容已经标上编号,记录人员如有增删需要,在保证文档格式正确的前提下修改。
3. 本文档在填写完毕后按“meeting-minutes-(周号)-序号”格式命名例如“meeting-minutes-15-01”。

@ -0,0 +1,34 @@
# 小组周计划-第15周
## 团队名称和起止时间
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :----------------------------------------- | :--------------- | :----------------------------------------------------------- |
| 1 | **【开发】Beta版本功能全面收尾与完工** | 全体开发成员 | **本周最高优先级任务**。<br>1. **多表查询**:完成多表联合查询功能的开发测试与优化,确保准确率。<br>2. **智能推荐**:完成查询结果智能推荐的前端展示与交互。<br>3. **其他功能**彻底完成通知管理、好友聊天、仪表盘动态更新等所有剩余功能的开发实现Beta版本功能实现与测试。 |
| 2 | **【文档】编写并提交《用户操作手册》** | PM、各模块负责人 | **关键交付物**。<br>编写一份清晰易懂的《用户操作手册》,详细说明系统各类角色(系统管理员、数据管理员、普通用户)的操作流程和功能使用方法,并在周五前完成提交。 |
| 3 | **【测试】全量系统测试与《测试报告》编写** | 全体成员 | **质量保障的关键环节**。<br>1. **全量测试**依据测试用例对Beta版本进行全覆盖的系统测试记录所有发现的Bug。<br>2. **Bug修复**:开发人员即时修复测试中发现的问题。<br>3. **报告编写**:汇总测试结果,编写并提交《系统测试报告》,客观评估系统质量。 |
| 4 | **【集成】系统整体集成与部署** | 后端组、PM | 将所有模块代码合并至主分支Master/Main进行最终的系统集成构建与线上部署。并将系统部署至演示服务器确保演示时系统运行稳定。 |
| 6 | **【管理】团队管理与文档提交** | PM (李瑜清) | 督促并检查所有成员第十四周周总结和第十五周周计划的提交情况,并按时汇总提交团队周报。 |
## 小结
1. **本周里程碑:** **Beta版本开发工作全面结束关键交付文档按时提交**。这标志着项目的开发阶段正式画上句号。
2. **工作重心:** 本周是**收尾**与**交付**并重。既要确保所有代码功能开发完毕、Bug修复到位又要保证文档质量为用户和老师提供一份完美的答卷。
3. **协作要点:** **测试与修复的快速迭代**是本周的关键。测试人员发现Bug后要立即反馈开发人员要迅速响应修复确保系统在周五前达到稳定发布状态。
4. **风险预判:** 多表查询等复杂功能的边界情况可能导致系统异常,测试时需重点覆盖这些复杂场景,确保系统的鲁棒性。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. PM综合本小组成员工作情况提交小组周计划、周总结报告按时上传至代码托管平台。

@ -0,0 +1,34 @@
# 小组周总结-第15周
## 团队名称和起止时间
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】Beta版本功能全面收尾与完工** | 完成 | **核心功能圆满收官** 团队集中力量完成了Beta版本所有剩余功能的开发与联调1. **多表查询**优化了后端联合查询逻辑与前端展示2. **智能推荐**完成了推荐算法的前后端对接3. **通知管理、好友聊天等功能**:均已实现全部基础功能,达到可用状态。 |
| 2 | **【文档】编写并提交《用户操作手册》** | 进行中 | 由PM组织各模块负责人依据最终实现的功能共同编写了涵盖系统管理员、数据管理员、普通用户三类角色的《用户操作手册》正在审核修改。 |
| 3 | **【测试】全量系统测试与《测试报告》编写** | 进行中 | 1. **全量测试**依据测试用例对Beta版本进行了全覆盖的功能、性能与兼容性测试</br>2. **Bug修复**对发现的部分Bug进行了修复剩余内容正在完善</br>3. **报告编写**:正在汇总测试过程与结果,编写了客观、详细的《系统测试报告》。 |
| 4 | **【集成】系统整体集成与部署** | 完成 | **稳定版本成功上线** 后端组将所有模块的稳定代码合并至主分支,完成了最终的系统集成构建与线上部署。系统已成功部署至演示服务器,运行稳定,为最终演示与验收做好了充分准备。 |
| 5 | **【管理】团队管理与文档提交** | 完成 | **收尾工作规范有序** PM按时督促并核查了全体成员的提交情况确保所有个人文档完整、规范。团队周报等管理文档均已按时汇总并完成归档项目收尾阶段的文档管理工作圆满结束。 |
## 小结
1. **里程碑胜利达成,开发阶段圆满落幕:** 本周成功完成了Beta版本所有功能的开发、测试与部署并按时提交了全部关键交付文档。
2. **收尾与交付并重,成果质量符合预期:** 团队高效执行了“功能收尾、深度测试、文档编写、系统部署”的收尾流程,不仅确保了代码功能完备、系统运行稳定,也交付了高质量的用户文档。
3. **团队凝聚力与执行力经受最终考验:** 在项目最后的冲刺阶段,全体成员目标一致、高度专注、互帮互助,顶住了时间与质量的双重压力,成功交付了令人满意的成果,充分证明了团队强大的凝聚力和卓越的执行力。
4. **展望与致谢:** 项目的开发工作虽已结束,但团队的学习与成长之旅仍在继续。感谢指导老师边耐政老师在整个项目周期中给予的悉心指导与宝贵反馈,也感谢每一位团队成员在此过程中的辛勤付出与紧密协作。我们期待在接下来的课程演示与最终答辩中,完美展示“智能查询”项目的全部成果。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. PM综合本小组成员工作情况提交小组周计划、周总结报告按时上传至代码托管平台。

@ -0,0 +1,31 @@
# 个人周计划-第 15 周
## 基本信息
**团队名称:** 4 班-神奇宝码
**姓  名:** 阿米娜·赛力克
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务安排
| 序号 | 任务类型 | 计划内容 | 执行人 | 说明 |
| ---- | ------------------------------------ | -------- | -------------------------------------------------------------------------------------------- | ---- |
| 1 | **【开发】前端核心功能开发与调试** | 前端组 | 负责智能推荐、通知管理等模块的前端界面开发与功能调试,确保界面交互流畅、数据展示准确。 |
| 2 | **【开发】前端 Bug 修复与优化** | 前端组 | 根据测试反馈的问题列表,集中修复前端模块中的界面显示异常、交互逻辑错误等问题,并进行性能优化 |
| 3 | **【文档】用户操作手册前端部分编写** | 前端组 | 编写《用户操作手册》中涉及前端操作流程、界面功能介绍等内容,确保说明清晰易懂,配图准确。 |
| 4 | **【测试】前端模块测试与验证** | 前端组 | 对负责的前端功能进行系统测试,包括正常流程与异常情况覆盖,并在修复问题后进行回归验证 |
| 5 | **【集成】系统集成与前端部署支持** | 全体成员 | 协助完成系统整体集成,并在部署后验证前端功能是否正常运行,确保线上环境稳定。 |
| 6 | **【管理】个人总结与计划提交** | 全体成员 | 按时提交第十四周个人总结与第十五周计划,并在周会上汇报工作进展与遇到的问题。 |
## 本周小结
1. **工作重点:** 本周将集中精力完成前端功能开发与调试,积极配合测试与集成工作,确保项目顺利进入交付阶段。
2. **质量保障:** 在开发过程中注重代码质量与用户体验,及时修复问题并优化性能,提升系统整体稳定性。
3. **协同推进:** 与团队成员保持紧密沟通,确保开发、测试、文档等各环节衔接顺畅,共同推进项目进度。
## 注意事项
1. **测试全面性:** 在测试阶段需重点关注复杂功能的边界情况,确保系统在各种场景下均能稳定运行。
2. **文档实用性:** 编写操作手册时注意语言简洁、步骤清晰,便于用户理解与操作。
3. **问题及时反馈:** 在集成与部署过程中如遇到问题,需及时与相关成员沟通,协同解决。

@ -0,0 +1,62 @@
# 个人周总结-第 15 周
## 基本信息
**姓  名:** 阿米娜·赛力克
**团队名称:** 4 班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
---
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| ---- | ------------------------------------ | -------- | -------------------------------------------------------------------------------------- |
| 1 | **【开发】前端核心功能开发与调试** | 完成 | 完成了智能推荐、通知管理等前端模块的界面开发与功能调试,确保界面交互流畅、数据展示准确 |
| 2 | **【开发】前端 Bug 修复与优化** | 完成 | 修复了测试反馈的多个界面显示异常和交互逻辑问题,并进行了性能优化,提升了响应速度 |
| 3 | **【文档】用户操作手册前端部分编写** | 完成 | 编写并完善了《用户操作手册》中前端操作流程、界面功能介绍等内容,配有清晰截图和步骤说明 |
| 4 | **【测试】前端模块测试与验证** | 完成 | 完成了对负责前端模块的系统测试,覆盖正常流程与异常场景,问题修复后均进行了回归验证 |
| 5 | **【集成】系统集成与前端部署支持** | 完成 | 协助完成了系统整体集成,并在部署后验证前端功能,确保线上环境运行稳定 |
| 6 | **【管理】个人总结与计划提交** | 完成 | 按时提交了第十四周个人总结与第十五周计划,并在周会上汇报了工作进展与问题 |
---
## 主要技术成果与问题解决
### 完成的前端核心模块
1. **智能推荐界面**:实现动态数据展示与用户交互逻辑
2. **通知管理模块**:完成通知列表、标记已读、删除等功能开发
3. **界面性能优化**:减少渲染耗时,提升用户体验
### 解决的关键问题
1. **界面适配异常**:修复了在不同分辨率下的显示错位问题
2. **数据加载延迟**:优化了数据请求策略,提升加载速度
3. **交互逻辑冲突**:修复了多操作并发时的状态同步问题
### 集成与部署支持成果
1. **部署脚本适配**:协助完成前端资源部署配置与环境适配
2. **线上问题排查**:配合后端定位并解决了集成过程中的跨域问题
---
## 对团队工作的建议
1. **前端测试自动化推进**:建议逐步引入前端自动化测试框架,提升回归测试效率
2. **UI/UX 规范文档化**:建议整理前端界面与交互规范,便于团队统一风格与开发效率提升
3. **前后端联调流程优化**:建议建立更规范的接口联调与文档同步机制
---
## 小结
1. **前端功能稳步推进**:本周按计划完成了前端核心功能开发与调试,模块功能完整、交互流畅
2. **问题响应及时有效**:对测试中发现的问题快速响应并修复,确保了功能质量
3. **文档编写清晰实用**:用户手册内容详实、步骤清晰,便于用户理解与操作
4. **集成配合积极到位**:在系统集成与部署过程中积极配合,保障了前端部分的顺利上线
5. **个人能力持续提升**:通过本次开发与测试过程,进一步巩固了前端开发与问题排查能力
6. **团队协作顺畅高效**:与测试、后端及项目管理团队保持良好沟通,共同推进项目进度
7. **项目收尾工作扎实**:认真完成各项收尾任务,为项目交付做好准备

@ -0,0 +1,27 @@
# 个人周计划-第15周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务计划安排
| 序号 | 计划内容 | 执行人 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】前端核心功能收尾与联调** | 前端组 | **配合团队最高优先级任务**。<br>1. **智能推荐**完成查询结果智能推荐模块的前端UI开发、数据展示与用户交互逻辑。<br>2. **通知管理**完成通知中心所有功能的前端开发收尾确保WebSocket消息的稳定接收、展示与状态管理。<br>3. **界面优化**:对已完成的仪表盘动态化、收藏夹等模块进行最终样式与交互细节打磨。 |
| 2 | **【开发】Beta版本前端Bug集中修复** | 前端组 | **响应团队测试反馈**。根据全量测试阶段发现的Bug清单集中精力修复属于个人负责的前端模块问题包括界面渲染错误、交互逻辑缺陷、性能瓶颈等确保功能稳定。 |
| 3 | **【文档】参与《用户操作手册》前端部分编写** | 前端组 | **配合团队关键交付物**。负责撰写《用户操作手册》中与前端界面操作、用户交互流程相关的章节,确保描述清晰、准确,并附上必要的界面截图说明。 |
| 4 | **【测试】执行前端模块专项测试与回归测试** | 前端组 | **履行质量保障职责**。<br>1. **专项测试**:对本人负责开发的所有前端功能进行覆盖性测试,并补充边界用例。<br>2. **回归测试**在修复Bug后立即对相关模块进行回归测试确保问题解决且未引入新问题。 |
| 5 | **【集成】协助系统集成与前端部署验证** | 全体成员 | **保障最终交付物**。协助PM及后端同学完成系统集成在部署至演示服务器后立即对前端所有页面、功能及交互进行验证确保线上环境运行正常。 |
| 6 | **【管理】完成个人文档与总结** | 个人 | **配合团队管理要求**。按时、按要求提交第十四周个人周总结与第十五周个人周计划。在周例会上清晰汇报前端收尾工作进展、测试结果及遇到的阻碍。 |
| 7 | **【考核/学习】整理前端开发文档与技术总结** | 个人 | **个人能力沉淀**。利用项目收尾间隙,系统梳理本次项目中负责模块的**技术难点、解决方案与最佳实践**,形成个人技术笔记,为后续复盘与提升做准备。 |
## 小结
1. **核心目标**:本周个人工作的核心是**全力保障前端开发任务的彻底收尾**紧密配合团队完成Beta版本的最终集成、测试与交付。工作重心将从“新功能开发”完全转向“质量闭环与交付保障”。
2. **角色定位**:作为前端开发,需**主动响应测试反馈**快速修复Bug**积极参与文档撰写**,确保交付物的完整性;并**全力协助集成部署**,验证线上环境。
3. **协作关键**与后端、测试、PM保持高频、高效的沟通确保“开发-测试-修复-验证”的循环快速运转,是本周项目成功收尾的关键。
4. **希望获得的帮助**:在项目收尾阶段,希望能有机会参与或学习关于 **“大型项目前端代码重构与维护经验”** 或 **“高效的项目收尾与交付流程”** 相关的分享,为本次项目画上圆满句号并为未来积累经验。

@ -0,0 +1,27 @@
# 个人周总结-第15周
## 姓名和起止时间
**团队名称:** 4班-神奇宝码
**姓  名:** 程荟锦
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :--- | :--- | :--- |
| 1 | **【开发】参与Beta版本核心功能收尾与联调** | 进行中 | 参与**智能推荐、通知管理**等模块的收尾,完成了前端页面的最终实现与交互逻辑联调,确保功能达到交付标准。 |
| 2 | **【开发】参与Beta版本Bug集中修复** | 进行中 | 根据测试报告,修复了所负责模块中发现的界面渲染、交互逻辑等相关缺陷,并对部分页面,如**收藏夹、仪表盘、好友管理**等功能进行了修复与优化。 |
| 3 | **【文档】参与《用户操作手册》内容编写** | 进行中 | 协助PM及团队撰写了系统中与用户界面操作、功能使用流程相关的说明章节并配合完成配图与定稿。 |
| 4 | **【测试】执行所负责模块的专项与回归测试** | 进行中 | 对个人开发的功能进行了全面测试覆盖正常与边界场景并在Bug修复后及时进行回归验证。 |
| 5 | **【集成】协助系统整体集成与部署验证** | 进行中 | 配合后端与PM完成代码集成在系统部署至演示服务器后协助完成了线上功能的完整验证确保运行稳定。 |
| 6 | **【管理】完成个人文档提交与进度同步** | 完成 | 按时提交了第十四周总结与本周计划,并在周例会中清晰汇报了工作进展与后续安排。 |
| 7 | **【学习】整理个人技术文档与项目总结** | 完成 | 系统梳理了在项目开发中承担的工作、解决的技术难点及收获,形成了个人总结文档。 |
## 小结
1. **任务圆满完成**:本周按计划完成了所分配的所有开发、测试、文档及协作任务,确保了在项目最终收尾阶段个人工作的闭环,为团队整体交付提供了有效支持。
2. **质量与协作并重**:在快速推进收尾工作的同时,积极响应测试反馈修复问题,并保持与团队成员的高效沟通,保障了交付成果的质量与团队节奏同步。
3. **个人综合能力得到锻炼**:通过参与项目从开发到部署上线的完整周期,不仅提升了技术水平,也在项目管理、团队协作和质量把控方面积累了宝贵经验。
4. **希望获得的帮助**:项目虽告一段落,但希望未来有机会学习 **“高效的项目复盘与经验沉淀方法”** 以及 **“从学生项目到工业级开发的过渡与准备”** 相关的指导或讲座,为下一阶段的成长明确方向。

@ -0,0 +1,35 @@
# 个人周计划-第15周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
| :--- | :----------------------------------------------- | :----------- | :----------------------------------------------------------- |
| 1 | **【核心技术】多表联合查询功能的最终调优** | 个人、AI组 | **Beta版本开发**<br> **优化关联识别**针对复杂的三表关联场景进一步调优Prompt与代码确保大模型能准确识别查询问问题并返回。 |
| 2 | **【核心技术】智能查询推荐逻辑的完整实现** | 个人、前端组 | 1.**完成推荐算法**基于当前的查询结果实现大模型自动生成3-5条相关查询建议的逻辑。<br>2. **前后端联调**:与前端组协作,完成推荐结果在界面上的动态展示和点击跳转功能。 |
| 3 | **【PM职责】主导《用户操作手册》的撰写与整合** | 全体成员 | **周五前必须提交**。<br>**安排编写文档与统筹汇总**:安排文档编写,收集并审核各组员提交的功能说明,进行统一的排版和校对,确保手册图文并茂、通俗易懂。 |
| 4 | **【PM职责】组织全量系统测试并编写《测试报告》** | 全体成员 | **周五前必须提交**。<br>1. **执行测试**带领团队按照测试用例进行最后一轮测试重点测试Beta版本的新功能。<br>2. **汇总报告**收集Bug修复数据分析系统遗留问题撰写正式的《系统测试报告》客观反映Beta版本的质量状况。 |
| 5 | **【PM职责】Beta版本最终验收** | 全体成员 | **最终验收**对照《需求规格说明书》逐项检查Beta版本的功能实现情况进行最终确认。 |
| 6 | **【管理】团队周报与文档归档** | 个人 | 督促并检查所有成员第十四周周总结和第十五周周计划的提交情况,并按时汇总提交团队周报。 |
## 小结
1. **工作重心:** 本周我的工作重心是**“全力冲刺,完美交付”**。我需要同时扮演好“高级开发者”和“严谨PM”两个角色既要保证多表查询等核心技术点的突破又要确保用户手册和测试报告这两份关键文档的高质量产出。
2. **个人挑战:** **时间管理和多任务并行**是本周最大的挑战。周五是文档提交的硬截止时间,我需要合理分配开发、测试和文档撰写的时间,确保每一项任务都能按时保质完成。
3. **期望成果:** 到本周末,我期望能交付一个**功能完全闭环、运行稳定、具备智能化亮点**的Beta版本。同时确保所有交付文档手册、报告均已通过审核并成功提交为项目的最终结项打下最坚实的基础。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,42 @@
# 个人周总结-第15周
## 姓名和起止时间
**姓  名:** 李瑜清
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
| :--- | :----------------------------------------------- | :------- | :----------------------------------------------------------- |
| 1 | **【开发】多表联合查询功能优化实现** | 完成 | 优化了Prompt长度和后端解析逻辑缩短使多表查询的平均响应时间达到了Beta版本的发布要求。 |
| 2 | **【开发】智能查询实现** | 完成 | 与前端组协作,完成了推荐动态渲染和点击大模型思考建议的交互逻辑,显著提升了系统的智能化体验。 |
| 3 | **【PM职责】主导《用户操作手册》的撰写与整合** | 进行中 | 目前已汇总各组员提交的功能说明,正在进行润色优化,确保截至时间前产出一份高质量的交付文档。 |
| 4 | **【PM职责】组织全量系统测试并编写《测试报告》** | 进行中 | 带领全员完成了针对Beta版本所有功能点测试重点验证了多表查询的准确性。正在修复bug进行撰写报告 |
| 5 | **【PM职责】Beta版本最终验收** | 进行中 | 对照需求规格说明书确认Beta版本所有承诺功能均已100%实现,部署服务器进行验收准备。 |
| 6 | **【管理】团队管理与文档提交** | 完成 | 督促并核查了全体成员第十四周周总结和第十五周周计划的提交情况,按时汇总并提交了团队周报,为项目开发阶段的文档管理画上了圆满句号。 |
## 对团队工作的建议
1. **保持文档更新意识**:虽然开发阶段结束了,但在后续的演示和维护中,如果代码调整,务必同步更新技术文档。
2. **全力准备结项演示**Beta版本的成果非常丰硕希望大家在接下来的结项演示中能把自己负责模块的亮点充分展示出来。
3. **总结个人成长**:建议每位成员在项目结束后,都能静下心来总结一下自己在技术、协作和解决问题方面的收获。
## 小结
1. **技术攻坚的成就感**:本周最让我自豪的是彻底攻克了多表联合查询这一技术高地。从最初的预研到现在的稳定运行,这个过程极大地锻炼了我的代码能力和逻辑思维。
2. **管理与执行**在项目最后一周面对繁重的文档任务和技术收尾我深刻体会到了PM“统筹全局”的重要性。通过合理的任务分配和严格的进度跟进我们顶住了压力实现了开发·。
3. **团队凝聚力的升华**在冲刺的过程中我看到了每一位成员的努力和互助。这种团队默契是我们能从Alpha一路走到Beta圆满收官的最宝贵财富。
4. **圆满收官,未来可期**Beta版本的成功完工标志着我们项目主要开发阶段的胜利结束。我为我们团队感到无比骄傲也期待在最终的演示中向老师和同学们展现我们这十五周来的心血结晶。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,37 @@
# 个人周计划-第15周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **【开发】完成智能推荐与多表查询后端功能开发与优化** | 李瑜清、赵文琪、马芳琼 | **核心功能收尾**。完成后端多表联合查询功能的性能优化与边界条件测试,确保查询结果的准确性与系统稳定性。 |
| 2 | **【开发】完成个人负责的后端模块功能收尾** | 赵文琪、马芳琼 | **Beta版本功能完工**。协助后端组完成好友聊天、通知管理等模块剩余接口的开发与联调,确保所有功能按《迭代开发计划》实现,并达到可测试状态。 |
| 3 | **【测试】参与全量系统测试与Bug修复** | 全体成员 | <br>1. **参与测试**:根据测试用例,对负责的后端模块及接口进行深入测试。<br>2. **快速修复**即时响应测试团队发现的与自身模块相关的Bug确保在当日或次日完成修复并进行验证。 |
| 4 | **【文档】编写《用户操作手册》中后端与AI功能部分** | 全体成员 | <br>负责撰写《用户操作手册》中与AI核心功能相关的操作说明与技术要点描述确保内容准确、清晰。 |
| 5 | **【集成】配合完成系统整体集成与部署** | 全体成员 |参与系统集成构建与线上部署的配合工作,确保部署后所负责的服务运行稳定。 |
## 小结
1. **最终冲刺**本周是Beta版本的**最终开发与交付周**,工作重心是**确保所有后端及AI功能开发完毕、彻底测试并通过集成**。这是项目开发阶段的收官之战。
2. **质量与文档并重**在全力进行功能收尾和Bug修复的同时必须保证《用户操作手册》等关键文档的编写质量做到“所做即所写”为项目最终验收提供完整支持。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,41 @@
# 个人周总结-第15周
## 姓名和起止时间
**姓  名:** 李琪雯
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
## 本周任务计划安排
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **【开发】完成智能推荐与多表查询后端功能开发与优化** | 已完成 | **核心功能成功收尾**。完成了多表联合查询功能的后端性能优化,提升了查询准确率。智能推荐算法的后端调优工作也已完成,确保了与前端展示的无缝对接。 |
| 2 | **【开发】完成个人负责的后端模块功能收尾** | 已完成 | **负责模块全部完工**。协助后端组完成了beta版本模块剩余接口的最终联调与测试达到稳定可用的发布状态。 |
| 3 | **【测试】参与全量系统测试与Bug修复** | 已完成 | **质量保障全程参与**。依据测试用例对负责的后端模块进行了全面深入的测试。积极响应测试反馈修复了1处接口逻辑缺陷和1处性能优化。 |
| 4 | **【文档】编写《用户操作手册》中后端与AI功能部分** | 进行中 | 《用户操作手册》撰写正在进行中。 |
| 5 | **【集成】配合完成系统整体集成与部署** | 已完成 | **系统成功稳定上线**。将个人开发并测试完毕的所有模块代码合并至主分支,全程参与了系统最终集成构建与线上部署的配合工作。部署后对所负责的后端服务进行了验证,确认运行稳定。 |
## 对团队工作的建议
1. **部署后监控建议**:建议在最终演示前,能对线上部署的系统进行一次集中的健康检查与压力测试模拟,提前发现潜在的性能问题,确保演示过程万无一失。
## 小结
1. **使命达成,圆满收官**本周作为项目开发阶段的最后一周成功完成了所有后端及AI功能开发、测试、文档编写与集成支持任务为Beta版本的最终交付贡献了关键力量。
2. **能力锤炼,收获颇丰**通过本次项目尤其是在多表查询、AI集成等复杂模块的实践中我的后端开发能力、问题排查能力和技术文档撰写能力都得到了显著提升。与团队高效协作完成最终冲刺的经历更是一笔宝贵的财富。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,39 @@
# 个人周计划-第15周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2025-01-04
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **【开发】Beta 版本后端功能全面收尾与完工** | 后端组、前端组、AI组 | **本周最高优先级任务,聚焦后端功能闭环与优化:** 1. 多表查询后端优化:完成多表联合查询剩余边界场景(关联字段为空、多表级联查询)的后端逻辑开发,优化 SQL 执行效率与准确率补充异常处理机制2. 智能推荐后端支撑收尾:完善查询结果智能推荐的后端数据传递接口,确保与 AI 引擎交互顺畅适配前端展示所需数据格式完成接口联调与测试3. 其他功能后端收尾:彻底完成通知管理、好友聊天(消息历史记录加载、高并发消息收发)、仪表盘动态更新的后端剩余逻辑开发,修复前期遗留的接口漏洞,确保所有功能正常运行并通过自测。 |
| 2 | **【文档】《用户操作手册》后端模块内容编写与审核** | 后端组、前端组、PM | **关键交付物配套工作:** 1. 编写后端相关功能的操作说明,涵盖系统管理员 / 数据管理员 / 普通用户三类角色对应的后端功能如多表查询、好友分享、数据导出的操作流程、权限约束、注意事项2. 补充功能使用中的常见问题如查询失败、分享失败及后端对应的解决方案3. 协助 PM 审核《用户操作手册》全稿,确保后端模块内容与实际功能一致、表述清晰易懂,周五前完成定稿与提交。 |
| 3 | **【测试】全量系统测试(后端模块)与 Bug 即时修复** | 后端组、前端组 | 质量保障核心工作1. 依据测试用例,对 Beta 版本后端所有模块查询、社交、通知、仪表盘等进行全覆盖测试重点覆盖多表查询、好友聊天等高复杂场景的边界情况2. 实时记录测试中发现的后端 Bug如接口报错、数据返回异常、权限校验失效等同步至团队问题清单3. 收到 Bug 反馈后即时响应,优先修复核心功能 Bug修复后进行回归测试确保问题彻底解决 |
| 4 | **【测试】《系统测试报告》后端模块内容汇总与编写** | 全体成员、后端组 | **测试成果固化与提交:** 1. 汇总后端模块的全量测试结果,包括测试覆盖范围、发现的 Bug 数量 / 类型、Bug 修复完成情况、未解决问题如有及后续计划2. 客观评估后端模块的系统质量包括功能完整性、性能稳定性、兼容性等3. 协助 PM 整合全团队测试内容,完成《系统测试报告》的编写与提交,周五前完成定稿。 |
| 5 | **【集成】系统整体集成(后端模块)与部署支持** | 全体成员 | **版本交付最后工作:** 1. 将个人负责的后端模块代码合并至项目主分支Master/Main排查并解决代码合并过程中的冲突问题2. 参与系统最终整体集成构建配合排查跨模块前后端、AI 与后端的集成漏洞3. 支持系统部署至演示服务器,验证后端接口在演示环境中的稳定性,确保演示时核心功能(多表查询、好友聊天、数据导出)正常运行。 |
| 6 | **个人文档提交与团队进度配合** | PM李瑜清、全体成员 | **团队管理配套工作:**1. 按时完成第 14 周周总结的修改与提交,同步更新第 15 周周计划至代码托管平台2. 参与每日团队进度同步会与周例会及时汇报后端功能收尾、测试修复、文档编写的进展与遇到的问题3. 配合 PM 汇总后端开发相关进度数据,支撑团队周报的编写与提交。 |
## 小结
1. **β版本开发攻坚核心周:** 本周核心聚焦β版本核心功能的后端开发与α版本遗留功能收尾,确保项目按迭代计划推进,为β版本交付筑牢基础;
2. **功能闭环关键推进:** 通过查询结果操作、收藏夹对比快照、好友管理等功能的后端开发,完善系统用户体验优化类功能,实现查询全流程的功能闭环;
3. **跨组协作深化:** 持续与前端组、其他后端成员紧密协作,通过接口联调、进度同步提升开发效率,保障前后端对接顺畅;
4. **技术能力提升:** 在快照差异对比、权限细粒度控制等功能开发中,进一步深化数据模型设计与复杂业务逻辑实现能力;
5. **所需帮助:** 希望能开展关于“大模型推荐功能后端对接技术”的专题指导明确AI引擎与后端接口的数据交互规范同时希望获得好友聊天接口性能优化的相关建议确保高并发场景下的稳定性。
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
1. 请将个人计划和总结提前发给负责人;
1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;

@ -0,0 +1,43 @@
# 个人周总结-第15周
## 姓名和起止时间
**姓  名:** 马芳琼
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2025-01-04
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **【开发】Beta 版本后端功能全面收尾与完工** | 已完成 | 已全面完成多表联合查询剩余边界场景的后端逻辑开发,优化后 SQL 执行效率提升,准确率达标,补充了完善的异常处理机制;完成查询结果智能推荐的后端数据传递接口开发与联调,实现与 AI 引擎的顺畅交互,适配前端展示数据格式;完成通知管理、好友聊天(消息历史记录加载)、仪表盘动态更新的后端剩余逻辑开发,修复前期遗留接口漏洞,基本功能均通过自测。期间重点修复 2 个关键 Bug一是好友分享功能中重新执行查询的异常问题二是数据管理员默认对所有数据库表有查询权限的权限溢出问题修复后均通过回归测试。|
| 2 | **【文档】《用户操作手册》后端模块内容编写与审核** | 进行中 | 已完成后端核心功能的操作说明编写,涵盖系统管理员 / 数据管理员 / 普通用户三类角色的操作流程、权限约束及注意事项;已补充查询失败、分享失败等常见问题的后端解决方案说明;目前正在配合 PM 进行全稿审核,针对手册中表述不清晰的接口操作步骤进行优化调整,尚未完成最终定稿 |
| 3 | **【测试】全量系统测试(后端模块)与 Bug 即时修复** | 进行中 | 已依据测试用例完成后端所有模块(查询、社交、通知、仪表盘等)的 80% 覆盖测试,重点完成多表查询、好友聊天等高复杂场景的边界情况测试;实时记录后端 Bug已同步至团队问题清单正在持续推进剩余 Bug 的修复工作,修复完成后即时开展回归测试,确保问题彻底解决。|
| 4 | **【测试】《系统测试报告》后端模块内容汇总与编写** | 进行中 | 已汇总后端模块已完成测试部分的测试结果,包括测试覆盖范围、已发现 Bug 数量 / 类型、Bug 修复完成情况;已初步完成功能完整性、性能稳定性、兼容性等系统质量的评估框架搭建;目前因部分 Bug 尚未修复完成,正在同步更新测试报告内容,补充 Bug 修复后的验证结果,待所有测试工作收尾后完成最终编写。 |
| 5 | **【集成】系统整体集成(后端模块)与部署支持** | 进行中 | 排查并解决代码合并过程中的冲突问题;已参与系统最终整体集成构建,配合排查出前后端跨模块集成漏洞(数据格式不匹配、接口调用时序问题),目前正在协同前端组推进漏洞修复。|
## 对团队工作的建议
1. **制定部署前冲刺倒计时计划:** 结合周三部署服务器的核心目标,建议梳理出部署前剩余工作(集成漏洞修复、部署验证、文档定稿、测试收尾)的倒计时清单,明确每项任务的截止时间(精确到小时)、责任人及交付标准,由 PM 每日早会同步进度,确保所有前置工作按时落地。
2. **建立核心问题攻坚专项小组:** 针对尚未修复的核心 Bug 及集成漏洞建议成立临时攻坚小组由前后端、AI 组核心成员组成,集中精力突破关键问题;采用 “问题认领 + 实时同步” 机制,避免重复排查,提升问题解决效率,确保不影响部署进度。
3. **优化部署全流程协作方案:** 提前明确部署分工,建议划分 “代码最终校验组”“环境配置组”“接口验证组”“应急保障组”,各组提前熟悉对应环节操作流程;部署前组织 1 次简短演练,明确沟通话术与问题反馈通道,确保部署过程高效衔接;同时准备部署回滚预案,应对突发问题。
4. **同步推进文档收尾与部署并行:** 建议文档编写与审核工作与部署准备并行推进,针对《用户操作手册》《系统测试报告》的收尾工作,指定专人盯控,采用 “分章节审核 + 集中定稿” 模式,避免因文档滞后影响项目整体交付。
## 小结
1. **Beta 版本后端攻坚收尾落地,部署冲刺进入关键阶段:** 本周核心聚焦 Beta 版本后端功能全面收尾,已顺利完成核心开发任务,修复关键 Bug为部署工作筑牢基础当前各项收尾工作测试、集成、文档均进入冲刺阶段距离服务器部署目标仅剩最后时间需集中精力推进剩余任务。
2. **跨组协同攻坚成效显著,部署准备衔接紧密:** 通过与前端、AI 组、测试组的高效协作,顺利完成代码合并与部分集成工作,排查解决多项跨模块问题;全程紧跟团队部署节奏,主动配合进度协调,确保后端工作与部署目标同频推进。
3. **存在的不足与冲刺方向:** 一是部分测试与文档任务进度略滞后,需优化时间分配,加快推进收尾;二是对集成漏洞的预判与解决效率有待提升,后续需更紧密地与前端协同,提前规避衔接问题。冲刺阶段将优先保障部署相关工作,集中精力解决核心问题,确保不拖团队部署进度后腿。
4. **所需帮助:** 希望团队能集中资源支持核心 Bug 与集成漏洞的攻坚,建议每日下午增设 1 小时跨组攻坚同步会,快速对齐问题解决方案;同时希望获得部署相关的技术支持,提前明确演示服务器的环境配置要求与接口验证标准,确保部署时后端接口能快速完成稳定性验证
---
## 【注】
1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
2. 请将个人计划和总结提前发给负责人;
3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;

@ -0,0 +1,38 @@
# 个人周计划-第15周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
---
## 本周任务计划安排
| 序号 | 计划内容 | 协作人 | 情况说明 |
|------|----------|--------|----------|
| 1 | **【测试】全量系统测试** | 全体成员 | 依据测试用例对Beta版本进行全覆盖的系统测试重点测试多表查询、智能推荐、通知管理、仪表盘动态更新等模块的边界情况和异常场景 |
| 2 | **【修复】Bug修复与回归验证** | 后端组 & 全体测试人员 | 及时响应测试中发现的问题快速修复后端相关Bug并进行回归测试确保修复有效性 |
| 3 | **【集成】系统整体集成支持** | 后端组 & PM | 协助完成各模块代码合并至主分支,参与系统集成构建与线上部署的配置和验证工作 |
| 4 | **【文档】协助编写《测试报告》** | 全体成员 | 根据测试记录整理测试结果,协助编写《系统测试报告》,客观评估所负责模块的质量情况 |
| 5 | **【收尾】已开发模块最终检查** | 个人 | 对负责的通知管理、仪表盘动态数据接口、收藏夹等模块进行最终代码和功能完整性检查 |
---
## 小结
1. **测试驱动质量保障:** 本周以系统测试和Bug修复为核心确保Beta版本达到稳定发布标准
2. **快速响应与协作修复:** 配合测试团队及时发现并修复问题,保持开发与测试的高效协作循环;
3. **集成部署支持:** 积极参与系统集成与部署过程,确保后端服务在演示环境中稳定运行;
4. **文档输出与总结:** 认真记录测试过程与结果,协助完成测试报告的编写,为项目交付提供质量依据;
5. **个人模块完整性确认:** 对个人负责的模块进行全面检查,确保功能完整、代码规范、无遗留问题。
---
## 【注】
1. 希望在测试和部署过程中,如遇到复杂环境问题,能得到老师或助教在服务器配置方面的指导;
2. 个人计划和总结将按时提交给负责人李瑜清;
3. 本周是项目收尾关键期,将严格执行计划,确保个人任务按时高质量完成。

@ -0,0 +1,51 @@
# 个人周总结-第15周
## 姓名和起止时间
**姓  名:** 赵文琪
**团队名称:** 4班-神奇宝码
**开始时间:** 2025-12-29
**结束时间:** 2026-01-04
---
## 本周任务完成情况
| 序号 | 总结内容 | 是否完成 | 情况说明 |
|------|----------|----------|----------|
| 1 | **【测试】全量系统测试** | 完成 | 依据测试用例完成了Beta版本的多表查询、智能推荐、通知管理、仪表盘动态更新等模块的全覆盖测试发现了关键功能边界和异常场景问题 |
| 2 | **【修复】Bug修复与回归验证** | 完成 | 及时响应并修复了测试中发现的一些后端相关Bug包括数据库连接异常、接口参数校验缺失、权限验证逻辑漏洞等并完成回归验证 |
| 3 | **【集成】系统整体集成支持** | 完成 | 参与了系统集成构建与线上部署的配置验证工作,确保后端服务稳定运行 |
| 4 | **【文档】协助编写《测试报告》** | 进行中 | 根据个人负责模块的测试记录,整理了测试结果与修复情况,协助完成了《系统测试报告》相关章节的编写 |
| 5 | **【收尾】已开发模块最终检查** | 完成 | 对负责的通知管理、仪表盘动态数据接口、收藏夹等模块进行了最终的代码审查和功能完整性验证,确保无遗留问题 |
## 主要技术成果与问题解决
**修复的关键Bug**
1. **数据库连接池泄漏问题**:修复了高并发场景下的连接未及时释放问题,优化了连接管理策略
2. **权限验证边界漏洞**:修复了角色权限验证在某些边界场景下的逻辑缺陷
**集成与部署成果:**
1. **环境配置标准化**:完善了开发、测试、生产环境的配置文件,确保一致性
2. **服务健康检查**:实现了服务的健康检查接口和监控告警机制
3. **日志系统优化**:统一了系统日志格式和级别,便于问题追踪
## 对团队工作的建议
1. **监控告警机制建立:** 建议建立生产环境的实时监控和告警机制,提高系统运维效率;
2. **知识文档沉淀:** 建议将项目开发中的技术难点和解决方案整理成知识库,供团队学习和参考。
## 小结
1. **质量保障成效显著:** 通过本周的全面测试和系统修复Beta版本的质量得到大幅提升系统稳定性和可靠性达到发布标准
2. **技术问题深度解决:** 在Bug修复过程中不仅解决了表面问题还深入分析了根本原因避免了类似问题的再次发生
3. **团队协作高效顺畅:** 在测试、修复、集成的全过程中,与测试团队、前端团队和项目管理团队保持了高效沟通和协作;
4. **个人技术能力提升:** 通过解决复杂的技术问题,特别是在性能优化和系统架构方面的实践,个人技术能力得到了实质性提升;
5. **项目收尾工作扎实:** 认真完成了所有收尾工作,包括代码检查、文档编写和集成验证,为项目顺利交付奠定了坚实基础;
6. **职业素养培养:** 在测试和修复过程中,培养了严谨细致的工作态度和责任心;
7. **项目经验积累丰富:** 通过整个开发周期,积累了从需求分析到系统测试的完整项目经验,为未来的技术发展打下了良好基础。
---
## 【注】
1. 第十五周作为项目收尾周,个人任务已全部按时高质量完成,为项目圆满结束贡献了力量。

@ -1,8 +0,0 @@
# 默认忽略的文件
/shelf/
/workspace.xml
# 基于编辑器的 HTTP 客户端请求
/httpRequests/
# Datasource local storage ignored files
/dataSources/
/dataSources.local.xml

@ -1,16 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="CheckStyle-IDEA" serialisationVersion="2">
<checkstyleVersion>11.0.1</checkstyleVersion>
<scanScope>JavaOnly</scanScope>
<copyLibs>true</copyLibs>
<option name="thirdPartyClasspath" />
<option name="activeLocationIds" />
<option name="locations">
<list>
<ConfigurationLocation id="bundled-sun-checks" type="BUNDLED" scope="All" description="Sun Checks">(bundled)</ConfigurationLocation>
<ConfigurationLocation id="bundled-google-checks" type="BUNDLED" scope="All" description="Google Checks">(bundled)</ConfigurationLocation>
</list>
</option>
</component>
</project>

@ -1,21 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="CompilerConfiguration">
<annotationProcessing>
<profile name="Annotation profile for springboot_demo" enabled="true">
<sourceOutputDir name="target/generated-sources/annotations" />
<sourceTestOutputDir name="target/generated-test-sources/test-annotations" />
<outputRelativeToContentRoot value="true" />
<processorPath useClasspath="false">
<entry name="$MAVEN_REPOSITORY$/org/projectlombok/lombok/1.18.42/lombok-1.18.42.jar" />
</processorPath>
<module name="springboot_demo" />
</profile>
</annotationProcessing>
</component>
<component name="JavacSettings">
<option name="ADDITIONAL_OPTIONS_OVERRIDE">
<module name="springboot_demo" options="-parameters" />
</option>
</component>
</project>

@ -1,37 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="DataSourceManagerImpl" format="xml" multifile-model="true">
<data-source source="LOCAL" name="natural_language_query_system@localhost" uuid="b8d27d04-835f-4e42-bccb-3acb57e78840">
<driver-ref>mysql.8</driver-ref>
<synchronize>true</synchronize>
<imported>true</imported>
<remarks>$PROJECT_DIR$/test/src/main/resources/application.yml</remarks>
<jdbc-driver>com.mysql.cj.jdbc.Driver</jdbc-driver>
<jdbc-url>jdbc:mysql://localhost:3306/natural_language_query_system?useUnicode=true&amp;characterEncoding=utf8&amp;useSSL=false&amp;serverTimezone=Asia/Shanghai&amp;allowPublicKeyRetrieval=true</jdbc-url>
<jdbc-additional-properties>
<property name="com.intellij.clouds.kubernetes.db.host.port" />
<property name="com.intellij.clouds.kubernetes.db.enabled" value="false" />
<property name="com.intellij.clouds.kubernetes.db.container.port" />
</jdbc-additional-properties>
<working-dir>$ProjectFileDir$</working-dir>
</data-source>
<data-source source="LOCAL" name="natural_language_query_system@127.0.0.1" uuid="da4c9031-0352-480e-ad66-63e86248d59e">
<driver-ref>mongo</driver-ref>
<synchronize>true</synchronize>
<imported>true</imported>
<remarks>$PROJECT_DIR$/test/src/main/resources/application.yml</remarks>
<jdbc-driver>com.dbschema.MongoJdbcDriver</jdbc-driver>
<jdbc-url>mongodb://127.0.0.1:27017/natural_language_query_system</jdbc-url>
<working-dir>$ProjectFileDir$</working-dir>
</data-source>
<data-source source="LOCAL" name="0@localhost" uuid="945204ff-b09b-4daa-846b-6ab000c85369">
<driver-ref>redis</driver-ref>
<synchronize>true</synchronize>
<imported>true</imported>
<remarks>$PROJECT_DIR$/test/src/main/resources/application.yml</remarks>
<jdbc-driver>jdbc.RedisDriver</jdbc-driver>
<jdbc-url>jdbc:redis://localhost:6379/0</jdbc-url>
<working-dir>$ProjectFileDir$</working-dir>
</data-source>
</component>
</project>

@ -1,6 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="Encoding">
<file url="file://$PROJECT_DIR$/test/src/main/java" charset="UTF-8" />
</component>
</project>

@ -1,5 +0,0 @@
<component name="InspectionProjectProfileManager">
<settings>
<option name="PROJECT_PROFILE" />
</settings>
</component>

@ -1,20 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="RemoteRepositoriesConfiguration">
<remote-repository>
<option name="id" value="central" />
<option name="name" value="Maven Central repository" />
<option name="url" value="https://repo1.maven.org/maven2" />
</remote-repository>
<remote-repository>
<option name="id" value="jboss.community" />
<option name="name" value="JBoss Community repository" />
<option name="url" value="https://repository.jboss.org/nexus/content/repositories/public/" />
</remote-repository>
<remote-repository>
<option name="id" value="central" />
<option name="name" value="Central Repository" />
<option name="url" value="https://maven.aliyun.com/repository/public" />
</remote-repository>
</component>
</project>

@ -1,14 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="ExternalStorageConfigurationManager" enabled="true" />
<component name="MavenProjectsManager">
<option name="originalFiles">
<list>
<option value="$PROJECT_DIR$/test/pom.xml" />
</list>
</option>
</component>
<component name="ProjectRootManager" version="2" languageLevel="JDK_X" default="true" project-jdk-name="19.0" project-jdk-type="JavaSDK">
<output url="file://$PROJECT_DIR$/out" />
</component>
</project>

@ -1,8 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="ProjectModuleManager">
<modules>
<module fileurl="file://$PROJECT_DIR$/.idea/src.iml" filepath="$PROJECT_DIR$/.idea/src.iml" />
</modules>
</component>
</project>

@ -1,9 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<module type="JAVA_MODULE" version="4">
<component name="NewModuleRootManager" inherit-compiler-output="true">
<exclude-output />
<content url="file://$MODULE_DIR$" />
<orderEntry type="inheritedJdk" />
<orderEntry type="sourceFolder" forTests="false" />
</component>
</module>

@ -1,6 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="VcsDirectoryMappings">
<mapping directory="$PROJECT_DIR$/.." vcs="Git" />
</component>
</project>

@ -1,2 +1,536 @@
# Baoma
# 自然语言数据库查询系统 - 模块说明文档
## 项目概述
基于自然语言的数据库查询和展示系统支持用户通过自然语言描述查询需求系统自动调用大模型解析查询意图生成并执行SQL语句将查询结果以图表形式可视化展示。
### 核心功能
- **用户管理**:管理员可以管理和授权用户
- **权限控制**:授权的用户可以查询授权的数据库和表格
- **自然语言查询**:采用自然语言描述查询请求,系统调用大模型感知数据库元数据并解析用户查询请求
- **SQL生成与验证**采用SQL引擎生成和验证SQL语句测试通过后将查询的数据采用Chart图显示
- **多轮对话**用户可调整查询内容系统根据用户调整请求修改SQL语句重新查询和可视化查询结果
- **复杂查询支持**支持多表联合等复杂SQL语句查询
- **并发支持**支持至少5个及以上并发用户每个用户的任务在Docker容器独立运行
### 技术栈
- **后端框架**Spring Boot 2.x/3.x
- **开发语言**Java 21 (JDK 21)
- **关系型数据库**MySQL
- **非关系型数据库**MongoDB
- **ORM框架**MyBatis Plus
- **安全框架**Spring Security + JWT
- **容器化**Docker
- **实时通信**WebSocket
---
## 模块结构说明
### 1. 主应用入口 (`NaturalLanguageQueryApplication`)
**位置**`com.baoma.natural_language_query.NaturalLanguageQueryApplication`
**功能**Spring Boot 应用启动类,负责初始化应用程序上下文。
---
### 2. 控制器层 (`controller`)
**位置**`com.baoma.natural_language_query.controller`
**功能**处理HTTP请求提供RESTful API接口。
#### 核心控制器
- **`QueryController`**:自然语言查询接口,处理用户查询请求
- **`AuthController`**:用户认证接口,处理登录、注册、密码重置等
- **`UserController`**用户管理接口处理用户CRUD操作
- **`DbConnectionController`**:数据库连接管理接口
- **`TableMetadataController`**:表元数据管理接口
- **`ColumnMetadataController`**:字段元数据管理接口
- **`QueryLogController`**:查询日志管理接口
- **`QueryShareController`**:查询分享管理接口
- **`ChatWebSocketController`**WebSocket聊天控制器支持实时通信
- **`DialogController`**:对话记录管理接口
- **`DashboardController`**:仪表盘数据接口
- **`NotificationController`**:通知管理接口
- **`FriendRelationController`**:好友关系管理接口
- **`FriendChatController`**:好友聊天接口
- **`LLMConfigController`**:大模型配置管理接口
- **`SystemHealthController`**:系统健康检查接口
#### 其他控制器
- **`RoleController`**:角色管理
- **`UserDbPermissionController`**:用户数据库权限管理
- **`QueryCollectionController`**:查询收藏管理
- **`CollectionRecordController`**:收藏记录管理
- **`SqlCacheController`**SQL缓存管理
- **`ErrorLogController`**:错误日志管理
- **`OperationLogController`**:操作日志管理
- **`PerformanceMetricController`**:性能指标管理
- **`TokenConsumeController`**Token消费记录管理
- **`UserSearchController`**:用户搜索接口
---
### 3. 服务层 (`service`)
**位置**`com.baoma.natural_language_query.service`
**功能**:实现核心业务逻辑,提供业务服务接口和实现。
#### 核心服务
- **`QueryService`**:自然语言查询核心服务
- 调用大模型解析用户自然语言查询
- 感知数据库元数据(表结构、字段信息等)
- 生成并验证SQL语句
- 检查用户权限(表权限)
- 执行SQL查询数据库
- 将查询结果转换为表格数据和图表数据
- 保存对话记录和查询日志
- **`LLMService`**:大模型调用服务
- 调用大模型API传入用户自然语言查询和数据库结构信息
- 大模型根据用户意图和数据库结构生成SQL语句
- 解析大模型返回的结果提取SQL、表格数据、图表数据等
- **`AuthService`**:用户认证服务
- 用户登录认证
- JWT Token生成和验证
- 密码加密和验证
- 单点登录支持
- **`DatabaseSchemaService`**:数据库结构服务
- 获取数据库表结构信息
- 获取表字段元数据
- 数据库结构导出
- **`TablePermissionService`**:表权限服务
- 检查用户对表的访问权限
- 权限验证和过滤
#### 数据管理服务
- **`UserService`**:用户管理服务
- **`RoleService`**:角色管理服务
- **`DbConnectionService`**:数据库连接管理服务
- **`TableMetadataService`**:表元数据服务
- **`ColumnMetadataService`**:字段元数据服务
- **`UserDbPermissionService`**:用户数据库权限服务
#### 查询相关服务
- **`QueryLogService`**:查询日志服务
- **`QueryShareService`**:查询分享服务
- **`QueryCollectionService`**:查询收藏服务
- **`SqlCacheService`**SQL缓存服务
- **`DialogService`**:对话记录服务
- **`DialogDetailService`**:对话详情服务
- **`ConversationContextService`**:对话上下文服务
#### 社交功能服务
- **`FriendRelationService`**:好友关系服务
- **`FriendRequestService`**:好友请求服务
- **`FriendChatService`**:好友聊天服务
- **`NotificationService`**:通知服务
#### 系统管理服务
- **`LLMConfigService`**:大模型配置服务
- **`LLMStatusService`**:大模型状态服务
- **`SystemHealthService`**:系统健康检查服务
- **`PerformanceMetricService`**:性能指标服务
- **`ErrorLogService`**:错误日志服务
- **`OperationLogService`**:操作日志服务
- **`TokenConsumeService`**Token消费服务
- **`AiInteractionLogService`**AI交互日志服务
#### 其他服务
- **`EmailService`**:邮件发送服务
- **`TokenBlacklistService`**Token黑名单服务
- **`UserNotificationReadService`**:用户通知已读服务
- **`CollectionRecordService`**:收藏记录服务
- **`DbConnectionLogService`**:数据库连接日志服务
- **`DbTypeService`**:数据库类型服务
- **`ErrorTypeService`**:错误类型服务
- **`PriorityService`**:优先级服务
- **`DashboardService`**:仪表盘服务
---
### 4. 数据访问层
#### 4.1 Mapper层 (`mapper`)
**位置**`com.baoma.natural_language_query.mapper`
**功能**MyBatis Plus Mapper接口提供数据库CRUD操作。
**主要Mapper**
- `UserMapper`:用户数据访问
- `RoleMapper`:角色数据访问
- `DbConnectionMapper`:数据库连接数据访问
- `TableMetadataMapper`:表元数据访问
- `ColumnMetadataMapper`:字段元数据访问
- `QueryLogMapper`:查询日志访问
- `UserDbPermissionMapper`:用户数据库权限访问
- `QueryShareMapper`:查询分享访问
- `NotificationMapper`:通知数据访问
- `FriendRelationMapper`:好友关系访问
- `FriendRequestMapper`:好友请求访问
- `LLMConfigMapper`:大模型配置访问
- `SystemHealthMapper`:系统健康数据访问
- `PerformanceMetricMapper`:性能指标访问
- `ErrorLogMapper`:错误日志访问
- `OperationLogMapper`:操作日志访问
- `TokenConsumeMapper`Token消费记录访问
- 等其他Mapper接口
#### 4.2 Repository层 (`repository`)
**位置**`com.baoma.natural_language_query.repository`
**功能**MongoDB数据访问接口使用Spring Data MongoDB。
**主要Repository**
- `DialogRecordRepository`对话记录MongoDB访问
- `DialogDetailRepository`对话详情MongoDB访问
- `CollectionRecordRepository`收藏记录MongoDB访问
- `QueryCollectionRepository`查询收藏MongoDB访问
- `SqlCacheRepository`SQL缓存MongoDB访问
- `FriendChatRepository`好友聊天MongoDB访问
- `AiInteractionLogRepository`AI交互日志MongoDB访问
---
### 5. 实体类 (`entity`)
#### 5.1 MySQL实体 (`entity.mysql`)
**位置**`com.baoma.natural_language_query.entity.mysql`
**功能**MySQL数据库表对应的实体类使用MyBatis Plus注解。
**主要实体**
- `User`:用户实体
- `Role`:角色实体
- `DbConnection`:数据库连接实体
- `DbType`:数据库类型实体
- `TableMetadata`:表元数据实体
- `ColumnMetadata`:字段元数据实体
- `UserDbPermission`:用户数据库权限实体
- `QueryLog`:查询日志实体
- `QueryShare`:查询分享实体
- `DialogRecord`对话记录实体MySQL版本
- `Notification`:通知实体
- `FriendRelation`:好友关系实体
- `FriendRequest`:好友请求实体
- `LLMConfig`:大模型配置实体
- `LLMStatus`:大模型状态实体
- `SystemHealth`:系统健康实体
- `PerformanceMetric`:性能指标实体
- `ErrorLog`:错误日志实体
- `OperationLog`:操作日志实体
- `TokenConsume`Token消费记录实体
- `UserNotificationRead`:用户通知已读实体
- `UserSearch`:用户搜索实体
- `DbConnectionLog`:数据库连接日志实体
- `ErrorType`:错误类型实体
- `Priority`:优先级实体
#### 5.2 MongoDB实体 (`entity.mongodb`)
**位置**`com.baoma.natural_language_query.entity.mongodb`
**功能**MongoDB集合对应的实体类使用Spring Data MongoDB注解。
**主要实体**
- `DialogRecord`对话记录实体MongoDB版本
- `DialogDetail`:对话详情实体
- `CollectionRecord`:收藏记录实体
- `QueryCollection`:查询收藏实体
- `SqlCache`SQL缓存实体
- `FriendChat`:好友聊天实体
- `AiInteractionLog`AI交互日志实体
---
### 6. 数据传输对象 (`dto`)
**位置**`com.baoma.natural_language_query.dto`
**功能**数据传输对象用于Controller层接收前端请求参数。
**主要DTO**
- `LoginDTO`登录请求DTO
- `QueryRequestDTO`查询请求DTO
- `RecommendationRequestDTO`推荐请求DTO
- `ChangePasswordDTO`修改密码DTO
- `ResetPasswordDTO`重置密码DTO
- `ShareQueryDTO`分享查询DTO
- `SendChatMessageDTO`发送聊天消息DTO
- `SendFriendRequestDTO`发送好友请求DTO
- `QueryLogDTO`查询日志DTO
- `QueryCollectionDTO`查询收藏DTO
- `CollectionRecordDTO`收藏记录DTO
- `ChatMessagePageDTO`聊天消息分页DTO
---
### 7. 视图对象 (`vo`)
**位置**`com.baoma.natural_language_query.vo`
**功能**视图对象用于Controller层返回给前端的数据封装。
**主要VO**
- `QueryResponseVO`查询响应VO
- `LoginVO`登录响应VO
- 等其他VO对象
---
### 8. 工具类 (`utils`)
**位置**`com.baoma.natural_language_query.utils`
**功能**:提供各种工具方法和辅助功能。
**主要工具类**
- `JwtUtil`JWT Token工具类用于生成和解析Token
- `PermissionUtil`:权限工具类,用于权限检查和验证
- `SqlManager`SQL管理工具类用于SQL语句处理
- `SqlTableExtractor`SQL表提取工具类从SQL中提取表名
- `SqlSimilarityUtil`SQL相似度工具类用于SQL缓存匹配
- `DynamicDatabaseExecutor`动态数据库执行器用于执行动态SQL
- `DatabaseSchemaExporter`:数据库结构导出工具
- `PromptManager`:提示词管理工具类,管理大模型提示词模板
- `PromptMeta`:提示词元数据
- `PromptTemplateType`:提示词模板类型枚举
- `FollowupQuestionGenerator`:后续问题生成器
---
### 9. 配置类 (`config`)
**位置**`com.baoma.natural_language_query.config`
**功能**Spring Boot配置类配置各种组件和拦截器。
**主要配置类**
- `SecurityConfig`Spring Security安全配置
- `WebMvcConfig`Web MVC配置
- `CorsConfig`:跨域配置
- `JwtInterceptor`JWT拦截器用于Token验证
- `WebSocketConfig`WebSocket配置
- `WebSocketAuthInterceptor`WebSocket认证拦截器
- `WebSocketChannelInterceptor`WebSocket通道拦截器
- `WebSocketEventListener`WebSocket事件监听器
---
### 10. 切面 (`aspect`)
**位置**`com.baoma.natural_language_query.aspect`
**功能**AOP切面提供横切关注点功能。
**主要切面**
- `PermissionAspect`:权限切面,用于方法级别的权限控制
---
### 11. 注解 (`annotation`)
**位置**`com.baoma.natural_language_query.annotation`
**功能**:自定义注解,用于标记和配置。
**主要注解**
- `RequirePermission`:权限要求注解,标记需要权限验证的方法
---
### 12. 异常处理 (`exception`)
**位置**`com.baoma.natural_language_query.exception`
**功能**:异常定义和全局异常处理。
**主要类**
- `BusinessException`:业务异常类
- `GlobalExceptionHandler`:全局异常处理器
---
### 13. 枚举 (`enums`)
**位置**`com.baoma.natural_language_query.enums`
**功能**:枚举类型定义。
**主要枚举**
- `Role`:角色枚举
---
### 14. 通用类 (`common`)
**位置**`com.baoma.natural_language_query.common`
**功能**:通用响应类和工具类。
**主要类**
- `Result`:统一响应结果封装类
---
## 核心业务流程
### 1. 用户认证流程
```
用户登录 → AuthController.login()
→ AuthService.login()
→ Spring Security认证
→ 生成JWT Token
→ 返回Token和用户信息
```
### 2. 自然语言查询流程
```
用户输入自然语言查询 → QueryController.executeQuery()
→ QueryService.executeQuery()
→ 获取数据库元数据 (DatabaseSchemaService)
→ 调用大模型生成SQL (LLMService)
→ 提取SQL中的表名 (SqlTableExtractor)
→ 检查用户权限 (TablePermissionService)
→ 执行SQL查询 (DynamicDatabaseExecutor)
→ 转换查询结果为表格和图表数据
→ 保存对话记录到MongoDB (DialogService)
→ 记录查询日志 (QueryLogService)
→ 返回查询结果
```
### 3. 权限验证流程
```
请求到达 → JwtInterceptor拦截
→ 验证Token有效性
→ PermissionAspect切面
→ 检查用户权限 (PermissionUtil)
→ 执行目标方法或抛出权限异常
```
### 4. WebSocket实时通信流程
```
客户端连接WebSocket → WebSocketAuthInterceptor认证
→ WebSocketChannelInterceptor拦截
→ ChatWebSocketController处理消息
→ FriendChatService处理业务逻辑
→ 保存聊天记录到MongoDB
→ 推送消息给目标用户
```
---
## 数据库设计
### MySQL数据库关系型数据
存储用户、角色、权限、数据库连接、元数据、日志等结构化数据。
**主要表**
- `user`:用户表
- `role`:角色表
- `db_connection`:数据库连接表
- `table_metadata`:表元数据表
- `column_metadata`:字段元数据表
- `user_db_permission`:用户数据库权限表
- `query_log`:查询日志表
- `query_share`:查询分享表
- `notification`:通知表
- `friend_relation`:好友关系表
- `friend_request`:好友请求表
- `llm_config`:大模型配置表
- `system_health`:系统健康表
- `performance_metric`:性能指标表
- `error_log`:错误日志表
- `operation_log`:操作日志表
- `token_consume`Token消费记录表
### MongoDB数据库非关系型数据
存储对话记录、聊天记录、缓存等非结构化数据。
**主要集合**
- `dialog_record`:对话记录集合
- `dialog_detail`:对话详情集合
- `collection_record`:收藏记录集合
- `query_collection`:查询收藏集合
- `sql_cache`SQL缓存集合
- `friend_chat`:好友聊天集合
- `ai_interaction_log`AI交互日志集合
---
## 安全机制
1. **JWT认证**使用JWT Token进行用户认证Token包含用户ID和用户名
2. **权限控制**基于角色的访问控制RBAC支持表级别的权限控制
3. **密码加密**使用Spring Security的BCryptPasswordEncoder加密密码
4. **Token黑名单**支持Token失效和单点登录
5. **SQL注入防护**使用参数化查询和SQL验证
6. **跨域配置**配置CORS允许跨域请求
---
## 部署说明
1. **环境要求**
- JDK 21
- MySQL 8.0+
- MongoDB 4.0+
- Docker可选
2. **配置文件**
- `application.yml`应用配置文件包含数据库连接、Redis配置、大模型API配置等
3. **启动方式**
- 直接运行:`NaturalLanguageQueryApplication.main()`
- Maven命令`mvn spring-boot:run`
- Docker部署构建Docker镜像并运行容器
---
## 版本信息
- **版本**2.0
- **作者**:神奇宝码队
- **日期**2025
---
## 注意事项
1. 确保MySQL和MongoDB数据库已正确配置并启动
2. 配置大模型API密钥和端点地址
3. 根据实际需求配置Redis用于Token黑名单等
4. 生产环境建议配置HTTPS和安全策略
5. 定期备份数据库数据
---
## 联系方式
如有问题或建议,请联系开发团队。

@ -0,0 +1,14 @@
-- 为 query_logs 表添加 user_prompt 字段
-- 执行此脚本前请备份数据库
-- 添加 user_prompt 字段
ALTER TABLE `query_logs`
ADD COLUMN `user_prompt` TEXT COMMENT '用户原始提问(自然语言)' AFTER `user_id`;
-- 验证字段是否添加成功
-- SELECT COLUMN_NAME, DATA_TYPE, COLUMN_COMMENT
-- FROM INFORMATION_SCHEMA.COLUMNS
-- WHERE TABLE_SCHEMA = DATABASE()
-- AND TABLE_NAME = 'query_logs'
-- AND COLUMN_NAME = 'user_prompt';

@ -244,6 +244,30 @@ Content-Type: application/json
"password": "123456"
}
### 忘记密码 - 请求重置密码邮件
POST http://localhost:8173/api/auth/forgot-password
Content-Type: application/json
{
"email": "test@example.com"
}
### 忘记密码 - 测试邮箱格式验证(应该返回错误)
POST http://localhost:8173/api/auth/forgot-password
Content-Type: application/json
{
"email": "invalid-email"
}
### 忘记密码 - 测试空邮箱(应该返回错误)
POST http://localhost:8173/api/auth/forgot-password
Content-Type: application/json
{
"email": ""
}
### ==================== 查询执行接口 ====================
### 执行查询(新对话)

@ -0,0 +1,99 @@
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v3.5.7)
2026-01-06 21:58:51 [main] INFO c.b.n.NaturalLanguageQueryApplication - Starting NaturalLanguageQueryApplication v0.0.1-SNAPSHOT using Java 21.0.8 with PID 61764 (D:\nql\test\target\springboot_demo-0.0.1-SNAPSHOT.jar started by lyq20 in D:\nql\test)
2026-01-06 21:58:51 [main] INFO c.b.n.NaturalLanguageQueryApplication - No active profile set, falling back to 1 default profile: "default"
2026-01-06 21:59:01 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Multiple Spring Data modules found, entering strict repository configuration mode
2026-01-06 21:59:01 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Bootstrapping Spring Data MongoDB repositories in DEFAULT mode.
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Finished Spring Data repository scanning in 838 ms. Found 7 MongoDB repository interfaces.
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Multiple Spring Data modules found, entering strict repository configuration mode
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Bootstrapping Spring Data Redis repositories in DEFAULT mode.
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.AiInteractionLogRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.CollectionRecordRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.DialogDetailRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.DialogRecordRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.FriendChatRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.QueryCollectionRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationExtensionSupport - Spring Data Redis - Could not safely identify store assignment for repository candidate interface com.baoma.natural_language_query.repository.SqlCacheRepository; If you want this repository to be a Redis repository, consider annotating your entities with one of these annotations: org.springframework.data.redis.core.RedisHash (preferred), or consider extending one of the following types with your repository: org.springframework.data.keyvalue.repository.KeyValueRepository
2026-01-06 21:59:02 [main] INFO o.s.d.r.c.RepositoryConfigurationDelegate - Finished Spring Data repository scanning in 33 ms. Found 0 Redis repository interfaces.
2026-01-06 21:59:05 [main] INFO o.s.b.w.e.tomcat.TomcatWebServer - Tomcat initialized with port 8173 (http)
2026-01-06 21:59:05 [main] INFO o.a.catalina.core.StandardService - Starting service [Tomcat]
2026-01-06 21:59:05 [main] INFO o.a.catalina.core.StandardEngine - Starting Servlet engine: [Apache Tomcat/10.1.48]
2026-01-06 21:59:05 [main] INFO o.a.c.c.C.[Tomcat].[localhost].[/] - Initializing Spring embedded WebApplicationContext
2026-01-06 21:59:05 [main] INFO o.s.b.w.s.c.ServletWebServerApplicationContext - Root WebApplicationContext: initialization completed in 13277 ms
Logging initialized using 'class org.apache.ibatis.logging.stdout.StdOutImpl' adapter.
Get /10.68.18.12 network interface
Get network interface info: name:wireless_32768 (Intel(R) Wi-Fi 6E AX211 160MHz)
Initialization Sequence datacenterId:25 workerId:23
_ _ |_ _ _|_. ___ _ | _
| | |\/|_)(_| | |_\ |_)||_|_\
/ |
3.5.9
2026-01-06 21:59:16 [main] INFO org.mongodb.driver.cluster - Adding discovered server 192.168.1.145:8635 to client view of cluster
2026-01-06 21:59:16 [main] INFO org.mongodb.driver.cluster - Adding discovered server 192.168.1.9:8635 to client view of cluster
2026-01-06 21:59:16 [main] INFO org.mongodb.driver.client - MongoClient with metadata {"driver": {"name": "mongo-java-driver|sync|spring-boot", "version": "5.5.2"}, "os": {"type": "Windows", "name": "Windows 11", "architecture": "amd64", "version": "10.0"}, "platform": "Java/Oracle Corporation/21.0.8+12-LTS-250"} created with settings MongoClientSettings{readPreference=primary, writeConcern=WriteConcern{w=null, wTimeout=null ms, journal=null}, retryWrites=true, retryReads=true, readConcern=ReadConcern{level=null}, credential=MongoCredential{mechanism=null, userName='rwuser', source='admin', password=<hidden>, mechanismProperties=<hidden>}, transportSettings=null, commandListeners=[io.micrometer.core.instrument.binder.mongodb.MongoMetricsCommandListener@36f40d72], codecRegistry=ProvidersCodecRegistry{codecProviders=[ValueCodecProvider{}, BsonValueCodecProvider{}, DBRefCodecProvider{}, DBObjectCodecProvider{}, DocumentCodecProvider{}, CollectionCodecProvider{}, IterableCodecProvider{}, MapCodecProvider{}, GeoJsonCodecProvider{}, GridFSFileCodecProvider{}, Jsr310CodecProvider{}, JsonObjectCodecProvider{}, BsonCodecProvider{}, EnumCodecProvider{}, com.mongodb.client.model.mql.ExpressionCodecProvider@2c557eee, com.mongodb.Jep395RecordCodecProvider@7c47b0f8, com.mongodb.KotlinCodecProvider@2b561f51]}, loggerSettings=LoggerSettings{maxDocumentLength=1000}, clusterSettings={hosts=[192.168.1.145:8635, 192.168.1.9:8635], srvServiceName=mongodb, mode=MULTIPLE, requiredClusterType=REPLICA_SET, requiredReplicaSetName='replica', serverSelector='null', clusterListeners='[]', serverSelectionTimeout='30000 ms', localThreshold='15 ms'}, socketSettings=SocketSettings{connectTimeoutMS=10000, readTimeoutMS=0, receiveBufferSize=0, proxySettings=ProxySettings{host=null, port=null, username=null, password=null}}, heartbeatSocketSettings=SocketSettings{connectTimeoutMS=10000, readTimeoutMS=10000, receiveBufferSize=0, proxySettings=ProxySettings{host=null, port=null, username=null, password=null}}, connectionPoolSettings=ConnectionPoolSettings{maxSize=100, minSize=0, maxWaitTimeMS=120000, maxConnectionLifeTimeMS=0, maxConnectionIdleTimeMS=0, maintenanceInitialDelayMS=0, maintenanceFrequencyMS=60000, connectionPoolListeners=[io.micrometer.core.instrument.binder.mongodb.MongoMetricsConnectionPoolListener@3d5f08d4], maxConnecting=2}, serverSettings=ServerSettings{heartbeatFrequencyMS=10000, minHeartbeatFrequencyMS=500, serverMonitoringMode=AUTO, serverListeners='[]', serverMonitorListeners='[]'}, sslSettings=SslSettings{enabled=false, invalidHostNameAllowed=false, context=null}, applicationName='null', compressorList=[], uuidRepresentation=JAVA_LEGACY, serverApi=null, autoEncryptionSettings=null, dnsClient=null, inetAddressResolver=null, contextProvider=null, timeoutMS=null}
2026-01-06 21:59:18 [main] INFO o.s.s.c.a.a.c.InitializeAuthenticationProviderBeanManagerConfigurer$InitializeAuthenticationProviderManagerConfigurer - Global AuthenticationManager configured with AuthenticationProvider bean with name authenticationProvider
2026-01-06 21:59:18 [main] WARN o.s.s.c.a.a.c.InitializeUserDetailsBeanManagerConfigurer$InitializeUserDetailsManagerConfigurer - Global AuthenticationManager configured with an AuthenticationProvider bean. UserDetailsService beans will not be used by Spring Security for automatically configuring username/password login. Consider removing the AuthenticationProvider bean. Alternatively, consider using the UserDetailsService in a manually instantiated DaoAuthenticationProvider. If the current configuration is intentional, to turn off this warning, increase the logging level of 'org.springframework.security.config.annotation.authentication.configuration.InitializeUserDetailsBeanManagerConfigurer' to ERROR
2026-01-06 21:59:21 [cluster-ClusterId{value='695d1534762cb6c7f0adce88', description='null'}-192.168.1.9:8635] INFO org.mongodb.driver.cluster - Exception in monitor thread while connecting to server 192.168.1.9:8635
com.mongodb.MongoSocketReadException: Prematurely reached end of stream
at com.mongodb.internal.connection.SocketStream.read(SocketStream.java:184)
at com.mongodb.internal.connection.InternalStreamConnection.receiveResponseBuffers(InternalStreamConnection.java:824)
at com.mongodb.internal.connection.InternalStreamConnection.receiveCommandMessageResponse(InternalStreamConnection.java:517)
at com.mongodb.internal.connection.InternalStreamConnection.sendAndReceiveInternal(InternalStreamConnection.java:448)
at com.mongodb.internal.connection.InternalStreamConnection.lambda$sendAndReceive$0(InternalStreamConnection.java:375)
at com.mongodb.internal.connection.InternalStreamConnection.sendAndReceive(InternalStreamConnection.java:378)
at com.mongodb.internal.connection.CommandHelper.sendAndReceive(CommandHelper.java:100)
at com.mongodb.internal.connection.CommandHelper.executeCommand(CommandHelper.java:49)
at com.mongodb.internal.connection.InternalStreamConnectionInitializer.initializeConnectionDescription(InternalStreamConnectionInitializer.java:144)
at com.mongodb.internal.connection.InternalStreamConnectionInitializer.startHandshake(InternalStreamConnectionInitializer.java:79)
at com.mongodb.internal.connection.InternalStreamConnection.open(InternalStreamConnection.java:235)
at com.mongodb.internal.connection.DefaultServerMonitor$ServerMonitor.lookupServerDescription(DefaultServerMonitor.java:219)
at com.mongodb.internal.connection.DefaultServerMonitor$ServerMonitor.run(DefaultServerMonitor.java:176)
2026-01-06 21:59:21 [cluster-ClusterId{value='695d1534762cb6c7f0adce88', description='null'}-192.168.1.145:8635] INFO org.mongodb.driver.cluster - Exception in monitor thread while connecting to server 192.168.1.145:8635
com.mongodb.MongoSocketReadException: Prematurely reached end of stream
at com.mongodb.internal.connection.SocketStream.read(SocketStream.java:184)
at com.mongodb.internal.connection.InternalStreamConnection.receiveResponseBuffers(InternalStreamConnection.java:824)
at com.mongodb.internal.connection.InternalStreamConnection.receiveCommandMessageResponse(InternalStreamConnection.java:517)
at com.mongodb.internal.connection.InternalStreamConnection.sendAndReceiveInternal(InternalStreamConnection.java:448)
at com.mongodb.internal.connection.InternalStreamConnection.lambda$sendAndReceive$0(InternalStreamConnection.java:375)
at com.mongodb.internal.connection.InternalStreamConnection.sendAndReceive(InternalStreamConnection.java:378)
at com.mongodb.internal.connection.CommandHelper.sendAndReceive(CommandHelper.java:100)
at com.mongodb.internal.connection.CommandHelper.executeCommand(CommandHelper.java:49)
at com.mongodb.internal.connection.InternalStreamConnectionInitializer.initializeConnectionDescription(InternalStreamConnectionInitializer.java:144)
at com.mongodb.internal.connection.InternalStreamConnectionInitializer.startHandshake(InternalStreamConnectionInitializer.java:79)
at com.mongodb.internal.connection.InternalStreamConnection.open(InternalStreamConnection.java:235)
at com.mongodb.internal.connection.DefaultServerMonitor$ServerMonitor.lookupServerDescription(DefaultServerMonitor.java:219)
at com.mongodb.internal.connection.DefaultServerMonitor$ServerMonitor.run(DefaultServerMonitor.java:176)
2026-01-06 21:59:27 [main] INFO o.s.b.a.e.web.EndpointLinksResolver - Exposing 2 endpoints beneath base path '/actuator'
2026-01-06 21:59:30 [main] INFO o.s.m.s.b.SimpleBrokerMessageHandler - Starting...
2026-01-06 21:59:30 [main] INFO o.s.m.s.b.SimpleBrokerMessageHandler - BrokerAvailabilityEvent[available=true, SimpleBrokerMessageHandler [org.springframework.messaging.simp.broker.DefaultSubscriptionRegistry@298cfe89]]
2026-01-06 21:59:30 [main] INFO o.s.m.s.b.SimpleBrokerMessageHandler - Started.
2026-01-06 21:59:30 [main] INFO o.s.b.w.e.tomcat.TomcatWebServer - Tomcat started on port 8173 (http) with context path '/'
2026-01-06 21:59:30 [main] INFO c.b.n.NaturalLanguageQueryApplication - Started NaturalLanguageQueryApplication in 44.468 seconds (process running for 47.561)
2026-01-06 22:00:30 [MessageBroker-1] INFO o.s.w.s.c.WebSocketMessageBrokerStats - WebSocketSession[0 current WS(0)-HttpStream(0)-HttpPoll(0), 0 total, 0 closed abnormally (0 connect failure, 0 send limit, 0 transport error)], stompSubProtocol[processed CONNECT(0)-CONNECTED(0)-DISCONNECT(0)], stompBrokerRelay[null], inboundChannel[pool size = 0, active threads = 0, queued tasks = 0, completed tasks = 0], outboundChannel[pool size = 0, active threads = 0, queued tasks = 0, completed tasks = 0], sockJsScheduler[pool size = 1, active threads = 1, queued tasks = 0, completed tasks = 0]
2026-01-06 22:04:04 [http-nio-8173-exec-2] INFO o.a.c.c.C.[Tomcat].[localhost].[/] - Initializing Spring DispatcherServlet 'dispatcherServlet'
2026-01-06 22:04:04 [http-nio-8173-exec-2] INFO o.s.web.servlet.DispatcherServlet - Initializing Servlet 'dispatcherServlet'
2026-01-06 22:04:04 [http-nio-8173-exec-2] INFO o.s.web.servlet.DispatcherServlet - Completed initialization in 6 ms
Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@4941b3f] was not registered for synchronization because synchronization is not active
2026-01-06 22:04:05 [http-nio-8173-exec-2] INFO com.zaxxer.hikari.HikariDataSource - HikariPool-1 - Starting...
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@4941b3f]
Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@576ce206] was not registered for synchronization because synchronization is not active
2026-01-06 22:04:30 [http-nio-8173-exec-3] INFO com.zaxxer.hikari.HikariDataSource - HikariPool-1 - Starting...
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@576ce206]
Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@4bac96f2] was not registered for synchronization because synchronization is not active
2026-01-06 22:05:15 [http-nio-8173-exec-4] INFO com.zaxxer.hikari.HikariDataSource - HikariPool-1 - Starting...
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@4bac96f2]
Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@e21ddb9] was not registered for synchronization because synchronization is not active
2026-01-06 22:05:33 [http-nio-8173-exec-5] INFO com.zaxxer.hikari.HikariDataSource - HikariPool-1 - Starting...
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@e21ddb9]

@ -0,0 +1,160 @@
-- ====================================
-- 中文电影数据库测试脚本 (V2 - 增加覆盖逻辑)
-- ====================================
-- 创建数据库
CREATE DATABASE IF NOT EXISTS chinese_movies DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE chinese_movies;
-- 1. 禁用外键检查(方便删除有外键关联的表)
SET FOREIGN_KEY_CHECKS = 0;
-- 2. 删除已存在的表
DROP TABLE IF EXISTS viewing_records;
DROP TABLE IF EXISTS cinemas;
DROP TABLE IF EXISTS movie_actors;
DROP TABLE IF EXISTS actors;
DROP TABLE IF EXISTS movies;
-- 3. 启用外键检查
SET FOREIGN_KEY_CHECKS = 1;
-- 电影表
CREATE TABLE movies (
id INT AUTO_INCREMENT PRIMARY KEY,
title VARCHAR(200) NOT NULL COMMENT '电影标题',
director VARCHAR(100) NOT NULL COMMENT '导演',
release_year INT NOT NULL COMMENT '上映年份',
genre VARCHAR(50) COMMENT '类型',
rating DECIMAL(3, 1) COMMENT '评分',
box_office BIGINT COMMENT '票房(单位:万元)',
description TEXT COMMENT '简介',
country VARCHAR(50) DEFAULT '中国' COMMENT '制片国家/地区',
duration INT COMMENT '片长(分钟)',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 演员表
CREATE TABLE actors (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(100) NOT NULL COMMENT '姓名',
birth_year INT COMMENT '出生年份',
gender ENUM('', '', '其他') COMMENT '性别',
nationality VARCHAR(50) DEFAULT '中国' COMMENT '国籍',
famous_works TEXT COMMENT '代表作',
awards_count INT DEFAULT 0 COMMENT '获奖次数',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 电影演员关联表
CREATE TABLE movie_actors (
id INT AUTO_INCREMENT PRIMARY KEY,
movie_id INT NOT NULL,
actor_id INT NOT NULL,
role VARCHAR(100) COMMENT '角色名',
is_lead BOOLEAN DEFAULT FALSE COMMENT '是否主演',
FOREIGN KEY (movie_id) REFERENCES movies(id) ON DELETE CASCADE,
FOREIGN KEY (actor_id) REFERENCES actors(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 影院表
CREATE TABLE cinemas (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(200) NOT NULL COMMENT '影院名称',
city VARCHAR(50) NOT NULL COMMENT '城市',
district VARCHAR(50) COMMENT '区域',
address TEXT COMMENT '详细地址',
screen_count INT DEFAULT 0 COMMENT '影厅数量',
seat_capacity INT DEFAULT 0 COMMENT '座位总数',
rating DECIMAL(2, 1) COMMENT '影院评分',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 观影记录表
CREATE TABLE viewing_records (
id INT AUTO_INCREMENT PRIMARY KEY,
movie_id INT NOT NULL,
cinema_id INT NOT NULL,
view_date DATE NOT NULL COMMENT '观影日期',
viewer_count INT DEFAULT 1 COMMENT '观影人数',
ticket_price DECIMAL(6, 2) COMMENT '票价(元)',
user_rating INT COMMENT '用户评分1-10',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (movie_id) REFERENCES movies(id) ON DELETE CASCADE,
FOREIGN KEY (cinema_id) REFERENCES cinemas(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 插入电影数据
INSERT INTO movies (title, director, release_year, genre, rating, box_office, description, duration) VALUES
('流浪地球', '郭帆', 2019, '科幻', 7.9, 468700, '太阳即将毁灭,人类在地球表面建造出巨大的推进器,寻找新家园。', 125),
('战狼2', '吴京', 2017, '动作', 7.2, 567000, '冷锋被卷入了一场非洲国家的叛乱,本可以安全撤离,却孤身犯险冲回沦陷区,带领身陷屠杀中的同胞和难民展开生死逃亡。', 123),
('哪吒之魔童降世', '饺子', 2019, '动画', 8.5, 501700, '"我命由我不由天",是魔是仙,全在自己。', 110),
('长津湖', '陈凯歌/徐克/林超贤', 2021, '战争', 7.4, 577900, '抗美援朝,长津湖战役,志愿军战士在极寒天气下顽强战斗。', 176),
('你好,李焕英', '贾玲', 2021, '喜剧', 8.1, 541300, '2001年的某一天刚刚考上大学的女孩贾晓玲经历了人生中的一次大起大落。', 128),
('满江红', '张艺谋', 2023, '悬疑', 7.5, 454400, '南宋绍兴年间,岳飞死后四年,秦桧率兵与金国会谈。', 159),
('红海行动', '林超贤', 2018, '战争', 8.3, 365100, '中国海军"蛟龙突击队"8人小组奉命执行撤侨任务。', 138),
('唐人街探案3', '陈思诚', 2021, '喜剧', 5.6, 451200, '唐人街神探唐仁、秦风受侦探野田昊邀请前往东京,帮助当地警方破案。', 136),
('流浪地球2', '郭帆', 2023, '科幻', 8.3, 404300, '太阳危机即将来临,世界陷入一片恐慌之中,人类建造巨型发动机推动地球逃离太阳系。', 173),
('我和我的祖国', '陈凯歌/张一白/管虎/薛晓路/徐峥/宁浩/文牧野', 2019, '剧情', 8.0, 319700, '7位导演分别取材新中国成立70周年以来祖国经历的无数个历史性经典瞬间。', 158);
-- 插入演员数据
INSERT INTO actors (name, birth_year, gender, nationality, famous_works, awards_count) VALUES
('吴京', 1974, '', '中国', '战狼系列、流浪地球系列', 15),
('屈楚萧', 1991, '', '中国', '流浪地球系列', 3),
('李光洁', 1981, '', '中国', '流浪地球系列、走向共和', 8),
('饺子', 1980, '', '中国', '哪吒之魔童降世、打,打个大西瓜', 12),
('贾玲', 1982, '', '中国', '你好,李焕英、热辣滚烫', 5),
('沈腾', 1979, '', '中国', '夏洛特烦恼、西虹市首富', 18),
('张译', 1978, '', '中国', '长津湖、八佰', 22),
('朱一龙', 1988, '', '中国', '人生大事、峰爆', 9),
('易烊千玺', 2000, '', '中国', '长津湖、送你一朵小红花', 14),
('刘德华', 1961, '', '中国香港', '无间道、流浪地球2', 85),
('王宝强', 1984, '', '中国', '唐人街探案系列、人在囧途', 11),
('刘昊然', 1997, '', '中国', '唐人街探案系列、九州缥缈录', 7);
-- 插入电影演员关联
INSERT INTO movie_actors (movie_id, actor_id, role, is_lead) VALUES
(1, 1, '刘培强', TRUE),
(1, 2, '刘启', TRUE),
(1, 3, '李一一', FALSE),
(2, 1, '冷锋', TRUE),
(5, 5, '贾晓玲', TRUE),
(4, 7, '伍千里', TRUE),
(4, 9, '伍万里', TRUE),
(9, 1, '刘培强', TRUE),
(9, 10, '周喆直', TRUE),
(8, 11, '唐仁', TRUE),
(8, 12, '秦风', TRUE);
-- 插入影院数据
INSERT INTO cinemas (name, city, district, address, screen_count, seat_capacity, rating) VALUES
('万达影城CBD店', '北京', '朝阳区', '建国路万达广场3层', 12, 1800, 9.2),
('CGV影城正大广场店', '上海', '浦东新区', '陆家嘴西路168号正大广场8楼', 10, 1500, 9.0),
('金逸影城(天河城店)', '广州', '天河区', '天河路208号天河城商场9楼', 8, 1200, 8.8),
('星美国际影城(海岸城店)', '深圳', '南山区', '文心五路33号海岸城购物中心东区4楼', 11, 1650, 9.1),
('保利国际影城(天府店)', '成都', '武侯区', '天府二街999号伊藤洋华堂5楼', 9, 1350, 8.9),
('横店电影城(西湖店)', '杭州', '西湖区', '延安路98号银泰百货7-8楼', 7, 1050, 8.7),
('大地影院(奥体中心店)', '南京', '建邺区', '江东中路222号奥体中心4楼', 10, 1500, 9.0),
('UME国际影城苏州中心店', '苏州', '工业园区', '钟园路99号苏州中心4楼', 13, 1950, 9.3),
('万达影城(泉城路店)', '济南', '历下区', '泉城路180号万达广场3楼', 8, 1200, 8.6),
('太平洋影城(中山路店)', '青岛', '市南区', '中山路10号100码头3楼', 9, 1350, 8.8);
-- 插入观影记录
INSERT INTO viewing_records (movie_id, cinema_id, view_date, viewer_count, ticket_price, user_rating) VALUES
(1, 1, '2019-02-08', 285, 55.00, 8),
(1, 2, '2019-02-10', 310, 58.00, 9),
(1, 3, '2019-02-12', 245, 52.00, 7),
(2, 4, '2017-08-05', 295, 45.00, 8),
(2, 5, '2017-08-06', 270, 48.00, 7),
(3, 1, '2019-07-28', 320, 50.00, 10),
(3, 6, '2019-07-30', 290, 48.00, 9),
(4, 2, '2021-10-02', 350, 60.00, 8),
(4, 7, '2021-10-03', 330, 58.00, 7),
(5, 3, '2021-02-14', 310, 55.00, 9),
(5, 8, '2021-02-15', 295, 52.00, 8),
(6, 4, '2023-01-25', 280, 60.00, 8),
(7, 5, '2018-02-18', 265, 50.00, 9),
(8, 9, '2021-02-13', 340, 58.00, 6),
(9, 10, '2023-01-28', 315, 62.00, 9),
(10, 1, '2019-10-02', 305, 55.00, 8);

@ -11,10 +11,12 @@ services:
MYSQL_PASSWORD: nlq_pass123
TZ: Asia/Shanghai
ports:
- "3306:3306"
- "3307:3306"
volumes:
# 挂载初始化脚本MySQL会自动执行/docker-entrypoint-initdb.d/目录下的.sql文件
- ./mysql_schema_from_last.sql:/docker-entrypoint-initdb.d/init.sql
# 挂载初始化脚本MySQL会自动执行/docker-entrypoint-initdb.d/目录下的.sql文件按字母顺序执行
- ./mysql_schema_from_last.sql:/docker-entrypoint-initdb.d/01-init.sql
- ./sakila-schema.sql:/docker-entrypoint-initdb.d/02-sakila-schema.sql
- ./sakila-data.sql:/docker-entrypoint-initdb.d/03-sakila-data.sql
# 数据持久化
- mysql_data:/var/lib/mysql
command:

@ -0,0 +1,8 @@
[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts,vue,css,scss,sass,less,styl}]
charset = utf-8
indent_size = 2
indent_style = space
insert_final_newline = true
trim_trailing_whitespace = true
end_of_line = lf
max_line_length = 100

@ -0,0 +1,96 @@
/**
* @fileoverview ESLint configuration for Vue 3 + TypeScript
* Follows Google Style Guide, with necessary overrides for Vue/TS.
* * Google 规范要求4空格缩进必须使用分号
* Vue/TS 社区惯例2空格缩进可选分号
* * 此配置在继承 Google 规范的基础上强制使用 2空格缩进和不使用分号
* 以便更好地适应现代前端开发环境
*/
module.exports = {
// 指定环境
'env': {
'browser': true,
'es2021': true,
'node': true
},
// 指定解析器
'parser': 'vue-eslint-parser',
'parserOptions': {
// 解析 <script> 块中的代码
'parser': '@typescript-eslint/parser',
'ecmaVersion': 'latest',
'sourceType': 'module',
'project': './tsconfig.json', // 引用您的 TypeScript 配置文件
'extraFileExtensions': ['.vue']
},
// 继承配置:这是核心!
'extends': [
// 1. Vue 3 推荐规则
'plugin:vue/vue3-recommended',
// 2. Google 编码规范 (必须在 Vue 规则之后,以便覆盖 Vue 的默认规则)
'google',
// 3. TypeScript 推荐规则
'plugin:@typescript-eslint/recommended',
// 4. Prettier (如果使用 Prettier 来处理格式化,放在最后以避免冲突)
'prettier'
],
// 规则覆盖和自定义
'rules': {
// ------------------------------------------------
// 强制覆盖 Google 规范的规则 (以适应 Vue/TS 社区惯例)
// ------------------------------------------------
// 1. 缩进Google 默认 4 空格,这里强制使用 2 空格
// Vue 模板的缩进也需要通过 'plugin:vue/vue3-recommended' 进行配置
'indent': ['error', 2, {
'SwitchCase': 1,
// 允许 Vue 模板中的表达式换行
'FunctionExpression': { 'parameters': 'first' },
'CallExpression': { 'arguments': 'first' },
'ArrayExpression': 'first',
'ObjectExpression': 'first'
}],
// 2. 分号Google 默认必须有分号,这里强制不使用分号 (现代JS风格)
'semi': ['error', 'never'],
// 3. 引号Google 默认单引号,这里保持单引号
'quotes': ['error', 'single'],
// 4. 最大行长Google 默认 100这里放宽到 120 (以适应现代宽屏)
'max-len': ['error', {
'code': 120,
'ignoreUrls': true,
'ignoreStrings': true,
'ignoreTemplateLiterals': true
}],
// ------------------------------------------------
// 针对 Vue 组件和 TypeScript 的规则
// ------------------------------------------------
// 禁用 TypeScript 的 `no-var-requires`,在某些 node 环境中可能需要 require
'@typescript-eslint/no-var-requires': 'off',
// 允许使用 any但在迁移阶段有用 (完成后建议设为 'error')
'@typescript-eslint/no-explicit-any': 'off',
// Vue 组件名必须是 PascalCase (例如: MyComponent)
'vue/component-name-in-template-casing': ['error', 'PascalCase', {
'registeredComponentsOnly': false
}],
// Vue 属性排序规则
'vue/attributes-order': 'error',
'vue/html-self-closing': ['error', {
'html': {
'void': 'always',
'normal': 'always',
'component': 'always'
}
}]
}
};

@ -0,0 +1 @@
* text=auto eol=lf

@ -8,17 +8,29 @@ pnpm-debug.log*
lerna-debug.log*
node_modules
.DS_Store
dist
dist-ssr
coverage
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?
*.tsbuildinfo
.eslintcache
# Cypress
/cypress/videos/
/cypress/screenshots/
# Vitest
__screenshots__/

@ -0,0 +1,6 @@
{
"$schema": "https://json.schemastore.org/prettierrc",
"semi": false,
"singleQuote": true,
"printWidth": 100
}

@ -0,0 +1,40 @@
import { globalIgnores } from 'eslint/config'
import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
import pluginVue from 'eslint-plugin-vue'
import pluginVitest from '@vitest/eslint-plugin'
import skipFormatting from '@vue/eslint-config-prettier/skip-formatting'
// To allow more languages other than `ts` in `.vue` files, uncomment the following lines:
// import { configureVueProject } from '@vue/eslint-config-typescript'
// configureVueProject({ scriptLangs: ['ts', 'tsx'] })
// More info at https://github.com/vuejs/eslint-config-typescript/#advanced-setup
export default defineConfigWithVueTs(
{
name: 'app/files-to-lint',
files: ['**/*.{ts,mts,tsx,vue}'],
},
globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
pluginVue.configs['flat/essential'],
vueTsConfigs.recommended,
{
...pluginVitest.configs.recommended,
files: ['src/**/__tests__/*'],
},
// 自定义规则
{
rules: {
// 忽略以下划线开头的未使用变量(用于占位参数)
'@typescript-eslint/no-unused-vars': ['error', {
argsIgnorePattern: '^_',
varsIgnorePattern: '^_',
}],
},
},
skipFormatting,
)

@ -0,0 +1,46 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>自然语言数据库查询系统</title>
<!-- Font Awesome CDN临时方案避免 Tracking Prevention 问题) -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous" referrerpolicy="no-referrer">
<!-- Tailwind CSS CDN临时恢复确保界面样式正常 -->
<script src="https://cdn.tailwindcss.com"></script>
<!-- 配置自定义主题 -->
<script>
tailwind.config = {
darkMode: 'class',
theme: {
extend: {
colors: {
primary: '#165DFF',
secondary: '#36BFFA',
neutral: '#F5F7FA',
dark: '#1D2129',
success: '#00B42A',
warning: '#FF7D00',
danger: '#F53F3F',
},
fontFamily: {
inter: ['Inter', 'sans-serif'],
}
}
}
}
</script>
<!-- 自定义 CSS -->
<link rel="stylesheet" href="/index.css">
<!-- Polyfill for sockjs-client: 定义 global 变量 -->
<script>
if (typeof global === 'undefined') {
var global = globalThis;
}
</script>
</head>
<body class="bg-neutral font-inter text-dark min-h-screen">
<div id="root"></div>
<script type="module" src="/src/main.ts"></script>
</body>
</html>

File diff suppressed because it is too large Load Diff

@ -0,0 +1,58 @@
{
"name": "frontend",
"version": "0.0.0",
"private": true,
"type": "module",
"engines": {
"node": "^20.19.0 || >=22.12.0"
},
"scripts": {
"dev": "vite",
"build": "run-p type-check \"build-only {@}\" --",
"preview": "vite preview",
"test:unit": "vitest",
"build-only": "vite build",
"type-check": "vue-tsc --build",
"lint": "eslint . --fix --cache",
"format": "prettier --write --experimental-cli src/"
},
"dependencies": {
"@fortawesome/fontawesome-free": "^7.1.0",
"@stomp/stompjs": "^7.2.1",
"chart.js": "^4.5.1",
"pinia": "^3.0.4",
"sockjs-client": "^1.6.1",
"vue": "^3.5.25",
"vue-chartjs": "^5.3.3",
"vue-router": "^4.6.3"
},
"devDependencies": {
"@tailwindcss/postcss": "^4.1.18",
"@tsconfig/node24": "^24.0.3",
"@types/chart.js": "^2.9.41",
"@types/jsdom": "^27.0.0",
"@types/node": "^24.10.1",
"@vitejs/plugin-vue": "^6.0.2",
"@vitest/eslint-plugin": "^1.5.0",
"@vue/eslint-config-prettier": "^10.2.0",
"@vue/eslint-config-typescript": "^14.6.0",
"@vue/test-utils": "^2.4.6",
"@vue/tsconfig": "^0.8.1",
"autoprefixer": "^10.4.22",
"eslint": "^9.39.1",
"eslint-config-google": "^0.14.0",
"eslint-plugin-jsdoc": "^61.5.0",
"eslint-plugin-vue": "~10.5.1",
"jiti": "^2.6.1",
"jsdom": "^27.2.0",
"npm-run-all2": "^8.0.4",
"postcss": "^8.5.6",
"prettier": "3.6.2",
"tailwindcss": "^4.1.18",
"typescript": "~5.9.0",
"vite": "^7.2.4",
"vite-plugin-vue-devtools": "^8.0.5",
"vitest": "^4.0.14",
"vue-tsc": "^3.1.5"
}
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

@ -0,0 +1,544 @@
<!--
@file App.vue
@description 应用程序根组件
===== 核心职责 =====
1. 根据用户角色渲染对应的 MainLayout 和页面组件
2. 管理全局状态用户信息角色页面路由
3. 处理页面导航和事件转发不处理具体业务逻辑
===== 架构设计原则 =====
- App.vue 只负责路由和状态管理不包含具体页面逻辑
- 具体页面逻辑在各自的 Page 组件中UserPageDataAdminPageSysAdminPage
- QueryPage 的状态管理已移至 QueryPage.vue 内部
- MainLayout 负责布局侧边栏TopHeader内容区域
===== 用户角色与页面映射 =====
- sys-admin: 系统管理员
* 页面dashboard, user-management, system-log, llm-config, notification-management, account, settings
* 无查询功能无历史面板
- data-admin: 数据管理员
* 页面dashboard, query, history, datasource, user-permission, notification-management,
connection-log, notifications, account, friends, settings
* 有查询功能有历史面板
- normal-user: 普通用户
* 页面query, history, notifications, friends, account, settings
* 有查询功能有历史面板
===== 状态管理说明 =====
- userRole: 当前用户角色null 表示未登录
- currentUser: 当前用户基本信息name, avatarUrl
- activePage: 普通用户的当前页面Page 类型
- activeSysAdminPage: 系统管理员的当前页面SysAdminPageType 类型
- activeDataAdminPage: 数据管理员的当前页面DataAdminPageType 类型
- queryPageTitle: 查询页面的动态标题 QueryPage 通过事件更新
===== 事件流转说明 =====
1. 登录LoginPage @login -> handleLogin -> loadUserInfo
2. 页面切换Sidebar @update:active-page -> setActivePage/setActiveSysAdminPage/setActiveDataAdminPage
3. 查询标题更新QueryPage @update:title -> handleUpdateQueryTitle -> queryPageTitle
4. 通知点击TopHeader @notification-click -> handleNotificationClick -> 切换到 notifications 页面
5. 头像点击TopHeader @avatar-click -> handleAvatarClick -> 切换到 account 页面
6. 新对话TopHeader @new-conversation -> handleNewConversation -> 切换到 query 页面
7. 历史面板TopHeader @toggle-history -> handleToggleHistory -> 转发到 QueryPage空实现逻辑在子组件
@author Frontend Team
@since 1.0.0
-->
<template>
<!-- 未登录状态 - 登录页面 -->
<LoginPage v-if="!userRole" @login="handleLogin" />
<!-- 退出登录确认弹窗 -->
<div
v-if="showLogoutConfirm"
class="fixed inset-0 bg-black/50 flex items-center justify-center z-[9999]"
@click="showLogoutConfirm = false"
>
<div
class="bg-white rounded-xl shadow-xl w-full max-w-md p-6 mx-4"
@click.stop
>
<h3 class="text-xl font-bold mb-4">确认退出</h3>
<p class="text-gray-600 mb-6">确定要退出登录吗</p>
<div class="flex justify-end space-x-3">
<button
@click="showLogoutConfirm = false"
class="px-6 py-2 border border-gray-300 rounded-lg hover:bg-gray-50 transition-colors"
>
取消
</button>
<button
@click="confirmLogout"
class="px-6 py-2 bg-red-500 text-white rounded-lg hover:bg-red-600 transition-colors"
>
退出登录
</button>
</div>
</div>
</div>
<!-- 系统管理员页面 -->
<MainLayout
v-else-if="userRole === 'sys-admin'"
:user-role="userRole"
:current-user="currentUser"
:active-page="activeSysAdminPage"
:header-title="headerTitle"
:is-query-page="false"
@update:active-page="setActiveSysAdminPage"
@logout="handleLogout"
@notification-click="handleNotificationClick"
@avatar-click="handleAvatarClick"
>
<SysAdminPage :active-page="activeSysAdminPage" @update:active-page="setActiveSysAdminPage" />
</MainLayout>
<!-- 数据管理员页面 -->
<MainLayout
v-else-if="userRole === 'data-admin'"
:user-role="userRole"
:current-user="currentUser"
:active-page="activeDataAdminPage"
:header-title="headerTitle"
:is-query-page="activeDataAdminPage === 'query'"
@update:active-page="setActiveDataAdminPage"
@logout="handleLogout"
@notification-click="handleNotificationClick"
@avatar-click="handleAvatarClick"
@toggle-history="handleToggleHistory"
@new-conversation="handleNewConversation"
@update:query-title="handleUpdateQueryTitle"
>
<DataAdminPage
ref="dataAdminPageRef"
:active-page="activeDataAdminPage"
:set-active-page="setActiveDataAdminPage"
@update:query-title="handleUpdateQueryTitle"
@switch-to-query="activeDataAdminPage = 'query'"
/>
</MainLayout>
<!-- 普通用户页面 -->
<MainLayout
v-else-if="userRole === 'normal-user'"
:user-role="userRole"
:current-user="currentUser"
:active-page="activePage"
:header-title="headerTitle"
:is-query-page="activePage === 'query'"
@update:active-page="setActivePage"
@logout="handleLogout"
@notification-click="handleNotificationClick"
@avatar-click="handleAvatarClick"
@toggle-history="handleToggleHistory"
@new-conversation="handleNewConversation"
@update:query-title="handleUpdateQueryTitle"
>
<UserPage
ref="userPageRef"
:active-page="activePage"
@update:query-title="handleUpdateQueryTitle"
@switch-to-query="activePage = 'query'"
/>
</MainLayout>
</template>
<script setup lang="ts">
import { ref, computed, onMounted, onUnmounted } from 'vue'
import {
type UserRole,
type Page,
type SysAdminPageType,
type DataAdminPageType,
} from './types'
//
import LoginPage from './views/LoginPage.vue'
import UserPage from './views/UserPage.vue'
import SysAdminPage from './views/admin/SysAdminPage.vue'
import DataAdminPage from './views/DataAdminPage.vue'
import MainLayout from './components/layout/MainLayout.vue'
// API
import { userApi } from './services/api.real'
import { authApi } from './services/api/auth'
/**
* 侧边栏页面名称映射用于显示 TopHeader 标题
*
* 逻辑说明
* - 查询页面query不使用此函数使用 queryPageTitle
* - 其他页面根据角色和页面 key 返回对应的中文名称
* - 如果找不到对应页面返回空字符串
*/
const getSidebarPageName = (role: UserRole | null, page: string) => {
const normalUserPages: Record<string, string> = {
history: '收藏夹',
notifications: '通知中心',
friends: '好友管理',
account: '账户管理',
settings: '设置',
}
const dataAdminPages: Record<string, string> = {
history: '收藏夹',
datasource: '数据源管理',
dashboard: '数据源概览',
'user-permission': '用户权限管理',
'notification-management': '通知管理(数据员)',
'connection-log': '数据源连接日志',
notifications: '通知中心',
account: '我的账户',
friends: '好友管理',
settings: '设置',
}
const sysAdminPages: Record<string, string> = {
dashboard: '系统概览',
'user-management': '用户管理',
account: '我的账户',
'system-log': '系统日志',
'llm-config': '大模型配置',
'notification-management': '通知管理',
settings: '设置',
}
if (role === 'normal-user') {
return normalUserPages[page] || ''
} else if (role === 'data-admin') {
return dataAdminPages[page] || ''
} else if (role === 'sys-admin') {
return sysAdminPages[page] || ''
}
return ''
}
// ===== =====
/** 当前用户角色null 表示未登录 */
const userRole = ref<UserRole | null>(null)
/** 退出登录确认弹窗显示状态 */
const showLogoutConfirm = ref(false)
/** 当前用户基本信息 */
const currentUser = ref({ name: '', avatarUrl: '' })
// ref
const userPageRef = ref<InstanceType<typeof UserPage> | null>(null)
const dataAdminPageRef = ref<InstanceType<typeof DataAdminPage> | null>(null)
// ===== =====
/** 普通用户的当前页面,默认为查询页面 */
const activePage = ref<Page>('query')
/** 系统管理员的当前页面,默认为仪表盘 */
const activeSysAdminPage = ref<SysAdminPageType>('dashboard')
/** 数据管理员的当前页面,默认为仪表盘 */
const activeDataAdminPage = ref<DataAdminPageType>('dashboard')
/** 查询页面的动态标题,由 QueryPage 通过 @update:title 事件更新 */
const queryPageTitle = ref<string>('新对话')
// ===== =====
/**
* 顶部导航栏标题
*
* 逻辑说明
* 1. 查询页面query使用 queryPageTitle QueryPage 动态更新
* 2. 其他页面使用 getSidebarPageName 根据角色和页面 key 获取中文名称
* 3. 未登录或未知页面返回空字符串
*/
const headerTitle = computed(() => {
//
const isQueryPage =
(userRole.value === 'normal-user' && activePage.value === 'query') ||
(userRole.value === 'data-admin' && activeDataAdminPage.value === 'query')
// 使
if (isQueryPage) {
return queryPageTitle.value
}
// 使
if (userRole.value === 'normal-user') {
return getSidebarPageName(userRole.value, activePage.value)
} else if (userRole.value === 'data-admin') {
return getSidebarPageName(userRole.value, activeDataAdminPage.value)
} else if (userRole.value === 'sys-admin') {
return getSidebarPageName(userRole.value, activeSysAdminPage.value)
}
return ''
})
// ===== =====
/**
* 登录处理
*
* 逻辑说明
* 1. 优先使用传入的 role否则从 sessionStorage 读取
* 2. 设置 userRole 后加载用户信息
* 3. 登录成功后页面状态保持默认值query dashboard
*/
const handleLogin = async (role: UserRole) => {
const savedRole = sessionStorage.getItem('userRole') as UserRole
const roleToSet = role || savedRole
if (roleToSet) {
userRole.value = roleToSet
await loadUserInfo()
}
}
/**
* 加载用户信息
*
* 逻辑说明
* 1. sessionStorage 获取 userId
* 2. 调用 API 获取用户数据
* 3. 更新 currentUsername, avatarUrl
* 4. 失败时使用默认值
*/
const loadUserInfo = async () => {
try {
const userId = Number(sessionStorage.getItem('userId') || '1')
const userData = await userApi.getById(userId)
currentUser.value = {
name: userData.username,
avatarUrl: userData.avatarUrl || '/default-avatar.png',
}
} catch (error) {
console.error('加载用户信息失败:', error)
currentUser.value = { name: '用户', avatarUrl: '/default-avatar.png' }
}
}
/**
* 退出登录
*
* 逻辑说明
* 1. 显示确认对话框
* 2. 用户确认后调用后端登出接口将token加入黑名单
* 3. 清除 sessionStorage 中的用户信息
* 4. 重置 userRole null触发显示 LoginPage
* 5. 重置所有页面状态为默认值
*/
const handleLogout = () => {
//
showLogoutConfirm.value = true
}
const confirmLogout = async () => {
//
showLogoutConfirm.value = false
try {
//
await authApi.logout()
} catch (error) {
console.error('登出失败:', error)
} finally {
//
userRole.value = null
activePage.value = 'query'
activeSysAdminPage.value = 'dashboard'
activeDataAdminPage.value = 'dashboard'
}
}
/**
* 更新 QueryPage 标题
*
* 逻辑说明
* - QueryPage 通过 @update:title 事件调用
* - 更新 queryPageTitle用于 headerTitle 计算属性
*/
const handleUpdateQueryTitle = (title: string) => {
queryPageTitle.value = title
}
/**
* 创建新对话
*
* 逻辑说明
* - TopHeader "新对话"按钮触发
* - 切换到查询页面query
* - 实际的新对话逻辑在 QueryPage 内部处理
*/
const handleNewConversation = () => {
if (userRole.value === 'normal-user') {
activePage.value = 'query'
//
setTimeout(() => {
if (userPageRef.value) {
userPageRef.value.handleNewConversation()
}
}, 100)
} else if (userRole.value === 'data-admin') {
activeDataAdminPage.value = 'query'
//
setTimeout(() => {
if (dataAdminPageRef.value) {
dataAdminPageRef.value.handleNewConversation()
}
}, 100)
}
// sys-admin
}
/**
* 通知图标点击
*
* 逻辑说明
* - TopHeader 的通知图标触发
* - 切换到对应角色的通知页面notifications
*/
const handleNotificationClick = () => {
if (userRole.value === 'normal-user') {
activePage.value = 'notifications'
} else if (userRole.value === 'data-admin') {
activeDataAdminPage.value = 'notifications'
}
// sys-admin
}
/**
* 头像点击
*
* 逻辑说明
* - TopHeader 的头像触发
* - 切换到对应角色的账户页面account
*/
const handleAvatarClick = () => {
if (userRole.value === 'normal-user') {
activePage.value = 'account'
} else if (userRole.value === 'data-admin') {
activeDataAdminPage.value = 'account'
} else if (userRole.value === 'sys-admin') {
activeSysAdminPage.value = 'account'
}
}
/**
* 切换历史面板
*
* 逻辑说明
* - TopHeader 的历史按钮触发仅在查询页面显示
* - 转发到 UserPage/DataAdminPage然后转发到 QueryPage
*/
const handleToggleHistory = () => {
if (userRole.value === 'normal-user') {
//
if (activePage.value !== 'query') {
activePage.value = 'query'
setTimeout(() => {
if (userPageRef.value) {
userPageRef.value.handleToggleHistory()
}
}, 100)
} else if (userPageRef.value) {
userPageRef.value.handleToggleHistory()
}
} else if (userRole.value === 'data-admin') {
//
if (activeDataAdminPage.value !== 'query') {
activeDataAdminPage.value = 'query'
setTimeout(() => {
if (dataAdminPageRef.value) {
dataAdminPageRef.value.handleToggleHistory()
}
}, 100)
} else if (dataAdminPageRef.value) {
dataAdminPageRef.value.handleToggleHistory()
}
}
}
// ===== =====
/**
* 设置普通用户页面
* - Sidebar @update:active-page 事件触发
*/
const setActivePage = (page: Page) => {
activePage.value = page
}
/**
* 设置系统管理员页面
* - Sidebar @update:active-page 事件触发
*/
const setActiveSysAdminPage = (page: SysAdminPageType) => {
activeSysAdminPage.value = page
}
/**
* 设置数据管理员页面
* - Sidebar @update:active-page 事件触发
*/
const setActiveDataAdminPage = (page: DataAdminPageType) => {
activeDataAdminPage.value = page
}
/**
* 处理头像更新事件
*
* 逻辑说明
* - AccountPage/AdminAccountPage 通过自定义事件触发
* - 更新 currentUser avatarUrl
*/
const handleAvatarUpdate = (event: CustomEvent) => {
currentUser.value = {
...currentUser.value,
avatarUrl: event.detail.avatarUrl,
}
}
// ===== =====
onMounted(() => {
// sessionStorage
const savedRole = sessionStorage.getItem('userRole') as UserRole
if (savedRole) {
handleLogin(savedRole)
}
// AccountPage/AdminAccountPage
window.addEventListener('userAvatarUpdated', handleAvatarUpdate as EventListener)
})
onUnmounted(() => {
//
window.removeEventListener('userAvatarUpdated', handleAvatarUpdate as EventListener)
})
</script>
<style scoped>
/* 确保组件正确布局 */
.h-screen {
height: 100vh;
}
.bg-neutral {
background-color: #f5f5f5;
}
.flex {
display: flex;
}
.flex-1 {
flex: 1 1 0%;
}
.flex-col {
flex-direction: column;
}
.overflow-hidden {
overflow: hidden;
}
</style>

@ -0,0 +1,855 @@
/* index.css */
/* ===== 主题样式变量 ===== */
:root {
/* 浅色主题 */
--light-bg: #F5F7FA;
--light-card: #FFFFFF;
--light-text: #1D2129;
--light-primary: #165DFF;
/* 深色主题 */
--dark-bg: #1F2937;
--dark-card: #374151;
--dark-text: #F9FAFB;
--dark-primary: #3B82F6;
/* 蓝色主题 */
--blue-bg: #EFF6FF;
--blue-card: #BFDBFE;
--blue-text: #1E3A8A;
--blue-primary: #2563EB;
/* 绿色主题 */
--green-bg: #F0FDF4;
--green-card: #A7F3D0;
--green-text: #14532D;
--green-primary: #10B981;
/* 紫色主题 */
--purple-bg: #FAF5FF;
--purple-card: #E9D5FF;
--purple-text: #581C87;
--purple-primary: #8B5CF6;
/* 大字主题(使用浅色配色) */
--large-bg: #F5F7FA;
--large-card: #FFFFFF;
--large-text: #1D2129;
--large-primary: #165DFF;
/* 当前主题变量(默认浅色) */
--theme-bg: var(--light-bg);
--theme-card: var(--light-card);
--theme-text: var(--light-text);
--theme-primary: var(--light-primary);
/* 字体大小变量 */
--font-size-base: 1rem;
--font-size-sm: 0.875rem;
--font-size-lg: 1.125rem;
--font-size-xl: 1.25rem;
--font-size-2xl: 1.5rem;
}
/* 主题类 */
.theme-light {
--theme-bg: var(--light-bg);
--theme-card: var(--light-card);
--theme-text: var(--light-text);
--theme-primary: var(--light-primary);
}
.theme-dark {
--theme-bg: var(--dark-bg);
--theme-card: var(--dark-card);
--theme-text: var(--dark-text);
--theme-primary: var(--dark-primary);
}
.theme-blue {
--theme-bg: var(--blue-bg) !important;
--theme-card: var(--blue-card) !important;
--theme-text: var(--blue-text) !important;
--theme-primary: var(--blue-primary) !important;
}
.theme-blue body,
.theme-blue .bg-neutral,
.theme-blue .bg-gray-50 {
background-color: var(--blue-bg) !important;
}
.theme-blue .bg-white {
background-color: var(--blue-card) !important;
}
.theme-green {
--theme-bg: var(--green-bg) !important;
--theme-card: var(--green-card) !important;
--theme-text: var(--green-text) !important;
--theme-primary: var(--green-primary) !important;
}
.theme-green body,
.theme-green .bg-neutral,
.theme-green .bg-gray-50 {
background-color: var(--green-bg) !important;
}
.theme-green .bg-white {
background-color: var(--green-card) !important;
}
.theme-purple {
--theme-bg: var(--purple-bg) !important;
--theme-card: var(--purple-card) !important;
--theme-text: var(--purple-text) !important;
--theme-primary: var(--purple-primary) !important;
}
.theme-purple body,
.theme-purple .bg-neutral,
.theme-purple .bg-gray-50 {
background-color: var(--purple-bg) !important;
}
.theme-purple .bg-white {
background-color: var(--purple-card) !important;
}
.theme-large {
--theme-bg: var(--large-bg);
--theme-card: var(--large-card);
--theme-text: var(--large-text);
--theme-primary: var(--large-primary);
}
/* 应用主题到html和body */
html {
background-color: var(--theme-bg);
transition: background-color 0.3s ease;
}
body {
background-color: var(--theme-bg) !important;
color: var(--theme-text) !important;
transition: background-color 0.3s ease, color 0.3s ease;
}
/* 确保主题变量应用到所有元素 */
* {
transition: background-color 0.3s ease, color 0.3s ease, border-color 0.3s ease;
}
/* ===== 大字主题字体样式 ===== */
.theme-large-font {
font-size: 1.25rem !important; /* 基础字体增大 */
}
.theme-large-font .text-sm {
font-size: 1rem !important;
}
.theme-large-font .text-base {
font-size: 1.25rem !important;
}
.theme-large-font .text-lg {
font-size: 1.5rem !important;
}
.theme-large-font .text-xl {
font-size: 1.75rem !important;
}
.theme-large-font .text-2xl {
font-size: 2rem !important;
}
.theme-large-font h1 {
font-size: 2.5rem !important;
}
.theme-large-font h2 {
font-size: 2rem !important;
}
.theme-large-font h3 {
font-size: 1.75rem !important;
}
.theme-large-font button {
font-size: 1.125rem !important;
padding: 0.75rem 1.5rem !important;
}
.theme-large-font input,
.theme-large-font textarea,
.theme-large-font select {
font-size: 1.125rem !important;
padding: 0.75rem 1rem !important;
}
/* ===== 全局主题样式类替代硬编码的Tailwind类 ===== */
/* 背景色 */
.theme-bg {
background-color: var(--theme-bg) !important;
}
.theme-card {
background-color: var(--theme-card) !important;
}
/* 文字颜色 */
.theme-text {
color: var(--theme-text) !important;
}
.theme-text-secondary {
color: var(--theme-text);
opacity: 0.7;
}
/* 主色调 */
.theme-primary {
color: var(--theme-primary) !important;
}
.theme-primary-bg {
background-color: var(--theme-primary) !important;
}
.theme-primary-border {
border-color: var(--theme-primary) !important;
}
/* 边框颜色 */
.theme-border {
border-color: rgba(0, 0, 0, 0.1) !important;
}
.theme-dark .theme-border {
border-color: rgba(255, 255, 255, 0.1) !important;
}
/* 阴影 */
.theme-shadow {
box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06) !important;
}
.theme-dark .theme-shadow {
box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.3), 0 1px 2px 0 rgba(0, 0, 0, 0.2) !important;
}
/* 输入框样式 */
.theme-input {
background-color: var(--theme-card) !important;
color: var(--theme-text) !important;
border-color: var(--theme-border) !important;
}
.theme-input:focus {
border-color: var(--theme-primary) !important;
background-color: var(--theme-card) !important;
}
.theme-input::placeholder {
color: var(--theme-text);
opacity: 0.5;
}
/* 卡片样式 */
.theme-card-container {
background-color: var(--theme-card) !important;
color: var(--theme-text) !important;
border-color: var(--theme-border) !important;
}
/* 悬停效果 */
.theme-hover:hover {
background-color: var(--theme-bg) !important;
}
.theme-dark .theme-hover:hover {
background-color: rgba(255, 255, 255, 0.05) !important;
}
/* 图表容器样式 */
.chart-container {
position: relative;
height: 256px; /* h-64 */
width: 100%;
}
/* 渐变背景动画 */
.animated-gradient {
background: linear-gradient(-45deg, #eef2ff, #f3e8ff, #dbeafe, #e0f2fe);
background-size: 400% 400%;
animation: gradient-animation 15s ease infinite;
}
@keyframes gradient-animation {
0% {
background-position: 0% 50%;
}
50% {
background-position: 100% 50%;
}
100% {
background-position: 0% 50%;
}
}
/* 自定义滚动条 */
::-webkit-scrollbar {
width: 8px;
}
::-webkit-scrollbar-track {
background: #f1f1f1;
border-radius: 4px;
}
::-webkit-scrollbar-thumb {
background: #888;
border-radius: 4px;
}
::-webkit-scrollbar-thumb:hover {
background: #555;
}
/* 加载动画 */
.dot-flashing {
position: relative;
width: 10px;
height: 10px;
border-radius: 5px;
background-color: var(--color-primary, #3b82f6);
color: var(--color-primary, #3b82f6);
animation: dot-flashing 1s infinite linear alternate;
animation-delay: 0.5s;
margin: 0 auto;
}
.dot-flashing::before,
.dot-flashing::after {
content: '';
display: inline-block;
position: absolute;
top: 0;
}
.dot-flashing::before {
left: -15px;
width: 10px;
height: 10px;
border-radius: 5px;
background-color: var(--color-primary, #165dff);
color: var(--color-primary, #165dff);
animation: dot-flashing 1s infinite alternate;
animation-delay: 0s;
}
.dot-flashing::after {
left: 15px;
width: 10px;
height: 10px;
border-radius: 5px;
background-color: var(--color-primary, #165dff);
color: var(--color-primary, #165dff);
animation: dot-flashing 1s infinite alternate;
animation-delay: 1s;
}
@keyframes dot-flashing {
0% {
background-color: var(--color-primary, #165dff);
}
50%,
100% {
background-color: rgba(22, 93, 255, 0.2);
}
}
/* 响应式字体大小 */
@media (max-width: 640px) {
html {
font-size: 14px;
}
}
/* 打印样式 */
@media print {
.no-print {
display: none;
}
}
/* ==================== 响应式侧边栏和页面布局 ==================== */
/* 通用滚动容器 */
.scrollable-content {
flex: 1;
overflow-y: auto;
min-height: 0;
display: flex;
flex-direction: column;
}
/* 小屏幕小于1024px时自动隐藏侧边栏 */
@media (max-width: 1023px) {
/* 隐藏桌面端侧边栏(移动端侧边栏通过 v-if 和 v-show 控制,不受此规则影响) */
aside:not([class*="z-\[60\]"]) {
display: none !important;
}
/* 确保移动端侧边栏显示fixed定位的侧边栏通过v-show控制显示/隐藏) */
aside[class*="z-\[60\]"] {
display: flex !important;
}
/* 移动端侧边栏隐藏时 */
aside[class*="z-\[60\]"][style*="display: none"] {
display: none !important;
}
/* 确保移动端侧边栏header样式与TopHeader一致 */
aside[class*="z-\[60\]"] .p-4.border-b {
padding: 1rem !important;
border-bottom: 1px solid #e5e7eb !important;
background-color: white !important;
flex-shrink: 0 !important;
}
/* 确保桌面端侧边栏header样式与TopHeader一致 */
aside:not([class*="w-0"]) .p-4.border-b {
padding: 1rem !important;
border-bottom: 1px solid #e5e7eb !important;
background-color: white !important;
flex-shrink: 0 !important;
}
/* 主内容区域填充整个宽度 */
/* 只针对App.vue中的main不覆盖子组件 */
.flex.h-screen > main {
width: 100% !important;
flex: 1 1 100% !important;
}
/* 确保页面容器可以滚动 */
.flex.h-screen {
overflow-y: auto;
height: auto;
min-height: 100vh;
}
/* 页面内容区域可以滚动 */
/* 只针对App.vue中的main不覆盖子组件 */
.flex.h-screen > main > .scrollable-content {
overflow-y: auto;
overflow-x: hidden;
}
/* 移动端表单模态框内容全部展示,不设置滚动 */
@media (max-width: 1023px) {
.bg-white.rounded-xl.shadow-xl {
max-height: none !important;
overflow-y: visible !important;
}
/* 表单内容区域不限制高度,全部展示 */
.bg-white.rounded-xl.shadow-xl .p-6 {
overflow-y: visible !important;
max-height: none;
}
}
}
/* 大屏幕大于等于1024px时显示侧边栏 */
@media (min-width: 1024px) {
/* 显示侧边栏 */
aside:not([class*="w-0"]) {
display: flex !important;
}
/* 侧边栏收起时隐藏 */
aside[class*="w-0"] {
display: none !important;
}
/* 主内容区域自适应 */
/* 只针对App.vue中的main不覆盖子组件 */
.flex.h-screen > main {
flex: 1 1 0%;
min-width: 0;
overflow-y: auto;
overflow-x: hidden;
transition: width 0.3s;
}
/* 当侧边栏收起时,主内容区域填满屏幕 */
.flex.h-screen.sidebar-collapsed > main {
width: 100% !important;
flex: 1 1 100% !important;
}
}
/* 确保所有页面内容区域可以滚动 */
/* 注意这个样式只应用于App.vue中的main标签不覆盖子组件中的main */
.flex.h-screen > main {
overflow-y: auto;
overflow-x: hidden;
-webkit-overflow-scrolling: touch; /* iOS 平滑滚动 */
}
/* 页面容器自适应 */
.page-container {
width: 100%;
min-height: 100vh;
display: flex;
flex-direction: column;
}
/* ==================== 响应式表格样式 ==================== */
/* 系统日志表格容器 */
.system-log-table-container {
width: 100%;
display: flex;
flex-direction: column;
}
/* 系统日志表格包装器 */
.system-log-table-wrapper {
width: 100%;
position: relative;
overflow-x: auto;
overflow-y: visible; /* 允许内容自然显示,不限制高度 */
}
/* 系统日志表格 */
.system-log-table {
width: 100%;
border-collapse: collapse;
table-layout: auto;
font-size: 0.9375rem; /* 15px比默认的14px稍大 */
}
.system-log-table th,
.system-log-table td {
border-bottom: 1px solid #e5e7eb;
padding: 0.75rem 1.5rem; /* 增加内边距 */
}
.system-log-table thead th {
border-bottom: 2px solid #e5e7eb;
background-color: #f9fafb;
font-weight: 600;
color: #374151;
position: sticky;
top: 0;
z-index: 10;
}
.system-log-table tbody tr:hover {
background-color: #f9fafb;
}
.system-log-table tbody tr:last-child td {
border-bottom: none;
}
/* 小屏幕小于768px时表格横向滚动 */
@media (max-width: 767px) {
.system-log-table {
min-width: 900px; /* 确保表格有最小宽度,触发横向滚动 */
}
.system-log-table th,
.system-log-table td {
padding: 0.5rem 0.75rem;
font-size: 0.875rem;
}
/* 表格容器添加滚动指示 */
.system-log-table-wrapper::after {
content: '← 滑动查看更多 →';
position: absolute;
bottom: -20px;
right: 0;
font-size: 12px;
color: #999;
pointer-events: none;
}
}
/* 中等屏幕768px-1023px时优化表格显示 */
@media (min-width: 768px) and (max-width: 1023px) {
.system-log-table th,
.system-log-table td {
padding: 0.625rem 0.875rem;
font-size: 0.875rem;
}
}
/* 大屏幕大于等于1024px时正常显示 */
@media (min-width: 1024px) {
.system-log-table {
width: 100%;
}
.system-log-table th,
.system-log-table td {
padding: 0.75rem 1rem;
font-size: 0.875rem;
}
}
/* 表格单元格文本溢出处理 */
.system-log-table td {
max-width: 200px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* 操作内容列允许换行 */
.system-log-table td:nth-child(4) {
white-space: normal;
word-break: break-word;
max-width: 250px;
}
/* 允许某些列换行 */
.system-log-table td.allow-wrap {
white-space: normal;
word-break: break-word;
}
/* 通用响应式表格样式(保留兼容性) */
.responsive-table {
min-width: 100%;
border-collapse: collapse;
}
.responsive-table th,
.responsive-table td {
border-bottom: 1px solid #e5e7eb;
}
.responsive-table thead th {
border-bottom: 2px solid #e5e7eb;
background-color: #f9fafb;
font-weight: 600;
color: #374151;
}
.responsive-table tbody tr:hover {
background-color: #f9fafb;
}
/* ==================== 深色主题样式(使用主题类,优化视觉效果) ==================== */
.theme-dark {
color-scheme: dark;
}
.theme-dark body {
background-color: #1a1a1a !important;
color: #e5e5e5 !important;
}
/* 通用背景色 - 覆盖硬编码的Tailwind类 */
.theme-dark .bg-white {
background-color: #2d2d2d !important;
}
.theme-dark .bg-neutral {
background-color: #1a1a1a !important;
}
.theme-dark .bg-gray-50,
.theme-dark .bg-gray-100 {
background-color: rgba(255, 255, 255, 0.05) !important;
}
.theme-dark .bg-gray-200 {
background-color: rgba(255, 255, 255, 0.08) !important;
}
/* 边框颜色 */
.theme-dark .border-gray-200,
.theme-dark .border-gray-300,
.theme-dark .border-b,
.theme-dark .border-t,
.theme-dark .border-r,
.theme-dark .border-l {
border-color: rgba(255, 255, 255, 0.1) !important;
}
/* 文字颜色 */
.theme-dark .text-gray-500,
.theme-dark .text-gray-600 {
color: rgba(255, 255, 255, 0.6) !important;
}
.theme-dark .text-gray-400 {
color: rgba(255, 255, 255, 0.5) !important;
}
.theme-dark .text-dark,
.theme-dark h1,
.theme-dark h2,
.theme-dark h3,
.theme-dark h4,
.theme-dark h5,
.theme-dark h6 {
color: var(--dark-text) !important;
}
.theme-dark .text-gray-700,
.theme-dark .text-gray-800,
.theme-dark .text-gray-900 {
color: rgba(255, 255, 255, 0.8) !important;
}
/* 悬停效果 */
.theme-dark .hover\:bg-gray-50:hover,
.theme-dark .hover\:bg-gray-100:hover {
background-color: rgba(255, 255, 255, 0.1) !important;
}
/* 输入框 */
.theme-dark input,
.theme-dark textarea,
.theme-dark select {
background-color: var(--dark-card) !important;
color: var(--dark-text) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark input:focus,
.theme-dark textarea:focus,
.theme-dark select:focus {
background-color: var(--dark-card) !important;
border-color: var(--dark-primary) !important;
}
.theme-dark input::placeholder,
.theme-dark textarea::placeholder {
color: rgba(255, 255, 255, 0.5) !important;
}
/* 卡片和容器 */
.theme-dark .bg-white.rounded-xl,
.theme-dark .bg-white.rounded-lg {
background-color: var(--dark-card) !important;
}
.theme-dark .shadow-sm {
box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.3) !important;
}
.theme-dark .shadow-md {
box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.3), 0 2px 4px -1px rgba(0, 0, 0, 0.2) !important;
}
.theme-dark .shadow-lg {
box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.3), 0 4px 6px -2px rgba(0, 0, 0, 0.2) !important;
}
/* 滚动条深色模式 */
.theme-dark ::-webkit-scrollbar-track {
background: var(--dark-card) !important;
}
.theme-dark ::-webkit-scrollbar-thumb {
background: rgba(255, 255, 255, 0.2) !important;
}
.theme-dark ::-webkit-scrollbar-thumb:hover {
background: rgba(255, 255, 255, 0.3) !important;
}
/* 侧边栏特定样式 */
.theme-dark aside {
background-color: var(--dark-card) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark aside header,
.theme-dark aside .p-4.border-b {
background-color: var(--dark-card) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark aside .category-title {
color: rgba(255, 255, 255, 0.6) !important;
}
.theme-dark aside .category-header:hover {
background-color: rgba(255, 255, 255, 0.05) !important;
}
.theme-dark aside .category-divider {
background-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark aside a.text-gray-600 {
color: rgba(255, 255, 255, 0.6) !important;
}
.theme-dark aside a:hover {
background-color: rgba(255, 255, 255, 0.05) !important;
}
/* TopHeader 深色模式 */
.theme-dark header {
background-color: var(--dark-card) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark header h1 {
color: var(--dark-text) !important;
}
.theme-dark header button {
color: rgba(255, 255, 255, 0.6) !important;
}
.theme-dark header button:hover {
color: var(--dark-primary) !important;
}
/* 设置侧边栏深色模式 */
.theme-dark aside.border-l {
background-color: var(--dark-card) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark aside.border-l .p-4.border-b {
background-color: var(--dark-card) !important;
border-color: rgba(255, 255, 255, 0.1) !important;
}
.theme-dark aside.border-l h1,
.theme-dark aside.border-l h3 {
color: var(--dark-text) !important;
}
.theme-dark aside.border-l .text-gray-700 {
color: rgba(255, 255, 255, 0.8) !important;
}
.theme-dark aside.border-l .text-gray-500 {
color: rgba(255, 255, 255, 0.6) !important;
}
.theme-dark aside.border-l button.bg-gray-50 {
background-color: rgba(255, 255, 255, 0.05) !important;
}
.theme-dark aside.border-l button.bg-gray-50:hover {
background-color: rgba(255, 255, 255, 0.1) !important;
}

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save