Frappe构建图书馆管理系统

我们将构建一个简单的图书馆管理系统，图书管理员 可以登录并管理文章和会员资格。我们将构建以下模型：

物品：可以出租的书籍或类似物品。
图书馆会员：订阅会员资格的用户。
图书馆交易：文章的发行或归还。
图书馆会员资格：代表图书馆会员有效会员资格的文件。
图书馆设置：定义借阅期限和一次可发放的最大文章数量等值的设置。

图书管理员将登录到名为 Desk的界面，这是框架附带的丰富管理界面。Desk 提供许多标准视图，如列表视图、表单视图、报告视图等，以及许多功能，如基于角色的权限。

我们还将创建公共的 Web 视图，供图书馆成员访问并浏览可用的文章。

library_management：此目录将包含应用程序的所有源代码
- public：存储在生产环境中由 Nginx 提供的静态文件
- 模板：用于呈现 Web 视图的 Jinja 模板
- www：根据目录路径提供的网页
- library_management：使用应用程序引导的默认模块
- modules.txt：应用程序中定义的模块列表
- patches.txt：数据库迁移的补丁条目
- hooks.py：用于扩展或拦截框架提供的标准功能的钩子
- pyproject.toml：指定您的应用程序如何构建，您可以选择在此处添加第三方 Python 依赖项，这些依赖项将在您的应用程序安装时安装。

创建站点

每个站点都带有一个数据库。它们可以通过站点特定的脚本进行定制，也可以在其上安装应用程序。

要创建新站点，请在目录frappe-bench执行创建新站点命令

bench new-site {sitename}

站点目录结构看起来将会像这样：

sites/library.localhost
├── indexes
│   └── web_routes
├── locks
├── logs
├── private
│   ├── backups
│   └── files
├── public
│   └── files
└── site_config.json

该indexes文件夹具有通过网站搜索生成的索引。

该locks文件夹维护站点内文档的基于文件的锁定以及站点本身状态的指示器。

如您所见，该private文件夹将包含所有数据库备份和私人文件。私人文件是用户上传的文件，需要经过身份验证才能访问。

该public文件夹将包含无需身份验证即可访问的文件。这可能包含无需登录即可访问的网站图像。

该site_config.json文件包含特定于此站点的配置，不应进行版本控制。这类似于环境变量文件。如果您查看文件的内容，它包含此站点的数据库配置值。

{

"db_name": "_ad03fa1a016ca1c4",

"db_password": "pz1d2gN5y35ydRO5",

"db_type": "mariadb"

}

bench允许您创建多个站点，并通过同一端口在浏览器中分别访问它们。这就是我们在 bench 中所说的多租户支持。

Frappe 将通过将请求的主机名与站点名称进行匹配来确定要服务的站点，可以通过http://library.localhost:8000访问站点。

如果这对您不起作用，那是因为我们必须告诉操作系统 library.localhost 应该指向 localhost。为此，您可以将以下条目添加到您的/etc/hosts文件中。

sudo nano /etc/hosts

127.0.0.1 library.localhost

这将映射library.localhost到localhost。或者执行下面命令

bench --site library.localhost add-to-hosts

这将要求您输入 root 密码并将一个条目添加到您的/etc/hosts文件。

在现场安装应用程序

要在我们的网站上安装我们的图书馆管理应用程序，请运行以下命令：

bench --site library.localhost install-app library_management

要确认应用程序是否已安装，请运行以下命令：

bench --site library.localhost list-apps

您应该会在您的网站上看到已安装的应用程序frappe。library_management

当您创建新站点时，该frappe应用程序会默认安装。

登录到服务台

根据提示设置完成后进入到app页面

修改默认站点

进入frappe-bench/sites目录

sudo nano common_site_config.json

修改默认站点设置

站点命令

我们用该选项运行了几个 bench 命令--site。这些命令称为 site 命令。

以下是一些有用的站点命令。

Python 控制台

bench --site library.localhost console

MariaDB 控制台

bench --site library.localhost mariadb

数据库备份

bench --site library.localhost backup

您可以通过运行以下命令查看所有站点命令的列表：

bench --help

创建 DocType

DocType 类似于其他框架中的 Model。除了定义属性之外，它还定义 Model 的行为。

启用开发者模式

在创建 DocType 之前，我们需要在工作台上启用开发者模式。这将在我们创建 doctype 时启用样板创建，并且我们可以使用我们的应用将它们跟踪到版本控制中。

转到您的终端并退出工作台服务器（如果它已在运行）frappe-bench，然后从目录中运行以下命令：

bench set-config -g developer_mode true
bench start

创建 DocType

在 Desk 中，使用Awesomebar导航到DocType 列表。此列表将包括与框架捆绑在一起的 DocType、已安装的 Frappe 应用程序的一部分以及您可以为每个站点创建的自定义 DocType。

我们将创建的第一个文档类型是Article。要创建它，请单击 New。

输入名称作为文章
在模块中选择图书馆管理
在Fields表中添加以下字段：
1. 文章名称（数据，必填）
2. 图片（附加图片）
3. 作者（数据）
4. 描述（文本编辑器）
5. ISBN（数据）
6. 状态（选择）- 输入两个选项：已发行和可用（输入已发行，按回车键，然后输入可用）
7. 出版商（数据）
8. 创建完成后可以在DocType列表中看到我们刚创建的新的DocType，还没有设置字段，我们想要给他设置一些字段
  
  字段设置
  选择类型设置
  
  点击保存
  
  点击按钮跳转到Article页面
  
  点击按钮添加列表