*/ protected $fillable = [ 'name', 'email', 'password', 'role', 'profile_photo', 'phone', 'address', 'bio', 'last_login_at', 'school_id', ]; /** * The attributes that should be hidden for serialization. * * @var array */ protected $hidden = [ 'password', 'remember_token', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'email_verified_at' => 'datetime', 'password' => 'hashed', 'last_login_at' => 'datetime', ]; /** * Get the school that the user belongs to. */ public function school() { return $this->belongsTo(School::class); } /** * Get the classes that the user is enrolled in or teaches. */ public function classes(): BelongsToMany { return $this->belongsToMany(Classroom::class, 'classroom_user') ->withPivot('role') ->withTimestamps(); } /** * Get the classes that the user teaches. */ public function teachingClasses(): BelongsToMany { return $this->belongsToMany(Classroom::class, 'classroom_user') ->wherePivot('role', 'teacher') ->withTimestamps(); } /** * Get the classes that the user is enrolled in as a student. */ public function enrolledClasses(): BelongsToMany { return $this->belongsToMany(Classroom::class, 'classroom_user') ->wherePivot('role', 'student') ->withTimestamps(); } /** * Get the assignments submitted by the user. */ public function submissions(): HasMany { return $this->hasMany(Submission::class); } /** * Get the attendance records for the user. */ public function attendanceRecords(): HasMany { return $this->hasMany(Attendance::class); } /** * Get the grades for the user. */ public function grades(): HasMany { return $this->hasMany(Grade::class); } /** * Get the portfolio items for the user. */ public function portfolioItems(): HasMany { return $this->hasMany(PortfolioItem::class); } /** * Get the messages sent by the user. */ public function sentMessages(): HasMany { return $this->hasMany(Message::class, 'sender_id'); } /** * Get the messages received by the user. */ public function receivedMessages(): HasMany { return $this->hasMany(Message::class, 'recipient_id'); } /** * Get the notifications for the user. */ public function userNotifications(): HasMany { return $this->hasMany(UserNotification::class); } /** * Get the badges earned by the user. */ public function badges(): BelongsToMany { return $this->belongsToMany(Badge::class, 'user_badges') ->withTimestamps(); } /** * Get the student profile associated with the user. */ public function studentProfile() { return $this->hasOne(StudentProfile::class); } /** * Check if the user is an admin. */ public function isAdmin(): bool { return in_array($this->role, ['admin', 'super_admin', 'application_admin']); } /** * Check if the user is a super admin. */ public function isSuperAdmin(): bool { return $this->role === 'super_admin'; } /** * Check if the user is a teacher. */ public function isTeacher(): bool { return $this->role === 'teacher'; } /** * Check if the user is a student. */ public function isStudent(): bool { return $this->role === 'student'; } /** * Check if the user is a school admin. */ public function isSchoolAdmin(): bool { return $this->role === 'school_admin'; } } */ protected $fillable = [ 'name', 'logo', 'address', 'phone', 'email', 'website', 'primary_color', 'secondary_color', 'curriculum_type', 'timezone', 'academic_year_start', 'academic_year_end', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'academic_year_start' => 'date', 'academic_year_end' => 'date', ]; /** * Get the users associated with the school. */ public function users(): HasMany { return $this->hasMany(User::class); } /** * Get the classrooms associated with the school. */ public function classrooms(): HasMany { return $this->hasMany(Classroom::class); } /** * Get the courses associated with the school. */ public function courses(): HasMany { return $this->hasMany(Course::class); } /** * Get the departments associated with the school. */ public function departments(): HasMany { return $this->hasMany(Department::class); } /** * Get the academic terms associated with the school. */ public function academicTerms(): HasMany { return $this->hasMany(AcademicTerm::class); } /** * Get the report card templates associated with the school. */ public function reportCardTemplates(): HasMany { return $this->hasMany(ReportCardTemplate::class); } /** * Get the curriculum standards associated with the school. */ public function curriculumStandards(): HasMany { return $this->hasMany(CurriculumStandard::class); } /** * Get the badges associated with the school. */ public function badges(): HasMany { return $this->hasMany(Badge::class); } /** * Get the current academic term. */ public function currentAcademicTerm() { return $this->academicTerms() ->where('start_date', '<=', now()) ->where('end_date', '>=', now()) ->first(); } } */ protected $fillable = [ 'name', 'description', 'course_id', 'school_id', 'academic_term_id', 'room_number', 'capacity', 'start_time', 'end_time', 'days_of_week', 'is_active', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'start_time' => 'datetime', 'end_time' => 'datetime', 'days_of_week' => 'array', 'is_active' => 'boolean', ]; /** * Get the school that the classroom belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the course that the classroom belongs to. */ public function course(): BelongsTo { return $this->belongsTo(Course::class); } /** * Get the academic term that the classroom belongs to. */ public function academicTerm(): BelongsTo { return $this->belongsTo(AcademicTerm::class); } /** * Get the users (teachers and students) associated with the classroom. */ public function users(): BelongsToMany { return $this->belongsToMany(User::class, 'classroom_user') ->withPivot('role') ->withTimestamps(); } /** * Get the teachers associated with the classroom. */ public function teachers(): BelongsToMany { return $this->belongsToMany(User::class, 'classroom_user') ->wherePivot('role', 'teacher') ->withTimestamps(); } /** * Get the students enrolled in the classroom. */ public function students(): BelongsToMany { return $this->belongsToMany(User::class, 'classroom_user') ->wherePivot('role', 'student') ->withTimestamps(); } /** * Get the lessons associated with the classroom. */ public function lessons(): HasMany { return $this->hasMany(Lesson::class); } /** * Get the assignments associated with the classroom. */ public function assignments(): HasMany { return $this->hasMany(Assignment::class); } /** * Get the attendance records for the classroom. */ public function attendanceRecords(): HasMany { return $this->hasMany(Attendance::class); } /** * Get the announcements for the classroom. */ public function announcements(): HasMany { return $this->hasMany(Announcement::class); } /** * Get the assessments associated with the classroom. */ public function assessments(): HasMany { return $this->hasMany(Assessment::class); } } */ protected $fillable = [ 'name', 'code', 'description', 'department_id', 'school_id', 'grade_level', 'credits', 'is_active', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'credits' => 'float', 'is_active' => 'boolean', ]; /** * Get the school that the course belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the department that the course belongs to. */ public function department(): BelongsTo { return $this->belongsTo(Department::class); } /** * Get the classrooms associated with the course. */ public function classrooms(): HasMany { return $this->hasMany(Classroom::class); } /** * Get the curriculum standards associated with the course. */ public function curriculumStandards(): BelongsToMany { return $this->belongsToMany(CurriculumStandard::class, 'course_curriculum_standard') ->withTimestamps(); } /** * Get the lessons associated with the course. */ public function lessons(): HasMany { return $this->hasMany(Lesson::class); } /** * Get the prerequisites for this course. */ public function prerequisites(): BelongsToMany { return $this->belongsToMany(Course::class, 'course_prerequisites', 'course_id', 'prerequisite_id') ->withTimestamps(); } /** * Get the courses that have this course as a prerequisite. */ public function followingCourses(): BelongsToMany { return $this->belongsToMany(Course::class, 'course_prerequisites', 'prerequisite_id', 'course_id') ->withTimestamps(); } } */ protected $fillable = [ 'name', 'description', 'school_id', 'head_user_id', ]; /** * Get the school that the department belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the user who is the head of the department. */ public function head(): BelongsTo { return $this->belongsTo(User::class, 'head_user_id'); } /** * Get the courses associated with the department. */ public function courses(): HasMany { return $this->hasMany(Course::class); } } */ protected $fillable = [ 'name', 'start_date', 'end_date', 'school_id', 'is_current', 'term_type', // semester, quarter, trimester, etc. ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'start_date' => 'date', 'end_date' => 'date', 'is_current' => 'boolean', ]; /** * Get the school that the academic term belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the classrooms associated with the academic term. */ public function classrooms(): HasMany { return $this->hasMany(Classroom::class); } /** * Get the report cards associated with the academic term. */ public function reportCards(): HasMany { return $this->hasMany(ReportCard::class); } /** * Check if the academic term is active. */ public function isActive(): bool { $now = now(); return $now->between($this->start_date, $this->end_date); } } */ protected $fillable = [ 'title', 'description', 'content', 'classroom_id', 'course_id', 'created_by', 'scheduled_date', 'duration_minutes', 'learning_objectives', 'materials', 'ai_generated', 'status', // draft, published, archived ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'scheduled_date' => 'datetime', 'learning_objectives' => 'array', 'materials' => 'array', 'ai_generated' => 'boolean', ]; /** * Get the classroom that the lesson belongs to. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the course that the lesson belongs to. */ public function course(): BelongsTo { return $this->belongsTo(Course::class); } /** * Get the user who created the lesson. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the assignments associated with the lesson. */ public function assignments(): HasMany { return $this->hasMany(Assignment::class); } /** * Get the resources associated with the lesson. */ public function resources(): HasMany { return $this->hasMany(Resource::class); } /** * Get the curriculum standards associated with the lesson. */ public function curriculumStandards(): BelongsToMany { return $this->belongsToMany(CurriculumStandard::class, 'lesson_curriculum_standard') ->withTimestamps(); } /** * Get the activities associated with the lesson. */ public function activities(): HasMany { return $this->hasMany(Activity::class); } /** * Get the assessments associated with the lesson. */ public function assessments(): HasMany { return $this->hasMany(Assessment::class); } } */ protected $fillable = [ 'title', 'description', 'instructions', 'classroom_id', 'lesson_id', 'created_by', 'due_date', 'points_possible', 'submission_type', // file, text, link, etc. 'status', // draft, published, archived 'ai_generated', 'allow_late_submissions', 'late_submission_deadline', 'rubric_id', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'due_date' => 'datetime', 'late_submission_deadline' => 'datetime', 'points_possible' => 'integer', 'ai_generated' => 'boolean', 'allow_late_submissions' => 'boolean', ]; /** * Get the classroom that the assignment belongs to. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the lesson that the assignment belongs to. */ public function lesson(): BelongsTo { return $this->belongsTo(Lesson::class); } /** * Get the user who created the assignment. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the rubric associated with the assignment. */ public function rubric(): BelongsTo { return $this->belongsTo(Rubric::class); } /** * Get the submissions for the assignment. */ public function submissions(): HasMany { return $this->hasMany(Submission::class); } /** * Get the resources associated with the assignment. */ public function resources(): HasMany { return $this->hasMany(Resource::class); } /** * Check if the assignment is overdue. */ public function isOverdue(): bool { if ($this->allow_late_submissions && $this->late_submission_deadline) { return now()->isAfter($this->late_submission_deadline); } return now()->isAfter($this->due_date); } /** * Check if late submissions are currently allowed. */ public function isLateSubmissionAllowed(): bool { if (!$this->allow_late_submissions) { return false; } return now()->isBefore($this->late_submission_deadline); } } */ protected $fillable = [ 'assignment_id', 'user_id', 'content', 'file_path', 'submitted_at', 'is_late', 'status', // submitted, graded, returned 'ai_feedback', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'submitted_at' => 'datetime', 'is_late' => 'boolean', 'ai_feedback' => 'array', ]; /** * Get the assignment that the submission belongs to. */ public function assignment(): BelongsTo { return $this->belongsTo(Assignment::class); } /** * Get the user who made the submission. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the grade for the submission. */ public function grade() { return $this->hasOne(Grade::class); } /** * Get the feedback comments for the submission. */ public function feedbackComments(): HasMany { return $this->hasMany(FeedbackComment::class); } /** * Check if the submission is graded. */ public function isGraded(): bool { return $this->status === 'graded' || $this->grade()->exists(); } /** * Check if the submission was submitted late. */ public function wasSubmittedLate(): bool { return $this->is_late || ($this->submitted_at && $this->submitted_at->isAfter($this->assignment->due_date)); } } */ protected $fillable = [ 'submission_id', 'user_id', 'assignment_id', 'points_earned', 'graded_by', 'graded_at', 'feedback', 'rubric_scores', 'ai_graded', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'points_earned' => 'float', 'graded_at' => 'datetime', 'rubric_scores' => 'array', 'ai_graded' => 'boolean', ]; /** * Get the submission that the grade belongs to. */ public function submission(): BelongsTo { return $this->belongsTo(Submission::class); } /** * Get the user who received the grade. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the assignment that the grade belongs to. */ public function assignment(): BelongsTo { return $this->belongsTo(Assignment::class); } /** * Get the user who graded the submission. */ public function grader(): BelongsTo { return $this->belongsTo(User::class, 'graded_by'); } /** * Calculate the percentage score. */ public function getPercentageAttribute(): float { if (!$this->assignment || $this->assignment->points_possible == 0) { return 0; } return ($this->points_earned / $this->assignment->points_possible) * 100; } /** * Get the letter grade based on the percentage. */ public function getLetterGradeAttribute(): string { $percentage = $this->getPercentageAttribute(); if ($percentage >= 90) { return 'A'; } elseif ($percentage >= 80) { return 'B'; } elseif ($percentage >= 70) { return 'C'; } elseif ($percentage >= 60) { return 'D'; } else { return 'F'; } } } */ protected $fillable = [ 'user_id', 'classroom_id', 'date', 'status', // present, absent, late, excused 'marked_by', 'notes', 'auto_marked', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'date' => 'date', 'auto_marked' => 'boolean', ]; /** * Get the user that the attendance record belongs to. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the classroom that the attendance record belongs to. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the user who marked the attendance. */ public function marker(): BelongsTo { return $this->belongsTo(User::class, 'marked_by'); } /** * Check if the attendance status is present. */ public function isPresent(): bool { return $this->status === 'present'; } /** * Check if the attendance status is absent. */ public function isAbsent(): bool { return $this->status === 'absent'; } /** * Check if the attendance status is late. */ public function isLate(): bool { return $this->status === 'late'; } /** * Check if the attendance status is excused. */ public function isExcused(): bool { return $this->status === 'excused'; } } */ protected $fillable = [ 'title', 'description', 'classroom_id', 'lesson_id', 'created_by', 'assessment_type', // quiz, test, exam, formative, summative 'start_date', 'end_date', 'duration_minutes', 'points_possible', 'is_adaptive', 'ai_generated', 'status', // draft, published, archived 'instructions', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'start_date' => 'datetime', 'end_date' => 'datetime', 'duration_minutes' => 'integer', 'points_possible' => 'integer', 'is_adaptive' => 'boolean', 'ai_generated' => 'boolean', ]; /** * Get the classroom that the assessment belongs to. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the lesson that the assessment belongs to. */ public function lesson(): BelongsTo { return $this->belongsTo(Lesson::class); } /** * Get the user who created the assessment. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the questions for the assessment. */ public function questions(): HasMany { return $this->hasMany(Question::class); } /** * Get the student responses for the assessment. */ public function studentResponses(): HasMany { return $this->hasMany(StudentResponse::class); } /** * Check if the assessment is currently active. */ public function isActive(): bool { $now = now(); return $now->between($this->start_date, $this->end_date) && $this->status === 'published'; } /** * Check if the assessment is completed by a specific user. */ public function isCompletedByUser(User $user): bool { return $this->studentResponses() ->where('user_id', $user->id) ->where('status', 'completed') ->exists(); } } */ protected $fillable = [ 'assessment_id', 'question_text', 'question_type', // multiple_choice, true_false, short_answer, essay, matching 'options', 'correct_answer', 'points', 'difficulty_level', // 1-5 scale 'ai_generated', 'explanation', 'curriculum_standard_id', 'parent_question_id', // For adaptive follow-up questions 'display_order', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'options' => 'array', 'correct_answer' => 'array', 'points' => 'integer', 'difficulty_level' => 'integer', 'ai_generated' => 'boolean', 'display_order' => 'integer', ]; /** * Get the assessment that the question belongs to. */ public function assessment(): BelongsTo { return $this->belongsTo(Assessment::class); } /** * Get the curriculum standard associated with the question. */ public function curriculumStandard(): BelongsTo { return $this->belongsTo(CurriculumStandard::class); } /** * Get the parent question (for adaptive follow-up questions). */ public function parentQuestion(): BelongsTo { return $this->belongsTo(Question::class, 'parent_question_id'); } /** * Get the follow-up questions (for adaptive assessments). */ public function followUpQuestions(): HasMany { return $this->hasMany(Question::class, 'parent_question_id'); } /** * Get the student responses for the question. */ public function studentResponses(): HasMany { return $this->hasMany(StudentResponse::class); } /** * Check if the question is a multiple choice question. */ public function isMultipleChoice(): bool { return $this->question_type === 'multiple_choice'; } /** * Check if the question is a true/false question. */ public function isTrueFalse(): bool { return $this->question_type === 'true_false'; } /** * Check if the question is a short answer question. */ public function isShortAnswer(): bool { return $this->question_type === 'short_answer'; } /** * Check if the question is an essay question. */ public function isEssay(): bool { return $this->question_type === 'essay'; } /** * Check if the question is a matching question. */ public function isMatching(): bool { return $this->question_type === 'matching'; } } */ protected $fillable = [ 'assessment_id', 'question_id', 'user_id', 'response', 'is_correct', 'points_earned', 'feedback', 'ai_feedback', 'submitted_at', 'time_spent_seconds', 'status', // in_progress, completed ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'response' => 'array', 'is_correct' => 'boolean', 'points_earned' => 'float', 'ai_feedback' => 'array', 'submitted_at' => 'datetime', 'time_spent_seconds' => 'integer', ]; /** * Get the assessment that the response belongs to. */ public function assessment(): BelongsTo { return $this->belongsTo(Assessment::class); } /** * Get the question that the response belongs to. */ public function question(): BelongsTo { return $this->belongsTo(Question::class); } /** * Get the user who submitted the response. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Calculate the percentage score. */ public function getPercentageAttribute(): float { if (!$this->question || $this->question->points == 0) { return 0; } return ($this->points_earned / $this->question->points) * 100; } } */ protected $fillable = [ 'code', 'description', 'subject_area', 'grade_level', 'parent_id', 'school_id', 'curriculum_type', // IB, National, Custom, etc. ]; /** * Get the school that the curriculum standard belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the parent curriculum standard. */ public function parent(): BelongsTo { return $this->belongsTo(CurriculumStandard::class, 'parent_id'); } /** * Get the child curriculum standards. */ public function children(): HasMany { return $this->hasMany(CurriculumStandard::class, 'parent_id'); } /** * Get the courses associated with the curriculum standard. */ public function courses(): BelongsToMany { return $this->belongsToMany(Course::class, 'course_curriculum_standard') ->withTimestamps(); } /** * Get the lessons associated with the curriculum standard. */ public function lessons(): BelongsToMany { return $this->belongsToMany(Lesson::class, 'lesson_curriculum_standard') ->withTimestamps(); } /** * Get the questions associated with the curriculum standard. */ public function questions(): HasMany { return $this->hasMany(Question::class); } } */ protected $fillable = [ 'user_id', 'academic_term_id', 'template_id', 'generated_by', 'generated_at', 'comments', 'teacher_comments', 'principal_comments', 'parent_signature', 'teacher_signature', 'principal_signature', 'status', // draft, published, archived 'ai_generated', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'generated_at' => 'datetime', 'parent_signature' => 'datetime', 'teacher_signature' => 'datetime', 'principal_signature' => 'datetime', 'ai_generated' => 'boolean', ]; /** * Get the user that the report card belongs to. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the academic term that the report card belongs to. */ public function academicTerm(): BelongsTo { return $this->belongsTo(AcademicTerm::class); } /** * Get the template that the report card uses. */ public function template(): BelongsTo { return $this->belongsTo(ReportCardTemplate::class, 'template_id'); } /** * Get the user who generated the report card. */ public function generator(): BelongsTo { return $this->belongsTo(User::class, 'generated_by'); } /** * Get the report card entries. */ public function entries(): HasMany { return $this->hasMany(ReportCardEntry::class); } /** * Check if the report card is published. */ public function isPublished(): bool { return $this->status === 'published'; } /** * Check if the report card is signed by all parties. */ public function isFullySigned(): bool { return $this->parent_signature && $this->teacher_signature && $this->principal_signature; } } */ protected $fillable = [ 'name', 'description', 'school_id', 'created_by', 'structure', 'grade_levels', 'is_default', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'structure' => 'array', 'grade_levels' => 'array', 'is_default' => 'boolean', ]; /** * Get the school that the report card template belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the user who created the report card template. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the report cards that use this template. */ public function reportCards(): HasMany { return $this->hasMany(ReportCard::class, 'template_id'); } } */ protected $fillable = [ 'report_card_id', 'course_id', 'classroom_id', 'grade', 'letter_grade', 'comments', 'teacher_id', 'attendance_data', 'skills_assessment', 'effort_grade', 'behavior_grade', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'grade' => 'float', 'attendance_data' => 'array', 'skills_assessment' => 'array', ]; /** * Get the report card that the entry belongs to. */ public function reportCard(): BelongsTo { return $this->belongsTo(ReportCard::class); } /** * Get the course that the entry is for. */ public function course(): BelongsTo { return $this->belongsTo(Course::class); } /** * Get the classroom that the entry is for. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the teacher who provided the entry. */ public function teacher(): BelongsTo { return $this->belongsTo(User::class, 'teacher_id'); } } */ protected $fillable = [ 'user_id', 'student_id_number', 'date_of_birth', 'grade_level', 'parent_guardian_name', 'parent_guardian_email', 'parent_guardian_phone', 'emergency_contact_name', 'emergency_contact_phone', 'special_needs', 'medical_conditions', 'learning_accommodations', 'preferred_learning_style', 'interests', 'strengths', 'areas_for_improvement', 'ai_learning_profile', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'date_of_birth' => 'date', 'special_needs' => 'array', 'medical_conditions' => 'array', 'learning_accommodations' => 'array', 'interests' => 'array', 'strengths' => 'array', 'areas_for_improvement' => 'array', 'ai_learning_profile' => 'array', ]; /** * Get the user that the student profile belongs to. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the age of the student. */ public function getAgeAttribute(): int { if (!$this->date_of_birth) { return 0; } return $this->date_of_birth->age; } /** * Check if the student has special needs. */ public function hasSpecialNeeds(): bool { return !empty($this->special_needs); } /** * Check if the student has learning accommodations. */ public function hasLearningAccommodations(): bool { return !empty($this->learning_accommodations); } } */ protected $fillable = [ 'user_id', 'title', 'description', 'type', // file, video, audio, reflection, goal, achievement 'file_path', 'content', 'date', 'classroom_id', 'course_id', 'assignment_id', 'submission_id', 'is_featured', 'reflection', 'teacher_feedback', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'date' => 'date', 'is_featured' => 'boolean', ]; /** * Get the user that the portfolio item belongs to. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the classroom associated with the portfolio item. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the course associated with the portfolio item. */ public function course(): BelongsTo { return $this->belongsTo(Course::class); } /** * Get the assignment associated with the portfolio item. */ public function assignment(): BelongsTo { return $this->belongsTo(Assignment::class); } /** * Get the submission associated with the portfolio item. */ public function submission(): BelongsTo { return $this->belongsTo(Submission::class); } /** * Get all of the portfolio item's comments. */ public function comments(): MorphMany { return $this->morphMany(Comment::class, 'commentable'); } /** * Check if the portfolio item is a file. */ public function isFile(): bool { return $this->type === 'file'; } /** * Check if the portfolio item is a video. */ public function isVideo(): bool { return $this->type === 'video'; } /** * Check if the portfolio item is an audio recording. */ public function isAudio(): bool { return $this->type === 'audio'; } /** * Check if the portfolio item is a reflection. */ public function isReflection(): bool { return $this->type === 'reflection'; } /** * Check if the portfolio item is a goal. */ public function isGoal(): bool { return $this->type === 'goal'; } /** * Check if the portfolio item is an achievement. */ public function isAchievement(): bool { return $this->type === 'achievement'; } } */ protected $fillable = [ 'sender_id', 'recipient_id', 'subject', 'content', 'read_at', 'is_starred', 'parent_id', 'attachments', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'read_at' => 'datetime', 'is_starred' => 'boolean', 'attachments' => 'array', ]; /** * Get the sender of the message. */ public function sender(): BelongsTo { return $this->belongsTo(User::class, 'sender_id'); } /** * Get the recipient of the message. */ public function recipient(): BelongsTo { return $this->belongsTo(User::class, 'recipient_id'); } /** * Get the parent message. */ public function parent(): BelongsTo { return $this->belongsTo(Message::class, 'parent_id'); } /** * Get the replies to this message. */ public function replies() { return $this->hasMany(Message::class, 'parent_id'); } /** * Check if the message is read. */ public function isRead(): bool { return $this->read_at !== null; } /** * Check if the message is unread. */ public function isUnread(): bool { return $this->read_at === null; } /** * Mark the message as read. */ public function markAsRead() { if ($this->read_at === null) { $this->update(['read_at' => now()]); } } /** * Mark the message as unread. */ public function markAsUnread() { $this->update(['read_at' => null]); } /** * Toggle the starred status of the message. */ public function toggleStar() { $this->update(['is_starred' => !$this->is_starred]); } } */ protected $fillable = [ 'title', 'content', 'type', // system, assignment, grade, attendance, message, etc. 'icon', 'action_url', 'school_id', 'created_by', 'expires_at', 'priority', // low, medium, high ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'expires_at' => 'datetime', ]; /** * Get the school that the notification belongs to. */ public function school() { return $this->belongsTo(School::class); } /** * Get the user who created the notification. */ public function creator() { return $this->belongsTo(User::class, 'created_by'); } /** * Get the user notifications associated with this notification. */ public function userNotifications(): HasMany { return $this->hasMany(UserNotification::class); } /** * Check if the notification is expired. */ public function isExpired(): bool { if (!$this->expires_at) { return false; } return now()->isAfter($this->expires_at); } /** * Check if the notification is high priority. */ public function isHighPriority(): bool { return $this->priority === 'high'; } } */ protected $fillable = [ 'user_id', 'notification_id', 'read_at', 'is_dismissed', 'delivery_status', // pending, sent, failed 'delivery_channels', // in_app, email, sms ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'read_at' => 'datetime', 'is_dismissed' => 'boolean', 'delivery_channels' => 'array', ]; /** * Get the user that the notification is for. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the notification. */ public function notification(): BelongsTo { return $this->belongsTo(Notification::class); } /** * Check if the notification is read. */ public function isRead(): bool { return $this->read_at !== null; } /** * Check if the notification is unread. */ public function isUnread(): bool { return $this->read_at === null; } /** * Mark the notification as read. */ public function markAsRead() { if ($this->read_at === null) { $this->update(['read_at' => now()]); } } /** * Mark the notification as unread. */ public function markAsUnread() { $this->update(['read_at' => null]); } /** * Dismiss the notification. */ public function dismiss() { $this->update(['is_dismissed' => true]); } } */ protected $fillable = [ 'name', 'description', 'icon', 'points', 'criteria', 'school_id', 'created_by', 'is_active', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'points' => 'integer', 'criteria' => 'array', 'is_active' => 'boolean', ]; /** * Get the school that the badge belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the user who created the badge. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the users who have earned the badge. */ public function users(): BelongsToMany { return $this->belongsToMany(User::class, 'user_badges') ->withPivot('awarded_at', 'awarded_by') ->withTimestamps(); } } */ protected $fillable = [ 'title', 'description', 'file_path', 'file_type', 'url', 'resourceable_id', 'resourceable_type', 'created_by', 'is_public', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'is_public' => 'boolean', ]; /** * Get the parent resourceable model. */ public function resourceable(): MorphTo { return $this->morphTo(); } /** * Get the user who created the resource. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Check if the resource is a file. */ public function isFile(): bool { return !empty($this->file_path); } /** * Check if the resource is a URL. */ public function isUrl(): bool { return !empty($this->url); } /** * Get the file extension. */ public function getExtensionAttribute(): string { if (!$this->file_path) { return ''; } return pathinfo($this->file_path, PATHINFO_EXTENSION); } /** * Check if the resource is an image. */ public function isImage(): bool { return in_array($this->file_type, ['image/jpeg', 'image/png', 'image/gif', 'image/svg+xml']); } /** * Check if the resource is a document. */ public function isDocument(): bool { return in_array($this->file_type, [ 'application/pdf', 'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/vnd.ms-excel', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'application/vnd.ms-powerpoint', 'application/vnd.openxmlformats-officedocument.presentationml.presentation', ]); } /** * Check if the resource is a video. */ public function isVideo(): bool { return in_array($this->file_type, [ 'video/mp4', 'video/quicktime', 'video/x-msvideo', 'video/x-flv', 'video/webm', ]); } /** * Check if the resource is an audio file. */ public function isAudio(): bool { return in_array($this->file_type, [ 'audio/mpeg', 'audio/wav', 'audio/ogg', 'audio/mp3', 'audio/webm', ]); } } */ protected $fillable = [ 'title', 'description', 'instructions', 'lesson_id', 'duration_minutes', 'activity_type', // individual, group, whole_class, etc. 'learning_style', // visual, auditory, kinesthetic, etc. 'difficulty_level', // 1-5 scale 'materials', 'ai_generated', 'differentiation_notes', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'duration_minutes' => 'integer', 'difficulty_level' => 'integer', 'materials' => 'array', 'ai_generated' => 'boolean', ]; /** * Get the lesson that the activity belongs to. */ public function lesson(): BelongsTo { return $this->belongsTo(Lesson::class); } /** * Check if the activity is suitable for a specific learning style. */ public function isSuitableForLearningStyle(string $style): bool { return $this->learning_style === $style || $this->learning_style === 'all'; } /** * Check if the activity is AI-generated. */ public function isAiGenerated(): bool { return $this->ai_generated; } /** * Check if the activity is for individual work. */ public function isIndividualActivity(): bool { return $this->activity_type === 'individual'; } /** * Check if the activity is for group work. */ public function isGroupActivity(): bool { return $this->activity_type === 'group'; } /** * Check if the activity is for the whole class. */ public function isWholeClassActivity(): bool { return $this->activity_type === 'whole_class'; } } */ protected $fillable = [ 'title', 'description', 'created_by', 'school_id', 'criteria', 'levels', 'is_template', 'ai_generated', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'criteria' => 'array', 'levels' => 'array', 'is_template' => 'boolean', 'ai_generated' => 'boolean', ]; /** * Get the user who created the rubric. */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * Get the school that the rubric belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Get the assignments that use this rubric. */ public function assignments(): HasMany { return $this->hasMany(Assignment::class); } /** * Get the maximum possible score for this rubric. */ public function getMaximumScoreAttribute(): int { if (empty($this->criteria) || empty($this->levels)) { return 0; } $maxLevelScore = max(array_column($this->levels, 'score')); return count($this->criteria) * $maxLevelScore; } } */ protected $fillable = [ 'content', 'user_id', 'commentable_id', 'commentable_type', 'parent_id', ]; /** * Get the parent commentable model. */ public function commentable(): MorphTo { return $this->morphTo(); } /** * Get the user who made the comment. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the parent comment. */ public function parent(): BelongsTo { return $this->belongsTo(Comment::class, 'parent_id'); } /** * Get the replies to this comment. */ public function replies() { return $this->hasMany(Comment::class, 'parent_id'); } /** * Check if the comment is a reply. */ public function isReply(): bool { return $this->parent_id !== null; } } */ protected $fillable = [ 'submission_id', 'user_id', 'content', 'position_x', 'position_y', 'page_number', 'highlight_text', 'ai_generated', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'position_x' => 'float', 'position_y' => 'float', 'page_number' => 'integer', 'ai_generated' => 'boolean', ]; /** * Get the submission that the feedback comment belongs to. */ public function submission(): BelongsTo { return $this->belongsTo(Submission::class); } /** * Get the user who made the feedback comment. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Check if the feedback comment is AI-generated. */ public function isAiGenerated(): bool { return $this->ai_generated; } } */ protected $fillable = [ 'title', 'content', 'user_id', 'classroom_id', 'school_id', 'start_date', 'end_date', 'is_pinned', 'is_important', ]; /** * The attributes that should be cast. * * @var array */ protected $casts = [ 'start_date' => 'datetime', 'end_date' => 'datetime', 'is_pinned' => 'boolean', 'is_important' => 'boolean', ]; /** * Get the user who created the announcement. */ public function user(): BelongsTo { return $this->belongsTo(User::class); } /** * Get the classroom that the announcement belongs to. */ public function classroom(): BelongsTo { return $this->belongsTo(Classroom::class); } /** * Get the school that the announcement belongs to. */ public function school(): BelongsTo { return $this->belongsTo(School::class); } /** * Check if the announcement is active. */ public function isActive(): bool { $now = now(); if ($this->start_date && $this->end_date) { return $now->between($this->start_date, $this->end_date); } if ($this->start_date) { return $now->isAfter($this->start_date); } if ($this->end_date) { return $now->isBefore($this->end_date); } return true; } } apiKey = config('ai.api_key'); $this->baseUrl = config('ai.base_url'); $this->model = config('ai.model'); } /** * Generate a lesson plan based on curriculum standards and student profiles. * * @param string $subject * @param string $gradeLevel * @param string $topic * @param array $curriculumStandards * @param array $studentProfiles * @return array|null */ public function generateLessonPlan(string $subject, string $gradeLevel, string $topic, array $curriculumStandards, array $studentProfiles = []): ?array { $prompt = $this->buildLessonPlanPrompt($subject, $gradeLevel, $topic, $curriculumStandards, $studentPro