Round 13: PWA Offline Mode, Rate Limiting, Behavior Analytics, Interventions, Audit Logging

src/app/api/report-schedules/[id]/route.ts

@@ -0,0 +1,158 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { db } from '@/lib/db';
+
+// GET /api/report-schedules/[id]
+export async function GET(
+  _req: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  try {
+    const { id } = await params;
+    const schedule = await db.reportSchedule.findFirst({
+      where: { id, deletedAt: null },
+      include: {
+        classGroup: { select: { id: true, name: true, gradeLevel: true } },
+        school: { select: { id: true, name: true } },
+      },
+    });
+    if (!schedule) {
+      return NextResponse.json({ error: 'Schedule not found' }, { status: 404 });
+    }
+    return NextResponse.json(schedule);
+  } catch (error) {
+    console.error('[report-schedules/[id]] GET error:', error);
+    return NextResponse.json({ error: 'Failed to fetch schedule' }, { status: 500 });
+  }
+}
+
+// PUT /api/report-schedules/[id]
+export async function PUT(
+  req: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  try {
+    const { id } = await params;
+    const body = await req.json();
+    const {
+      classGroupId,
+      template,
+      frequency,
+      dayOfWeek,
+      dayOfMonth,
+      monthOfYear,
+      recipients,
+      includeStudents,
+      includeGrades,
+      includeAttendance,
+      includeBehavior,
+      includeCompetencies,
+      isActive,
+    } = body;
+
+    const data: Record<string, unknown> = {};
+    if (classGroupId !== undefined) data.classGroupId = classGroupId || null;
+    if (template !== undefined) data.template = template;
+    if (frequency !== undefined) data.frequency = frequency;
+    if (dayOfWeek !== undefined) data.dayOfWeek = dayOfWeek;
+    if (dayOfMonth !== undefined) data.dayOfMonth = dayOfMonth;
+    if (monthOfYear !== undefined) data.monthOfYear = monthOfYear;
+    if (recipients !== undefined) data.recipients = recipients ? JSON.stringify(recipients) : null;
+    if (includeStudents !== undefined) data.includeStudents = includeStudents;
+    if (includeGrades !== undefined) data.includeGrades = includeGrades;
+    if (includeAttendance !== undefined) data.includeAttendance = includeAttendance;
+    if (includeBehavior !== undefined) data.includeBehavior = includeBehavior;
+    if (includeCompetencies !== undefined) data.includeCompetencies = includeCompetencies;
+    if (isActive !== undefined) data.isActive = isActive;
+
+    // Recalculate nextRunAt if frequency or timing changed
+    if (frequency || dayOfWeek !== undefined || dayOfMonth !== undefined || monthOfYear !== undefined) {
+      const current = await db.reportSchedule.findUnique({ where: { id } });
+      if (current) {
+        const freq = frequency || current.frequency;
+        const dow = dayOfWeek !== undefined ? dayOfWeek : current.dayOfWeek;
+        const dom = dayOfMonth !== undefined ? dayOfMonth : current.dayOfMonth;
+        const moy = monthOfYear !== undefined ? monthOfYear : current.monthOfYear;
+        data.nextRunAt = calculateNextRun(freq, dow, dom, moy);
+      }
+    }
+
+    const schedule = await db.reportSchedule.update({
+      where: { id },
+      data,
+      include: {
+        classGroup: { select: { id: true, name: true, gradeLevel: true } },
+      },
+    });
+
+    return NextResponse.json(schedule);
+  } catch (error) {
+    console.error('[report-schedules/[id]] PUT error:', error);
+    return NextResponse.json({ error: 'Failed to update schedule' }, { status: 500 });
+  }
+}
+
+// DELETE /api/report-schedules/[id]
+export async function DELETE(
+  _req: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  try {
+    const { id } = await params;
+    await db.reportSchedule.update({
+      where: { id },
+      data: { deletedAt: new Date() },
+    });
+    return NextResponse.json({ success: true });
+  } catch (error) {
+    console.error('[report-schedules/[id]] DELETE error:', error);
+    return NextResponse.json({ error: 'Failed to delete schedule' }, { status: 500 });
+  }
+}
+
+function calculateNextRun(
+  frequency: string,
+  dayOfWeek?: number | null,
+  dayOfMonth?: number | null,
+  monthOfYear?: number | null,
+): Date {
+  const now = new Date();
+  const next = new Date(now);
+
+  switch (frequency) {
+    case 'weekly': {
+      const targetDay = dayOfWeek ?? 1;
+      const currentDay = next.getDay();
+      const daysUntil = ((targetDay - currentDay + 7) % 7) || 7;
+      next.setDate(next.getDate() + daysUntil);
+      next.setHours(8, 0, 0, 0);
+      break;
+    }
+    case 'monthly': {
+      const targetDate = dayOfMonth ?? 1;
+      next.setDate(targetDate);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setMonth(next.getMonth() + 1);
+      break;
+    }
+    case 'quarterly': {
+      const targetMonth = monthOfYear ?? 1;
+      next.setMonth(targetMonth - 1);
+      next.setDate(1);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setMonth(next.getMonth() + 3);
+      break;
+    }
+    case 'end_of_term': {
+      next.setMonth(6);
+      next.setDate(15);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setFullYear(next.getFullYear() + 1);
+      break;
+    }
+    default: {
+      next.setDate(next.getDate() + 7);
+      next.setHours(8, 0, 0, 0);
+    }
+  }
+  return next;
+}

src/app/api/report-schedules/[id]/run/route.ts

@@ -0,0 +1,120 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { db } from '@/lib/db';
+
+// POST /api/report-schedules/[id]/run — trigger manual run
+export async function POST(
+  _req: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  try {
+    const { id } = await params;
+    const schedule = await db.reportSchedule.findFirst({
+      where: { id, deletedAt: null },
+      include: {
+        classGroup: { select: { id: true, name: true, gradeLevel: true } },
+        school: { select: { id: true, name: true } },
+      },
+    });
+
+    if (!schedule) {
+      return NextResponse.json({ error: 'Schedule not found' }, { status: 404 });
+    }
+
+    // Mark as run and calculate next run
+    const now = new Date();
+    const nextRunAt = calculateNextRun(
+      schedule.frequency,
+      schedule.dayOfWeek,
+      schedule.dayOfMonth,
+      schedule.monthOfYear,
+    );
+
+    await db.reportSchedule.update({
+      where: { id },
+      data: { lastRunAt: now, nextRunAt },
+    });
+
+    // In a real system, this would trigger the actual report generation pipeline
+    // and send notifications to recipients. For now, we simulate success.
+    const recipientIds: string[] = schedule.recipients
+      ? JSON.parse(schedule.recipients)
+      : [];
+
+    // Create notifications for recipients
+    if (recipientIds.length > 0) {
+      try {
+        await db.notification.createMany({
+          data: recipientIds.map((userId) => ({
+            schoolId: schedule.schoolId,
+            userId,
+            type: 'report_ready',
+            title: `Scheduled Report Generated`,
+            message: `Report schedule "${schedule.template}" for ${schedule.classGroup?.name ?? 'all classes'} has been generated.`,
+            actionUrl: '/reports',
+            relatedId: schedule.id,
+          })),
+        });
+      } catch {
+        // Notification creation is non-critical
+      }
+    }
+
+    return NextResponse.json({
+      success: true,
+      lastRunAt: now,
+      nextRunAt,
+      recipientsNotified: recipientIds.length,
+    });
+  } catch (error) {
+    console.error('[report-schedules/[id]/run] POST error:', error);
+    return NextResponse.json({ error: 'Failed to run schedule' }, { status: 500 });
+  }
+}
+
+function calculateNextRun(
+  frequency: string,
+  dayOfWeek?: number | null,
+  dayOfMonth?: number | null,
+  monthOfYear?: number | null,
+): Date {
+  const now = new Date();
+  const next = new Date(now);
+
+  switch (frequency) {
+    case 'weekly': {
+      const targetDay = dayOfWeek ?? 1;
+      const currentDay = next.getDay();
+      const daysUntil = ((targetDay - currentDay + 7) % 7) || 7;
+      next.setDate(next.getDate() + daysUntil);
+      next.setHours(8, 0, 0, 0);
+      break;
+    }
+    case 'monthly': {
+      const targetDate = dayOfMonth ?? 1;
+      next.setDate(targetDate);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setMonth(next.getMonth() + 1);
+      break;
+    }
+    case 'quarterly': {
+      const targetMonth = monthOfYear ?? 1;
+      next.setMonth(targetMonth - 1);
+      next.setDate(1);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setMonth(next.getMonth() + 3);
+      break;
+    }
+    case 'end_of_term': {
+      next.setMonth(6);
+      next.setDate(15);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) next.setFullYear(next.getFullYear() + 1);
+      break;
+    }
+    default: {
+      next.setDate(next.getDate() + 7);
+      next.setHours(8, 0, 0, 0);
+    }
+  }
+  return next;
+}

src/app/api/report-schedules/route.ts

@@ -0,0 +1,137 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { db } from '@/lib/db';
+
+// GET /api/report-schedules?schoolId=xxx
+export async function GET(req: NextRequest) {
+  try {
+    const schoolId = req.nextUrl.searchParams.get('schoolId');
+    if (!schoolId) {
+      return NextResponse.json({ error: 'schoolId is required' }, { status: 400 });
+    }
+
+    const schedules = await db.reportSchedule.findMany({
+      where: { schoolId, deletedAt: null },
+      include: {
+        classGroup: { select: { id: true, name: true, gradeLevel: true } },
+      },
+      orderBy: { createdAt: 'desc' },
+    });
+
+    return NextResponse.json(schedules);
+  } catch (error) {
+    console.error('[report-schedules] GET error:', error);
+    return NextResponse.json({ error: 'Failed to fetch report schedules' }, { status: 500 });
+  }
+}
+
+// POST /api/report-schedules
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json();
+    const {
+      schoolId,
+      classGroupId,
+      template,
+      frequency,
+      dayOfWeek,
+      dayOfMonth,
+      monthOfYear,
+      recipients,
+      includeStudents,
+      includeGrades,
+      includeAttendance,
+      includeBehavior,
+      includeCompetencies,
+    } = body;
+
+    if (!schoolId || !template || !frequency) {
+      return NextResponse.json({ error: 'schoolId, template, and frequency are required' }, { status: 400 });
+    }
+
+    // Calculate nextRunAt
+    const nextRunAt = calculateNextRun(frequency, dayOfWeek, dayOfMonth, monthOfYear);
+
+    const schedule = await db.reportSchedule.create({
+      data: {
+        schoolId,
+        classGroupId: classGroupId || null,
+        template,
+        frequency,
+        dayOfWeek: dayOfWeek ?? null,
+        dayOfMonth: dayOfMonth ?? null,
+        monthOfYear: monthOfYear ?? null,
+        recipients: recipients ? JSON.stringify(recipients) : null,
+        includeStudents: includeStudents ?? true,
+        includeGrades: includeGrades ?? true,
+        includeAttendance: includeAttendance ?? true,
+        includeBehavior: includeBehavior ?? false,
+        includeCompetencies: includeCompetencies ?? true,
+        nextRunAt,
+      },
+      include: {
+        classGroup: { select: { id: true, name: true, gradeLevel: true } },
+      },
+    });
+
+    return NextResponse.json(schedule, { status: 201 });
+  } catch (error) {
+    console.error('[report-schedules] POST error:', error);
+    return NextResponse.json({ error: 'Failed to create report schedule' }, { status: 500 });
+  }
+}
+
+function calculateNextRun(
+  frequency: string,
+  dayOfWeek?: number | null,
+  dayOfMonth?: number | null,
+  monthOfYear?: number | null,
+): Date {
+  const now = new Date();
+  const next = new Date(now);
+
+  switch (frequency) {
+    case 'weekly': {
+      const targetDay = dayOfWeek ?? 1; // Monday default
+      const currentDay = next.getDay();
+      const daysUntil = ((targetDay - currentDay + 7) % 7) || 7;
+      next.setDate(next.getDate() + daysUntil);
+      next.setHours(8, 0, 0, 0);
+      break;
+    }
+    case 'monthly': {
+      const targetDate = dayOfMonth ?? 1;
+      next.setDate(targetDate);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) {
+        next.setMonth(next.getMonth() + 1);
+      }
+      break;
+    }
+    case 'quarterly': {
+      const targetMonth = monthOfYear ?? 1;
+      next.setMonth(targetMonth - 1);
+      next.setDate(1);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) {
+        next.setMonth(next.getMonth() + 3);
+      }
+      break;
+    }
+    case 'end_of_term': {
+      // Default: July 15 (end of German school year)
+      next.setMonth(6); // July
+      next.setDate(15);
+      next.setHours(8, 0, 0, 0);
+      if (next <= now) {
+        next.setFullYear(next.getFullYear() + 1);
+      }
+      break;
+    }
+    default: {
+      next.setDate(next.getDate() + 7);
+      next.setHours(8, 0, 0, 0);
+    }
+  }
+
+  return next;
+}