Skip to content

LingHangStudio/wust-library-mini-program

BranchesTags

Repository files navigation

图书馆小程序项目体系

武汉科技大学图书馆微信小程序

仓库地址：查看PMS

支撑技术

vue3 + + pinia + + scss + typescript

使用HBuild开发uni-app，生成微信小程序

运行，打包，发布

运行：微信开发者工具，app模拟器 打包：各种小程序，Android, IOS 发布：微信公众平台上传，审核，发布代码；APP上架

需求内容

导航栏

服务大厅/主页，活动大厅，消息资源，个人中心

主页

搜索框，轮播图，热门服务，智能答疑 其他服务（读者指南，关于本馆，机构设置，文献资源……） 推荐阅读，搜索页(结果列表的筛选)，书籍详情（分享功能隐藏，还有bug）

活动，消息资源

通知公告，最新资源，活动日历（未完成） 跳转公众号文章（未完成）小程序获取公众文章

个人中心

登录/绑定账号，用户信息，借阅记录，关于，意见反馈， 设置（多语言，清除缓存，设置主题，未完成） 超期提醒（未完成） 年度总结-海报(类似于 年终总结，这一年的阅读记录，未完成)

其他

夜间模式（未完成），适配平板界面（未完成），

接口详情

接口是从浏览器上 抓包获取的，没有文档 每个接口，对应于一个功能

可供参考的汇文后台地址

https://huiwen.yuque.com/fxik4g/qpggre/utqhsl? 这些接口也可以整合到小程序或者APP，来将图书馆功能整合进小程序或者APP，并以此来开发图书到期归还通知（微信公众号自动推送模板信息）

后台地址汇总

汇文接口地址: https://libsys.wust.edu.cn 统一登录接口 https://auth.wust.edu.cn node后台地址：https://smarttool.wust.edu.cn:3001

tsg接口

登录相关

登录接口1

/**
* 登录接口1 POST /lyuapServer/v1/tickets
* 
* @prarm username 学号
* @prarm password rsa加密后的密码
* @prarm service 浏览器跳转的去向
* @prarm loginType ''
* @return 一段字符串
*/

登录接口2

/**
* 登录接口2 POST  /lyuapServer/v1/tickets
* @prarm 上一个接口的返回值，拼接在url后面
* @return 还是一段字符串
*/

汇文接口

汇文的文档地址

appId uFizoTW/ZW3mj70uUidDaa4gQKP5lNsTTqiFMKf4x+w=

登录相关

请求头添加Cookie

获取用户信息:Cookie来自后端接口的返回值

/*
* 获取用户信息 GET /meta-local/opac/users/info
* @prarm isPlaintext false
* @header
* 
*/

借阅统计（总览）

/*
* 借阅状态 GET /meta-local/opac/users/stats
*/

借阅列表

/*
* 借阅列表 GET /meta-local/opac/users/loans
* @param page 当前页数
* @param pageSize 每页大小
* @return [] 列表
*/

借阅类型分布

/**
* 借阅分布 GET /meta-local/opac/users/loan_dcp_dist
* @return [] 用于画饼图
*/

借阅时间分布

/**
* 借阅时间分布 GET /meta-local/opac/users/loan_range_dist
* @return {} 用于画柱状图
*/

借阅历史

/*
* 借阅历史 GET /meta-local/opac/users/loan_hists
* @prarm page 当前页数
* @prarm pagesize 每页大小
*/

欠费列表

/**
*
*
*/

搜索相关

主要是主页的搜索

搜索

/*
* 搜索 POST /meta-local/opac/search
* 
* 请求参数示例：queryFieldList: [	{
					logic: 0,
					field: 用户选择的类型,
					operator: "*",
					values: [用户输入的内容]
				}],
   	sortType: "desc",
	sortField: "relevance",
	indexName: "idx.opac",
	collapseField: "groupId",
	filterFieldList: [],
	page: pagination.currentPage,
	pageSize: pagination.pageNum
* 
*/

热门检索词

/*
* 热门检索 GET /meta-local/opac/commend/top_search_trend
* @prarm count 返回数量
*/

推荐搜索，热门图书

/*
* 推荐-热门图书 GET /meta-local/opac/commend/hot1
* @prarm {number} count 返回数量
*/

书籍的详情 比较麻烦，很多个接口汇总 infos 获取baseInfo，放在顶部 info 获取详细信息，放在下面：章节信息，作者简介，书目简介，封面 trend 获取图表 holdings 获取馆藏信息

/**
 * 获取基础信息baseInfo
 * @param {string} bibId 
 * @return {}
*/

汇文地址的请求示例 https://libsys.wust.edu.cn/meta-local/opac/commend/hot1?count=20

自己的后台接口（基于node）

  1. 登录接口3
/**
* 登录的第三个接口 从后端获取cookie(来自汇文，有后端拦截)
* 参数来自于接口2返回的字符串
* 拼接到url后面
* /meta-local/opac/cas/rosetta?ticket=
*/
  1. 获取活动，资源列表
  2. 获取活动，资源详情

小程序全局登录逻辑

使用了登录接口的页面：

  • 登录页 /login
  • 主页/home（因为登录的token很快就会过期。重新启动时，检测是否已经登录，如果已经登录[此时token失效]，则重新登录）

密码加密算法

RSA加密，具体详情，看代码

登录接口

登录一共涉及到2个地址，3个接口 最终目的：获取到Cookie

序号 接口名称 请求源 接口地址 返回值
1 登录接口1 tsg /lyuapServer/v1/tickets 一段字符串1
2 登录接口2 tsg /lyuapServer/v1/tickets/+一段字符串1 一段字符串2
3 登录接口3 后台 /get-cookie Cookie

当获取到Cookie后，需要激活Cookie

目录结构

  • 主包 home,activity,resources,center

  • 主页 page-home

    • 搜索
    • 我的借阅
    • 自动答疑
    • tsg官网 web-view

  • 活动 page-sevice

  • 资源 page-sevice

  • 个人中心 pages/center/compoents/menu

    • 登录（绑定用户（未登录）） /login
    • 我的借阅 /mySubscribe
    • 关于我们 /aboutMe
    • 我的 /userinfo(登录后才有)
    • 分享小程序
    • 反馈意见

├─api │ ├─end │ ├─huiwen │ └─user ├─components │ ├─Empty │ ├─List │ ├─ListNavBar │ └─ListSkeleton ├─page-center ├─page-home ├─page-service ├─pages │ ├─activity │ ├─center │ ├─home │ └─resources ├─router ├─static │ ├─background │ └─icon ├─store ├─uni_modules ├─unpackage │ ├─dist │ │ ├─build │ │ └─dev │ │ └─mp-weixin 微信开发者工具运行 │ ├─release │ │ └─apk 生成的安装包 └─utils 工具

组件

组件封装文档

封装组件：Empty,List,ListSkeleton

Empty

参数 定义 类型 备注
description 空白描述 string 默认为暂无数据
width 宽度 string 默认320px
height 每页数量 string 默认240px
image 获取更多 string | solt 默认为'empty'
imageStyle 图片的样式 ()=>{}

List

封装的目的：简化一些内容：回到顶部，列表为空，加载更多

参数 定义 类型 备注
listLength 表单标题 string 默认为0,显示空
page 当前页 number 默认1
pageSize 每页数量 number 默认20
getMore 获取更多 ()=>{} 页数+1 
<List @getMore="search(paginations.currentPage+1,paginations.pageNum)" :listLength="searchList.length"
		:page="paginations.currentPage" 	:pageSize="paginations.pageNum">
	<!-- key必须使用id，不能使用index -->
	<view v-for="item in list" :key="item.id">
    	<!-- 你的内容 -->
    </view>
</List>

ListSkeleton骨架屏

参数 定义 类型 默认 是否必须
isShow 是否展示 boolean true 否
hasImage 是否包含图片 boolean false 否
rows 一轮多少行 number 4 否
loop 多少轮 number 1 否
display 一条的排列方式 string block 否
width string 100vw 否

ListNavBar

列表顶部导航栏，和系统导航栏一样，自定义样式

参数 定义 类型 默认
title 导航栏标题 string ''
color 字体颜色 string #fff
backgroundColor 背景颜色 string #142d88主题色

其他

  • 配置业务域名 要跳转到其他页面，使用web-view需要配置业务域名 将下载的校验文件，放到目标地址的服务器的根路径下 业务域名配置

  • 体验评分 开发者工具 - 详情 - 性能质量 - 体验评分

  • 主题色：#142d88

  • 写发布日志 log.md

  • uni组件库部分组件有所改动，代码必须保留uni_modules的内容

    不完全统计修改过的组件：tag, card, segmented-control，

  • 不要随意删除某一行代码

About

图书馆微信小程序

Resources

Readme
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages