开源鸿蒙研发团队周工作总结自动化智能体

Work-Summary-Automation-Agent

项目简介

开源鸿蒙研发团队周工作总结自动化智能体是一个基于Flask框架开发的Web应用，旨在帮助鸿蒙研发团队实现周工作总结的自动化管理和智能生成。系统提供了完整的用户体系与分级权限管控功能，涵盖用户登录、表单生成与提交、数据解析、汇报生成等全流程自动化。

主要功能

1. 用户管理系统

• 用户登录：支持手机号+密码登录
• 自动注册：首次登录将会自动注册为新用户
• 密码管理：默认密码为123456，支持用户修改姓名
• 权限控制：基于角色的权限管理（管理员/普通用户）

2. 周工作总结管理

• 表单提交：标准化的周工作总结表单，包含核心工作内容、完成情况、遇到的问题、下周计划等字段
• 默认值设置：部门字段默认为"技术研发部"
• 周报修改：支持修改本周周报，历史周报不可修改
• 数据存储：JSON格式持久化存储用户数据和周报数据

3. 管理员功能

• 数据管理：查看所有用户的周报数据
• 汇报生成：自动生成团队周报汇总
• 文件导入导出：支持Excel/CSV文件的导入和导出

4. 界面设计

• 科技感风格：深蓝色渐变背景、磨砂玻璃效果、发光按钮等现代设计元素
• 响应式布局：适配不同设备屏幕尺寸
• 用户友好：直观的操作界面和清晰的视觉层次

5. AI智能总结功能

• 自动总结：基于火山引擎方舟大模型的AI智能总结功能
• 模板输出：按照指定模板格式生成工作总结
• 快速响应：即使无API密钥也能返回默认总结
• 错误处理：完善的错误处理机制，确保功能稳定运行

技术栈

• 后端框架：Flask 3.0.0
• 认证系统：Flask-Login 0.6.3
• 表单处理：Flask-WTF 1.2.1
• 数据处理：Pandas 2.2.3
• 文件处理：openpyxl 3.1.2, xlrd 2.0.1
• AI集成：OpenAI SDK
• 前端技术：HTML5, CSS3, JavaScript
• 数据存储：JSON文件

安装步骤

1. 克隆项目

git clone <repository-url>
cd Week

2. 创建虚拟环境

python3 -m venv venv

3. 激活虚拟环境

Windows

venv\Scripts\activate

macOS/Linux

source venv/bin/activate

4. 安装依赖

pip install -r requirements.txt

5. 启动应用

python app.py

应用将在 http://127.0.0.1:5001 上运行

使用说明

1. 首次登录

1. 访问 http://127.0.0.1:5001/login
2. 输入手机号（首次登录会自动注册）
3. 输入默认密码：123456
4. 点击登录按钮

2. 填写周工作总结

1. 登录后进入用户仪表盘
2. 点击"填写本周工作总结"按钮
3. 填写表单信息（部门默认为"技术研发部"）
4. 点击"提交表单"按钮

3. 修改本周周报

1. 在用户仪表盘找到本周周报
2. 点击"修改"按钮
3. 更新表单信息
4. 点击"提交表单"按钮

4. 管理员操作

1. 使用管理员账号登录（默认手机号：13800138000，密码：123456）
2. 进入管理员仪表盘
3. 选择相应功能：查看数据、生成汇报、导入导出文件等

5. AI智能总结功能使用

1. 生成总结：在用户仪表盘或管理员仪表盘点击"生成AI总结"按钮

2. 查看结果：系统会自动生成符合模板格式的工作总结

3. 模板格式：总结会按照指定的模板格式输出，包含周次、日期范围、上周工作总结和本周工作计划

4. API配置（可选）：如需使用火山引擎方舟大模型，可设置ARK_API_KEY环境变量

   # 设置环境变量
   export ARK_API_KEY=your-api-key
   
   # 或在启动应用前设置
   ARK_API_KEY=your-api-key python app.py

项目结构

Week/
├── app.py              # 应用核心文件
├── requirements.txt    # 依赖包配置
├── data/
│   ├── users.json      # 用户数据
│   └── summaries.json  # 周报数据
├── templates/
│   ├── login.html          # 登录页面
│   ├── user_dashboard.html # 用户仪表盘
│   ├── form.html           # 周报表单
│   ├── admin_dashboard.html # 管理员仪表盘
│   └── ...                 # 其他模板文件
├── uploads/             # 上传文件目录
└── venv/                # 虚拟环境

核心文件说明

• app.py：应用的核心逻辑，包含路由、用户认证、数据处理等功能
• templates/：前端页面模板，采用Jinja2模板引擎
• data/：数据存储目录，使用JSON格式保存数据
• uploads/：文件上传目录，存储导入导出的文件

注意事项

1. 默认管理员账号：

   • 手机号：15828647311
   • 密码：123456

2. 新用户默认密码：123456

3. 数据存储：

   • 用户数据和周报数据以JSON格式存储在data/目录下
   • 建议定期备份数据文件

4. 文件上传：

   • 支持Excel/CSV文件格式
   • 最大文件大小限制为16MB

5. 修改权限：

   • 仅允许修改本周周报
   • 历史周报不可修改

6. AI智能总结功能：

   • 即使未配置API密钥，也能返回默认总结
   • 配置API密钥后，会使用火山引擎方舟大模型生成更智能的总结
   • 接口响应时间：默认总结约0.00秒，AI生成总结约15-30秒
   • 总结格式：严格按照指定模板格式输出，包含周次、日期范围、上周工作总结和本周工作计划

常见问题

1. 端口被占用

如果启动应用时提示"Port 5001 is in use"，可以使用以下命令释放端口：

lsof -i :5001 | grep LISTEN | awk '{print $2}' | xargs kill -9

2. 数据缺少必需字段

如果生成汇报时提示"数据缺少必需字段：姓名"，请检查周报数据是否完整。

3. 忘记密码

目前系统不支持密码重置功能，如需修改密码，请联系管理员。

贡献指南

欢迎对项目提出建议和改进，贡献方式如下：

1. Fork本项目
2. 创建功能分支
3. 提交修改
4. 发起Pull Request

许可证

本项目采用MIT许可证。

技术支持

• 开发团队：开源鸿蒙研发团队
• 联系邮箱：[15828647311@126.com]
• 项目地址：[https://github.com/happyhq/Work-Summary-Automation-Agent]

---

开源鸿蒙研发团队周工作总结自动化智能体 - 让工作汇报更高效、更智能！#