mckayc/task-donegeon

任务奖励系统镜像文档

镜像概述

本镜像为任务奖励系统提供容器化解决方案，核心功能是实现任务的创建、跟踪及完成后的奖励发放流程。通过轻量级设计与灵活配置，支持快速部署任务激励机制，适用于需要任务-奖励联动的各类应用场景。

核心功能与特性

• 任务生命周期管理：支持任务创建、分配、执行状态跟踪及结果验证
• 自动化奖励机制：任务完成后自动触发奖励规则，支持多种奖励类型（积分、虚拟物品、权限等）
• 外部系统集成：提供API接口，可与数据库、通知服务、支付系统等第三方平台对接
• 可配置规则引擎：支持自定义任务条件、奖励标准及发放策略
• 轻量化部署：基于Alpine基础镜像构建，容器启动速度快，资源占用低

使用场景与适用范围

• 企业内部激励平台：员工任务完成与绩效奖励联动系统
• 用户运营活动：App/网站用户完成指定行为（如签到、分享、消费）获取奖励
• 众包协作平台：自由职业者完成任务后自动结算报酬
• 学习教育系统：学生完成课程任务获取学习积分或证书

使用方法与配置说明

基础启动命令

通过以下命令快速启动容器（默认配置）：

bash
docker run -d --name task-reward-system -p 8080:8080 [镜像名称]:latest

环境变量配置

通过环境变量自定义系统行为，常用配置参数如下：

带自定义配置的启动示例：

bash
docker run -d --name task-reward-system \
  -p 8080:8080 \
  -e TASK_DB_CONN="mysql://user:password@mysql-host:3306/task_db" \
  -e REWARD_TYPE="VIRTUAL" \
  -e NOTIFICATION_URL="https://api.example.com/notify" \
  -v ./data:/app/data \
  [镜像名称]:latest

数据持久化配置

为防止任务和奖励数据丢失，建议挂载数据卷：

bash
docker run -d --name task-reward-system \
  -v /host/path/to/data:/app/data \
  [镜像名称]:latest

说明：/app/data目录包含任务日志、未完成任务缓存及奖励发放记录

Docker Compose 配置示例

创建docker-compose.yml文件实现多服务联动（含数据库）：

yaml
version: '3.8'
services:
  task-reward:
    image: [镜像名称]:latest
    ports:
      - "8080:8080"
    environment:
      - TASK_DB_CONN="postgresql://postgres:pgpass@db:5432/taskdb"
      - REWARD_TYPE="MONEY"
    depends_on:
      - db
    volumes:
      - ./app-data:/app/data
  db:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=pgpass
      - POSTGRES_DB=taskdb
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

注意事项

1. 首次启动需通过/init接口初始化系统规则（访问http://localhost:8080/init完成基础配置）
2. 高并发场景下建议调整WORKER_THREADS环境变量（默认4线程）
3. 奖励发放涉及资金/敏感操作时，需启用SECURITY_MODE=strict并配置签名验证
4. 定期备份/app/data目录数据，避免容器重建导致数据丢失