电商|公众号微服务思路设计

2017-08-25 本文已影响91人 KennethChen93

阅读只需要五分钟，转载请注明出处。

api.pe.dotnet.sdao

=============

操作权限列表

PE_SetUp 接口（数据库操作）

PE_SetUp_Initial

PE_PeType 接口（公众号类型：组织/机构/...）

PE_PeType_ReadAll

PE_PeType_ReadByToken

PE_PeType_ReadById

PE_PeType_AddAndUpdate

PE_PeType_DeleteByTokenAndId

PE_PeType_DeleteById

PE_PeType_DeleteAll

PE_PeType_Audit

PE_PublicEntity 接口(公众号)

PE_PeType_ReadAll

PE_PeType_ReadByToken

PE_PeType_ReadById

PE_PeType_AddAndUpdate

PE_PeType_DeleteByTokenAndId

PE_PeType_DeleteById

PE_PeType_DeleteAll

PE_PeType_Audit

PE_PeMember 接口(公众号成员)

PE_PeMember_ReadAll

PE_PeMember_ReadByToken

PE_PeMember_ReadById

PE_PeMember_AddAndUpdate

PE_PeMember_DeleteByTokenAndId

PE_PeMember_DeleteById

PE_PeMember_DeleteAll

PE_PeMember_Audit

PE_AuthticationType 接口(认证类型:2017/2018/金牌/...)

PE_AuthticationType_ReadAll

PE_AuthticationType_ReadByToken

PE_AuthticationType_ReadById

PE_AuthticationType_AddAndUpdate

PE_AuthticationType_DeleteByTokenAndId

PE_AuthticationType_DeleteById

PE_AuthticationType_DeleteAll

PE_AuthticationType_Audit

PE_AuthticationStatus 接口(认证状态:草稿/提交/提交待修改/通过)

PE_AuthticationStatus_ReadAll

PE_AuthticationStatus_ReadByToken

PE_AuthticationStatus_ReadById

PE_AuthticationStatus_AddAndUpdate

PE_AuthticationStatus_DeleteByTokenAndId

PE_AuthticationStatus_DeleteById

PE_AuthticationStatus_DeleteAll

PE_AuthticationStatus_Audit

PE_PeAuthentication 接口(认证)

PE_PeAuthentication_ReadAll

PE_PeAuthentication_ReadByToken

PE_PeAuthentication_ReadById

PE_PeAuthentication_AddAndUpdate

PE_PeAuthentication_DeleteByTokenAndId

PE_PeAuthentication_DeleteById

PE_PeAuthentication_DeleteAll

PE_PeAuthentication_Audit
公众号微服务接口设计说明

文档介绍###

提供用户所属机构管理功能、机构创建、认证等。

公众号 是水道电商平台中的用户组织，由一个或多个用户同共组成，类似于现实中的企业、自媒体等等，是用于在水道电商平中进行交易或网络宣传的主体。

公众号微服务提供公众号相关功能操作的RESTful WebApi。

pe是publicEntity的意思，公众实体，类似于微信的公众号

可以把该微服务可以看做是一个微信公众号 -（服务号）。

注册一个微信公众号(订阅号，服务号，企业号)服务号和企业号注册的时候就需要先进行企业认证。

而订阅号可以是个人微信号进行注册的。订阅号是传播资讯，服务号是功能服务（可以进行开发者操作），企业号是员工管理。

假如我们的企业是一个售卖手机的公司，我们要在微信平台下的注册一个微店来对我们的产品-手机进行售卖，我们就选择注册微信服务号，首先要进行企业认证（提供企业资料，资质认证，名称认证后），等待微信审核（7天左右）通过了。该企业就可以进行开通微店。然后进行产品的上架，售卖。

所以我们的电商平台 公众号微服务 原理就跟 微信服务号差不多。某一个企业要在我们的电商平台上进行售卖自己名下的产品，就需要先注册一个微信服务号，注册的时候需要进行企业资料的审核，机构的认证，审核通过后，就可以在我们的电商平台进行售卖产品了。

设计思路概要描述###

公众号微服务的主要包括:

机构

机构基本信息的 CRUD

机构成员的 CRUD

机构认证的审核

Option Description

注册机构注册了机构，并且审核通过后才可以添加机构成员

申请机构认证比如：在百度贴吧发起一个帖子,你的身份必须是在该贴吧:"运动吧"上登录了。你不是立马就能发帖子，你必须是该“运动吧”的会员 且 你的等级得达到 “运动吧” 的要求 且 你有基础经验分（经常上浏览"运动吧"帖子而且有回帖经验而不是一般的潜水者） 才能发帖子，而我们的系统的条件是必须是注册用户，且是管理员用户才能申请机构认证。

修改认证比如：你在"运动吧"已经达到以上的要求，可以发帖子了，当你写完一篇帖子的时候，{标题："xxx",内容：“xxx” }点击发布的时候，会在后台进行审核：一般会筛选一些广告贴，敏感信息的帖子则会被立马删除而没法在“运动吧”看到你刚写的帖子。当你点击"我的帖子" 页面后，可以看到你刚才被删掉的帖子，而且带有被删除的原因，还有一个申请恢复的按钮。你觉得你发的并不是广告贴，你可以修改帖子，并且申请恢复+恢复理由提交申请恢复。被删除的帖子如果不处理的话只保留xx天的有效期则会被真正的删除。这个后台审核就类型我们系统运营人员的审核。我们可以进行再次提交申请认证，原理跟帖子被删一样。

草稿状态前端保存为草稿

申请状态提交申请

申请待修改提交申请后被驳回，这个是后台运营人员进行的审核操作+不通过的留言

认证超时如果该认证在未在有效的时间内通过审核，则是认证超时。应该是前端做处理，后端可以不需要该状态.

认证通过这个是后台运营人员进行的审核操作+通过的留言。

功能API包括：

注册机构

申请机构认证（发起申请）

修改机构认证（只允许修改有限的内容）

修改机构认证状态（是运营人员才能操作的），修改认证状态 + 认证回复（回复可以不填）

Option	Description
注册机构	注册了机构，并且审核通过后才可以添加机构成员
申请机构认证	比如：在百度贴吧发起一个帖子,你的身份必须是在该贴吧:"运动吧"上登录了。你不是立马就能发帖子，你必须是`该“运动吧”的会员` 且 `你的等级得达到 “运动吧” 的要求` 且 `你有基础经验分（经常上浏览"运动吧"帖子而且有回帖经验而不是一般的潜水者）` 才能发帖子，而我们的系统的条件是必须是注册用户，且是管理员用户才能申请机构认证。
修改认证	比如：你在"运动吧"已经达到以上的要求，可以发帖子了，当你写完一篇帖子的时候，{标题："xxx",内容：“xxx” }点击发布的时候，会在后台进行审核：一般会筛选一些广告贴，敏感信息的帖子则会被立马删除而没法在“运动吧”看到你刚写的帖子。当你点击"我的帖子" 页面后，可以看到你刚才被删掉的帖子，而且带有被删除的原因，还有一个申请恢复的按钮。你觉得你发的并不是广告贴，你可以修改帖子，并且申请恢复+恢复理由提交申请恢复。被删除的帖子如果不处理的话只保留xx天的有效期则会被真正的删除。这个后台审核就类型我们系统运营人员的审核。我们可以进行再次提交申请认证，原理跟帖子被删一样。
草稿状态	前端保存为草稿
申请状态	提交申请
申请待修改	提交申请后被驳回，这个是后台运营人员进行的审核操作+不通过的留言
认证超时	如果该认证在未在有效的时间内通过审核，则是认证超时。应该是前端做处理，后端可以不需要该状态.
认证通过	这个是后台运营人员进行的审核操作+通过的留言。

设计思路详细描述###

机构基本信息表
字段：
{
 Id:"自增编号"
 机构logoUrl："logoUrl",
 类型："{企业，组织（公司），个体}",
 名称:"全称",
 简称:"用于显示", 
 注册号/组织号："营业执照号或者组织机构代码(string类型)",
 执照的照片：（允许上传多个是一个链接）
 管理员真实姓名："xxx",
 管理员手机号："xxx",
 ownerId:"管理员Id（必须是登录的管理员才能注册机构.UserId）"
 是否审核通过："针对该注册的机构 是否真实存在",
 审核备注：“...”
 ...
}
注：ownerId既是userId必须是管理员Id才能注册公众号，基本的用户是没法注册的。

执照的照片允许上传一个到多个。

有效期是与机构审核表相关的。

同个ownerId可以创建多个机构。

机构成员表
字段：
{
 Id:"自增Id"
 uId："成员Id",
 peId："所属的机构Id",
 uName:"成员机构内名称"
 ...
} 
注：uId代表是用户注册后的userId。暂时不需要限定角色。

uName 类似在微信群里的群别名。
这个表一般用来与机构关联，一个机构下有：销售成员，售后成员，客服等等。

机构认证表
字段：
{
 Id:"自增Id"
 peId："机构Id",
 认证申请时间："",
 是否已通过:[状态]
 认证完成时间:"",
 认证资料:"(多个链接：协议书，图片等等)"是一个json数组对象:[{name:'xx'，url:'...'},{name:'xxx',url:'...'}],
 认证申请人:""
 认证类型：(首次申请认证/2016/2017/2018/会员认证/顶级供应商认证/金牌/银牌等等,是一个通用的认证类型)
 认证有效时长：（天为单位），
 认证回复：
 [
    {
     回复时间：'',
     留言:'',
     回复者Id
    }，
    {
     回复时间：'',
     留言:'',
     回复者Id
    }，
    ...
 ]
 ...
} 
认证有效时长与认证类型有关系：有些认证类型的时间长，有些的时间短。

认证与回复是一对多的关系，发起一个认证，在这个认证内，有多个流程，多个回复，比如说，现在要申请一个2017（认证类型）的认证，我后台审核，第一次审核不通过。被撤回并携带一个认证回复留言：需要补交XXX认证资料。当我收到留言后，我修改了该条机构认证信息，补交了认证资料。

可以把发起一个机构认证看做是在github 上面提的issue，下面可以写很多个回复，也可以把这个issue close掉。
同一个peId下的认证类型只能存在一个,不能存在相同的认证类型提交认证。

申请认证的以后可能会改版：比如说：发起年度申请认证等等...

认证回复表
字段：
{
 Id:"自增Id"
 机构认证表Id："1001",
 回复内容："...",
 回复时间:"...",
 回复者Id:"..."
}
与机构认证表是一对多关系。

理解流程###
某一个登录用户，注册了一个机构，填写机构的logoURL,机构类型，机构名称，机构简称，注册号/组织号，上传执照的照片，管理员真实信息，管理员手机号。
注册成功后，代表该机构已经存在，并且可以建立自己的机构成员。

该机构注册的时候需要判断在同一类型下的名称全称与注册号不能相同。
当后台制定了机构认证类型：2016年审核/2017年审核/金牌审核/银牌审核/...等等。
假如某一个机构想进行2016年审核,则需要上传针对2016年审核的审核资料，然后提交审核。
审核状态：草稿，申请，申请通过，申请待修改(申请了被驳回.)

运营人员审核的时候，有两种结果：审核通过，审核不通过。
- 第一次审核通过 + 留言："恭喜你...审核已通过"
当该机构审核成功后就可以建立自己的机构成员。
- 审核不通过
第一次审核不通过，运营人员留言：缺少xxx资料，请补充上传。相当于撤回操作。

该机构的管理者收到留言，如果是在认证有效时长内，可以修改机构的信息（重新上传xxx资料），再次提交该条申请审核。

运营人员收到该机构申请信息，审核提交的新资料，不通过的话，再次驳回+留言。回到第二步的步骤，否则申请通过+留言，流程结束。

当申请已通过后，不能再回复。不能再修改。
认证类型与认证有效时长是根据页面版面指定的。

电商|公众号微服务思路设计

api.pe.dotnet.sdao

文档介绍###

设计思路概要描述###

设计思路详细描述###

理解流程###

猜你喜欢

热点阅读

电商|公众号微服务 思路设计

api.pe.dotnet.sdao

文档介绍###

设计思路概要描述###

设计思路详细描述###

理解流程###

猜你喜欢

热点阅读

电商|公众号微服务思路设计