AssessmentReport

Assessment report — payload validation + aggregated_scores extraction + brief/full serialization (Layer 3 Domain).

Status

Key	Value
Layer	domain
Tier	L1
Status	deprecated
Version	0.9.0
Price	Free (free)
Category	Learning

Overview

Overview

AssessmentReport is a Layer 3 Domain Plugin of multi-saas-kit. It provides standard validation / extraction / serialization for persisting session assessment results from apis.how's pronunciation-service.

Eloquent dependencies removed; pure validator + extractor + serializer reusable across writing/listening/reading evaluation domains.

Core Components (3 Pure Services)

AggregatedScoreExtractor

Extracted from apis.how's AssessmentReportController::store. Extracts 4 standard column values from aggregated_scores:

• Missing / non-numeric → null
• Numeric strings auto-cast
• Score → float, duration → int

AssessmentPayloadValidator

Extracted from AssessmentReportController::store. Returns AssessmentReport fillable-compatible array:

Validation	Description
session_id	required + pattern + max 191
rubric default	'session_general'
utterance_count etc.	non-negative int
aggregated_scores	delegated to AggregatedScoreExtractor
array fields	only array passes, else null
store_raw	false → raw_utterances null (privacy)

ReportSerializer

Extracted from AssessmentReportController::serialize. Two modes:

• full — all fields
• brief — list view metadata (id / session_id / rubric / scores / created_at)

serializeMany([...]) — list defaults to brief, detail to full.

Configuration

return [
    'enabled' => env('PLG_ASSESSMENT_REPORT_ENABLED', true),
    'session_id' => [
        'pattern' => '/^[A-Za-z0-9_\-]{1,191}$/',
        'max_length' => 191,
    ],
    'default_rubric' => 'session_general',
    'store_raw_default' => false,
];

Usage

$validator = AssessmentPayloadValidator::fromConfig(config('assessment-report'));
$normalized = $validator->validate($request->all());
$report = AssessmentReport::create([...$normalized, 'tenant_id' => $tid]);

$serializer = new ReportSerializer;
return response()->json(['data' => $serializer->serialize($report->toArray())]);

Origin

Extracted from apis.how's AssessmentReport Model (105 LOC) + AssessmentReportController (318 LOC). Eloquent / RLS / Policy / auth remain in project; only pure validation + extraction + serialization in plugin.

Dependencies

None (self-contained, PromptTemplating optional for narrative).

Plugin Relationships

• AiRelay — automatic narrative generation (optional)
• AiTracking — call history (Phase 2)

Roadmap (Phase 3+)

• Standard AssessmentReport Model + Migration with RLS
• Filament Resource
• ApiToken ability integration
• Auto narrative (PromptTemplating + AiRelay)
• Writing/Reading evaluation domain extension

License

MIT

Dependencies

• PromptTemplating (optional)

Demos

• Platform 관리자 패널에서 메타 확인 🔒 Login required
• 사용 예시 (PHP)

---

🛒 View on Plugin Store: store.codebase.how/plugins/assessment-report