<?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;
}