第七周个人周报-197241-刘相宏

[2601_95542422]

一、本周工作内容

1. 团队协作功能开发

• 团队空间：创建了独立的团队空间模块，用户可创建团队并切换工作上下文。

• 成员管理：实现了基于角色的访问控制（RBAC），区分“管理员”与“普通成员”权限。

• 任务指派：扩展了任务模型，支持设置“负责人”与“参与人”，并在列表中高亮显示指派给自己的任务。

• 动态通知：团队内的任务变更（如被指派、状态更新）实时推送给相关成员。

2. 评论与附件系统

• 评论流：在任务详情页实现了类似社交媒体的评论功能，支持富文本输入与表情。

• @提及功能：评论中支持@提及团队成员，被提及者会收到特殊通知。

• 文件附件：集成了阿里云OSS，实现了文件的上传、下载、删除及在线预览（支持图片、PDF等格式）。

• 历史版本：对重要附件保留了最近5次的上传记录，防止误操作覆盖。

3. 项目收尾与优化

• 代码重构：抽取公共业务逻辑，优化组件结构，提高代码可维护性。

• Bug修复：集中修复了前三周累积的边界Case和UI显示异常问题。

• 引导教程：添加了新手引导（Intro.js），帮助首次使用的用户快速上手系统。

二、技术实现细节

1. 权限系统设计

• 采用RBAC（Role-Based Access Control）模型，通过中间件拦截API请求，校验用户是否拥有操作权限。

• 团队邀请链接使用一次性Token，防止恶意扫描加入。

2. 文件存储策略

• 前端直传OSS，后端仅签发临时上传凭证，减轻服务器带宽压力。

• 文件名进行Hash处理，防止同名文件冲突，并保障安全性。

3. 实时协作感知

• 利用WebSocket广播团队内的操作事件，实现评论和任务更新的即时同步，无需手动刷新页面。

三、遇到的问题与解决方案

1. 问题：文件上传大文件超时

• 问题描述：上传超过100MB的大文件时，前端请求容易超时。

• 解决方案：改用“分片上传”方案，将大文件切割为5MB的片段并行上传，最后由服务端合并。

2. 问题：权限校验复杂度高

• 问题描述：随着功能增多，接口权限判断逻辑变得冗长且难以维护。

• 解决方案：抽象出权限装饰器（Decorator）/中间件，通过注解方式声明接口所需权限，简化代码结构。

3. 问题：评论过多导致加载慢

• 问题描述：任务评论数过多时，详情页加载缓慢。

• 解决方案：实现评论的分页加载与无限滚动，默认只加载最新10条评论。

四、测试与部署

• 全流程测试：完成团队协作场景的端到端测试，确保多人协作流程顺畅。

• 安全审计：检查SQL注入、XSS攻击等常见漏洞，加固系统安全性。

• 部署上线：编写Dockerfile，使用Docker容器化部署，并完成Nginx反向代理配置。

• 文档交付：撰写《系统使用手册》、《API接口文档》及《项目开发总结报告》。

五、项目总结与反思

1. 项目亮点

• 实现了从个人管理到团队协作的完整闭环。

• 注重用户体验细节（如深色模式、快捷键、实时通知）。

• 系统架构清晰，前后端分离彻底，具备良好的扩展性。

2. 不足之处

• 初期对需求评估不足，导致后期协作功能开发时间略显紧张。

• 自动化测试覆盖率有待进一步提高。

• 移动端适配主要保证了可用性，在交互细节上仍有优化空间。

六、本周工作成果

• 团队协作功能完整交付，系统从单人工具升级为多人协作平台。

• 项目顺利上线部署，所有核心功能运行稳定。

• 全套技术文档交付，完成项目验收标准。