daveearley/hi.events-all-in-one

event-management-platform 镜像文档

镜像概述和主要用途

event-management-platform 是一个开源的活动管理与票务销售平台镜像，旨在为活动组织者提供一站式解决方案，支持从活动创建、票务设置到销售跟踪的全流程管理。该镜像基于开源代码构建，可快速部署，适用于各类线上线下活动（如研讨会、音乐会、企业会议等）的票务管理需求，帮助用户高效处理活动组织与票务销售工作。

核心功能和特性

活动管理

• 支持自定义活动信息（名称、描述、时间、地点、封面图等）
• 活动状态管理（草稿、发布、结束、归档）
• 多语言与多地区配置支持

票务管理

• 灵活配置多种票种（普通票、VIP票、早鸟票等）
• 自定义票价、销售时段、库存数量
• 支持折扣码、促销活动设置

销售与订单管理

• 实时销售数据监控
• 订单状态跟踪（待支付、已支付、已取消、已退款）
• 订单导出与批量操作功能

用户与参与者管理

• 参与者注册、登录及个人中心
• 活动报名信息收集（自定义表单字段）
• 参与者沟通（邮件通知、活动提醒）

支付与集成

• 支持多种支付方式集成（***、第三方支付平台）
• 支付流程自动化（订单确认、票据发送）
• API接口支持第三方系统集成（如CRM、营销工具）

数据与报表

• 销售统计报表（按时间、票种、渠道）
• 参与者数据分析（地域、 demographics）
• 财务数据汇总与导出

开源特性

• 完全开源，无许可费用
• 代码可自定义扩展与二次开发
• 活跃社区支持，持续功能迭代

使用场景和适用范围

适用用户

• 小型活动组织者（社区活动、公益讲座、工作坊）
• 中型活动策划方（企业会议、行业展会、培训课程）
• 教育机构（校园活动、学术研讨会）
• 非营利组织（筹款活动、志愿者招募活动）

典型场景

• 线下活动票务销售（如音乐会、体育赛事）
• 线上活动报名（如网络研讨会、直播课程）
• 企业内部活动管理（员工培训、团建活动）
• 多场次活动统筹（系列讲座、巡回展览）

使用方法和配置说明

前置要求

• Docker Engine 20.10+
• Docker Compose（可选，用于多容器部署）
• 至少 1GB 内存，200MB 磁盘空间

快速部署（单容器模式）

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/event-management-platform:latest

2. 启动容器

bash
docker run -d \
  --name event-platform \
  -p 8080:8080 \
  -e DATABASE_URL=jdbc:h2:mem:eventdb  \  # 内置H2内存数据库（测试用，生产环境建议外接数据库）
  -e ADMIN_EMAIL=admin@example.com \      # 管理员邮箱（初始登录账号）
  -e ADMIN_PASSWORD=SecurePass123! \      # 管理员密码
  event-management-platform:latest

3. 访问平台

容器启动后，通过浏览器访问 http://localhost:8080，使用配置的 ADMIN_EMAIL 和 ADMIN_PASSWORD 登录管理后台。

生产环境部署（Docker Compose + MySQL）

1. 创建 docker-compose.yml 文件

yaml
version: '3.8'
services:
  app:
    image: docker.xuanyuan.run/event-management-platform:latest
    ports:
      - "80:8080"  # 映射宿主机80端口
    environment:
      - DATABASE_URL=jdbc:mysql://db:3306/eventdb?useSSL=false&serverTimezone=UTC
      - DATABASE_USER=eventuser
      - DATABASE_PASSWORD=EventDbPass123!
      - ADMIN_EMAIL=admin@yourdomain.com
      - ADMIN_PASSWORD=AdminPass456!
      - SMTP_HOST=smtp.yourdomain.com  # 邮件服务器（用于发送票据和通知）
      - SMTP_PORT=587
      - SMTP_USER=notifications@yourdomain.com
      - SMTP_PASSWORD=SmtpPass789!
      - PAYMENT_PROVIDER=stripe  # 支付提供商（支持stripe/paypal等）
      - PAYMENT_API_KEY=sk_test_your_stripe_key  # 支付平台API密钥
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: docker.xuanyuan.run/mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=RootPass123!
      - MYSQL_DATABASE=eventdb
      - MYSQL_USER=eventuser
      - MYSQL_PASSWORD=EventDbPass123!
    restart: unless-stopped

volumes:
  db_data:  # 持久化存储数据库数据

2. 启动服务

bash
docker-compose up -d

核心配置参数说明

基本使用流程

1. 登录管理后台：通过 http://<部署地址>/admin 访问，使用管理员账号登录。
2. 创建活动：在后台导航栏选择“活动管理”→“创建活动”，填写活动名称、时间、地点等信息。
3. 配置票务：进入活动详情页，选择“票务设置”，添加票种（名称、价格、库存、销售时段）。
4. 发布活动：活动信息与票务配置完成后，点击“发布”按钮，活动将对参与者可见。
5. 监控销售：在“销售报表”页面查看实时销售数据，通过“订单管理”处理订单状态。
6. 导出数据：活动结束后，可导出销售报表、参与者名单等数据用于后续分析。