Pruefzaehler + Pruefkontingent (Decision-Update Phase-2 vorgezogen)

Eigener Pruef-Zaehler, getrennt von der Credit-Wallet (Paragraph 4.2/4.3):

- review_checks Ledger (eine Zeile je Pruefung, source free|credit,
  charged_credits), aggregiert pro Account/Monat statt pro PM
- ReviewCheckService: Tageslimit (harte Bremse, nicht freikaufbar) ->
  Monats-Freikontingent (tier-gestaffelt 4/12/30/60/120) -> Overflow
  zieht 1 Credit/Pruefung aus der Wallet
- ReviewLimitException fuer das erreichte Tageslimit

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-06-17 14:19:37 +00:00
parent b63cd26326
commit 3e8844245d
8 changed files with 387 additions and 0 deletions

View file

@ -0,0 +1,27 @@
<?php
namespace Database\Factories;
use App\Enums\ReviewCheckSource;
use App\Models\ReviewCheck;
use App\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;
/**
* @extends Factory<ReviewCheck>
*/
class ReviewCheckFactory extends Factory
{
/**
* @return array<string, mixed>
*/
public function definition(): array
{
return [
'user_id' => User::factory(),
'press_release_id' => null,
'source' => ReviewCheckSource::Free,
'charged_credits' => 0,
];
}
}

View file

@ -0,0 +1,36 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Prüfzähler-Ledger (Decision-Update §4.2): eine Zeile je Prüfung. Der eigene
* Zähler ist bewusst von der Credit-Wallet getrennt „Prüfungen inklusive"
* bleibt ein sauberes Versprechen. `source` unterscheidet die aus dem
* Monats-Freikontingent gedeckte Prüfung (free) von der per Credit
* nachgezogenen Overflow-Prüfung (credit); `charged_credits` hält den
* tatsächlich belasteten Betrag fest. Aggregiert wird pro Account/Monat
* (nicht pro PM), das Tageslimit dient als Burst-Schutz.
*/
return new class extends Migration
{
public function up(): void
{
Schema::create('review_checks', function (Blueprint $table): void {
$table->id();
$table->foreignId('user_id')->constrained()->cascadeOnDelete();
$table->foreignId('press_release_id')->nullable()->constrained()->nullOnDelete();
$table->string('source');
$table->integer('charged_credits')->default(0);
$table->timestamps();
$table->index(['user_id', 'created_at']);
});
}
public function down(): void
{
Schema::dropIfExists('review_checks');
}
};