Merge branch 'develop'

Author: whtsky

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.3.0
+current_version = 1.4.0
 commit = True
 tag = True
 

.travis.yml

@@ -5,13 +5,13 @@ matrix:
   include:
   - env:
     - PYTHON_MAJOR="py34|py35"
-    - PYTHON_VERSION="3.5.2 3.4.5"
+    - PYTHON_VERSION="3.5.5 3.4.8"
   - env:
     - PYTHON_MAJOR="py36"
-    - PYTHON_VERSION="3.6.2"
+    - PYTHON_VERSION="3.6.5"
   - env:
     - PYTHON_MAJOR=py2
-    - PYTHON_VERSION="2.7.12"
+    - PYTHON_VERSION="2.7.14"
   - env:
     - PYTHON_MAJOR=pypy
     - PYTHON_VERSION="pypy2.7-5.10.0"

README.rst

@@ -14,8 +14,8 @@ WeRoBot
     :target: https://jq.qq.com/?_wv=1027&k=449sXsV
 
 
-.. image:: http://werobot-slack.whtsky.com/badge.svg
-    :target: http://werobot-slack.whtsky.com
+.. image:: https://werobot-slackin.herokuapp.com/badge.svg
+    :target: https://werobot-slackin.herokuapp.com
 
 WeRoBot 是一个微信公众号开发框架，采用MIT协议发布。
 

docs/changelog.rst

@@ -1,6 +1,22 @@
 Changelog
 =============
 
+Version 1.4.0
+----------------
++ 增加 :class:`werobot.messages.events.CardPassCheckEvent`
++ 增加 :class:`werobot.messages.events.CardNotPassCheckEvent`
++ 增加 :class:`werobot.messages.events.UserGetCardEvent`
++ 增加 :class:`werobot.messages.events.UserGiftingCardEvent`
++ 增加 :class:`werobot.messages.events.UserDelCardEvent`
++ 增加 :class:`werobot.messages.events.UserConsumeCardEvent`
++ 增加 :class:`werobot.messages.events.UserPayFromPayCellEvent`
++ 增加 :class:`werobot.messages.events.UserViewCardEvent`
++ 增加 :class:`werobot.messages.events.UserEnterSessionFromCardEvent`
++ 增加 :class:`werobot.messages.events.UpdateMemberCardEvent`
++ 增加 :class:`werobot.messages.events.CardSkuRemindEvent`
++ 增加 :class:`werobot.messages.events.CardPayOrderEvent`
++ 增加 :class:`werobot.messages.events.SubmitMembercardUserInfoEvent`
+
 Version 1.3.0
 ----------------
 + 增加 :class:`werobot.messages.events.UserScanProductEvent`

docs/deploy.rst

@@ -101,10 +101,11 @@ server 支持以下几种：
 配置文件样例： ::
 
     [program:wechat_robot]
-    command = python /home/whtsky/robot.py
-    user = whtsky
+    command = python /home/<username>/robot.py
+    user = <username>
     redirect_stderr = true
-    stdout_logfile = /home/whtsky/logs/robot.log
+    stdout_logfile = /home/<username>/logs/robot.log
+    stdout_errfile = /home/<username>/logs/robot_error.log
 
 使用 Nginx 进行反向代理
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/events.rst

@@ -251,6 +251,210 @@ result           审核结果。verify_ok表示审核通过，verify_not_pass表
 reason_msg       审核未通过的原因。
 =============   ======================================================================
 
+CardPassCheckEvent
+--------------------------------
+
+生成的卡券通过审核时，微信推送的 Event。属性:
+
+=============   ======================================================================
+name             value
+=============   ======================================================================
+type             'card_pass_check_event'
+card_id          卡券 ID。
+refuse_reason    审核不通过原因。
+=============   ======================================================================
+
+CardNotPassCheckEvent
+--------------------------------
+
+生成的卡券未通过审核时，微信推送的 Event。属性:
+
+=============   ======================================================================
+name             value
+=============   ======================================================================
+type             'card_not_pass_check_event'
+card_id          卡券 ID。
+refuse_reason    审核不通过原因。
+=============   ======================================================================
+
+UserGetCardEvent
+--------------------------------
+
+用户在领取卡券时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_get_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+is_give_by_friend            是否为转赠领取，1 代表是，0 代表否。
+friend_user_name             当 is_give_by_friend 为 1 时填入的字段，表示发起转赠用户的 openid。
+outer_id                     未知。
+old_user_card_code           为保证安全，微信会在转赠发生后变更该卡券的 code 号，该字段表示转赠前的 code。
+outer_str                    领取场景值，用于领取渠道数据统计。可在生成二维码接口及添加 Addcard 接口中自定义该字段的字符串值。
+is_restore_member_card       用户删除会员卡后可重新找回，当用户本次操作为找回时，该值为 1，否则为 0。
+is_recommend_by_friend       未知。
+=========================   ==============================================================================================
+
+UserGiftingCardEvent
+--------------------------------
+
+用户在转赠卡券时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_gifting_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+friend_user_name             接收卡券用户的openid。
+is_return_back               是否转赠退回，0 代表不是，1 代表是。
+is_chat_room                 是否是群转赠。
+=========================   ==============================================================================================
+
+UserDelCardEvent
+--------------------------------
+
+用户在删除卡券时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_del_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。自定义 code 及非自定义 code 的卡券被领取后都支持事件推送。
+=========================   ==============================================================================================
+
+UserConsumeCardEvent
+--------------------------------
+
+卡券被核销时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_consume_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+consume_source               核销来源。
+location_name                门店名称，当前卡券核销的门店名称（只有通过自助核销和买单核销时才会出现该字段）。
+staff_open_id                核销该卡券核销员的 openid（只有通过卡券商户助手核销时才会出现）。
+verify_code                  自助核销时，用户输入的验证码。
+remark_amount                自助核销时 ，用户输入的备注金额。
+outer_str                    开发者发起核销时传入的自定义参数，用于进行核销渠道统计。
+=========================   ==============================================================================================
+
+UserPayFromPayCellEvent
+--------------------------------
+
+用户微信买单完成时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_pay_from_pay_cell_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+trans_id                     微信支付交易订单号（只有使用买单功能核销的卡券才会出现）。
+location_id                  门店 ID，当前卡券核销的门店 ID（只有通过卡券商户助手和买单核销时才会出现）。
+fee                          实付金额，单位为分。
+original_fee                 应付金额，单位为分。
+=========================   ==============================================================================================
+
+UserViewCardEvent
+--------------------------------
+
+用户在进入会员卡时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_view_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+outer_str                    商户自定义二维码渠道参数，用于标识本次扫码打开会员卡来源来自于某个渠道值的二维码。
+=========================   ==============================================================================================
+
+UserEnterSessionFromCardEvent
+--------------------------------
+
+用户在卡券里点击查看公众号进入会话时（需要用户已经关注公众号），微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'user_enter_session_from_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+=========================   ==============================================================================================
+
+UpdateMemberCardEvent
+--------------------------------
+
+用户的会员卡积分余额发生变动时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'update_member_card_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+modify_bonus                 变动的积分值。
+modify_balance               变动的余额值。
+=========================   ==============================================================================================
+
+CardSkuRemindEvent
+--------------------------------
+
+当某个card_id的初始库存数大于200且当前库存小于等于100时，用户尝试领券，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'card_sku_remind_event'
+card_id                      卡券 ID。
+detail                       报警详细信息。
+=========================   ==============================================================================================
+
+CardPayOrderEvent
+--------------------------------
+
+用户的会员卡积分余额发生变动时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'card_pay_order_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+order_id                     本次推送对应的订单号。
+status                       本次订单号的状态。
+create_order_time            购买券点时，支付二维码的生成时间。
+pay_finish_time              购买券点时，实际支付成功的时间。
+desc                         支付方式，一般为微信支付充值。
+free_coin_count              剩余免费券点数量。
+pay_coin_count               剩余付费券点数量。
+refund_free_coin_count       本次变动的免费券点数量。
+refund_pay_coin_count        本次变动的付费券点数量
+order_type                   所要拉取的订单类型。
+memo                         系统备注，说明此次变动的缘由，如开通账户奖励、门店奖励、核销奖励以及充值、扣减。
+receipt_info                 所开发票的详情。
+=========================   ==============================================================================================
+
+SubmitMembercardUserInfoEvent
+--------------------------------
+
+用户通过一键激活的方式提交信息并点击激活或者用户修改会员卡信息时，微信推送的 Event。属性:
+
+=========================   ==============================================================================================
+name                         value
+=========================   ==============================================================================================
+type                         'submit_membercard_user_info_event'
+card_id                      卡券 ID。
+user_card_code               code 序列号。
+=========================   ==============================================================================================
+
 UnknownEvent
 ------------