# plm-assitant

**Repository Path**: iocs/plm-assitant

## Basic Information

- **Project Name**: plm-assitant
- **Description**: Masterlab项目管理辅助工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PLM Dashboard - 项目管理辅助工具

基于 MasterLab 数据库的项目管理辅助分析工具，提供**全员任务工作负载一览**和**日报质量 AI 分析**两大核心功能。

## 功能特性

### 功能一：任务总览
- 📊 **热力图可视化**：横轴时间线、纵轴人员，直观展示任务分布
- 🎨 **密集度颜色标记**：空闲（绿）→ 适中（黄）→ 繁忙（橙）→ 过载（红）
- 🔍 **灵活筛选**：支持时间范围、人员多选、事项类型筛选
- 📈 **统计摘要**：总任务数、活跃人数、人均任务、过载人数

### 功能二：日报质量分析
- 🤖 **AI 智能分析**：基于 DeepSeek 大模型分析日报质量
- 📝 **多维度评估**：内容完整性、事项匹配度、详实程度
- 🏷️ **评分体系**：0-100 分制 + 优秀/良好/一般/较差等级
- 💡 **改进建议**：针对每条日报提供具体的改进方向
- ⚡ **批量分析**：一键分析所有日报，实时查看进度

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Python 3.13 + Flask + SQLAlchemy + PyMySQL |
| 前端 | React 18 + TypeScript + Tailwind CSS + ECharts |
| AI | DeepSeek API (deepseek-chat) |
| 数据库 | MySQL 5.7 (MasterLab) |

## 快速启动

### 1. 启动后端

```bash
cd backend

# 创建虚拟环境（首次）
python -m venv venv

# 激活虚拟环境
# Windows PowerShell:
.\venv\Scripts\Activate.ps1

# 安装依赖（首次）
pip install -r requirements.txt

# 启动后端服务
python app.py
```

后端将在 http://localhost:5000 启动。

### 2. 启动前端

```bash
cd frontend

# 安装依赖（首次）
npm install

# 启动开发服务器
npm run dev
```

前端将在 http://localhost:3000 启动，自动代理 API 请求到后端。

### 3. 访问

浏览器打开 http://localhost:3000 即可使用。

## 配置说明

数据库连接和 AI 配置在 `backend/.env` 文件中：

```env
# MySQL 数据库配置
DB_HOST=172.20.100.200
DB_PORT=3306
DB_NAME=masterlab
DB_USER=root
DB_PASSWORD=New@Passw0rd

# DeepSeek AI 配置
DEEPSEEK_API_KEY=your-api-key
DEEPSEEK_BASE_URL=https://api.deepseek.com
```

## 项目结构

```
plm_assistant/
├── backend/
│   ├── app.py                 # Flask 应用入口
│   ├── config.py              # 配置管理
│   ├── .env                   # 环境变量
│   ├── requirements.txt       # Python 依赖
│   ├── api/
│   │   ├── workload.py        # 任务总览 API
│   │   └── report.py          # 日报分析 API
│   └── services/
│       └── ai_analyzer.py     # DeepSeek AI 分析封装
├── frontend/
│   ├── src/
│   │   ├── App.tsx            # 路由配置
│   │   ├── pages/
│   │   │   ├── WorkloadPage.tsx   # 任务总览页
│   │   │   └── ReportPage.tsx     # 日报分析页
│   │   ├── components/
│   │   │   ├── Layout.tsx         # 布局组件
│   │   │   ├── FilterBar.tsx      # 通用筛选栏
│   │   │   └── WorkloadHeatmap.tsx # 热力图组件
│   │   └── lib/
│   │       ├── api.ts             # API 请求封装
│   │       └── utils.ts           # 工具函数
│   └── package.json
└── README.md
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/users | 获取用户列表 |
| GET | /api/issue-types | 获取事项类型 |
| GET | /api/workload | 获取任务总览数据 |
| GET | /api/reports | 获取日报列表 |
| POST | /api/reports/analyze | AI 分析日报质量 |