Merge branch 'develop'

README.md

@@ -26,13 +26,13 @@
 ### 稳定版本下载
 
 - Windows
-    - 链接: [whu-library-seat-setup-1.4.0.exe](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-setup-1.4.0.exe)
+    - 链接: [whu-library-seat-setup-1.4.1.exe](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-setup-1.4.1.exe)
 
 - Mac OS
-    - 链接: [whu-library-seat-1.4.0.dmg](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-1.4.0.dmg)
+    - 链接: [whu-library-seat-1.4.1.dmg](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-1.4.1.dmg)
 
 - Linux
-    - 链接: [whu-library-seat-1.4.0-x86_64.AppImage](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-1.4.0-x86_64.AppImage)
+    - 链接: [whu-library-seat-1.4.1-x86_64.AppImage](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-1.4.1-x86_64.AppImage)
 
 ### 安装软件
 

docs/.vuepress/config.js

@@ -30,13 +30,13 @@ module.exports = {
         editLinkText: '在 GitHub 上编辑此页',
         lastUpdated: '上次更新',
         nav: [
-          {
-            text: '版权声明',
-            link: '/copyright/'
-          },
           {
             text: '用户手册',
             link: '/specification/',
+          },
+          {
+            text: '项目说明',
+            link: '/project/'
           }
         ],
         sidebar: {
@@ -45,9 +45,12 @@ module.exports = {
               title: '用户手册',
               children: [
                 ['', '下载安装'],
-                ['settings', '软件设置'],
                 ['menu', '菜单'],
+                ['settings', '软件设置'],
                 ['reservation', '定时预约'],
+                ['cancel', '取消预约'],
+                ['stop', '结束使用'],
+                ['change', '更改位置'],
                 ['others', '其他']
               ]
             }

docs/README.md

@@ -6,10 +6,16 @@ actionLink: /#快速开始
 features:
 - title: 定时抢座
   details: 软件提供了定时抢座的功能，用户可以指定时间开始抢座，也可以通过勾选"√使用当前时间"立即抢座
-- title: 座位更改
-  details: 勾选"√使用当前时间"立即抢座，如果当前已有预约、正在使用、暂离状态的座位，软件会取消当前座位，重新预约
 - title: 错误处理
   details: 当位置已经被别人预约之后，软件会根据用户提供的时间段和房间信息，自动预约距离该位置较近的座位
+- title: 座位更改
+  details: 勾选"√使用当前时间"立即抢座，如果当前已有预约、正在使用、暂离状态的座位，软件会取消当前座位，重新预约
+- title: 取消预约
+  details: 在预约历史界面，如果您有处于预约的座位，可以点击对应记录后面的取消预约按钮取消座位
+- title: 终止使用
+  details: 在预约历史界面，如果您有处于正在使用或暂离状态的座位，可以点击对应记录后面的终止使用的按钮结束使用该座位
+- title: 开源跨平台
+  details: 本软件为开源跨平台软件，有 WIndows、MacOS、Linux、Android 等版本可供用户下载使用
 footer: Copyright © 2018 CS-Tao
 ---
 
@@ -19,24 +25,26 @@ footer: Copyright © 2018 CS-Tao
 您可以通过以下步骤快速使用本软件预约座位，查看详细使用说明请移步[用户手册](/specification/)
 :::
 
-#### 下载软件
+#### 安装软件
 
-链接: [https://github.com/CS-Tao/whu-library-seat#稳定版本下载](https://github.com/CS-Tao/whu-library-seat#稳定版本下载)
+- 桌面端(Windows/MacOS/Linux)
 
-#### 登录
+  安装包链接: [https://github.com/CS-Tao/whu-library-seat#稳定版本下载](https://github.com/CS-Tao/whu-library-seat#稳定版本下载)
 
-启动软件，输入用户名和密码(点击小锁图标可以记住用户名和密码)，点击`登录`按钮登录到图书馆，如下图所示
+- 移动端(Android)
 
-![登录演示](https://raw.githubusercontent.com/CS-Tao/github-content/master/contents/github/whu-library-seat/login.gif)
+  安装包链接：[https://github.com/CS-Tao/whu-library-seat-mobile#最新版本下载](https://github.com/CS-Tao/whu-library-seat-mobile#最新版本下载)
 
-#### 快速预约
+  二维码：
 
-登录成功后，在主界面选择必要的参数(点击电源图标和太阳图标可以对座位进行预筛选)，点击`定时抢座`按钮，在弹出的`定时器`界面选择定时抢座的`日期`和`时间`，点击`定时抢座`按钮开始定时抢座，倒计时结束软件便会开始抢座，如下图所示
+  ![安卓版本二维码](https://raw.githubusercontent.com/CS-Tao/whu-library-seat/user-validation/last-android-qr.jpg)
 
-![快速预约演示](https://raw.githubusercontent.com/CS-Tao/github-content/master/contents/github/whu-library-seat/reserve.gif)
+#### 使用演示
 
-#### 取消预约
+> 以桌面端(v1.2.0)为例，移动端相关操作与之一致
 
-登录成功后，点击主界面下方的`预约历史`按钮可以查看预约历史，如果有处于预约状态的条目，点击`取消预约`按钮即可取消预约，如下图所示
+![软件演示](https://raw.githubusercontent.com/CS-Tao/github-content/master/contents/github/whu-library-seat/full.gif)
 
-![取消预约演示](https://raw.githubusercontent.com/CS-Tao/github-content/master/contents/github/whu-library-seat/cancel.gif)
+::: warning Copyright © 2018 CS-Tao
+本软件开源，但没有向开发者提供任何源码`许可证`，作者本人保留源代码的所有权利，任何组织和个人不得将本软件或源码用于商业活动
+:::

docs/project/README.md

@@ -0,0 +1,57 @@
+---
+next: false
+---
+:::tip
+本页面针对开发者
+:::
+
+### 桌面端(Windows/MacOS/Linux)
+
+>项目工程：[whu-library-seat](https://github.com/CS-Tao/whu-library-seat)，使用 Electron + Vue 搭建
+
+#### 分支使用说明
+
+- master
+
+  主分支，每次提交都标记一个 tag，对应一个新版本，并更新本文档
+
+- develop
+
+  开发分支，开发的新功能都汇总到本分支
+
+- gh-pages
+
+  存放本文档
+
+- usage-records
+
+  存放后台项目源码，使用 express.js 搭建，用于记录软件使用数据
+
+- user-validation
+
+  存放用户白名单、发布新公告、发布移动端新版本
+
+- 其他
+
+  开发新功能(最终会策略合并到`develop`分支)、解决刚发布版本的 bug(最终会策略合并到`master`分支和`develop`分支)
+
+### 移动端(Android)
+
+>项目工程：[whu-library-seat-mobile](https://github.com/CS-Tao/whu-library-seat-mobile)，使用 Cordova + Vue 搭建
+
+#### 分支使用说明
+
+- master
+
+  主分支，所有标记 tag 的提交一定在此分支上，每一个 tag 对应一个版本。
+
+  本分支是一个 cordova 工程，利用 Travis CI 对它的每次提交进行持续集成，并将生成的安装包部署到[GitHub Release](https://github.com/CS-Tao/whu-library-seat-mobile/releases)
+
+- source
+
+  网页源工程，由桌面端项目工程转化而成。每次提交都会被 Travis CI 持续集成，并将生成的网页部署到`gh-pages`分支
+
+- gh-pages
+
+  由`source`分支生成的网页会被存放到本分支，当`master`分支被集成的时候，会下载本分支的资源，将其打包为`apk`安装包
+

docs/specification/README.md

@@ -1,21 +1,27 @@
 ### 下载软件
 
-本软件是针对`武汉大学`图书馆预约系统开发的抢座软件，支持 Windows、Mac OS、Linux 等操作系统
+本软件是针对`武汉大学`图书馆预约系统开发的抢座软件，支持 Windows、Mac OS、Linux、Android 等操作系统
 
-#### 最新版本下载
-
-最新版本(包括预览版): [https://github.com/CS-Tao/whu-library-seat/releases/latest](https://github.com/CS-Tao/whu-library-seat/releases/latest)
-
-#### 稳定版本下载
+#### 桌面端下载
 
 - Windows
-    - 链接: [whu-library-seat-setup-1.4.0.exe](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-setup-1.4.0.exe)
+    - 链接: [whu-library-seat-setup-1.4.1.exe](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-setup-1.4.1.exe)
 
 - Mac OS
-    - 链接: [whu-library-seat-1.4.0.dmg](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-1.4.0.dmg)
+    - 链接: [whu-library-seat-1.4.1.dmg](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-1.4.1.dmg)
 
 - Linux
-    - 链接: [whu-library-seat-1.4.0-x86_64.AppImage](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.0/whu-library-seat-1.4.0-x86_64.AppImage)
+    - 链接: [whu-library-seat-1.4.1-x86_64.AppImage](https://github.com/CS-Tao/whu-library-seat/releases/download/v1.4.1/whu-library-seat-1.4.1-x86_64.AppImage)
+
+#### 移动端下载
+
+- 移动端(Android)
+
+  安装包链接: [https://github.com/CS-Tao/whu-library-seat-mobile#最新版本下载](https://github.com/CS-Tao/whu-library-seat-mobile#最新版本下载)
+
+  二维码:
+
+  ![安卓版本二维码](https://raw.githubusercontent.com/CS-Tao/whu-library-seat/user-validation/last-android-qr.jpg)
 
 ### 安装软件
 
@@ -29,4 +35,8 @@
 
 ### 软件更新
 
-软件启动的时候会自动访问[GitHub Release](https://github.com/CS-Tao/whu-library-seat/releases/latest)检查更新，如果有更新，在软件的左下角会出现更新的按钮
+- 桌面端
+    软件启动的时候会自动访问[GitHub Release](https://github.com/CS-Tao/whu-library-seat/releases/latest)检查更新，如果有更新，在软件的左下角会出现更新的按钮
+
+- 移动端(Android)
+    软件启动的时候会自动访问[这个文件](https://github.com/CS-Tao/whu-library-seat/blob/user-validation/last-mobile.json)检查更新，如果有更新，在软件的左下角会出现下载更新的按钮

docs/specification/cancel.md

@@ -0,0 +1,3 @@
+### 取消预约
+
+在`预约历史`界面，如果您有处于`预约`状态的座位，可以点击对应记录后面的`取消预约`的按钮取消预约

docs/specification/change.md

@@ -0,0 +1,5 @@
+### 座位更改(即"改签")
+
+在预约座位时，如果您当前已有处于`预约`、`正在使用`、`暂离`状态的座位，在开始预约之前软件会自动取消已有的座位，重新预约
+
+也就是说如果您希望的重新预约的座位和正在使用的座位信息一致，便能更改当前座位的使用时间

docs/specification/menu.md

@@ -1,3 +1,7 @@
+:::warning 注意
+本页面针对桌面端
+:::
+
 ### 文件
 
 - 退出程序
@@ -38,23 +42,37 @@
 
     将软件隐藏到托盘
 
+### 权限
+
+- 申请权限
+
+    打开[申请软件使用权](https://home.cs-tao.cc/whu-library-seat/specification/#申请软件使用权)
+
+- 查看用户白名单
+
+    打开[用户白名单](https://github.com/CS-Tao/whu-library-seat/blob/user-validation/validation.json)
+
 ### 关于
 
-- 文档
+- 版本 vx.x.x
 
-    打开[软件文档](https://home.cs-tao.cc/whu-library-seat)
+    显示本软件的版本号，点击可以进入本版本的[更新日志和下载链接](https://github.com/CS-Tao/whu-library-seat/releases/tag/v1.4.0)
 
-- 项目
+- 更新日志
 
-    打开[项目地址](https://github.com/CS-Tao/whu-library-seat)
+    查看[最新版本的更新日志](https://github.com/CS-Tao/whu-library-seat/releases)
 
-- 申请权限
+- 检查更新
 
-    打开[申请软件使用权](https://home.cs-tao.cc/whu-library-seat/specification/#申请软件使用权)
+    检查更新，如果有更新可用，在软件的左下角会出现下载更新的按钮
 
-- 申请权限
+- 文档
 
-    打开[用户白名单](https://github.com/CS-Tao/whu-library-seat/blob/user-validation/validation.json)
+    打开[软件文档](https://home.cs-tao.cc/whu-library-seat)
+
+- 项目
+
+    打开[项目地址](https://github.com/CS-Tao/whu-library-seat)
 
 - 问题反馈
 

docs/specification/settings.md

@@ -18,9 +18,17 @@
 
 #### 退出到托盘
 
+> 本条针对桌面端
+
 如果勾选该项，当您点击了窗口自带的关闭按钮或者点击了`菜单 -> 窗口 -> 关闭`，程序会隐藏到托盘而不是直接退出程序
 
-默认`没有`勾选该项
+默认`有`勾选该项
+
+#### 提交软件使用数据
+
+如果勾选该项，软件会将您的使用数据发送到后台，该数据没有包含任何您的隐私信息
+
+默认`有`勾选该项
 
 ### 保存设置
 

docs/specification/stop.md

@@ -0,0 +1,3 @@
+### 结束使用
+
+在`预约历史`界面，如果您有处于`正在使用`或`暂离`状态的座位，可以点击对应记录后面的`终止使用`的按钮结束使用该座位

package.json

@@ -1,6 +1,6 @@
 {
   "name": "whu-library-seat",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "author": "CS-Tao <[email protected]>",
   "description": "武汉大学图书馆抢座软件",
   "license": null,
@@ -12,6 +12,7 @@
     "build:web": "cross-env BUILD_TARGET=web node .electron-vue/build.js",
     "build:docs": "vuepress build docs",
     "dev": "node .electron-vue/dev-runner.js",
+    "dev:docs": "vuepress dev docs",
     "e2e": "npm run pack && mocha test/e2e",
     "lint": "eslint --ext .js,.vue -f ./node_modules/eslint-friendly-formatter src test",
     "lint:fix": "eslint --ext .js,.vue -f ./node_modules/eslint-friendly-formatter --fix src test",

src/renderer/components/Body/Announce/index.vue

@@ -1,6 +1,6 @@
 <template>
 	<div class="flex-row">
-    <div class="warp">
+    <div v-loading="loading" :fullscreen="false" class="warp">
       <vue-markdown class="mark-down" html :source="source"/>
     </div>
 	</div>
@@ -19,28 +19,32 @@ const store = new Store({
 export default {
   data () {
     return {
+      loading: false,
       source: ''
     }
   },
   components: {
     VueMarkdown
   },
   mounted () {
+    this.loading = true
     gitcontentsApi.announce().then((response) => {
+      this.loading = false
       if (response.status === 200) {
         this.source = response.data
         this.$store.dispatch('setAnnounceViewed', true)
         store.set('announceMd5', md5(response.data))
       }
     }).catch(() => {
+      this.loading = false
       this.showError('公告加载失败')
     })
   },
   methods: {
     showError (message) {
       this.$message({
         type: 'error',
-        duration: '0',
+        duration: '2000',
         showClose: true,
         dangerouslyUseHTMLString: true,
         message: '<p style="line-height:20px;">' + message + '</p>'