Laravel 기반의 회원 분배 시스템 개발

최근 Sitesauce의 기존 기반에 새로운 멤버십 시스템이 추가되었는데, 구체적인 구현 세부 사항에 대해 이 글을 썼습니다.

참고: 저는 여러분이 어떤 단계에 있든 기사를 읽을 수 있도록 처음부터 이 프로그램을 만들 예정입니다. 물론 이미 Laravel에 매우 익숙하다면 Rewardful과 같은 플랫폼에서 이 작업을 수행할 수 있으므로 많은 시간을 절약할 수 있습니다.

개념을 명확히 하기 위해 다음 텍스트에서는 초대자는 상급자로, 초대받는 사람은 부하로 대체됩니다.

우선 요구 사항을 명확히 해야 합니다. 먼저 사용자는 친구를 초대하여 등록할 수 있습니다. 프로그램 공유 링크를 통해 초대받은 사람이 링크를 통해 등록할 수 있어 초대 관계가 구속력을 갖게 됩니다. 둘째, 부하가 소비하면 상사가 해당 커미션을 받을 수 있습니다.

이제 등록 구현 방법을 결정해야 합니다. 원래는 Fathom의 방법을 사용할 계획이었습니다. 사용자가 특정 페이지로 이동하면 사용자가 등록을 완료한 후 해당 사용자가 특별 추천 페이지로 표시됩니다. 하지만 결국 추천 페이지를 구축하기 위한 링크에 ?via=miguel 매개변수를 추가하는 Rewardful의 접근 방식이 채택되었습니다.

좋아, 이제 등록 페이지를 만들어 보겠습니다. 등록 페이지에서 프로그램은 링크 매개변수를 통해 상사와 일치합니다. 코드는 간단합니다. via가 있으면 이를 30일 동안 쿠키에 저장합니다. 이를 필요로 하는 여러 하위 도메인이 있으므로 모든 하위 도메인이 쿠키를 사용할 수 있도록 기본 도메인 아래에 추가합니다. 아래의 구체적인 코드를 참고하세요:

import Cookies from 'js-cookie'
const via = new URL(location.href).searchParams.get('via')
if (via) {
    Cookies.set('sitesauce_affiliate', via, {
        expires: 30,
        domain: '.sitesauce.app',
        secure: true,
        sameSite: 'lax'
    })
}

이것의 장점은 회원이 이번 공유를 통해 회원가입을 하는 것이 아니라, 나중에 스스로 회원가입을 하게 되면 해당 회원이 해당 상사의 추천을 통해 가입했다는 것을 확실히 알 수 있다는 것입니다. 한걸음 더 나아가 신규 회원 가입 시 슬로건과 우월한 정보를 표시하여 사용자가 회원(친구)의 추천 링크임을 확실히 알 수 있도록 하여 가입 성공률을 더욱 높이고자 하여 추가하였습니다. 프롬프트 팝업 창. 효과는 다음과 같습니다.

위의 효과를 얻으려면 이제 상위 태그뿐만 아니라 상위 세부 정보도 필요하므로 상위 세부 정보를 일치시켜 제공하는 API가 필요합니다. 통해.

import axios from 'axios'
import Cookies from 'js-cookie'
const via = new URL(location.href).searchParams.get('via')
if (via) {
    axios.post(`https://app.sitesauce.app/api/affiliate/${encodeURIcomponent(this.via)}`).then(response => {
        Cookies.set('sitesauce_affiliate', response.data, { expires: 30, domain: '.sitesauce.app', secure: true, sameSite: 'lax' })
    }).catch(error => {
        if (!error.response || error.response.status !== 404) return console.log('Something went wrong')
        console.log('Affiliate does not exist. Register for our referral program here: https://app.sitesauce.app/affiliate')
    })
}

URL에서 encodeURIComponent를 볼 수 있으며, 그 역할은 경로 탐색 취약점으로부터 우리를 보호하는 것입니다. /api/referral/:via에 요청을 보낼 때 누군가 악의적으로 링크 매개변수를 다음과 같이 변경하는 경우: ?via=../../logout, 사용자는 클릭 후 로그아웃될 수 있습니다. 아무런 영향이 없습니다. 그러나 예상치 못한 결과를 가져올 다른 작업이 있을 수 있습니다.

Sitesauce는 몇몇 곳에서 Alpine을 사용하기 때문에 이를 기반으로 팝업창을 Alpine 컴포넌트로 수정하여 확장성이 더 좋습니다. 내 전환이 제대로 작동하지 않았을 때 귀중한 조언을 해준 Ryan에게 감사를 표하고 싶습니다.

<div x-data="{ ...component() } x-cloak x-init="init()">
    <template x-if="affiliate">
        <div>
            <img :src="affiliate.avatar" class="h-8 w-8 rounded-full mr-2">
            <p>Your friend <span x-text="affiliate.name"></span> has invited you to try Sitesauce</p>
            <button>Start your trial</button>
        </div>
    </template>
</div>
<script>
import axios from &#39;axios&#39;
import Cookies from &#39;js-cookie&#39;
// 使用模板标签 $nextTick ，进行代码转换，这里特别感谢下我的朋友 Ryan 
window.component = () => ({
    affiliate: null,
    via: new URL(location.href).searchParams.get(&#39;via&#39;)
    init() {
        if (! this.via) return this.$nextTick(() => this.affiliate = Cookies.getJSON(&#39;sitesauce.affiliate&#39;))
        axios.post(`https://app.sitesauce.app/api/affiliate/${encodeURIComponent(this.via)}`).then(response => {
            this.$nextTick(() => this.affiliate = response.data)
            Cookies.set(&#39;sitesauce.affiliate&#39;, response.data, {
                expires: 30, domain: &#39;.sitesauce.app&#39;, secure: true, sameSite: &#39;lax&#39;
            })
        }).catch(error => {
            if (!error.response || error.response.status !== 404) return console.log(&#39;Something went wrong&#39;)
            console.log(&#39;Affiliate does not exist. Register for our referral program here: https://app.sitesauce.app/affiliate&#39;)
        })
    }
})
</script>

이제 유효한 데이터를 얻을 수 있도록 API를 개선해 보세요. 또한 기존 데이터베이스에 여러 필드를 추가해야 하는데 이에 대해서는 나중에 설명하겠습니다. 다음은 마이그레이션 파일입니다:

class AddAffiliateColumnsToUsersTable extends Migration
{
    /**
     * 迁移执行
     *
     * @return void
     */
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('affiliate_tag')->nullable();
            $table->string('referred_by')->nullable();
            $table->string('paypal_email')->nullable();
            $table->timestamp('cashed_out_at')->nullable();
        });
    }
    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('affiliate_tag', 'referred_by', 'paypal_email', 'cashed_out_at');
        });
    }
}

라우팅 사용자 정의 키 이름 기능(Laravel 7.X에서 사용 가능)을 통해 매개변수 바인딩을 구현하여 API 라우팅을 구축합니다.

Route::post('api/affiliate/{user:affiliate_tag}', function (User $user) {
    return $user->only('id', 'name', 'avatar', 'affiliate_tag');
})->middleware('throttle:30,1');

등록 작업을 시작하기 전에 먼저 쿠키를 읽어보세요. 쿠키는 암호화되어 있지 않으므로 이를 제외하려면 EncryptCookies의 제외 필드에 추가해야 합니다.

// 中间件：app/Http/Middleware/EncryptCookies.php
use Illuminate\Cookie\Middleware\EncryptCookies as Middleware;
class EncryptCookies extends Middleware
{
    /**
    * The names of the cookies that should not be encrypted
    *
    * @var array
    */
    protected $except = [
        'sitesauce_referral',
    ];
}

이제 RegisterController의 인증된 메소드를 통해 해당 등록 로직을 실행합니다. 이 기간 동안 위의 메소드를 통해 Cooke를 획득하고 Cooke를 통해 해당 상위자를 찾고 최종적으로 하위자를 상위자와 연결합니다.

/**
 * 上级用户已经注册
 *
 * @param \Illuminate\Http\Request $request
 * @param \App\User $user
 */
protected function registered(Request $request, User $user)
{
    if (! $request->hasCookie('sitesauce.referral')) return;
    $referral = json_decode($request->cookie('sitesauce_referral'), true)['affiliate_tag'];
    if (! User::where('affiliate_tag', $referral)->exists()) return;
    $user->update([
        'referred_by' => $referral,
    ]);
}

또한 내 하위 사용자 목록을 가져오는 방법이 필요합니다. 이는 ORM의 hasMany 메서드를 통해 쉽게 얻을 수 있습니다.

class User extends Model
{
    public function referred()
    {
        return $this->hasMany(self::class, 'referred_by', 'affiliate_tag');
    }
}

이제 등록 페이지를 만들어 보겠습니다. 사용자가 등록할 때 기본 설정 탭을 선택하고 후속 출금 작업을 위해 PayPal 이메일을 제공하도록 요구할 수 있습니다. 다음은 효과 미리보기입니다.

회원 등록 후, 변경된 이메일 주소와 라벨 변경을 위한 해당 입구도 제공해야 합니다. 레이블을 변경한 후에는 하위 사용자의 레이블을 계단식으로 업데이트하여 둘의 통일성을 보장해야 합니다. 여기에는 데이터베이스 트랜잭션 작업이 포함됩니다. 작업의 원자성을 보장하려면 트랜잭션에서 위의 두 작업을 완료해야 합니다. 코드는 다음과 같습니다.

public function update(Request $request)
    {
        $request->validate([
            'affiliate_tag' => ['required', 'string', 'min:3', 'max:255', Rule::unique('users')->ignoreModel($request->user())],
            'paypal_email' => ['required', 'string', 'max:255', 'email'],
        ]);
        DB::transaction(function () use ($request) {
            if ($request->input('affiliate_tag') != $request->user()->affiliate_tag) {
                User::where('referred_by', $request->user()->affiliate_tag)
                    ->update(['referred_by' => $request->input('affiliate_tag')]);
            }
            $request->user()->update([
                'affiliate_tag' => $request->input('affiliate_tag'),
                'paypal_email' => $request->input('paypal_email'),
            ]);
        });
        return redirect()->route('affiliate');
    }

다음으로 회원 수입 계산 방법을 결정해야 합니다. 계산의 편의를 위해 하위 사용자의 전체 소비 금액 중 상위 사용자에게 수수료로 반환될 수 있는 비율만 계산합니다. 마지막 결제일 이후의 데이터입니다. Mattias의 백분율 패키지 확장을 사용하여 계산을 간단하고 간단하게 만듭니다.

use Mattiasgeniar\Percentage\Percentage;
const COMMISSION_PERCENTAGE = 20;
public function getReferralBalance() : int
{
    return Percentage::of(static::COMISSION_PERCENTAGE,
        $this->referred
            ->map(fn (User $user) => $user->invoices(false, ['created' => ['gte' => optional($this->cashed_out_at)->timestamp]]))
            ->flatten()
            ->map(fn (\Stripe\Invoice $invoice) => $invoice->subtotal)
            ->sum()
    );
}

마지막으로 월별 정산 형태로 상사에게 커미션을 배분하고, cashed_out_at 필드에 커미션 배분 시간을 업데이트합니다. 효과는 다음과 같습니다.

이 시점에서 위 문서가 도움이 되길 바랍니다. 나는 매일 당신에게 행복을 기원합니다.

추천 튜토리얼: "Laravel Tutorial"

위 내용은 Laravel 기반의 회원 분배 시스템 개발의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!