活石小程序

活石APP

5/6
需求点：
1. 新增个人中心
2. 新增背诵历史查询

新增个人中心

• 个人中心只做两部分：反馈和展示用户的头像与昵称
• 原型图已经发在邮件里，这部分你之前做过。
• 需要注意：用户头像读取失败的时候，用默认头像代替（这种概率好像发生的情况很低吧，你评估下需不需要这么做）
• 反馈：直接接入小程序客服功能，一行代码的事
• 用户头像，需要增加一个用来表示性别的外框，稍微粗一点，但是也不能太粗
  
  
  • 女性色值：#ffb1b3
  • 男性色值：#8ad4ff

新增背诵历史查询

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

4/12
背圣经优化：
1. 新增注释功能及优化部分UI
2. 新增拼写功能
3. 新增上报日志
4. 新增用户关系链

综述

原型demo地址：https://modao.cc/app/WWCglzWIPl0Li465JW5Yg6QzKSM2Z1H

优化UI

• 按demo优化UI

新增注释功能

数据将由接口下发，见最新接口文档

• 注释功能入口（出现的场合）
  
  • 金句初记时默认首展展示
    
  • 金句复习时用户点击【我再瞅一瞅】时展示
    
• 策略
  
  • 没有内容时，高度缩短，显示文字“暂无注释，自己动脑筋记忆吧”
  • 固定注释区域高度，内容超出时允许滚动
  • 以“【”这个符号作为换行（这个评估下能不能实现）

新增用户关系链

• 目的
  通过用户分享后，携带用户ID的参数，来判断是哪个用户点击了这个分享登录了小程序。并将这个用户的关系上传服务器
• 形式
  通过分享带参数，具体我会发一个demo给你看

新增拼写功能

• 拼写功能入口
  
  • 金句初记的第三步，即在遮挡页面用户点击【我记住了】后进入下一步时出现拼写
  • 金句复习的第二步，即在复习遮挡页面，用户点击【我记住了】后进入下一步时出现拼写
• 拼写逻辑
  
  • 按50%随机取要拼写的字
  • 字必须全部写对才可以完成进入下个环节
  • 用户点击下一步，对错误的字进行标红，并弹出toast提示用户修改，文案为“糟糕~~有错字，快点修改”。
  • 用户点击右上角【提示】时，当前输入光标位于哪一个位置，则在该位置填入正确文字，当光标没有位于任何空白位置时，则按顺序填入第一个空缺内容。

新增接入微信客服功能

• 背诵首页底下的文字链，打开后由现在进入选择列表页改为进入小程序客服页，这部分可以直接添加小程序客服

小程序上报日志

见：https://mp.weixin.qq.com/debug/wxadoc/analysis/custom/#测试事件配置

背圣经功能
已完成

2/16 背圣经需求

• 接口需求
  
  • 背诵流程
    
    • 用户进入小程序，启动登录授权
    • 用户在小程序内，进入背圣经页面
    • 用户点击开始背诵按钮就行背诵
    • 如果用户没有选择背诵主题或者当前主题已经全部背诵完了，则只返回需要复习的经文；如果需要复习的经文都没，则都提供null值
    • 用户首先获得今天需要首次背诵（又称为新增背诵）的第一条经文
    • 用户完成新增背诵、经文复习，开始接收第二条今天需要首次背诵的经文
    • 用户发现不想背这个，于是选择忽略。
    • 忽略后，再获得一条新的，今天需要首次背诵的经文。
    • 用户完成了两节新增背诵后，开始进入此前已经背诵过的经文的复习阶段
    • 用户依次序完成了复习内容
    • 没有新内容了，进入完成背诵页面，结束一整个背诵经文周期

• 接口

  • 用户进入小程序，授权完成小程序下的注册
    
    • 微信接口文档：https://mp.weixin.qq.com/debug/wxadoc/dev/api/api-login.html#wxloginobject
    • 客户端会发送一个code给服务端,服务端返回一个登录的session给客户端,下次请求接口客户端会带上这个登录的session,这样服务端就知道是哪一个微信用户了
      
    • 注意 将微信用户字段写入我们现有的用户表里，图片和昵称就直接保存微信传来的。同时新增一个微信ID字段用以区分。目前不考虑老用户的情况，即原来手机注册的用户，如果用微信登录了，先作为一个新用户处理。等以后我们在小程序里做手机注册的二次验证时再统一处理。当前阶段，只做最简单的用户信息保存
  • 用户进入小程序背圣经页面，下发：
    
    • 今天新增背诵的主题ID、经文ID、来源书目、章号、节号、内容，默认传2条新增背诵记录作为用户每日新增背诵的内容，如果没有新增背诵，传一个参数提示小程序
    • 今天需要复习的主题、经文ID、来源书目、章号、节号、内容、复习次数。复习的内容，每天有多少，下发多少记录
  • 如果新增经文为null+需要复习经文为null，则要提示用户选择主题，用户选择主题后，上报选择的主题ID，服务端根据ID进行新增经文的分配；如果新增经文为null+复习经文不为null，则直接进入复习而不考虑新增。

  • 小程序端根据下发的接口内容，计算今天要复习几节，新增背诵几节，并展示在页面上

  • 用户忽略经文，小程序上报给服务端，服务端做标记，被忽略的经文在该主题内所有新增背诵和复习背诵里，均不再出现，同时，从没有背诵过的经文里，取ID+1的下一节经文下发给小程序

  • 当所有今日需要背诵的内容背诵完，小程序点击“我记住了”后，上传给服务端所有数据，此时小程序进入背诵完成页。

• 背景介绍
  背圣经，本质上就是提醒用户什么时候该背哪部分内容的功能
  分三块内容

  • 背诵主题
    这部分包括：主题名称、主题ID，在小程序里可以在列表页把主题名称写死，因为是不会变的
  • 背诵经文
    背诵经文包括：主题ID、经文ID、来源书目、来源章、来源节、内容，所有数据，由服务器下发
  • 背诵逻辑
    包括：每天新增加的背诵是哪些、需要复习的内容是哪些

• 用户操作流程
  具体demo见下面地址
  https://modao.cc/app/rT5KjIkcYZACppF8cb327niSt0f32yi

• 新增需求
  增加一个背诵进度可视化展示功能，如下图
  
  在最开始，服务端传递数据，告诉本地需要新增多少节背诵，复习多少节背诵。
  在复习页面，点击“我记住了”，则标记当前节完成，进度+1，并修改后面的数字。数字组合，斜杠左侧为当前背诵第几个，右侧为本轮背诵总节数

• 还有需要用到微信的用户登录功能，我们现在app有用户关系，不过是通过手机号注册，所以小程序上，这一期简单的先用微信的登录接口，把传来的参数传给服务器，服务器创建用户（即在现有用户表基础上增加一个微信的字段）

2/11 测试反馈

• 每卷书对应的章的数量不准
  这部分我把文件改好了，发给你你替换下

• 内容页底部还缺少翻页button
  
  默认第一章时，上一章 字体灰色不可点击；最后一章时，下一章字体灰色不可点击状态

• 样式问题

  • 现在好像不是微软雅黑？看起来不太像，如果不是，就都改成微软雅黑吧
  • 有时候有些段落突然莫名的行距变大了
    
  • 段首位置，再往左侧移动一个汉字的距离，不需要隔的那么远

• 内容还缺个小标题
  
  数据库应该有数据，辛苦看看怎么放出来吧

• 增加右上角菜单的分享项目，包括分享给好友，添加到桌面等所有分享

1/19 修改意见

• tab顺序调整一下，旧约在左，新约在右
  
• 目录的字加粗，首字放大几个字号（放大的字号以最长的字“帖撒罗尼迦前书”不换行为准，整体可以往左再移动几个像素，）
  
• 点击目录，在当前目录下方弹出章节选择的区域，现在是在最底下弹出

• 增加右上角菜单的分享项目，包括分享给好友，添加到桌面等所有分享
  

• 文字展示区域，当接口返回的为空值时，则不做任何展示。

新增需求

• 【新约】底部，增加一个可以文字展示区域
  如图
  

• 关于经文页的读取，希望可以做一个小优化。在阅读当前章的时候，默认再把后面2章加载出来。即例如当前阅读第三章，则把4、5章也预加载出来，使点击下一章的时候可以体验更好。
  这个需要需要审核下可行性

首页

• 默认为首展页
• 分为两个tab：旧约、新约，每个tab下的书卷名称写死固定
  
  • 旧约（括号内为章数）
    创世记（50）、出埃及记（40）、利未记（27）、
    民数记（36）、申命记（34）、约书亚记（24）、
    士师记（21）、路得记（4）、撒母耳记上（31）、
    撒母耳记下（24）、列王记上（22）、 列王记下（25）、
    历代记上（29）、历代记（36）、以斯拉记（10）、
    尼希米记（13）、以斯帖记（10）、约伯记（42）、
    诗篇（150）、 箴言（31）、传道书（12）、
    雅歌（8）、以赛亚书（66）、耶利米书（52）、
    耶利米哀歌（5）、以西结书（48）、但以理书（12）、
    何西阿书（14）、约珥书（3）、阿摩司书（9）、
    俄巴底亚书（1）、约拿书（4）、弥迦书（7）、
    那鸿书（3）、哈巴谷书（3）、西番雅书（3）、
    哈该书（2）、撒迦利亚书（8）、玛拉基书（4）、
  • 新约（括号内为章数）
    马太福音（28）、马可福音（16）、路加福音（24）
    约翰福音（21）、使徒行传（28）、罗马书（16）
    哥林多前书（16）、哥林多后书（13）、加拉太书（6）
    以弗所书（6）、腓立比书（4）、歌罗西书（4）
    帖撒罗尼迦前书（5）、帖撒罗尼迦后书（3）、提摩太前书（6）
    提摩太后书（4）、提多书（3）、腓利门书（1）
    希伯来书（13）、雅各书（5）、彼得前书（5）
    彼得后书（3）、约翰一书（5）、约翰二书（1）
    约翰三书（1）、犹大书（1）、启示录（22）

章目录页

• 进入
  
  • 用户点击某个书卷A，以下拉的方式滑出对应章目录选项。章数写死固定
  • 用户点击其他书卷B，收起A后再展开B
  • 书卷被选中，要有选中态。章被点击要有点击态

经文页

• 进入
  
  • 用户点击某个章进入经文页
  • 经文页数据来自于服务端，所以这部分接口需要你和后台同学沟通确定下
• 经文页内容
  
  • 经文页内容由三部分组成：小标题、节序号、节内容
    
    • 小标题：可以理解为某一部分经文的一个总结性标题，也是由服务端提供，需要加黑且字号稍大一号
    • 节序号：显示在前面每节经文前
    • 节内容：具体的字号和颜色，只能先做一个出来我们再优化吧~~~

其他

• 所有控件，在给出来的交互样式之上，反正都用微信给的UI样式来做
• 第一期功能不多，主要是提高相应速度
• 交互地址：
  https://modao.cc/app/rT5KjIkcYZACppF8cb327niSt0f32yi