klausenschaefersinho/quant-ux

Quant-UX Docker镜像文档

1. 镜像概述

Quant-UX Docker镜像是将Quant-UX原型设计工具容器化的部署包，旨在简化工具安装与运行流程。Quant-UX是一款专注于用户体验设计的工具，支持通过直观界面创建高保真交互式原型，并集成用户反馈收集功能，帮助设计团队快速验证产品概念。本镜像封装了Quant-UX核心组件，可直接通过Docker启动，减少环境依赖与配置复杂度。

2. 核心功能与特性

• 交互式原型设计：提供拖拽式界面编辑器，支持动画效果、页面跳转及交互逻辑配置，快速生成可操作原型。
• 用户反馈收集：内置测试链接生成功能，支持收集用户操作路径、点击热图及主观评价，辅助UX优化决策。
• 多平台适配：支持响应式设计，自动适配桌面端、移动端及平板设备屏幕尺寸，确保跨设备体验一致性。
• 数据导出与集成：支持原型文件导出为HTML、PDF格式，或通过API与Figma、Sketch等设计工具联动，衔接开发流程。
• 轻量化部署：容器化设计支持单机部署、云服务器部署及CI/CD流程集成，适配不同规模团队需求。

3. 适用场景

• 产品设计团队：快速迭代原型方案，缩短从概念到验证的周期。
• UX研究人员：开展用户测试，量化评估界面易用性与用户满意度。
• 开发团队：基于原型直接对接开发，减少需求理解偏差与沟通成本。
• 教育与培训场景：高校或企业内训中演示原型设计流程，降低工具配置门槛。

4. 使用方法与配置说明

4.1 快速启动（Docker Run）

通过以下命令启动基础服务：

bash
docker run -d -p 8080:8080 --name quant-ux docker.xuanyuan.run/quantux/quant-ux:latest

• 参数说明：
  • -d：后台运行容器
  • -p 8080:8080：映射容器8080端口至主机（默认服务端口）
  • --name quant-ux：指定容器名称
  • quantux/quant-ux:latest：使用最新版本镜像（生产环境建议指定固定版本，如v1.8.0）

启动后访问http://localhost:8080即可进入Quant-UX界面。

4.2 数据持久化配置

为避免容器重启导致数据丢失，需挂载主机目录至容器数据卷：

bash
docker run -d -p 8080:8080 \
  -v /path/on/host:/app/data \
  --name quant-ux docker.xuanyuan.run/quantux/quant-ux:latest

• -v /path/on/host:/app/data：将主机目录（如/opt/quant-ux/data）挂载至容器数据目录/app/data，持久化存储原型文件、用户数据及配置。

4.3 环境变量配置

支持通过环境变量自定义服务参数，常用配置如下：

示例（配置外部MySQL数据库）：

bash
docker run -d -p 3000:3000 \
  -e PORT=3000 \
  -e DATABASE_URL=jdbc:mysql://db-host:3306/quantux?user=root&password=db-pass \
  -e LOG_LEVEL=DEBUG \
  -v /opt/quant-ux/data:/app/data \
  --name quant-ux docker.xuanyuan.run/quantux/quant-ux:latest

4.4 Docker Compose配置

通过docker-compose.yml实现多容器部署（如搭配外部数据库）：

yaml
version: '3'
services:
  quant-ux:
    image: docker.xuanyuan.run/quantux/quant-ux:v1.8.0
    ports:
      - "8080:8080"
    volumes:
      - ./quant-ux-data:/app/data
    environment:
      - PORT=8080
      - DATABASE_URL=jdbc:mysql://mysql:3306/quantux?user=root&password=secret
      - CORS_ALLOWED=https://example.com,https://design.team.com
    depends_on:
      - mysql

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=quantux

volumes:
  quant-ux-data:
  mysql-data:

执行docker-compose up -d启动服务，通过docker-compose logs -f查看运行日志。

5. 注意事项

• 数据库选择：内置H2数据库适合开发/测试环境；生产环境建议使用MySQL或PostgreSQL，通过DATABASE_URL配置外部数据库连接，提升数据可靠性。
• 持久化权限：主机挂载目录需确保容器进程有读写权限（可通过chmod 775 /path/on/host调整），避免数据写入失败。
• SSL配置：如需HTTPS访问，可通过反向代理（如Nginx）配置SSL证书，或挂载证书文件至容器并设置环境变量SSL_CERT_PATH与SSL_KEY_PATH。

6. 版本与更新

• 镜像标签遵循SemVer规范（如v1.8.0），建议生产环境使用固定版本标签，避免latest标签自动更新导致兼容性问题。
• 最新版本及更新日志可通过Docker Hub（https://hub.docker.com/r/quantux/quant-ux%EF%BC%89%E6%9F%A5%E8%AF%A2%E3%80%82