# EIST-ERP社区版

**Repository Path**: wheist/eist_erp_ce

## Basic Information

- **Project Name**: EIST-ERP社区版
- **Description**: EIST ERP 社区版（基于Odoo二开）
- **Primary Language**: Python
- **License**: MulanPSL-1.0
- **Default Branch**: 18.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 287
- **Forks**: 209
- **Created**: 2018-12-23
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: weixin-app, erp

**Tags**: None

## README

# Odoo 18.0 社交IM集成

本模块为 Odoo 18.0 提供社交 IM 集成，支持企业微信、微信、飞书等主流即时通讯平台的接入，提升企业内部沟通与协作效率。

## 功能特性

- **企业微信集成**：支持企业微信消息推送、用户同步、应用管理等功能。
- **微信集成**：提供微信登录、消息通知等基础功能接入。
- **飞书集成**：支持飞书机器人消息推送、飞书应用集成等。
- **统一社交配置界面**：提供统一的社交平台配置界面，方便管理多个社交平台。
- **模块化设计**：各社交平台功能模块独立，便于扩展与维护。

## 安装说明

1. 将本仓库克隆到目标目录：

   ```bash
   git clone https://gitee.com/wheist/social_im.git
   ```
2. 重启 Odoo 服务。
3. 在 Odoo 的“应用”菜单中更新模块列表。
4. 搜索“社交 IM 集成”并安装所需模块（如 `eist_social_wecom`、`eist_social_wechat`、`eist_social_feishu` 等）。

## 配置说明

1. 安装完成后，在 Odoo 的“设置” > “社交”菜单中找到对应平台的配置页面。
2. 根据指引填写各社交平台提供的凭证信息（如 AppID、AppSecret、回调 URL 等）。
3. 启用对应平台并进行测试连接。

## 使用说明

- **企业微信**：可配置企业微信应用，实现 Odoo 与企业微信的消息互通，支持扫码登录、消息推送等功能。
- **微信**：支持微信扫码登录、微信通知推送等基础功能。
- **飞书**：支持飞书机器人消息推送、飞书用户同步等功能。

## 开发与扩展

本项目采用模块化设计，新增社交平台支持可参考现有模块结构进行扩展：

- `eist_social`：社交核心模块，提供基础模型与服务。
- `eist_social_wecom`：企业微信集成模块。
- `eist_social_wechat`：微信集成模块。
- `eist_social_feishu`：飞书集成模块。

## 依赖

- Odoo 18.0
- Python 3.x
- 各社交平台官方 SDK（如企业微信、微信、飞书等）

## 许可证

本项目采用 [LGPL-3.0](https://www.gnu.org/licenses/lgpl-3.0.html) 开源许可证。

## 贡献

欢迎提交 Issue 与 Pull Request，帮助我们改进本项目。请遵循 [贡献指南](CONTRIBUTING.md) 提交代码。

## 联系我们

如有问题或合作需求，请联系：

- 邮箱：rain.wen@eist.com.cn
- 项目主页：https://gitee.com/wheist/social_im

## 加入QQ群
<img src="./docs/images/QQ群.jpg" width="400" height="712">

---

感谢您使用本模块，希望它能为您的 Odoo 系统带来更高效的社交集成体验！若该项目对您有帮助，请不吝啬打赏一杯咖啡或一包烟钱，您的支持是我们最大的动力！

<img src="./docs/images/收款码.jpg" width="400" height="545">