uclalibrary/ursus

UCLA图书馆管理系统 - Ursus

!UCLA熊雕像（图片左对齐，宽度150px）

---

Ursus设计为UCLA数字图书馆内容的公共访问界面。

Bruins熊雕像
1984年，为纪念建校50周年，UCLA校友会委托制作了“Mighty Bruins”并向学校赠送了Bruins熊雕像。该雕像现已成为校园地标和Westwood广场的焦点。

---

![构建状态]([] ![覆盖率状态]([] ![本项目使用Percy.io进行视觉回归测试]([***]

---

开发指南

本节提供在本地运行Ursus的基本说明。更详细的开发者文档维护在https://github.com/UCLALibrary/amalgamated-samvera/wiki%E3%80%82

本地安装与运行

Ursus是一个Black应用，仅需依赖Solr和Fedora。

Ursus可通过两种方式在本地运行：

1. 独立模式运行
2. 与Californica本地实例协同运行

---

独立模式

文件docker-compose-standalone.yml包含ursus-stage和sinai-stage的Solr索引克隆配置，因此无需运行Californica或手动摄入材料（实际上，为避免端口冲突，不应运行Californica）。

1. 从GitHub克隆仓库

git clone git@github.com:UCLALibrary/ursus.git

2. 进入仓库目录

cd ursus

3. 设置数据库

docker-compose run web bundle exec rails db:setup
docker-compose run sinai bundle exec rails db:setup

4. 启动开发环境

需在数据库设置完成后执行 - 启动脚本需要数据库就绪，以便设置功能标志（例如Sinai UI模式的标志）。

docker-compose up

Ursus现已运行

• Ursus / UCLA图书馆数字馆藏界面在3003端口启用
• Sinai手稿数字图书馆界面在3004端口启用
  • 注意：查看Sinai图像前，需先访问生产站点并登录/注册以加载生产环境的Cookie。

---

与Californica本地实例协同运行

若已运行独立模式的Ursus，需先停止：

docker-compose down

1. 首先，https://github.com/UCLALibrary/californica%E5%B9%B6%E6%91%84%E5%85%A5%E6%95%B0%E6%8D%AE%EF%BC%9B

确保Californica运行中，以便Ursus可指向其数据。

2. 从GitHub克隆Ursus仓库并进入目录：

git clone git@github.com:UCLALibrary/ursus.git
cd ursus

3. 打开终端标签页

docker-compose -f docker-compose-with-californica.yml run web bundle exec rails db:setup
docker-compose -f docker-compose-with-californica.yml run sinai bundle exec rails db:setup
docker-compose -f docker-compose-with-californica.yml up

4. 打开第二个终端标签页

此操作将连接到容器内的shell，用于运行代码检查工具和单元测试：

docker-compose -f docker-compose-with-californica.yml run web bash

5. 打开第三个终端标签页

docker-compose -f docker-compose-with-californica.yml run sinai bash

6. 打开第四个终端标签页用于git命令

git ...

运行代码检查工具和单元测试

通过以下命令连接到容器内的shell：

docker-compose run web bash

然后运行除Cypress集成测试外的全套检查和测试：

sh start-ci.sh

可查看start-ci.sh脚本了解其调用的代码检查工具和测试。

运行集成测试

首先，需在本地安装node.js和npm。

然后进入e2e目录并安装JavaScript依赖：

cd e2e
npm install

可通过以下命令打开Cypress测试运行器GUI：

npx cypress open

或在命令行运行测试：

npx cypress run

视觉回归测试

视觉回归测试通过percy.io进行。仅在Travis上的拉取请求中运行，本地环境不执行。

---

构建与许可

![构建状态]([]

![覆盖率状态]([]
![本项目使用Percy.io进行视觉回归测试]([***]