QuickQuiz/app/Services/ReportQueryService.php

686 lines
30 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Services;
use App\Models\User;
use Carbon\CarbonImmutable;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Database\Query\Builder;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
final class ReportQueryService
{
/**
* @param array<string, mixed> $input
* @return array<string, mixed>
*/
public function filters(array $input): array
{
$from = filled($input['date_from'] ?? null)
? CarbonImmutable::parse((string) $input['date_from'])->startOfDay()
: now()->subDays(6)->startOfDay()->toImmutable();
$to = filled($input['date_to'] ?? null)
? CarbonImmutable::parse((string) $input['date_to'])->endOfDay()
: now()->endOfDay()->toImmutable();
return [
'date_from' => $from,
'date_to' => $to,
'class_id' => $this->nullableInt($input['class_id'] ?? null),
'user_id' => $this->nullableInt($input['user_id'] ?? null),
'question_bank_id' => $this->nullableInt($input['question_bank_id'] ?? null),
'category_id' => $this->nullableInt($input['category_id'] ?? null),
'tag_id' => $this->nullableInt($input['tag_id'] ?? null),
'type' => filled($input['type'] ?? null) ? (string) $input['type'] : null,
'mode' => filled($input['mode'] ?? null) ? (string) $input['mode'] : null,
];
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function overview(User $user, array $filters): array
{
$answered = $this->answeredItems($user, $filters)
->selectRaw('count(*) as answered_count')
->selectRaw('count(distinct qa.id) as attempts')
->selectRaw('count(distinct qa.user_id) as active_students')
->selectRaw('coalesce(sum(case when qaq.is_correct = 1 then 1 else 0 end), 0) as correct_count')
->selectRaw('coalesce(avg(qaq.duration_seconds), 0) as avg_duration_seconds')
->first();
$totalItems = $this->allItems($user, $filters)->count();
$studentIds = $this->scopedStudentIds($user, $filters);
$wrongBase = $this->wrongQuestions($user, $filters);
$answeredCount = (int) ($answered->answered_count ?? 0);
$correctCount = (int) ($answered->correct_count ?? 0);
return [
'students' => $studentIds->count(),
'active_students' => (int) ($answered->active_students ?? 0),
'attempts' => (int) ($answered->attempts ?? 0),
'answered_count' => $answeredCount,
'accuracy' => $this->percent($correctCount, $answeredCount),
'completion_rate' => $this->percent($answeredCount, $totalItems),
'avg_duration_seconds' => round((float) ($answered->avg_duration_seconds ?? 0), 1),
'wrong_questions' => (clone $wrongBase)->whereNull('wrong_questions.mastered_at')->count(),
'mastered_wrong_questions' => (clone $wrongBase)->whereNotNull('wrong_questions.mastered_at')->count(),
];
}
/**
* @param array<string, mixed> $filters
* @return array<int, array<string, mixed>>
*/
public function trends(User $user, array $filters): array
{
$rows = $this->answeredItems($user, $filters)
->selectRaw('date(qaq.answered_at) as day')
->selectRaw('count(distinct qa.id) as attempts')
->selectRaw('count(distinct qa.user_id) as active_students')
->selectRaw('count(*) as answered_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 1 then 1 else 0 end), 0) as correct_count')
->selectRaw('coalesce(avg(qaq.duration_seconds), 0) as avg_duration_seconds')
->groupBy('day')
->orderBy('day')
->get()
->keyBy('day');
$wrongRows = $this->wrongQuestions($user, $filters)
->whereBetween('wrong_questions.last_wrong_at', [$filters['date_from'], $filters['date_to']])
->selectRaw('date(wrong_questions.last_wrong_at) as day, count(*) as wrong_added')
->groupBy('day')
->pluck('wrong_added', 'day');
$days = [];
$cursor = CarbonImmutable::parse($filters['date_from'])->startOfDay();
$end = CarbonImmutable::parse($filters['date_to'])->startOfDay();
while ($cursor <= $end) {
$day = $cursor->toDateString();
$row = $rows->get($day);
$answeredCount = (int) ($row->answered_count ?? 0);
$correctCount = (int) ($row->correct_count ?? 0);
$days[] = [
'day' => $day,
'attempts' => (int) ($row->attempts ?? 0),
'active_students' => (int) ($row->active_students ?? 0),
'answered_count' => $answeredCount,
'accuracy' => $this->percent($correctCount, $answeredCount),
'avg_duration_seconds' => round((float) ($row->avg_duration_seconds ?? 0), 1),
'wrong_added' => (int) ($wrongRows[$day] ?? 0),
];
$cursor = $cursor->addDay();
}
return $days;
}
/**
* @param array<string, mixed> $filters
*/
public function questionErrors(User $user, array $filters, int $perPage = 20): LengthAwarePaginator
{
return $this->questionErrorQuery($user, $filters)
->paginate($perPage)
->through(fn (object $row): array => $this->questionErrorRow($row));
}
/**
* @param array<string, mixed> $filters
* @return array<int, array<string, mixed>>
*/
public function classRanking(User $user, array $filters): array
{
return $this->visibleClasses($user, $filters)
->limit(20)
->get()
->map(function (object $class) use ($user, $filters): array {
$classFilters = $filters + ['class_id' => (int) $class->id];
$classFilters['class_id'] = (int) $class->id;
$overview = $this->overview($user, $classFilters);
return [
'id' => (int) $class->id,
'name' => $class->name,
'members_count' => (int) $class->members_count,
'attempts' => $overview['attempts'],
'answered_count' => $overview['answered_count'],
'completion_rate' => $overview['completion_rate'],
'avg_duration_seconds' => $overview['avg_duration_seconds'],
'accuracy' => $overview['accuracy'],
];
})
->sortByDesc('answered_count')
->values()
->all();
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function mastery(User $user, array $filters): array
{
return [
'banks' => $this->dimensionRows($user, $filters, 'qb.id', 'qb.name', ['qb.id', 'qb.name'], 20),
'categories' => $this->dimensionRows($user, $filters, 'q.category_id', 'coalesce(qc.name, "未分类")', ['q.category_id', 'qc.name', 'qb.name'], 30, [
'bank_name' => 'qb.name',
]),
'types' => $this->dimensionRows($user, $filters, 'q.type', 'q.type', ['q.type'], 10),
'tags' => $this->tagRows($user, $filters, 30),
];
}
/**
* @param array<string, mixed> $filters
*/
public function students(User $user, array $filters, int $perPage = 20): LengthAwarePaginator
{
return $this->answeredItems($user, $filters)
->join('users as u', 'u.id', '=', 'qa.user_id')
->leftJoin('wrong_questions as wq', function ($join): void {
$join->on('wq.user_id', '=', 'u.id')
->on('wq.question_id', '=', 'q.id')
->whereNull('wq.mastered_at');
})
->selectRaw('u.id, u.name, u.email')
->selectRaw('count(distinct qa.id) as attempts')
->selectRaw('count(*) as answered_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 1 then 1 else 0 end), 0) as correct_count')
->selectRaw('coalesce(avg(qaq.duration_seconds), 0) as avg_duration_seconds')
->selectRaw('count(distinct wq.id) as wrong_questions')
->selectRaw('max(qaq.answered_at) as last_answered_at')
->groupBy('u.id', 'u.name', 'u.email')
->orderByDesc('answered_count')
->paginate($perPage)
->through(fn (object $row): array => $this->studentRow($row));
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function studentDetail(User $viewer, User $student, array $filters): array
{
$filters['user_id'] = $student->id;
abort_if(! $this->canViewStudent($viewer, $student->id), 403);
return [
'student' => ['id' => $student->id, 'name' => $student->name, 'email' => $student->email],
'overview' => $this->overview($viewer, $filters),
'banks' => $this->dimensionRows($viewer, $filters, 'qb.id', 'qb.name', ['qb.id', 'qb.name'], 10),
'categories' => $this->dimensionRows($viewer, $filters, 'q.category_id', 'coalesce(qc.name, "未分类")', ['q.category_id', 'qc.name', 'qb.name'], 10, ['bank_name' => 'qb.name']),
'types' => $this->dimensionRows($viewer, $filters, 'q.type', 'q.type', ['q.type'], 10),
'question_errors' => $this->questionErrorQuery($viewer, $filters)->limit(10)->get()->map(fn (object $row): array => $this->questionErrorRow($row))->all(),
];
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function bankDetail(User $user, int $bankId, array $filters): array
{
$filters['question_bank_id'] = $bankId;
abort_if(! $this->canViewBank($user, $bankId), 403);
return [
'overview' => $this->overview($user, $filters),
'categories' => $this->dimensionRows($user, $filters, 'q.category_id', 'coalesce(qc.name, "未分类")', ['q.category_id', 'qc.name'], 20),
'tags' => $this->tagRows($user, $filters, 20),
'types' => $this->dimensionRows($user, $filters, 'q.type', 'q.type', ['q.type'], 10),
'question_errors' => $this->questionErrorQuery($user, $filters)->limit(20)->get()->map(fn (object $row): array => $this->questionErrorRow($row))->all(),
];
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function insights(User $user, array $filters): array
{
$students = $this->students($user, $filters, 100)->getCollection()
->filter(fn (array $row): bool => $row['accuracy'] < 60 && $row['answered_count'] >= 10)
->take(5)
->values()
->all();
$questions = $this->questionErrorQuery($user, $filters)
->havingRaw('wrong_count >= 3')
->limit(5)
->get()
->map(fn (object $row): array => $this->questionErrorRow($row))
->filter(fn (array $row): bool => $row['wrong_rate'] > 50 && $row['attempts'] >= 5)
->values()
->all();
$categories = collect($this->dimensionRows($user, $filters, 'q.category_id', 'coalesce(qc.name, "未分类")', ['q.category_id', 'qc.name', 'qb.name'], 30, ['bank_name' => 'qb.name']))
->filter(fn (array $row): bool => $row['accuracy'] < 65 && $row['answered_count'] >= 10)
->take(5)
->values()
->all();
return [
'students' => $students,
'questions' => $questions,
'categories' => $categories,
];
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function options(User $user, array $filters): array
{
$bankQuery = DB::table('question_banks')
->select('id', 'name')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('owner_id', $user->id))
->orderBy('name');
$classQuery = DB::table('classes')
->select('id', 'name')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('owner_id', $user->id))
->orderBy('name');
$studentIds = $this->scopedStudentIds($user, $filters);
return [
'banks' => $bankQuery->get(),
'classes' => $classQuery->get(),
'students' => User::query()->select('id', 'name', 'email')->whereIn('id', $studentIds)->orderBy('name')->limit(200)->get(),
'categories' => DB::table('question_categories')
->join('question_banks', 'question_banks.id', '=', 'question_categories.question_bank_id')
->select('question_categories.id', 'question_categories.name', 'question_categories.question_bank_id')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('question_banks.owner_id', $user->id))
->when($filters['question_bank_id'] ?? null, fn (Builder $query, int $bankId) => $query->where('question_categories.question_bank_id', $bankId))
->orderBy('question_categories.name')
->get(),
'tags' => DB::table('question_tags')
->join('question_banks', 'question_banks.id', '=', 'question_tags.question_bank_id')
->select('question_tags.id', 'question_tags.name', 'question_tags.question_bank_id')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('question_banks.owner_id', $user->id))
->when($filters['question_bank_id'] ?? null, fn (Builder $query, int $bankId) => $query->where('question_tags.question_bank_id', $bankId))
->orderBy('question_tags.name')
->get(),
];
}
/**
* @param array<string, mixed> $filters
* @return array<string, mixed>
*/
public function exportPayload(User $user, array $filters): array
{
return [
'filters' => [
'date_from' => CarbonImmutable::parse($filters['date_from'])->toDateString(),
'date_to' => CarbonImmutable::parse($filters['date_to'])->toDateString(),
] + collect($filters)->except(['date_from', 'date_to'])->filter()->all(),
'overview' => $this->overview($user, $filters),
'trends' => $this->trends($user, $filters),
'class_ranking' => $this->classRanking($user, $filters),
'students' => $this->students($user, $filters, 1000)->items(),
'mastery' => $this->mastery($user, $filters),
'question_errors' => $this->questionErrors($user, $filters, 1000)->items(),
'insights' => $this->insights($user, $filters),
];
}
/**
* @param array<string, mixed> $filters
*/
private function answeredItems(User $user, array $filters): Builder
{
return $this->itemBase($user, $filters)
->whereNotNull('qaq.answered_at')
->whereBetween('qaq.answered_at', [$filters['date_from'], $filters['date_to']]);
}
/**
* @param array<string, mixed> $filters
*/
private function allItems(User $user, array $filters): Builder
{
return $this->itemBase($user, $filters)
->whereBetween('qa.started_at', [$filters['date_from'], $filters['date_to']]);
}
/**
* @param array<string, mixed> $filters
*/
private function itemBase(User $user, array $filters): Builder
{
return DB::table('quiz_attempt_questions as qaq')
->join('quiz_attempts as qa', 'qa.id', '=', 'qaq.quiz_attempt_id')
->join('questions as q', 'q.id', '=', 'qaq.question_id')
->join('question_banks as qb', 'qb.id', '=', 'q.question_bank_id')
->leftJoin('question_categories as qc', 'qc.id', '=', 'q.category_id')
->whereNull('q.deleted_at')
->whereNull('qb.deleted_at')
->tap(fn (Builder $query) => $this->applyScope($query, $user))
->tap(fn (Builder $query) => $this->applyFilters($query, $filters));
}
private function applyScope(Builder $query, User $user): void
{
if ($user->role === 'admin') {
return;
}
$query->where(function (Builder $scope) use ($user): void {
$scope->where('qb.owner_id', $user->id)
->orWhereExists(function (Builder $exists) use ($user): void {
$exists->selectRaw('1')
->from('class_members as scope_cm')
->join('classes as scope_c', 'scope_c.id', '=', 'scope_cm.class_id')
->whereColumn('scope_cm.user_id', 'qa.user_id')
->where('scope_c.owner_id', $user->id)
->whereNull('scope_c.deleted_at');
});
});
}
/**
* @param array<string, mixed> $filters
*/
private function applyFilters(Builder $query, array $filters): void
{
$query
->when($filters['class_id'] ?? null, fn (Builder $builder, int $classId) => $builder->whereExists(function (Builder $exists) use ($classId): void {
$exists->selectRaw('1')
->from('class_members as filter_cm')
->whereColumn('filter_cm.user_id', 'qa.user_id')
->where('filter_cm.class_id', $classId);
}))
->when($filters['user_id'] ?? null, fn (Builder $builder, int $userId) => $builder->where('qa.user_id', $userId))
->when($filters['question_bank_id'] ?? null, fn (Builder $builder, int $bankId) => $builder->where('q.question_bank_id', $bankId))
->when($filters['category_id'] ?? null, fn (Builder $builder, int $categoryId) => $builder->where('q.category_id', $categoryId))
->when($filters['tag_id'] ?? null, fn (Builder $builder, int $tagId) => $builder->whereExists(function (Builder $exists) use ($tagId): void {
$exists->selectRaw('1')
->from('question_tag as filter_qt')
->whereColumn('filter_qt.question_id', 'q.id')
->where('filter_qt.question_tag_id', $tagId);
}))
->when($filters['type'] ?? null, fn (Builder $builder, string $type) => $builder->where('q.type', $type))
->when($filters['mode'] ?? null, fn (Builder $builder, string $mode) => $builder->where('qa.mode', $mode));
}
/**
* @param array<string, mixed> $filters
*/
private function wrongQuestions(User $user, array $filters): Builder
{
return DB::table('wrong_questions')
->join('questions as q', 'q.id', '=', 'wrong_questions.question_id')
->join('question_banks as qb', 'qb.id', '=', 'q.question_bank_id')
->leftJoin('question_categories as qc', 'qc.id', '=', 'q.category_id')
->whereNull('q.deleted_at')
->whereNull('qb.deleted_at')
->tap(fn (Builder $query) => $this->applyWrongScope($query, $user))
->tap(fn (Builder $query) => $this->applyWrongFilters($query, $filters));
}
private function applyWrongScope(Builder $query, User $user): void
{
if ($user->role === 'admin') {
return;
}
$query->where(function (Builder $scope) use ($user): void {
$scope->where('qb.owner_id', $user->id)
->orWhereExists(function (Builder $exists) use ($user): void {
$exists->selectRaw('1')
->from('class_members as scope_cm')
->join('classes as scope_c', 'scope_c.id', '=', 'scope_cm.class_id')
->whereColumn('scope_cm.user_id', 'wrong_questions.user_id')
->where('scope_c.owner_id', $user->id)
->whereNull('scope_c.deleted_at');
});
});
}
/**
* @param array<string, mixed> $filters
*/
private function applyWrongFilters(Builder $query, array $filters): void
{
$query
->when($filters['class_id'] ?? null, fn (Builder $builder, int $classId) => $builder->whereExists(function (Builder $exists) use ($classId): void {
$exists->selectRaw('1')
->from('class_members as filter_cm')
->whereColumn('filter_cm.user_id', 'wrong_questions.user_id')
->where('filter_cm.class_id', $classId);
}))
->when($filters['user_id'] ?? null, fn (Builder $builder, int $userId) => $builder->where('wrong_questions.user_id', $userId))
->when($filters['question_bank_id'] ?? null, fn (Builder $builder, int $bankId) => $builder->where('q.question_bank_id', $bankId))
->when($filters['category_id'] ?? null, fn (Builder $builder, int $categoryId) => $builder->where('q.category_id', $categoryId))
->when($filters['tag_id'] ?? null, fn (Builder $builder, int $tagId) => $builder->whereExists(function (Builder $exists) use ($tagId): void {
$exists->selectRaw('1')
->from('question_tag as filter_qt')
->whereColumn('filter_qt.question_id', 'q.id')
->where('filter_qt.question_tag_id', $tagId);
}))
->when($filters['type'] ?? null, fn (Builder $builder, string $type) => $builder->where('q.type', $type));
}
/**
* @param array<string, mixed> $filters
*/
private function questionErrorQuery(User $user, array $filters): Builder
{
return $this->answeredItems($user, $filters)
->selectRaw('q.id, q.content, q.type, qb.name as bank_name, coalesce(qc.name, "未分类") as category_name')
->selectRaw('count(*) as attempts')
->selectRaw('coalesce(sum(case when qaq.is_correct = 0 then 1 else 0 end), 0) as wrong_count')
->selectRaw('max(case when qaq.is_correct = 0 then qaq.answered_at else null end) as last_wrong_at')
->groupBy('q.id', 'q.content', 'q.type', 'qb.name', 'qc.name')
->orderByDesc('wrong_count')
->orderByDesc('attempts');
}
/**
* @param array<string, mixed> $filters
* @param array<int, string> $groups
* @param array<string, string> $extraSelects
* @return array<int, array<string, mixed>>
*/
private function dimensionRows(User $user, array $filters, string $idExpression, string $nameExpression, array $groups, int $limit, array $extraSelects = []): array
{
$query = $this->answeredItems($user, $filters)
->selectRaw($idExpression.' as id')
->selectRaw($nameExpression.' as name');
foreach ($extraSelects as $alias => $expression) {
$query->selectRaw($expression.' as '.$alias);
}
return $query
->selectRaw('count(*) as answered_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 1 then 1 else 0 end), 0) as correct_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 0 then 1 else 0 end), 0) as wrong_count')
->selectRaw('coalesce(avg(qaq.duration_seconds), 0) as avg_duration_seconds')
->groupBy(...$groups)
->orderByDesc('wrong_count')
->orderByDesc('answered_count')
->limit($limit)
->get()
->map(fn (object $row): array => $this->dimensionRow($row))
->all();
}
/**
* @param array<string, mixed> $filters
* @return array<int, array<string, mixed>>
*/
private function tagRows(User $user, array $filters, int $limit): array
{
return $this->answeredItems($user, $filters)
->join('question_tag as qt', 'qt.question_id', '=', 'q.id')
->join('question_tags as qtag', 'qtag.id', '=', 'qt.question_tag_id')
->selectRaw('qtag.id as id, qtag.name as name, qb.name as bank_name')
->selectRaw('count(*) as answered_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 1 then 1 else 0 end), 0) as correct_count')
->selectRaw('coalesce(sum(case when qaq.is_correct = 0 then 1 else 0 end), 0) as wrong_count')
->selectRaw('coalesce(avg(qaq.duration_seconds), 0) as avg_duration_seconds')
->groupBy('qtag.id', 'qtag.name', 'qb.name')
->orderByDesc('wrong_count')
->orderByDesc('answered_count')
->limit($limit)
->get()
->map(fn (object $row): array => $this->dimensionRow($row))
->all();
}
/**
* @param array<string, mixed> $filters
*/
private function visibleClasses(User $user, array $filters): Builder
{
return DB::table('classes')
->leftJoin('class_members', 'class_members.class_id', '=', 'classes.id')
->whereNull('classes.deleted_at')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('classes.owner_id', $user->id))
->when($filters['class_id'] ?? null, fn (Builder $query, int $classId) => $query->where('classes.id', $classId))
->selectRaw('classes.id, classes.name, count(distinct class_members.user_id) as members_count')
->groupBy('classes.id', 'classes.name')
->orderBy('classes.name');
}
/**
* @param array<string, mixed> $filters
* @return Collection<int, int>
*/
private function scopedStudentIds(User $user, array $filters): Collection
{
$ids = DB::table('quiz_attempts as qa')
->join('quiz_attempt_questions as qaq', 'qaq.quiz_attempt_id', '=', 'qa.id')
->join('questions as q', 'q.id', '=', 'qaq.question_id')
->join('question_banks as qb', 'qb.id', '=', 'q.question_bank_id')
->whereNotNull('qaq.answered_at')
->tap(fn (Builder $query) => $this->applyScope($query, $user))
->tap(fn (Builder $query) => $this->applyFilters($query, $filters))
->distinct()
->pluck('qa.user_id');
$classMemberQuery = DB::table('class_members')
->join('classes', 'classes.id', '=', 'class_members.class_id')
->whereNull('classes.deleted_at')
->when($user->role !== 'admin', fn (Builder $query) => $query->where('classes.owner_id', $user->id))
->when($filters['class_id'] ?? null, fn (Builder $query, int $classId) => $query->where('class_members.class_id', $classId));
if (($filters['class_id'] ?? null) || $user->role !== 'admin') {
$classIds = $classMemberQuery
->pluck('user_id');
$ids = $ids->merge($classIds);
}
return $ids->map(fn ($id): int => (int) $id)->unique()->values();
}
private function canViewStudent(User $viewer, int $studentId): bool
{
if ($viewer->role === 'admin') {
return true;
}
return DB::table('class_members')
->join('classes', 'classes.id', '=', 'class_members.class_id')
->where('class_members.user_id', $studentId)
->where('classes.owner_id', $viewer->id)
->whereNull('classes.deleted_at')
->exists();
}
private function canViewBank(User $viewer, int $bankId): bool
{
if ($viewer->role === 'admin') {
return true;
}
return DB::table('question_banks')
->where('id', $bankId)
->where('owner_id', $viewer->id)
->whereNull('deleted_at')
->exists();
}
/**
* @return array<string, mixed>
*/
private function dimensionRow(object $row): array
{
$answered = (int) $row->answered_count;
$correct = (int) $row->correct_count;
$data = [
'id' => $row->id === null ? null : (is_numeric($row->id) ? (int) $row->id : (string) $row->id),
'name' => (string) $row->name,
'answered_count' => $answered,
'correct_count' => $correct,
'wrong_count' => (int) $row->wrong_count,
'accuracy' => $this->percent($correct, $answered),
'avg_duration_seconds' => round((float) $row->avg_duration_seconds, 1),
];
if (property_exists($row, 'bank_name')) {
$data['bank_name'] = $row->bank_name;
}
return $data;
}
/**
* @return array<string, mixed>
*/
private function questionErrorRow(object $row): array
{
$attempts = (int) $row->attempts;
$wrong = (int) $row->wrong_count;
return [
'id' => (int) $row->id,
'content' => $row->content,
'type' => $row->type,
'bank_name' => $row->bank_name,
'category_name' => $row->category_name,
'attempts' => $attempts,
'wrong_count' => $wrong,
'wrong_rate' => $this->percent($wrong, $attempts),
'last_wrong_at' => $row->last_wrong_at,
];
}
/**
* @return array<string, mixed>
*/
private function studentRow(object $row): array
{
$answered = (int) $row->answered_count;
$correct = (int) $row->correct_count;
return [
'id' => (int) $row->id,
'name' => $row->name,
'email' => $row->email,
'attempts' => (int) $row->attempts,
'answered_count' => $answered,
'correct_count' => $correct,
'accuracy' => $this->percent($correct, $answered),
'avg_duration_seconds' => round((float) $row->avg_duration_seconds, 1),
'wrong_questions' => (int) $row->wrong_questions,
'last_answered_at' => $row->last_answered_at,
];
}
private function percent(int|float $value, int|float $total): float
{
return $total > 0 ? round($value / $total * 100, 2) : 0.0;
}
private function nullableInt(mixed $value): ?int
{
if ($value === null || $value === '') {
return null;
}
return (int) $value;
}
}