本页为 AI 撰写的翻译初稿,尚未经中文母语人士审校。

教程

本教程说明如何在本地电脑上运行本系统。需要使用终端,但不需要了解 Rust 或 Svelte。

此设置仅用于评估。请勿使用真实患者数据。它使用公开的测试密码。

第 1 步:安装工具

需要以下工具:

第 2 步:获取代码

打开终端,下载项目并进入其文件夹:

git clone https://github.com/patient-administration-system/patient-administration-system.git
cd patient-administration-system

第 3 步:启动数据库和登录服务

podman compose -f podman/compose.yml up -d

如果端口已被占用,请按如下方式选择其他端口,并修改后续步骤中相应的端口号:

PAS_PG_PORT=5442 PAS_KEYCLOAK_PORT=8190 podman compose -f podman/compose.yml up -d

第 4 步:设置数据库

这一步会创建数据表,然后添加一个演示机构、一个病区、一个房间和三张床位。首次运行需要下载并编译依赖项,可能需要一些时间。

export DATABASE_URL=postgres://pas:pas_dev_password@localhost:5432/pas
cargo run -p patient-administration-system-migrations --bin pas-migrate -- up
cargo run -p patient-administration-system --bin pas-seed

第 5 步:启动令牌服务

在同一文件夹中打开第二个终端,并让它保持运行:

sh scripts/dev-auth.sh

第 6 步:启动 API

回到第一个终端并运行:

PAS_PASETO_KEYS_URL=http://127.0.0.1:8195/keys.json PAS_REQUIRE_AUTH=true \
  cargo run -p patient-administration-system --bin patient-administration-system

启动后,在浏览器中打开 http://localhost:8080/api/health,确认其正在运行。在此模式下,位于 /swagger-ui/ 的 Swagger UI 需要令牌,因此会返回 401。

第 7 步:启动网页界面

在项目文件夹中打开第三个终端:

cd patient-administration-system-ui-with-svelte
cp .env.example .env
pnpm install && pnpm run dev

如果您在第 3 步选择了其他 Keycloak 端口,也请修改 .env 中的 OIDC_ISSUER。

第 8 步:登录

打开 http://localhost:5173,使用其中一个测试用户登录:

用户名 密码 用途
admin admin 工作人员视图:排班、预约和候诊名单
patient patient 患者视图:预约和消息

admin 用户和其他工作人员一样,还需要输入一次性验证码。请将开发密钥 JBSWY3DPEHPK3PXP 添加到身份验证器应用中,然后输入其显示的验证码。

列表将为空。 演示数据中没有人员,因为患者和工作人员保存在 person-service 和 worker-service 中,它们是独立的项目。

第 9 步:关闭

在每个终端中按 Ctrl 和 C 停止程序,然后停止配套服务:

podman compose -f podman/compose.yml down

后续步骤