bupt hotel management system

A hotel management system, Software Engineering, for bupt 2023 autumn course design.

Project structure & planning

• backend: Python flask, for faster developing.
• frontend: Simple HTML, css, Javascript. bootstrap will be used for boosting the page structing.

Notice that we will build a front-backend split system, communicating with standard API.

Stack

• Vue3 (axios, element-plus)
• Flask
• pymysql

---

2023-12.07 update

上面的都是在画饼放屁，这里才是真话。

前端写得一坨屎，我自己主导负责的，主打一个能跑就行，部分工程架构或许有参考价值。

后端才是我们项目的重点，考虑空调管理系统的需求背景，我们实现了调度算法，包括：

• 时间片调度
• 风速优先级

这两个调度算法的implement就是后端的价值所在。

已知存在的问题

后端与数据库的交互部分时不时会崩掉，原因未知，但是大多数时候是能跑的。（不清楚到底是他妈网络的问题还是电脑与MySQL Connection的问题还是他妈的代码的问题，不过从报错信息上来看似乎是使用连接的方式有问题，后人可以完善一下连接池的处理）

如何启动？

请严格按照：启动后端-启动前端-启动checkin的顺序执行！！！！！

1. 后端启动：

后端部分的启动较为复杂，在启动之前，你需要先配置好你的数据库。

step 1: 修改账户与密码以适应你的配置

首先，你需要记住你的数据库连接的账户和密码。

在这份代码中，本人的配置是用户名为root，密码为1234，这两个信息你需要在backend/master.py的：

• DATABASE_USER_NAME
• DATABASE_USER_PASSWORD

更改为你自己的。

step 2: 创建一个空数据库db（或者叫schema）

CREATE DATABASE backend;

这个空数据库的名字就叫backend。创建好了即可。

step 3: 启动server

cd backend
python server.py

注意：

1. 启动之后，会自动对数据库进行一系列初始化，无需担心数据库的问题。
2. 在启动过程中，遇到什么缺的包直接pip install即可。

2. 前端启动：

注意：在启动前端之前，必须先启动后端！！！

cd frontend
npm run dev

注意： 你需要安装一些packages，这个可以通过node.js安装，遇到缺失的直接npm install就行。

3. 进行checkin

为了方便，我们每次都是通过一份脚本进行checkin的，而不是手动去前端那里戳戳戳

启动checkin脚本的指令：

cd tests
python checkin.py

注意，一定要在启动后端之后，再执行checkin脚本。

4. 测试脚本

为了验证我们的系统到底怎么样，我们有一份测试脚本。

根据老师给出的样例，对服务器进行测试

脚本启动指令:

cd tests
python SE-TEST.py

之后会生成一份result.xlsx文件作为输出结果（如果运行顺利的话）

写在后面

前端部分有很多没有完成的，因为是助教验收，所以三两下糊弄过去就完事。

• 登陆页面（为了联调，登陆改为前端自己的事情，但是实际上应该是与后端联合的，那段代码被我注释掉了，取消注释应该就可以运行）
• 各种面板
  • 前台面板：有一些结账逻辑没有完善、比如说checkout之后，房间的清空之类的。
  • 管理员面板：至今unfinished，我也不想管了
  • 经理面板：查看日报、周报的功能，这里应该用前端狠狠渲染出一份很好看的图表的，但是我们完全没做，甚至那份前端的路由都没创建，后端也没有对应的接口，可以说这部分几乎为0.
• 各种美化工作
  • 我的前端界面在各种八仙过海一般的前端界面中，勉强算是能看的，归功于element-plus提供的组件库，让我不用太考虑布局样式之类的，也能勉强看得顺眼。
  • 但是实际上如果肯花时间的话，这部分的美化工作一定是可以做的很好的。

这一份作业真正开工到完工的时间也就两周。大家可以作为一份base，在这个基础上进行一系列魔改。

代码fork过去自己改都行，pr我也会看，甚至你直接抄过去也没问题。

如果你觉得这份base code对你有帮助，请帮我点个star呜呜呜呜呜 QAQ

写在最后面