# qiye_wechat_data

**Repository Path**: mbcn/qiye_wechat_data

## Basic Information

- **Project Name**: qiye_wechat_data
- **Description**: 企业微信的数据大盘
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业微信数据采集项目

## 功能说明

该项目用于从企业微信获取以下数据并存储到RDS数据库中：

1. **群信息**：获取企业的所有群的基本信息
2. **群成员数量变化**：记录每个群每天的成员数量、新增人数和减少人数
3. **员工好友数量**：获取每个员工的好友数量
4. **员工好友数量变化**：记录每个员工每天的好友数量、新增人数和减少人数

## 技术栈

- Go 1.20
- MySQL (RDS)
- 企业微信API

## 数据库表结构

### groups 表
- id: 主键
- group_id: 群ID（唯一）
- group_name: 群名称
- owner: 群主
- member_count: 成员数量
- create_time: 创建时间
- update_time: 更新时间

### group_member_changes 表
- id: 主键
- group_id: 群ID
- date: 日期
- member_count: 成员数量
- increase: 新增人数
- decrease: 减少人数
- create_time: 创建时间

### employees 表
- id: 主键
- employee_id: 员工ID（唯一）
- name: 员工姓名
- department: 部门
- create_time: 创建时间
- update_time: 更新时间

### employee_friend_changes 表
- id: 主键
- employee_id: 员工ID
- date: 日期
- friend_count: 好友数量
- increase: 新增人数
- decrease: 减少人数
- create_time: 创建时间

## 企业微信授权要求

要使用该项目，需要在企业微信后台获取以下信息：

1. **CorpID**：企业ID，在企业微信管理后台的「我的企业」->「企业信息」中获取
2. **AgentID**：应用ID，需要在企业微信管理后台创建一个应用，然后在应用详情中获取
3. **AppSecret**：应用密钥，在创建应用后获取

此外，需要为应用添加以下权限：

- 外部联系人权限：用于获取群信息和外部联系人列表
- 成员管理权限：用于获取员工列表

## 配置方法

1. 在企业微信管理后台创建一个应用，并获取CorpID、AgentID和AppSecret
2. 为应用添加相应的权限
3. 设置环境变量：
   - CORP_ID: 企业ID
   - AGENT_ID: 应用ID
   - APP_SECRET: 应用密钥
   - DSN: 数据库连接字符串（可选，默认值已配置）

## 使用方法

1. 安装依赖：
   ```bash
   go mod tidy
   ```

2. 运行程序：
   ```bash
   go run main.go
   ```

3. 可以将程序设置为定时任务，每天运行一次，以获取每天的数据变化

## 部署建议

1. 可以将程序部署到服务器上，设置为每天定时运行
2. 确保服务器能够访问企业微信API和RDS数据库
3. 建议使用系统的crontab或其他定时任务工具来调度程序运行