项目介绍

基本概况

• 22年立的项，一个srdp项目，主要是为法语图书室建立一个可以借阅书籍的小程序

• 图书的数据：包括xlsx原始文件和转化成可以导入云数据库的json文件以及转换脚本
book_data.xlsx
93.6KB
book_data.json
225.2KB
excel2json.py
1.5KB

数据库设计

• books表：

属性名	类型	备注
_id	string	自动生成的id
BName	string	书名，中文、英文、法语
Author	string	作者
BNo	string	编号，如1-1-001
Publisher	string	出版社
PublishYear	number	出版年份
BCount	number	剩余数量
BSum	number	原来总数（现在还没有改）
Category	string	分类

• 用户表：users

属性名	类型	备注
_id	string	主键
nickName	string	昵称
avatarUrl	string	头像链接
gender	number	性别,0男,1女
registerTime	number	注册时间,时间戳
stuAuthStatus	number	学生认证状态,0未认证,1认证成功,2审核中,3认证失败

• 借书表：borrow_list

属性名	类型	备注
_id	string	id
user_id	string	用户id
book_id	string	book id
borrowTime	number	借书时间
returnBookTime	number	还书时间 借书时间+1个月
status	number	借书状态,0借了未取,1已经取到,2已经归还,3逾期了

• 学生认证表(stu_auth_list)

属性名	类型	备注
_id	string	id
user_id	string	user id
SName	string	学生姓名
SNo	number	学生学号

核心功能逻辑

• 借书：
1. 首先必须实名学校信息（后台审核真实性），默认微信登录
2. 查询到书籍，如果有剩余，提交借阅申请，一次只能提交借阅一本，一次借阅30天
3. 用户到图书室拿书,管理员修改借阅状态为已经取到

• 还书：
直接去图书室还书,管理员修改状态为已归还
 

准备过程

1.学习uniCloud

2.技术选型

3.创建项目

4.一些依赖的安装和导入

• uView：用下载的方式导入到HBuilderX的方式安装的，教程🔗，配置也要用下载安装方式的配置教程

开始第一天的开发

调用云函数的二次封装、统一管理api

1. http.js文件对uniCloud.callFunction函数进行了二次封装，主要是处理了异步和异常
很神奇的一点就是我新建的目录和文件竟然也可以直接访问uniCloud而不需要引入，一开始以为要引入浪费不少时间。。。

2. api.js文件用于对所有的api进行统一管理，方便维护，就以当前写的这两个做示例了

3. 在main.js中挂载api的全局属性，使用时只需要this.$api.func()即可

查询图书列表的接口的开发

• 按照分类模糊查询（书名和作者，因为列表只显示这两项内容）

• 在当前类别输入为空时返回当前类的全部

• 如果不添加分类的字段，则返回所有图书

• 一次返回10条

• or：或逻辑

• and：且逻辑

• skip(skipCount)：跳过前skipCount条数据，从查询结果的第skipCount条数据开始返回

• limit(pageSize)：返回查询结果的前pageSize条

1. changKeyword函数的作用：
因为返回结果是拼接原来的list，这就会出现一个问题，如果查询关键字或者分类改变了，那么查询的时候还是用的当前的list的长度作为skipCount，并且此时查询的结果会拼接到当前list，显然不符合我们的预期，我们希望在keyword和分类改变时，执行搜索时当前list应该清空
所以这个函数的作用就是在用户按下enter时判断当前的keyword和原来的keyword是不是改变了，如果改变了就清空当前list，随之而来的问题就是如果用户不停的按下回车，结果集list会一直变大，也就是相当于不断往下滑，相对来说还是不太优雅，但因为时间很紧我写的时候没想太多就直接这样用了
至于检测分类的改变可以用watch监听，这里就有个问题，为什么keyword不用watch监听？一开始我第一反应是将keyword这个挂到watch上，旧值和新值不一样时清空list就可以了，但是这个检测是实时的，用户没有打完keyword就已经空了，体验不是很好，所以就只在点击不同的分类时用的watch监听，改变时清空list重新调用search函数即可

2. skipCount是当前list的长度

3. 查询结果用es6解构的方式拼接

查看图书详情

记录开发的第二天

将uView中的tabbar组件二次封装

1. tabBar.vue组件页

2. page.json文件
注意custum配置项为true

3. 在tab页使用
不同的tab给current绑定不同的值就行，这样其实还是有点不够解藕，但是目前我还没有更优雅的方法

优化了一下查询接口

第三天:实现了无感登录(微信授权)

登录逻辑

• 借书

• 查询借书记录

• 帮助文档

最后的收工(后台管理)

比较难的点(对我来说)

1. 借书信息时因为我用了两个外键user_id和book_id,所以如果要展示借书信息以及书籍和用户信息,就要联查三个表去做,第一次用unicloud云函数写接口,还是踩了好多坑,这里就记录一下正确的处理方法(可以跑,但是不一定正确哈哈哈)
因为我还要返回这次搜索结果的数量,就是不加分页器的数量,就先用管道pipline变量接收了一下经过match之后的内容,然后再根据需求进行后续查询
里面的unwind就是将子表的查询结果变成对象而不是数组中的一个对象,扁平化了一下,project用来筛选返回结果
比较让人摸不着头脑的就是关键字用来查询的并不是本表的内容而是外键对应的表的内容,这样就比较抽象,找了好久的资料才研究出来
还有就是正则匹配时要用一个source获取这个正则的源代码,就是不包括修饰符和标志

2. 其余的几个表的操作都大差不差了,只做了查询和一些变量的操作,主要是时间太紧了,一共就给了两三周,让我从前台开发到后台,还有一堆课程大作业要做,所以只能是能跑就行了,emmm

上线过程梳理

1. 首先要在微信公众平台注册一个小程序账号,每个邮箱只能注册一个小程序
微信公众平台
微信公众平台，给个人、企业和组织提供业务服务与用户管理能力的全新服务平台。

https://mp.weixin.qq.com/

2. 填写相关认证信息
这三个都完成才能上线版本,第四项的微信认证是可选的

3. 开发管理/开发设置中添加服务器域名配置,因为我用的是unicloud,所以就去unicloud官网找一下对应的阿里云还是腾讯云的域名就可以,我用的是阿里云

4. 上传体验版,体验需要管理员审核,上限15人
可以用uniapp的发行功能直接上传,其中要用上传密钥,在开发管理/开发设置中生成

5. 上传成功后就可以在版本管理中找到体验版以及提交审核的选项啦,审核完如果最开始那三个都完成了就可以上线啦

总结一下下