活石需求2.8

活石小程序

12/25
1. 补充页卡后台字段描述
2. 补充页卡后台需求

页卡字段要求

• 页卡包含字段：
  
  • 图标：标准图片格式，支持png/jpg/jpeg等
  • 标题：中文+英文字符，最多支持15个汉字
  • 时间：以实际发布时间为准，格式：当天的只显示时、分，隔天的显示月、日、时、分
  • 摘要：人工录入，支持换行、最多150个汉字
  • 按钮：最多支持10个汉字
  • 链接：即跳转路径

页卡后台需求

功能：
1. 优化和修复bug
2. 首页功能
3. MD文档格式插入功能
4. 感恩圈功能
原型地址：https://modao.cc/app/WWCglzWIPl0Li465JW5Yg6QzKSM2Z1H

优化背诵页

• 优化登录
  
  • 拒绝或者登录失败：当用户在登录授权页拒绝登录时或其他原因导致的登录失败，在【背诵】页面点击任何按钮时，都不执行下一步，而是通过wx.authorize(OBJECT) 这个api重新唤起授权登录框。即用户没有登录，就不能进行背诵页面的下的任何操作
• 背诵首页新增好友头像功能
  
  
  • 在背诵首页展示用户好友头像
  • 最多展示9个，多余的展示省略号；最少展示1个，全部居中对齐；当一个用户都没有的时候，留空什么都不展示
  • 头像与头像之间进行叠放
  • 头像选择逻辑：用户的好友

• 优化已背诵内容列表

  • 【今日】tab下，当无数据时，显示提示文案：今天你还没有开始背诵，暂无数据；【历史】tab下无数据时，显示文案：你还没背诵过圣经经文，快去背诵神的话语吧。

• 优化填词打码比例：将比例降低到50%

• 优化圣经阅读页字号：将字号放大一号字体

优化【我】页面

• 优化登录

  • 拒绝或者登录失败：当用户在登录授权页拒绝登录时或其他原因导致的登录失败，在【我】页面点击任何按钮时，都不执行下一步，而是通过wx.authorize(OBJECT) 这个api重新唤起授权登录框。即用户没有登录，就不能进行我页面的下的任何操作

• 将“意见反馈”，文案改为“打小报告”

• 新增：“推荐活石”
  
  • 功能：用户点击后，分享当前页面。分享标题是：点击进入XXX向你推荐的背圣经工具，同样要带分享码，用户通过分享进入活石首页

修复

• 修复背诵历史页面没有数据只有10多条的bug
• 修复邀请码问题

新增：首页

• 新增首页tab，首页内容以消息页卡的方式展示定制化的内容
• 消息页卡定义：即在首页展示的每个独立内容，拥有扩展性，目前阶段已经确定的页卡有：
  
  • 每天十分钟背圣经
  • 感恩圈
  • 每天解释一个小问题
  • 值得分享的主内新闻
  • 有趣但无用的主内冷知识
  • 主内谣言粉碎机
  • 帮助活石做好做强

• 消息页卡属性：

  • 展示属性：
    消息页卡的展示分两类：常驻展示和更新展示
    
    • 常驻展示：即页卡不会隐藏，将一直在首页可见，可供用户使用
    • 更新展示：即页卡只有在有内容更新的时候，才会展示，并在3天无更新后隐藏
  • 排序属性：
    消息页卡在首页的前后排序，按更新时间从新到旧排序。
    特殊：背圣经页卡始终置顶，即始终是第一位
  • 提示属性：
    
    
    • 更新在首页&&未被用户点击进入过的，有未读红色角标提示
    • 用户点击后，红色角标消失
    • 特殊：背圣经页卡，当且仅当背诵任务完成后，红色角标才消失
  • 功能属性：
    即页卡不同组织部分之间的功能描述
    
    • 标题：标题区域都是固定的
    • 时间：时间格式：月+日+时+分（24小时制），这个时间为发布在首页的时间
    • 图标：图标分为两种，一类是固定图标，这类图标不会变动。一类是计数图标，即针对有打卡内容的页卡，将累计的打卡天数在图标里展示，所以这类图标是变化的
    • 摘要：页卡的摘要会针对不同的消息页卡提供不同的数据来源
    • button按钮：button是可选的，即字段为1的时候就展示，为0的时候就不展示
    • 链接：上述组成元素，每个都有指向的链接。一般情况下，图标+时间+标题，是指向同一个；摘要+button是指向另一个；也可能四者都指向同一个链接
    • 列表：即有的页卡会有一个内容列表页来展示历史内容，包括主题和摘要。
    • 内容页：内容页需要尽量完美的展示样式格式，以及带有分享按钮

• 消息卡详情

  • 每天十分钟背金句
    
    • 图标：图标上居中展示当前背经打卡的天数
    • 标题：标题固定为：每天十分钟背金句
    • 时间：固定在每天00:01的时候发布
    • 摘要：从接口中取【背诵主题】、【已背诵节数】数据，文案为：
      
      • 有主题，但未完成当日背诵：你已经熟背了23句经文，当前正在进行「信心」的背诵，快开始今天的背诵吧。
      • 有主题，但已经完成当日背诵：你已经熟背了23句经文，当前正在进行「信心」的背诵，已经完成今天的背诵，快分享出去给大家看看。
      • 无主题，或用户一次都没用过背诵：活石智能背金句，简单记得牢，点击进来体验吧。
      • 按钮：固定显示：开始背诵
      • 链接：点击页卡任何位置，都进入背诵的主页
        

  • 每天解释一个小问题

    • 图标：固定图标
    • 标题：标题固定为：每天解释一个小问题
    • 时间：每天固定在8:00发布
    • 摘要：接口提供
    • 按钮：无按钮
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，每天自动获取即可

    

  • 感谢坛

    • 图标：固定图标
    • 标题：标题固定为：感谢坛——以感谢献上为祭
    • 时间：以实际更新时间为准
    • 摘要：固定内容：
      「凡以感谢献上为祭的，便是荣耀我。那按正路而行的，我必使他得着我的救恩。」（诗篇50:23）
      进来，写下每一个感恩神的小经历；
      转发，与更多人欢呼诉说神的作为；
    • 按钮：固定显示：点击进入
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，即这部分内容需要有个入口人工录入数据
      

  • 值得分享的主内新闻

    • 图标：固定图标
    • 标题：标题固定为：值得分享的主内新闻
    • 时间：以实际发布时间为准
    • 摘要：接口提供，即这部分内容需要有个入口人工录入数据
    • 按钮：无按钮
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，即这部分内容需要有个入口人工录入数据
      

  • 有趣但无用的主内冷知识

    • 图标：固定图标
    • 标题：标题固定为：有趣但无用的主内冷知识
    • 时间：以实际发布时间为准
    • 摘要：接口提供，即这部分内容需要有个入口人工录入数据
    • 按钮：无按钮
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，即这部分内容需要有个入口人工录入数据

  • 主内谣言粉碎机

    • 图标：固定图标
    • 标题：标题固定为：主内谣言粉碎机
    • 时间：以实际发布时间为准
    • 摘要：接口提供，即这部分内容需要有个入口人工录入数据
    • 按钮：无按钮
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，即这部分内容需要有个入口人工录入数据

  • 帮助活石做好做强

    • 图标：固定图标
    • 标题：标题固定为：帮助活石做好做强
    • 时间：以实际发布时间为准
    • 摘要：接口提供，即这部分内容需要有个入口人工录入数据
    • 按钮：无按钮
    • 链接：点击图标、标题、时间，进入列表页；点击摘要进入内容页
    • 内容：内容由接口提供，即这部分内容需要有个入口人工录入数据

MD文档格式插入功能

背景：由于小程序没有富媒体编辑内容的功能，所以打算所有的富文本编辑采用Markdown的语法传入。当然不是全部的MD语法，而是根据实际需求选择部分常用的。最终状态是，在编辑后台传入含有一定格式的MD内容，小程序前端根据约定好的规则，将内容样式展示出来

• 需求
  
  • 支持在小程序内展示基本的MD格式
  • 可以有个简单的后台去传内容数据
• 讨论
  这部分的具体需求希望跟你详细讨论下，目前网上有些开源的资料可以用，你可以先看看
  https://github.com/sbfkcel/towxml
  https://www.icmsdev.com/docs/

感谢坛功能

• 介绍：简而言之，这就是一个类微博的发布和展示功能。允许用户发布纯文本的内容以及允许用户浏览别人发布的纯文本内容。主要功能包括：写内容、读内容、审核发布内容三个部分

• 写内容

  • 入口：位于感谢坛列表的右下角，且始终悬浮固定，点击即进入文本编辑页

  • 编辑页面：

    • 字数限制：500字，超出500字时，点击【提交】提示toast“字数超了XX个，再精炼下文字吧”
    • 支持换行、微信表情和特殊字符
    • 用户点击发布后，弹出toast提示：提交成功，请等待小编发布。然后自动返回内容列表页

  • 底部说明内容：
    小提示：

    1. 过滤：采用微信公众号留言评论形式，过滤不合适的内容后再发布；
    2. 更新：90%内容都会顺利发布，每个整点更新一次；
    3. 鼓励：鼓励分享每天经历神的小故事，暂时不支持代祷信息、灵修信息等非感恩相关的内容；
  • 敏感词过滤
    
    • 在用户点击【发布】之后，进行一次敏感词内容匹配，如果匹配成功，则弹出toast提示“文中含有适宜的词语，请修改后发布”
    • 具体敏感词库我会单独提供给你，这部分为了效率，就直接写在本地进行匹配就好，不再走服务器端，参考网站：http://blog.csdn.net/shuyou612/article/details/74931955

  

• 读内容
  
  • 入口：即首页的【感谢坛】页卡，点击后进入感谢坛的内容列表页
  • 排序：按用户发布的时间顺序从新到旧排序
  • 展示元素
    
    • 头像：男性用户为蓝色边框，女性用户为红色边框
    • 昵称：显示用户昵称
    • 时间：显示发布的时间，格式：月+日+时+分（9/27 16:50）
    • 正文：显示全文
    • 笑脸：可以理解为点赞按钮，这里变成笑脸符号。有两个状态符号，分别在用户点击前后切换不同ico；同时点击后数字+1
  • 列表支持异步加载，每次加载20条，最多可以取出最近的300条数据。当没有新数据取或者取到300条的时候底部显示文案“暂时没有内容了，请等待下个整点更新”
  • 详情页：暂时不用做详情页

• 审核发布
  
  • 所有用户发布的内容，需要汇集到一个管理后台，管理后台的感谢坛部分的字段包括：用户昵称、发布时间、发布内容、状态（屏蔽，待发布，已发布）
  • 发布策略：
    
    • 所有的内容，在提交后默认状态是“待发布”
    • 定时发布，即每个整点时刻（如：08:00,09:00），批量发布当前所有状态为“待发布”的内容
    • 支持在后台批量多选，支持一键修改所有选中内容的状态

功能：
1. 个人中心页
2. 经文历史页
3. 填词背诵页
4. 提醒服务
5. 其他优化

交互原型地址：
https://modao.cc/app/WWCglzWIPl0Li465JW5Yg6QzKSM2Z1H
接口文档地址：
https://www.teambition.com/project/567b9265e1ae4c6c0ccdd46e/works/56b08fb46ac388421d1dc9e2/work/587f757073d70d9d63d813a7

个人中心页

• 原型图
  
• 个人中心只做两部分：反馈和展示用户的头像与昵称
• 原型图素材和切图晚点发邮箱。
• 反馈：直接接入小程序客服功能
• 用户头像，需要增加一个用来表示性别的外框，稍微粗一点，但是也不能太粗
  
  
  • 女性色值：#ffb1b3
  • 男性色值：#8ad4ff

新增背诵历史查询

• 原型图
  
  左右各间隔20px，标题和正文直接间隔15px，正文和横线直接间隔20px，两个tab下内容一样，只是传的数据不同（这部分就不给设计稿了，直接按原型图做样式就行）
• 展示四个数据，都由接口提供：主题、来源、经文、复习次数
• 接口文档：1.15、历史背诵列表

填词背诵页

样式需求

读圣经页

• 章的样式大小
  调整红框区域每个小圆圈的大小，在一行8个章数不变的情况下，调整底部所占的高度和长度，使每个圆圈变大，即增加可点击的面积。
  

背圣经页

• 样式如下：
  
  
  • 背景改为与圣经阅读tab灰底一样的色值
    +【当前背诵】为白色
    +【开始背诵】button色值为#3baedb

填词复习功能

• 介绍
  填词复习功能，即在复习阶段，随机筛选出一部分字打码，并在底部选词区域显示，用户通过点击选词区域的词语，按顺序填入正确的字，并在最后检查正确性。
• 样式图：
  

• 功能详细说明

  • 原文打码
    原文打码逻辑，同现有打码逻辑，把打码率提高到80%，即只展示20%的文字

  • 打码文字展示
    将打码的文字保存下来，并打乱顺序，展示在选词区域

  • 选题填空

    1. 用户按顺序点击选词区域的词，每单击一个词，就在原文区域对应空位显示这个词，暂不检查正确性
    2. 选词区域的词被选中后，状态切换为灰底灰色的选中状态，同时该词无法再被点击选中
    3. 在原文区域，填入的词字体颜色与主蓝色色号一致
  • 检测正确率
    
    1. 用户选择最后一个词，在该词填入后，自动检测正确率。
    2. 若全对，显示下一步的button；若有错，则错误的词语红色高亮，维持3秒，3秒后，全部空格清空，用户重新选词填空
    3. 注意：在检查后，正确的文字字体颜色变化为和原来原文的字体颜色，错误的颜色高亮为红色
  • 修改空格
    
    1. 用户在没有填入最后一个空之前，都可以修改当前空格的内容
    2. 用户点击对应空格位置，若该位置有字，则删除该位置上的文字，并在选词区域取消对应文字的选中状态。
       
  • 算法参考
    
    1. 取经文数据的时候，拿到经文数据后做一个处理，把标点符号先处理掉，保留不含标点的文字
    2. 根据文字的数量列出一个数字，比如一段经文有17个字，则列出1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17
       的数字
    3. 按80%的打码比例打码，那么就是17*0.8=13.6，删掉小数取整数13。也就是说，从上面1-17个数字里，随机取13个数字出来
    4. 做个对应关系，找到这13个数字对应的文字
    5. 因为数字就代表了在一段经文里的顺序，且针对每个经文，每个数字又都代表一个唯一的文字。那么就可以把取出来的13个数字代表的文字随机在底部摆放展示

流程顺序说明

• 背诵流程分为2部分：新增背诵和复习背诵
  
  • 新增背诵：
    
    • 新增背诵一般是每天有2节
    • 新增背诵也分为两部分，一部分是初记阶段，如下图，有注释，有下一步button，有次数按钮。
      
      另一部分是初记复习阶段，初记复习阶段就引入全新的填词复习功能。
    • 填词功能将生效于目前所有需要复习的页面，包括初记复习和金句复习页面。即替换现有的文字遮挡功能

提醒服务

• 目的：通过用户的设置，对用户进行定时背圣经提醒

• 流程

  • 设置入口：我——开启提醒
    

  • 默认状态为关闭状态，关闭状态下，时间设置部分不可点击

  • 点击打开提醒，此时下一行时间为可选择状态

  

  • 点击【选择时间】，调起时间选择控件。默认时间为20:00
    
  • 选择完时间后，点击保存，此时提醒功能生效
  • 发送提醒：在用户指定的时间发送指定的内容
  • 打卡模板：
    
    • id：KPnDXwoHdqL91f1ua7zfDuwh1sc43A__nK88zVNY41Q
    • 
      打卡项目
      {{keyword1.DATA}}——背圣经打卡（这是固定文案）
      课程名称
      {{keyword2.DATA}}——取当前用户背诵的主题名称展示
      提示语
      {{keyword3.DATA}}——每天十分钟，圣经记心中，不要忘记我们今天背圣经的约定
      已打卡次数
      {{keyword4.DATA}}——取用户当前的打卡天数

分享邀请码

• 目的：通过用户分享时带上用户的user_id，使得用户与用户直接产生关联关系
• 实现逻辑：
  
  • 用户A分享的时候，在任何分享页面分享时，均带上A用户的user_id作为参赛
  • 用户B通过A用户分享的链接进入小程序并且完成登录后，将A用户的user_id写入自己的 invitation_code 中
• 接口：1.13、邀请

其他优化

1. 优化：小程序修改了用户信息获取的逻辑，现在的小程序还是之前的逻辑，这部分需要更新一下新的用户信息获取方法
2. 修复：直接分享内页，其他用户通过点击进来后，无法获取用户信息。此前是可以的，推测跟微信修改了用户信息获取方法有关
3. 优化：用户通过分享的点击进入，自动带一个分享参数进来，上报给后台接口

不确定性需求记录

• 优化绕审核功能
  背景：为了绕过审核，允许圣经tab在用户符合某些条件下才展示。

  • 功能
    
    • 当且仅当用户背诵圣经天数<=2 天的时候，将【圣经】tab替换为指向【背诵】tab，即图标使用【圣经】图标，不变；文字在满足条件时由“圣经”改为“背诵”；页面所指向的链接，也由指向圣经目录页改为指向背诵页
    • 即对一个用户，默认是展示背圣经页面，当且仅当背诵天数满足条件的时候，进行内容隐藏与替换。这部分在用户登录授权的时候就开始进行，必须等内容完全隐藏和替换结束后才从加载登录页面完成加载，即通过延长一部分登录时间来确保替换内容是肉眼不可见的。

  完成背诵后自动出题功能

  背景：即在用户完成背诵后的结果页，出现一个入口，【给好友出题】，用户点击后，进入一个出题页面

• 功能
  
  • 数据来源：为了保证效率，在本地创建数据库，保存一个题库，存放若干经文数据。这部分数据会单独提供。
  • 形式：采用选词填空的模式，即用户分享一个独立的单页出去，其他用户进入这个单页后，去完成一节经文的选词填空，填完提交，计算正确率。
  • 要求：
    
    • 每个用户分享的单页是唯一的，且带邀请码
    • 直接在单页内完成一次经文选词填空操作
    • 单页内会展示分享者的基本信息，包括：分享者头像、昵称、已经背诵的天数、累计背诵节数等