visualregressiontracker/migration

Visual Regression Tracker后端应用

镜像概述和主要用途

该镜像为Visual Regression Tracker的后端应用，用于支持视觉回归测试的后端服务，处理用户认证、测试数据存储、测试任务管理等核心功能。适用于开发人员本地搭建后端开发环境、测试人员验证后端功能及进行LDAP认证集成测试等场景。

核心功能和特性

• 基于Node.js 18 (LTS)构建，支持本地开发环境快速配置
• 集成Postgres数据库，提供数据库结构创建、迁移及种子数据功能
• 支持本地HTTPS配置，可使用自签名证书实现安全访问
• 内置LDAP测试服务器，便于验证LDAP认证集成流程
• 包含单元测试、端到端测试支持，确保功能稳定性

使用场景和适用范围

• 开发人员本地搭建Visual Regression Tracker后端开发环境
• 测试团队进行后端功能验证及接口测试
• 需要验证LDAP认证流程的集成测试场景
• 需自定义HTTPS配置的本地开发或测试环境

详细使用方法和配置说明

本地环境设置

前置条件

• 安装Node.js 18 (LTS)版本
• 安装Docker及Docker Compose
• Git工具

环境配置步骤

1. 克隆代码仓库

   sh
   git clone https://github.com/Visual-Regression-Tracker/Visual-Regression-Tracker.git
   cd Visual-Regression-Tracker/backend
   

2. 配置环境变量

   • 更新根目录下的.env文件
   • 更新prisma/.env文件（数据库相关配置）

3. 启动Postgres数据库（在单独终端执行）

   sh
   docker compose up
   

4. 安装依赖并执行测试

   sh
   # 安装依赖包
   npm i
   
   # 运行单元测试
   npm run test
   

5. 数据库初始化操作

   sh
   # 创建数据库结构
   npx prisma db push
   
   # 应用数据库迁移
   npx prisma migrate deploy
   
   # 运行端到端测试
   npm run test:e2e
   
   # 生成初始种子数据
   npx prisma db seed
   

6. 启动应用（调试模式）

   sh
   npm run start:debug
   

本地HTTPS配置

1. 生成自签名证书（可通过[***]
2. 创建/secrets文件夹，将证书文件放置其中：
   • 证书文件命名为ssl.cert
   • 密钥文件命名为ssl.key

本地LDAP测试服务器

启动LDAP测试服务器

sh
# 合并多个compose文件启动服务
docker compose -f docker-compose.yml -f docker-compose.ldap.yml up

测试LDAP登录

使用以下命令测试LDAP认证流程，同时可查看服务日志验证结果：

sh
curl 'http://localhost:4200/users/login' \
-H 'accept: */*' \
-H 'accept-language: de-DE,de;q=0.9,en-US;q=0.8,en;q=0.7,fr;q=0.6' \
-H 'content-type: application/json' \
--data-raw '{"email":"***","password":"password"}'