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

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

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包括:

    • 注册机构
    • 申请机构认证(发起申请)
    • 修改机构认证(只允许修改有限的内容)

    • 修改机构认证状态(是运营人员才能操作的),修改认证状态 + 认证回复(回复可以不填)


  • 设计思路详细描述###

    • 机构基本信息表
    字段:
    {
     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年审核的审核资料,然后提交审核。
    审核状态:草稿,申请,申请通过,申请待修改(申请了被驳回.)

    运营人员审核的时候,有两种结果:审核通过,审核不通过。

    • 第一次审核通过 + 留言:"恭喜你...审核已通过"
    • 当该机构审核成功后 就可以建立自己的机构成员。
    • 审核不通过
    1. 第一次审核不通过,运营人员留言:缺少xxx资料,请补充上传。相当于撤回操作。
    2. 该机构的管理者收到 留言,如果是在认证有效时长内,可以修改机构的信息(重新上传xxx资料),再次提交该条申请审核。
    • 运营人员收到 该机构申请信息,审核提交的新资料,不通过的话,再次驳回+留言。回到第二步的步骤,否则申请通过+留言,流程结束。
    • 当申请已通过后,不能再回复。不能再修改。

    认证类型 与 认证有效时长 是根据页面版面指定的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,393评论 5 467
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,790评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,391评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,703评论 1 270
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,613评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,003评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,507评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,158评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,300评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,256评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,274评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,984评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,569评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,662评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,899评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,268评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,840评论 2 339

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,559评论 18 139
  • 第二章 开始啦 Command-Line Program shell mode 输入sqlite3即可。如果不指定...
    我是花老虎阅读 430评论 0 0
  • 不少著名摄影师在旅途中,会拍摄异地或街头的人像作品,虽然拍摄时未必有精确的灯光可供控制,拍摄时间也可能仓促,但他们...
    徕摄街头阅读 2,494评论 0 6
  • 想要睡一个高质量的美容觉,就要学会聪明地挑选睡前食物。有的食物是天然的“安眠药”,可以帮你舒缓情绪、安神助眠,而有...
    开心药师阅读 191评论 0 1
  • 每个深夜都是矛盾体在释放,忍住了,你是天使;忍不住,你是恶魔。 圣诞结,嗯,我没写错,不是圣诞节; 有些事,解得开...
    浣星阅读 405评论 4 2