使用说明

[TOC]

简介

本使用说明旨在帮助非开发者的Windows用户方便快速地使用本系统预约座位。

初始化

环境要求

Python3
pip3（一般安装Python时自带）
- 安装帮助 - 官方文档
- 安装帮助 - 菜鸟教程
GitHub Desktop(功能强大的图形化界面) / Git(可选命令行或简洁的图形化界面)
文本编辑器（主要用来编辑配置文件）

记事本即可，也可使用Sublime、Notepad++等工具。
Python IDE（可选）
- Python IDE推荐 - 菜鸟教程
Markdown软件（可选）

主要用来在本地查看文档
- Typora

步骤

Clone项目代码到本地
- 使用GitHub Desktop
  - 已有GitHub账号
    1. 在项目主页点击右上角Fork按钮，将项目Fork到个人主页
    （若不做此步骤，则可直接当做没有GitHub账号操作）
    1. 在GitHub Desktop上登录个人账户
    2. 依次点击File - Clone repository - GitHub.com - YourUsername/Auto_Reservation_System_BE - Clone
  - 没有GitHub账号
    1. 在GitHub Desktop中依次点击File - Clone repository - URL
    2. 在Repository URL一栏中输入
      
      https://github.com/DefJia/Auto_Reservation_System_BE.git
    3. 选择路径并点击Clone
- 使用Git
  - 使用命令行（Git Bash）
    - 在文件管理器中切换到目标文件夹，在空白处点击右键，打开Git Bash
    - git clone https://github.com/DefJia/Auto_Reservation_System_BE.git
  - 使用图形化界面（Git GUI）
    - 在文件管理器的空白处点击右键，打开Git GUI
    - 点击Clone Existing Repository
    - 在Source Location中输入
      
      https://github.com/DefJia/Auto_Reservation_System_BE.git
    - 在Target Directory中选中目标文件夹
    - 点击Clone
安装Python依赖库
- 以管理员身份打开“命令提示符”
- 切换到项目根目录下
  - cd C:\xxx\path\xxx\
- 安装依赖
  - pip3 install -r requirements.txt
    
    若提示pip3不可执行，则尝试去掉“3”
复制.config.example.ini为.config.ini，并按照文件内的说明在.config.ini中修改或添加相关个性化信息。

使用方法

所有以单下划线命名的文件为可用功能，一个文件对应一个功能，需要提前在配置文件中修改对应参数，然后才可以运行，否则会报错。

自动预约

按照.config.example.ini的示例和注释，修改或填写.config.ini中_Auto_book和Time（不建议修改）下的参数；同时还要确保Account中至少有一个账号信息。

模拟预约

按照.config.example.ini的示例和注释，修改或填写.config.ini中_Book_seat下的参数；同时还要确保Account中有对应的账号信息。

捡漏座位

删除违约（内测功能）

预约过户（内测功能）

维护账号列表（内测功能）

代码更新

使用GitHub Desktop

使用Git GUI

使用Git Bash

在文件管理器中打开项目根目录，右键点击空白处，选中Git Bash并打开
在命令框中运行

git pull
若报错，则运行

git reset --hard HEAD

后再回到2

注意事项

请勿擅自修改代码内容
尽量每次使用前进行代码更新