# prowei

**Repository Path**: techwolf/prowei

## Basic Information

- **Project Name**: prowei
- **Description**: prowei
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 员工个性化管理系统

基于飞书多维表格和AI智能体的员工个性化管理系统。

## 功能

- 任务进度数据获取
- 人员档案数据获取
- 行为日志记录
- **AI行为分析** - 自动检测产出下降、质量波动、进度异常
- **个性化话术生成** - 根据员工画像生成沟通话术
- **预警推送** - 异常检测后推送预警消息

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置环境变量

复制 `.env.example` 为 `.env`，填入飞书应用配置：

```env
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_APP_TOKEN=your_bitable_app_token
```

### 3. 运行服务

```bash
python main.py
```

服务启动后访问 http://localhost:8000/docs 查看API文档。

## API接口

### 数据获取

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/v1/tasks | GET | 获取任务列表 |
| /api/v1/tasks/{id} | GET | 获取任务详情 |
| /api/v1/persons | GET | 获取人员列表 |
| /api/v1/persons/{id} | GET | 获取人员详情 |
| /api/v1/behaviors | GET | 获取行为日志列表 |
| /api/v1/behaviors | POST | 创建行为日志记录 |

### AI智能体

| 接口 | 方法 | 说明 |
|------|------|------|
| /api/v1/analyze | POST | AI行为分析 - 检测异常行为 |
| /api/v1/script | POST | AI话术生成 - 生成个性化沟通话术 |
| /api/v1/analyze-and-script | POST | 一键分析+话术生成 |
| /api/v1/alerts/preview | GET | 预览预警信息 |
| /api/v1/notify | POST | 发送预警通知 |

## AI智能体功能说明

### 行为分析智能体

自动分析任务数据，检测以下异常行为：

- **产出下降**: 实际工时超过计划工时30%以上
- **质量波动**: 任务阻塞次数超过阈值
- **进度异常**: 进行中任务无实际工时更新

### 话术生成智能体

根据员工画像生成个性化沟通话术：

**员工画像维度:**
- 工作风格: 独立型 / 协作型
- 激励偏好: 认可型 / 自主型 / 成长型 / 目标型

**话术特点:**
- 独立型员工: 给足空间，先询问再提供帮助
- 协作型员工: 主动提出一起讨论解决方案
- 认可型员工: 先肯定贡献，再提问题
- 自主型员工: 给出目标即可，不过度指导

### 预警推送

分析异常后自动推送预警消息给项目经理，包含：
- 员工信息
- 预警类型和风险等级
- 详细问题描述
- 建议沟通话术

## 飞书多维表格配置

需要在飞书多维表格中创建以下表格：

1. **任务进度表** - 字段：任务名称、负责人、任务状态、计划工时、实际工时、完成标准、阻塞原因、产出质量标记
2. **人员档案表** - 字段：姓名、部门、角色、工作风格、激励偏好、风险等级、个性化话术
3. **行为日志表** - 字段：日期、人员、行为类型、具体行为、异常标记、风险分值

详细字段定义见 `docs/superpowers/specs/2026-04-22-employee-personalized-management-design.md`

## 项目结构

```
prowei/
├── src/
│   ├── config.py              # 配置管理
│   ├── feishu/
│   │   ├── client.py          # 飞书API客户端
│   │   └── models.py          # 数据模型定义
│   ├── api/
│   │   └── routes.py          # API路由
│   └── agents/
│       ├── behavior_analyzer.py   # 行为分析智能体
│       ├── script_generator.py    # 话术生成智能体
│       └── alert_notifier.py      # 预警推送服务
├── tests/
│   ├── test_client.py         # 客户端测试
│   └── test_api.py            # API测试
├── main.py                    # 入口文件
└── requirements.txt           # 依赖
```

## 运行测试

```bash
pytest tests/ -v
```

## 使用示例

### 1. 分析任务异常

```bash
curl -X POST http://localhost:8000/api/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 2. 生成沟通话术

```bash
curl -X POST http://localhost:8000/api/v1/script \
  -H "Content-Type: application/json" \
  -d '{
    "person_id": "张三",
    "scenario": "产出下降",
    "task_name": "登录功能开发"
  }'
```

### 3. 一键分析并推送预警

```bash
curl -X POST http://localhost:8000/api/v1/notify \
  -H "Content-Type: application/json" \
  -d '{
    "manager_id": "ou_manager_xxx"
  }'
```