feat: Initial commit for Saqel Platform architecture, backend, Docker, and documentation

2026-08-26 15:45:55 +03:00
commit d53b64500a
177 changed files with 19909 additions and 0 deletions
@@ -0,0 +1,22 @@
+<?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;
+}