tfgco/offers

Offers 镜像文档

1. 镜像概述和主要用途

Offers是一款专为游戏开发场景设计的服务镜像，核心功能是帮助游戏开发者高效管理和处理游戏内的优惠、促销活动。该服务可简化游戏内营销活动的创建、规则配置、用户触达及效果追踪流程，适用于各类游戏应用的活动运营需求。

2. 核心功能和特性

• 活动生命周期管理：支持优惠/促销活动的创建、编辑、启用/禁用及归档操作，覆盖活动全流程
• 灵活规则配置：可自定义活动时间范围、参与条件（如用户等级、角色类型）、优惠内容（道具、虚拟货币等）
• 用户定向推送：支持基于用户标签（新用户、活跃用户、付费用户等）精准推送活动
• 轻量级部署：基于容器化设计，支持快速集成到现有游戏服务架构，降低运维成本

3. 使用场景和适用范围

3.1 适用范围

• 手机游戏（iOS/Android平台）
• PC客户端游戏
• 网页游戏
• 主机游戏

3.2 典型使用场景

• 节日主题促销活动（如春节、圣诞节限定优惠）
• 用户留存激励（连续登录奖励、回归礼包）
• 新用户引导（新手专属优惠、首充奖励）
• 付费转化活动（套餐折扣、限时特惠）

4. 使用方法和配置说明

4.1 基础部署命令（Docker Run）

bash
docker run -d \
  --name offers-service \
  -p 8080:8080 \
  your-registry/offers:latest

4.2 环境变量配置

4.3 Docker Compose 配置示例

yaml
version: '3'
services:
  offers:
    image: your-registry/offers:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - DB_CONN=postgresql://user:pass@db:5432/offers
    depends_on:
      - db
  db:
    image: postgres:14
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=offers

volumes:
  postgres-data:

4.4 服务访问

服务启动后，可通过 http://<host>:<port>/api 访问活动管理接口，具体接口文档请参考官方完整API手册。