{"id":20806189,"url":"https://github.com/mochat-cloud/mochat-java","last_synced_at":"2025-04-09T07:06:16.321Z","repository":{"id":43551148,"uuid":"352714731","full_name":"mochat-cloud/mochat-java","owner":"mochat-cloud","description":"基于企业微信的开源应用开发框架\u0026引擎，也是一套通用的企业私域流量管理系统!","archived":false,"fork":false,"pushed_at":"2022-03-04T08:28:03.000Z","size":6432,"stargazers_count":270,"open_issues_count":3,"forks_count":112,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-02T02:22:54.121Z","etag":null,"topics":["mochat","qiye-wechat","wecom","weixin","wework"],"latest_commit_sha":null,"homepage":"https://mo.chat","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mochat-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-29T16:42:15.000Z","updated_at":"2025-03-30T02:46:46.000Z","dependencies_parsed_at":"2022-08-12T10:41:49.076Z","dependency_job_id":null,"html_url":"https://github.com/mochat-cloud/mochat-java","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mochat-cloud%2Fmochat-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mochat-cloud%2Fmochat-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mochat-cloud%2Fmochat-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mochat-cloud%2Fmochat-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mochat-cloud","download_url":"https://codeload.github.com/mochat-cloud/mochat-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247994119,"owners_count":21030050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mochat","qiye-wechat","wecom","weixin","wework"],"created_at":"2024-11-17T19:18:33.083Z","updated_at":"2025-04-09T07:06:16.302Z","avatar_url":"https://github.com/mochat-cloud.png","language":"Java","readme":"\u003cp\u003e\u003c/p\u003e\n\u003cp\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"logo\" src=\"https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/logo.png\"\u003e\n\u003c/p\u003e\n\u003ch2 align=\"center\"\u003eMoChat —— 让企业微信开发更简单\u003c/h2\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\n\u003c/div\u003e\n\n\u003cp\u003e\u003c/p\u003e\n\u003cp\u003e\u003c/p\u003e\n\u003cp\u003e\u003c/p\u003e\n\u003cp\u003e\u003c/p\u003e\n\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/header.png)\n\n## 项目简介\n\n\u003e MoChat, easy way to WeWork\n\nMoChat 是开源的企业微信应用开发框架\u0026引擎，是一套通用的企业微信管理系统，得益于 `Hyperf` 框架的优秀，MoChat 可提供超高性能的同时，也保持着极其灵活的可扩展性。\n\n### 应用场景\n\n可用于电商、金融、零售、餐饮服装等服务行业的企业微信用户，通过简单的分流、引流转化微信客户为企业客户，结合强大的后台支持，灵活的运营模式，建立企业与客户的强联系，让企业的盈利模式有了多种不同的选择。\n\n### 功能特性\n\n六大模块助力企业营销能力升级：\n\n* 引流获取：通过多渠道活码获取客户，条理有序分类\n* 客户转化：素材库、欢迎语互动客户，加强与客户联系\n* 客户管理：精准定位客户，一对一标签编辑，自定义跟踪轨迹，流失客户提醒与反馈\n* 客户群管理：于客户的基础，进一步获取客户裂变，自动拉群。集中管理，快速群发\n* 聊天侧边栏：提高企业员工沟通效率，精准服务\n* 企业风控：客户聊天记录存档，并设立敏感词库、敏感词报警，多方位跟进管理员工服务\n\n### 业务架构\n严格的分层来保证架构的灵活性\n\n![架构](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/framework.png \"mochat微信.png\")\n\n### 核心技术\n* 前端技术栈: `Vue`、`Vuex`、`Vant`、`Ant Design of Vue`\n* 后端技术栈: `Java`、`MySQL`、`Redis`、`Spring Boot`、`MyBatis-Plus`、`Spring Security`、`Jwt`\n\n### 环境部署\n\n#### 准备工作\n\n```\nJava \u003e= 1.8 (推荐1.8版本)\nMySQL \u003e= 5.7\nRedis \u003e= 3.0\nNode.js \u003e= 10\n```\n\n#### 运行系统\n\n后端运行\n\n\n##### 后端运行\n\n* 导入 IDEA 中\n* 创建数据库 `mochat` 并导入数据脚本 `api-server/install/mochat.sql`\n* 打开运行 `com.mochat.mochat.MoChatApplication.java`\n\n假设你的安装目录为 /data/www/\n\n```bash\n# 进入项目目录\ncd /data/www/\n\n# 克隆项目文件\ngit clone https://github.com/mochat-cloud/mochat-java。git\n\n# 更新子模块文件\ngit submodule update --init --recursive\n```\n\n#### 修改相关配置文件\n\ncd /data/www/mochat-java/api-server\n\n修改 MySQL 数据库连接\n\n- 编辑 `resources` 目录下的 `application.yml`查看spring配置中的active属性，然后根据属性值找到application-dev.xml或者是application-prod.xml（默认是dev环境）\n- `url` : 服务器地址\n- `username` : 账号\n- `password `: 密码\n\n修改 Redis 相关配置\n\n开发环境配置\n\n- 编辑 `resources` 目录下的 `application.yml`\n- `port` : 端口\n\n- 然后会在项目下生成 ` target` 文件夹包含 `war`  或 `jar `\n- `jar` 部署方式：使用命令行执行 `java –jar mochat.jar`\n- `war` 部署方式：`pom.xml packaging` 修改为 `war`  放入 `tomcat` 服务器 `webapps` 直接启动bin目录下的./startup.sh(linux环境下)\n\n- Nginx 配置：具体参考开发文档\n\n- 初始管理员账号为 18888888888 密码123456\n\n\n##### 前端运行\n\n```bash\n# 进入项目目录\ncd /path/to/mochat/dashboard\n\n# 安装依赖\nyarn install\n\n# 修改 .env 中的配置 \nVUE_APP_API_BASE_URL= 接口地址\n\n# 编译直接查看\nyarn run dev\n\n\n# 编译生成dist\nyarn run build\n```\n\n##### 前端部署\n\n当项目开发完毕，只需要运行一行命令就可以打包你的应用\n\n```bash\n# dashboard 打包正式环境\nyarn run build\n\n# sidebar 打包正式环境\nyarn run build\n```\n\n构建打包成功之后，会在根目录生成 `dist` 文件夹，里面就是构建打包好的文件，通常是 `.js` 、`.css`、`index.html` 等静态文件。\n\n通常情况下 `dist` 文件夹的静态文件发布到你的 `nginx` 或者静态服务器即可，其中的 `index.html` 是后台服务的入口页面。\n\n### 项目介绍\n\n#### 文件结构\n```\n.\n├── api-server------------------------------------------ 后端接口代码\n├── dashboard------------------------------------------- 管理后台前端代码\n├── sidebar--------------------------------------------- 聊天侧边栏前端代码\n└── workbench------------------------------------------- 工作台前端代码\n```\n\n##### 后端结构\n\n```\n.\n├── com.mochat.mochat\n│  ├── controller------------------------------------------- 控制器\n│  ├── config----------------------------------------------- 应用配置\n│  ├── dao-------------------------------------------------- 数据层\n│  ├── common----------------------------------------------- 公共类\n│  ├── interceptor------------------------------------------ 拦截器\n│  ├── job-------------------------------------------------- 定时任务\n│  ├── model------------------------------------------------ 模型层\n│  ├── service----------------------------------- ---------- 逻辑层\n│  ├── weixin.mp-------------------------------------------- 微信相关配置\n│  ├── Service---------------------------------------------- 服务层\n\n├── resourse\n├── docker-compose.yml\n├── docker-entrypoint.sh\n├── Dockerfile\n├── pom.xml\n\n```\n\n##### 前端结构\n\n```\ndashboard 和 sidebar 项目结构类似\n.\n├── README.md------------------------------------------- 项目说明\n├── babel.config.js------------------------------------- babel配置文件\n├── config\n│   ├── plugin.config.js-------------------------------- 插件配置文件\n│   └── themePluginConfig.js---------------------------- 主题配置文件\n├── jest.config.js\n├── jsconfig.json\n├── package.json\n├── postcss.config.js\n├── public\n│   ├── favicon.ico------------------------------------- 浏览器icon\n│   └── index.html-------------------------------------- Vue 入口模板\n├── src\n│   ├── App.vue----------------------------------------- Vue 模板入口\n│   ├── api--------------------------------------------- Api ajax 等\n│   ├── assets------------------------------------------ 本地静态资源\n│   ├── components-------------------------------------- 业务通用组件\n│   ├── core-------------------------------------------- 项目引导, 全局配置初始化，依赖包引入等\n│   ├── global.less------------------------------------- 全局样式\n│   ├── layouts----------------------------------------- 控制器\n│   ├── main.js----------------------------------------- Vue 入口 JS\n│   ├── router------------------------------------------ Vue-Router\n│   ├── store------------------------------------------- Vuex\n│   ├── utils------------------------------------------- 工具库\n│   └── views------------------------------------------- 业务页面入口和常用模板\n├── vue.config.js--------------------------------------- Vue主配置\n└── webstorm.config.js---------------------------------- ide配置文件\n```\n\n### 联系作者加入群\n\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/contact-qr3.png \"mochat微信.png\")\n\n### 部分演示图，持续更新\n\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-1.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-2.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-3.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-4.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-5.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-6.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-7.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-8.png \"demo演示.png\")\n![输入图片说明](https://mochatcloud.oss-cn-beijing.aliyuncs.com/github/demo-9.png \"demo演示.png\")\n\n\n### 版权声明\n\nMoChat 开源版遵循 [`GPL-3.0`](https://github.com/mochat-cloud/mochat/blob/main/LICENSE \"GPL-3.0\") 开源协议发布，并提供免费研究使用，但绝不允许修改后和衍生的代码做为闭源的商业软件发布和销售！\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmochat-cloud%2Fmochat-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmochat-cloud%2Fmochat-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmochat-cloud%2Fmochat-java/lists"}