unillett/dilps-tiresias

Dilps/Tiresias

镜像概述

Dilps/Tiresias是一个面向艺术史和建筑领域的图像数据库Web应用，采用GraphQL构建后端API，Angular作为前端框架，提供图像数据的存储、查询和管理功能。

核心功能

• 基于GraphQL的高效API接口，支持复杂数据查询
• Angular构建的现代化前端界面，提供直观的用户交互
• 与MariaDB数据库集成，实现图像数据持久化存储
• 支持用户认证与权限管理
• 集成邮件服务与日志系统，便于应用监控与维护

使用场景

适用于艺术史研究机构、建筑部门等需要管理大量图像资源的场景，可用于图像数据的集中存储、标准化管理和高效查询。

安装与配置

环境要求

• Docker及Docker Compose
• MariaDB数据库
• Nginx服务器

基本安装步骤

1. 配置Nginx虚拟主机，指向htdocs/目录并包含configuration/nginx.conf
2. 在MariaDB中创建名为"dilps"的数据库
3. 配置数据库连接：复制config/autoload/local.php.dist为config/autoload/local.php并修改数据库参数
4. 复制环境变量文件：cp example.env .env，根据需要修改配置值
5. 构建应用：./bin/build.sh

Docker开发环境配置

环境文件准备

sh
# 复制环境变量与配置文件
cp example.env .env
cp dev/example.env dev/.env
cp config/development.config.php.dist config/development.config.php
cp config/autoload/local.php.dist config/autoload/local.php
cp config/autoload/tiresias.local.php.dist config/autoload/tiresias.local.php
cp config/autoload/development.local.php.dist config/autoload/development.local.php

主机配置

编辑hosts文件，将dilps.docker和tiresias.docker指向Docker主机IP。

Docker容器部署

sh
# 构建并启动所有容器（-d参数可后台运行）
docker compose up

# 加载测试数据与用户
docker exec dilps-tiresias-app ./bin/load-test-data.php

# 进入应用容器（apache-php环境）
docker exec -it dilps-tiresias-app bash

访问方式

主要应用界面

• 主应用：[***]
• Tiresias界面：[***]

辅助服务

• phpMyAdmin（数据库管理）：[***]

  • 服务器：dilps-tiresias-mysql
  • 用户名：user
  • 密码：password

• MailHog（邮件测试）：[***]

  • JSON格式邮件列表：[***]

服务器配置

开发模式切换

sh
# 启用开发模式（开启日志）
composer development-enable

# 查看日志
tail -f logs/all.log

# 清除配置缓存（生产环境部署时）
composer clear-config-cache

测试方法

PHPUnit测试

sh
# 加载测试数据（首次运行）
./bin/load-test-data.php

# 运行测试
./vendor/bin/phpunit

Karma前端测试

sh
# 运行Karma单元测试
ng test

Docker环境下的测试

Karma测试

bash
docker run -it --rm -v $PWD:/var/www -w /var/www --ipc host --network dilps-tiresias_dilps-tiresias-net mcr.microsoft.com/playwright:v1.33.0-focal yarn ng test --watch false --browsers ChromeHeadlessCustom

E2E测试

bash
docker run -it --rm -v $PWD:/var/www -w /var/www --ipc host --network dilps-tiresias_dilps-tiresias-net mcr.microsoft.com/playwright:v1.33.0-focal yarn e2e

数据持久化

Docker环境中，MySQL数据通过命名卷持久化存储，可使用以下命令管理卷：

sh
# 查看卷列表
docker volume ls

# 删除卷（重置数据库）
docker volume rm [volume_name]