repe-assistant 社群活动助手

repe社群助手主要是为了提高社群活跃度以及群活动管理而设计。管理员使用后台web发起一系列活动并设置动态的参与口令，群成员只需要发送对应口令即可参与活动，并且能够结合积分系统做一些约束和奖励。

架构设计

机器人

bot基于nodejs平台开发，借助wechaty框架实现微信消息监听与发送

职责

定时从后台service拉取待发送信息，并发送给对应的contact。
监听微信消息，上报给后台service。
同步contact列表
同步room列表

依赖API

const uri="http://127.0.0.1:89/bot"

// 获取待发送的消息
axios.get(uri+"/task")

// 上报微信消息
axios.post(uri+"/cmd",message)

// 全量同步联系人
axios.post(uri+"/sync/user",contacts)

// 全量同步群聊
axios.post(uri+"/sync/room",rooms)

// 同步单个联系人
axios.post(uri+"/user",{id:id,name:name})

// 同步单个群聊
axios.post(uri+"/room",{id:id,name:name})

bot get-started

修改/bot/examples/apis.js文件中的配置

const uri="http://127.0.0.1:89/bot"; // service api url
const token=""; // wechaty padplus token

终端输入命令 npm start

后台服务

后台服务使用golang开发，负责解析、调度微信消息，并且为管理员后台提供web api。

tips：wechaty golang依赖包成熟后会将bot迁移到golang上来，目前是使用web api方式交互。

功能

机器人web api
管理员后台web api
微信口令解析服务 command service
任务调度服务 bot task service
活动管理服务 activity manage service

BOT API

对应的bot依赖的api接口，默认监听89端口。基于安全考虑，建议不开放外网端口，只提供bot访问。

engine.GET("/task", t.getTask)
engine.POST("/cmd", t.postCommand)
engine.POST("/user", t.postUser)
engine.POST("/room", t.postRoom)
engine.POST("/sync/room", t.syncRooms)
engine.POST("/sync/user", t.syncUsers)

WEB API

对应管理员后台的api接口，默认监听80端口。

user manage

engine.GET("/", t.getList)
engine.GET("/:id", t.get)
engine.PUT("/:id", t.update)

room manage

engine.GET("/", t.getList)
engine.GET("/:id", t.get)
engine.PUT("/:id", t.update)

activity manage

engine.GET("/", t.getList)
engine.GET("/:id", t.get)
engine.GET("/:id/log", t.getLogList)
engine.POST("/", t.add)
engine.PUT("/:id/done", t.setDone)

bot task manage

engine.GET("/", t.getList)
engine.GET("/:id", t.get)
engine.POST("/", t.add)
engine.PUT("/:id", t.update)
engine.PUT("/:id/done", t.doneTask)
engine.DELETE("/:id", t.delete)

后台服务 get-started

后台启动依赖/backend/main/tmpl和repe.yaml，因此最简单的启动命令如下：

cd ./backend/main
go build
./main

test web

后台提供两个测试web页面，以监听80和89端口为例

## 微信机器人模拟器
http://localhost:89/example/1

## 活动管理页面
http://localhost/example/1/actv

GitHub

https://github.com/xiaogan18/repe-wechat-assistant

致谢

repe bot机器人基于wechaty框架实现，十分感谢wechaty团队提供的技术让repe需求得以实现，wechaty对开源社区的贡献让人致敬。

Author: @xiaogan18 Full stack developer,specialized golang and blockchain. Code: @Github