探索HotinGo：优雅的酒店管理系统开源项目

HotinGo - 酒店管理系统
探索文档 >

查看 Figma 设计文件 · 报告问题 · 建议功能

目录

1. 关于项目
   • 截图
   • 动机
   • 构建所用
2. 开始使用
   • 预条件
   • 安装
   • 额外信息
3. 使用方法
4. 路线图
5. 贡献
6. 许可
7. 联系
8. 致谢

关于项目

HotinGo 是一个基于 Python 的开源酒店管理系统，采用 Python 3、Tkinter 和 MySQL 构建，并且在设计上注重用户体验。它包括了所有必要的酒店管理功能，如：

• 登录和身份验证（通过 MySQL 数据库）
• 添加、更新、查看和删除记录的功能，适用于：
  • 房间管理
  • 客户管理
  • 预约管理
• 使用环境变量进行秘密存储和处理

该项目最初是一个学校计算机科学课程的项目，展示了一种方式，即使使用如 Tkinter 这样的"古老"框架，也能创建出有吸引力的应用程序，拥有漂亮的用户界面。

(回到顶部)

屏幕快照

以下是一些应用的界面截图，展示了其美观的设计：

登录	仪表板
添加预订页面	更新预订
查看预订	确认退出
关于我们页面

想要创建自己的版本？可以在 Figma 查看设计，并使用 Tkinter Designer 导出为 Python 代码。

(回到顶部)

动机

这个项目作为学校信息学实践课的一个作业而诞生。虽然原本并不打算用于实际运营，但我们尽力让它在众多项目中脱颖而出。

更多信息...

根据课程要求，学习信息技术的学生需要用 Python 和 MySQL 创建一款应用程序，由来自其他学校的评估员/教师在学期结束时进行评审，以决定成绩。所以，这款应用是我们团队努力、毅力和投入的结晶。你可以从提交历史中看到我们的起点，如何停滞，然后是项目如今的状态。

(回到顶部)

构建所用（技术栈）

以下是一些参与制作本项目的关键技术：

• Python 3 🐍 - 应用主代码运行平台
• Tkinter & TTk - 用户界面
• MySQL Server 🐬 - 数据库管理与查询
• MySQL Connector Python - 通过 Python 查询 MySQL
• Tkinter Designer ☄️ - 将 Figma UI 导出为 Python 代码
• Numpy 🧮 - 作为 Matplotlib 的依赖项
• Matplotlib 📈 - 图形和可视化
• Python Dotenv 🤫 - 加载 .env 文件中的环境变量

(回到顶部)

开始使用

以下是设置本地项目所需步骤的简单示例：

预条件

确保您已安装以下内容：

• Python 3 - 可在此处下载说明
• Pip 3（通常随 Python 安装）
• MySQL Server - 如果尚未安装，请从此处下载，然后创建用户账户并记下用户名和密码

完成上述准备工作后，您可以继续执行下一步。

安装

1. 克隆仓库

   找到此处的克隆/下载仓库指南，然后解压缩存档，或者在终端中使用命令：

   git clone https://github.com/Just-Moh-it/HotinGo.git
   

2. 切换至文件夹

   在终端中更改目录至克隆的文件夹。参考这里 获取详细说明。

   命令可能是：

   cd Location\ To/Hotingo
   

3. 安装 PIP 包/依赖项

   确保终端提示符显示如下：

   Something.../HotinGo $
   

   如不显示，请重新执行前一步。

   接下来，在终端中输入以下命令：

   pip install -r requirements.txt
   

4. 设置数据库

   要从 MySQL 模式创建数据库，可以：

   1. 直接将 sql/hms.sql 内容粘贴到 MySQL 命令行，或

   2. 使用命令自动化操作（从终端）

   mysql -u <mysql-username> -p<mysql-password> < hms.sql
   

   此操作会创建并配置数据库。

   （注：不要包括尖括号 '<>'，并将 <mysql-username> 和 <mysql-password> 替换为实际的 MySQL 凭证，如 预备阶段 中所述）

5. 向应用添加数据库凭据

   首先重命名 .example.env 文件为 .env，然后将 Your-Username 和 Your-Password 替换为您创建的 MySQL 凭证。

6. 安装字体

   为了使应用程序的图形界面看起来更美观，您需要安装名为 Montserrat 的字体。在 assets 文件夹内，双击三个 .ttf 格式的字体进行安装。

7. 完成啦！🎉 | 运行应用

   通过 Python 3 运行 main.py 文件，如果按照每个步骤正确执行，您应该能看到登录窗口。

默认的用户名和密码分别为 username 和 password。

如果应用没有正常运行或出现错误，研究解决方法，或者在这里创建问题。

注意：以上所有代码均为 Markdown 格式，若需预览效果，请复制到支持 Markdown 渲染的环境中查看。

(回到顶部)