23 lines
588 B
PHP
23 lines
588 B
PHP
<?php
|
|
|
|
namespace App\Contracts;
|
|
|
|
interface AiService
|
|
{
|
|
/**
|
|
* Analyze a student's performance data and return a structured remediation plan.
|
|
*
|
|
* @param array<string, mixed> $performance
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function analyzeStudentPerformance(array $performance): array;
|
|
|
|
/**
|
|
* Generate a parent-friendly weekly summary from the student's activity data.
|
|
*
|
|
* @param array<string, mixed> $activity
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function generateParentWeeklyReport(array $activity): array;
|
|
}
|