return [
    // 数据库表前缀（可选）
    'table_prefix' => env('AGENT_TABLE_PREFIX', ''),

    // 路由配置
    'route' => [
        'prefix' => env('AGENT_ROUTE_PREFIX', 'api/agent'),  // API 前缀
        'middleware' => ['api'],                              // 中间件
        'enabled' => true,                                    // 是否启用路由
    ],

    // 投手默认密码
    'default_password' => env('AGENT_DEFAULT_PASSWORD', '123456'),
];

'models' => [
    // 管理员模型（创建投手的管理员）
    'admin' => 'Modules\\User\\Models\\User',

    // 会员模型（投流带来的用户）
    'member' => 'Modules\\Member\\Models\\Member',

    // 订单模型（用于统计充值）
    'order' => 'Modules\\Pay\\Models\\Order',

    // 可推广的产品模型（多态关联）
    'promotable' => [
        'video' => 'Modules\\VideoSubscription\\Models\\Video',      // 短剧
        // 'product' => 'Modules\\Shop\\Models\\Product',            // 商品
        // 'course' => 'Modules\\Course\\Models\\Course',            // 课程
    ],

    // 充值包模型（多态关联）
    'packages' => [
        'recharge' => 'Modules\\Pay\\Models\\RechargeActivity',      // 充值活动
        // 'subscription' => 'Modules\\Pay\\Models\\SubscriptionPlan', // 订阅套餐
    ],
],

// 广告平台
'platforms' => [
    'facebook' => ['name' => 'Facebook', 'enabled' => true],
    'tiktok' => ['name' => 'TikTok', 'enabled' => true],
    'google' => ['name' => 'Google', 'enabled' => true],
],

// 投放方式
'delivery_types' => [
    'knife' => '打刀',
    'normal' => '常规',
],

// 应用平台
'app_platforms' => [
    'h5_direct' => 'H5直投',
    'pwa' => 'PWA',
    'app' => 'APP',
],

// 归因平台
'attribution_platforms' => [
    'facebook' => 'Facebook',
    'appsflyer' => 'AppsFlyer',
    'adjust' => 'Adjust',
    'branch' => 'Branch',
],

<?php

namespace Modules\VideoSubscription\Models;

use Illuminate\Database\Eloquent\Model;
use Xditn\Agent\Contracts\PromotableInterface;

class Video extends Model implements PromotableInterface
{
    /**
     * 获取产品名称（用于链接显示）
     */
    public function getPromotableName(): string
    {
        return $this->title;
    }

    /**
     * 获取产品扩展数据（存储到 extra_data）
     */
    public function getPromotableExtraData(): array
    {
        return [
            'video_id' => $this->id,
            'video_name_cn' => $this->title_cn,
            'episode_count' => $this->episode_count,
            'coin_per_episode' => $this->coin_per_episode,
            'paid_episode_count' => $this->paid_episode_count,
        ];
    }
}

<?php

namespace Modules\Member\Models;

use Illuminate\Database\Eloquent\Model;
use Xditn\Agent\Contracts\MemberInterface;

class Member extends Model implements MemberInterface
{
    public function getMemberId(): int|string
    {
        return $this->id;
    }

    public function getRegisteredAt(): int
    {
        return $this->created_at instanceof \Carbon\Carbon 
            ? $this->created_at->timestamp 
            : (int) $this->created_at;
    }

    public function getMemberExtraData(): array
    {
        return [
            'nickname' => $this->nickname,
            'avatar' => $this->avatar,
            'vip_level' => $this->vip_level,
        ];
    }
}

<?php

namespace Modules\Pay\Models;

use Illuminate\Database\Eloquent\Model;
use Xditn\Agent\Contracts\OrderInterface;

class Order extends Model implements OrderInterface
{
    public function getOrderAmount(): float
    {
        return (float) $this->amount;
    }

    public function getPaymentChannel(): string
    {
        // 返回 google / ios / aggregate
        return match($this->payment_method) {
            'google_pay' => 'google',
            'apple_pay' => 'ios',
            default => 'aggregate',
        };
    }

    public function getOrderMemberId(): int|string
    {
        return $this->member_id;
    }

    public function getPaidAt(): ?int
    {
        return $this->paid_at;
    }

    public function isPaid(): bool
    {
        return $this->status === 'paid';
    }
}

<?php

namespace App\Services;

use Xditn\Agent\Services\AgentTrackingService;

class MemberService
{
    public function __construct(
        protected AgentTrackingService $trackingService
    ) {}

    public function register(array $data): Member
    {
        // 创建会员
        $member = Member::create($data);

        // 如果有投流链接参数，记录新用户
        if ($shortCode = request()->input('ref')) {
            $link = $this->trackingService->getLinkByShortCode($shortCode);
            
            if ($link) {
                $this->trackingService->trackNewUser(
                    $link->agent_id,
                    $link->id,
                    $member,
                    [
                        'new_id' => $data['device_id'] ?? null,
                        'register_id' => $member->id,
                        'ip' => request()->ip(),
                        'country' => $this->getCountryFromIp(request()->ip()),
                        'system' => request()->input('platform', 'h5'),
                        'ad_series_name' => request()->input('campaign'),
                        'ad_group_name' => request()->input('adset'),
                        'ad_name' => request()->input('ad'),
                    ]
                );
            }
        }

        return $member;
    }
}

<?php

namespace App\Services;

use Xditn\Agent\Services\AgentTrackingService;

class PaymentService
{
    public function __construct(
        protected AgentTrackingService $trackingService
    ) {}

    public function handlePaymentSuccess(Order $order): void
    {
        // 获取会员关联的投手信息
        $agentNewUser = AgentNewUser::where('member_id', $order->member_id)->first();
        
        if ($agentNewUser) {
            $this->trackingService->trackOrder(
                $agentNewUser->agent_id,
                $agentNewUser->link_id,
                $order
            );
        }
    }
}

<?php

// EventServiceProvider.php
protected $listen = [
    \Xditn\Agent\Events\NewUserRegistered::class => [
        \App\Listeners\HandleNewUserRegistered::class,
    ],
    \Xditn\Agent\Events\OrderPaid::class => [
        \App\Listeners\HandleAgentOrderPaid::class,
    ],
];

<?php

namespace App\Listeners;

use Xditn\Agent\Events\NewUserRegistered;

class HandleNewUserRegistered
{
    public function handle(NewUserRegistered $event): void
    {
        $newUser = $event->newUser;
        $agentId = $event->agentId;
        $linkId = $event->linkId;

        // 发送 Facebook Pixel 事件
        // 发送通知等
    }
}

// app/Console/Kernel.php
protected function schedule(Schedule $schedule): void
{
    // 每天凌晨1点同步前一天的统计数据
    $schedule->command('agent:sync-statistics')->dailyAt('01:00');
}