Initial commit: ExaMetra v1.0.0 — Free & open-source competence & grading platform

Features:
- 15+ views: Dashboard, Classes, Progress, Flower, Matrix, Assessments, Grading, Reports, Attendance, Calendar, Lesson Plans, Analytics, Parent Communication, Behavior Tracking, Settings
- 34+ API endpoints
- 30+ Prisma models
- 700+ i18n keys (German + English)
- Keyboard shortcuts (Cmd+K, Cmd+1-9, Cmd+/)
- Batch deletion, drag-and-drop seating, custom color palette
- Demo accounts (admin, teacher, student, parent)
- Dark mode, responsive design, print styles
- CSV/PDF export, notification system, onboarding tour
- Zero emojis — all replaced with Lucide icons
- MIT License
This commit is contained in:
Mustafa Cetin committed 2026-07-29 05:46:10 +00:00
commit 0c1f739989
156 files changed
+51090

No files matched your search

+279
View File
@@ -0,0 +1,279 @@
import { NextResponse } from 'next/server';
import { db } from '@/lib/db';
import { getSession } from '@/lib/auth';
export async function GET(
_request: Request,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const session = await getSession();
if (!session) {
return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
}
const { id: studentId } = await params;
// Load the student with relations
const student = await db.student.findUnique({
where: { id: studentId, deletedAt: null },
select: {
id: true,
firstName: true,
lastName: true,
dateOfBirth: true,
externalId: true,
createdAt: true,
schoolId: true,
school: { select: { id: true, name: true } },
enrollments: {
where: { endDate: null },
include: {
classGroup: {
select: {
id: true,
name: true,
gradeLevel: true,
schoolType: true,
},
},
schoolYear: { select: { id: true, label: true } },
},
orderBy: { startDate: 'desc' },
},
},
});
if (!student) {
return NextResponse.json({ error: 'Student not found' }, { status: 404 });
}
// 1. Progress entries (timeline)
const progressEntries = await db.learningProgressEntry.findMany({
where: { studentId },
orderBy: { date: 'desc' },
take: 100,
include: {
competency: {
select: {
id: true,
code: true,
title: true,
category: { select: { id: true, name: true, color: true } },
},
},
teacher: { select: { id: true, firstName: true, lastName: true } },
classGroup: { select: { id: true, name: true } },
},
});
// 2. Assessment results
const assessmentResults = await db.assessmentResult.findMany({
where: { studentId },
orderBy: { assessment: { date: 'desc' } },
take: 50,
include: {
assessment: {
select: {
id: true,
title: true,
date: true,
type: true,
maxScore: true,
subject: { select: { id: true, name: true } },
},
},
},
});
// 3. Computed grades
const computedGrades = await db.computedGrade.findMany({
where: { studentId },
orderBy: { computedAt: 'desc' },
take: 50,
include: {
subject: { select: { id: true, name: true } },
classGroup: { select: { id: true, name: true } },
schoolYear: { select: { id: true, label: true } },
},
});
// 4. Reports
const reports = await db.report.findMany({
where: { studentId },
orderBy: { generatedAt: 'desc' },
take: 30,
include: {
classGroup: { select: { id: true, name: true } },
schoolYear: { select: { id: true, label: true } },
generatedByUser: { select: { id: true, firstName: true, lastName: true } },
sections: {
orderBy: { order: 'asc' },
select: { id: true, generatedText: true, order: true },
},
},
});
// 5. Competence flowers — for each class+subject assignment, compute categories
const classIds = student.enrollments.map((e) => e.classGroup.id);
const assignments = classIds.length > 0
? await db.classCompetencyAssignment.findMany({
where: { classGroupId: { in: classIds } },
include: {
subject: { select: { id: true, name: true } },
competencyTemplate: {
include: {
categories: {
orderBy: { order: 'asc' },
select: {
id: true,
name: true,
color: true,
competencies: {
orderBy: { order: 'asc' },
select: { id: true },
},
},
},
},
},
},
})
: [];
const flowers: Array<{
studentId: string;
studentName: string;
subjectId: string;
subjectName: string;
categories: Array<{
categoryId: string;
categoryName: string;
color: string | null;
averageMasteryLevel: number;
competencyCount: number;
assessedCompetencyCount: number;
}>;
}> = [];
const studentName = `${student.firstName} ${student.lastName}`;
for (const assignment of assignments) {
const template = assignment.competencyTemplate;
const templateId = assignment.clonedTemplateId ?? assignment.competencyTemplateId;
let categories = template.categories;
// If cloned, load the cloned template's categories
if (assignment.clonedTemplateId) {
const cloned = await db.competencyTemplate.findUnique({
where: { id: assignment.clonedTemplateId },
include: {
categories: {
orderBy: { order: 'asc' },
select: {
id: true,
name: true,
color: true,
competencies: { orderBy: { order: 'asc' }, select: { id: true } },
},
},
},
});
if (cloned) categories = cloned.categories;
}
// Get latest progress entries per competency for this student/class
const entries = await db.learningProgressEntry.findMany({
where: {
studentId,
classGroupId: assignment.classGroupId,
competency: {
category: { competencyTemplateId: templateId },
},
},
orderBy: { date: 'desc' },
select: {
competencyId: true,
masteryLevelValue: true,
},
});
// Latest value per competency (entries sorted by date desc)
const compMap = new Map<string, number>();
for (const entry of entries) {
if (!compMap.has(entry.competencyId)) {
compMap.set(entry.competencyId, entry.masteryLevelValue);
}
}
const categoryResults = categories.map((cat) => {
const catCompetencyIds = cat.competencies.map((c) => c.id);
const assessedValues = catCompetencyIds
.filter((cid) => compMap.has(cid))
.map((cid) => compMap.get(cid)!);
const avg =
assessedValues.length > 0
? assessedValues.reduce((a, b) => a + b, 0) / assessedValues.length
: 0;
return {
categoryId: cat.id,
categoryName: cat.name,
color: cat.color,
averageMasteryLevel: Math.round(avg * 100) / 100,
competencyCount: catCompetencyIds.length,
assessedCompetencyCount: assessedValues.length,
};
});
flowers.push({
studentId: student.id,
studentName,
subjectId: assignment.subject.id,
subjectName: assignment.subject.name,
categories: categoryResults,
});
}
// 6. Quick stats
const totalProgressEntries = progressEntries.length;
const averageMastery =
totalProgressEntries > 0
? Math.round(
(progressEntries.reduce((sum, e) => sum + e.masteryLevelValue, 0) /
totalProgressEntries) *
100
) / 100
: 0;
const latestGrade =
computedGrades.length > 0
? {
value: computedGrades[0].overriddenValue ?? computedGrades[0].computedValue,
period: computedGrades[0].period,
subjectName: computedGrades[0].subject.name,
}
: null;
return NextResponse.json({
student,
progressEntries,
assessmentResults,
computedGrades,
reports,
flowers,
stats: {
totalProgressEntries,
averageMastery,
latestGrade,
totalReports: reports.length,
totalAssessments: assessmentResults.length,
},
});
} catch (error) {
console.error('Student detail GET error:', error);
return NextResponse.json(
{ error: 'Internal server error' },
{ status: 500 }
);
}
}
+155
View File
@@ -0,0 +1,155 @@
import { NextResponse } from 'next/server';
import { z } from 'zod';
import { db } from '@/lib/db';
import { getSession } from '@/lib/auth';
const studentItemSchema = z.object({
firstName: z.string().min(1),
lastName: z.string().min(1),
dateOfBirth: z.string().optional().nullable(),
externalId: z.string().optional().nullable(),
});
const bulkCreateSchema = z.object({
schoolId: z.string().min(1),
classGroupId: z.string().optional(),
schoolYearId: z.string().optional(),
students: z.array(studentItemSchema).min(1).max(500),
});
export async function POST(request: Request) {
try {
const session = await getSession();
if (!session) {
return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
}
if (
session.user?.role !== 'SUPER_ADMIN' &&
session.user?.role !== 'SCHOOL_ADMIN' &&
session.user?.role !== 'TEACHER'
) {
return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
}
const body = await request.json();
const parsed = bulkCreateSchema.safeParse(body);
if (!parsed.success) {
return NextResponse.json(
{ error: 'Validation failed', details: parsed.error.issues },
{ status: 400 }
);
}
const { schoolId, classGroupId, schoolYearId, students } = parsed.data;
// Validate class & school year
if (classGroupId) {
const cls = await db.classGroup.findUnique({ where: { id: classGroupId } });
if (!cls) {
return NextResponse.json(
{ error: 'Class not found' },
{ status: 404 }
);
}
if (cls.schoolId !== schoolId) {
return NextResponse.json(
{ error: 'Class does not belong to the specified school' },
{ status: 400 }
);
}
}
if (classGroupId && !schoolYearId) {
return NextResponse.json(
{ error: 'schoolYearId is required when classGroupId is provided' },
{ status: 400 }
);
}
let created = 0;
let enrolled = 0;
const errors: Array<{ row: number; error: string }> = [];
// Process each student one at a time, capturing errors per row
for (let i = 0; i < students.length; i++) {
const s = students[i];
try {
// Use externalId uniqueness if provided, otherwise just create
let student: Awaited<ReturnType<typeof db.student.findFirst>> = null;
if (s.externalId) {
student = await db.student.findFirst({
where: { externalId: s.externalId, schoolId },
});
}
if (!student) {
student = await db.student.create({
data: {
schoolId,
firstName: s.firstName,
lastName: s.lastName,
dateOfBirth: s.dateOfBirth ? new Date(s.dateOfBirth) : null,
externalId: s.externalId ?? null,
},
});
created++;
}
if (classGroupId && schoolYearId) {
// Check existing enrollment before creating
const existing = await db.enrollment.findFirst({
where: {
studentId: student.id,
classGroupId,
endDate: null,
},
});
if (!existing) {
await db.enrollment.create({
data: {
studentId: student.id,
classGroupId,
schoolYearId,
startDate: new Date(),
},
});
enrolled++;
}
}
} catch (err) {
errors.push({
row: i + 1,
error: err instanceof Error ? err.message : 'Unknown error',
});
}
}
// Audit log entry
await db.auditLog.create({
data: {
userId: session.userId,
schoolId,
action: 'CREATE',
entityType: 'Student',
entityId: null,
metadata: JSON.stringify({
bulkImport: true,
classGroupId: classGroupId ?? null,
totalRequested: students.length,
created,
enrolled,
errors: errors.length,
}),
},
});
return NextResponse.json({ created, enrolled, errors }, { status: 201 });
} catch (error) {
console.error('Bulk students POST error:', error);
return NextResponse.json(
{ error: 'Internal server error' },
{ status: 500 }
);
}
}
+70
View File
@@ -0,0 +1,70 @@
import { NextRequest, NextResponse } from 'next/server';
import { z } from 'zod';
import { db } from '@/lib/db';
import { getSession } from '@/lib/auth';
const reorderSchema = z.object({
classGroupId: z.string(),
studentIds: z.array(z.string()).min(1),
});
export async function PUT(req: NextRequest) {
const session = await getSession();
if (!session?.user) {
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
}
if (session.user.role !== 'TEACHER' && session.user.role !== 'SCHOOL_ADMIN' && session.user.role !== 'SUPER_ADMIN') {
return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
}
let body: unknown;
try {
body = await req.json();
} catch {
return NextResponse.json({ error: 'Invalid JSON' }, { status: 400 });
}
const parsed = reorderSchema.safeParse(body);
if (!parsed.success) {
return NextResponse.json({ error: parsed.error.issues.map((i) => i.message).join(', ') }, { status: 400 });
}
const { classGroupId, studentIds } = parsed.data;
// Verify the class belongs to the teacher's school
const classGroup = await db.classGroup.findUnique({
where: { id: classGroupId },
});
if (!classGroup) {
return NextResponse.json({ error: 'Class not found' }, { status: 404 });
}
if (session.user.schoolId && classGroup.schoolId !== session.user.schoolId) {
return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
}
try {
await db.classGroup.update({
where: { id: classGroupId },
data: {
seatingOrder: JSON.stringify(studentIds),
},
});
// Audit log
await db.auditLog.create({
data: {
userId: session.userId,
schoolId: session.user.schoolId,
action: 'REORDER_STUDENTS',
entityType: 'ClassGroup',
entityId: classGroupId,
metadata: JSON.stringify({ studentIds }),
},
});
return NextResponse.json({ success: true });
} catch (error) {
console.error('Reorder students error:', error);
return NextResponse.json({ error: 'Failed to reorder students' }, { status: 500 });
}
}
+174
View File
@@ -0,0 +1,174 @@
import { NextResponse } from 'next/server';
import { z } from 'zod';
import { db } from '@/lib/db';
import { getSession } from '@/lib/auth';
const createStudentSchema = z.object({
schoolId: z.string().min(1),
firstName: z.string().min(1),
lastName: z.string().min(1),
dateOfBirth: z
.string()
.optional()
.transform((v) => (v ? new Date(v) : undefined)),
externalId: z.string().optional(),
});
export async function GET(request: Request) {
try {
const session = await getSession();
if (!session) {
return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
}
const { searchParams } = new URL(request.url);
const schoolId = searchParams.get('schoolId');
const classGroupId = searchParams.get('classGroupId');
const search = searchParams.get('search');
const where: Record<string, unknown> = { deletedAt: null };
if (schoolId) where.schoolId = schoolId;
if (classGroupId) {
where.enrollments = {
some: { classGroupId, endDate: null },
};
}
if (search) {
where.OR = [
{ firstName: { contains: search } },
{ lastName: { contains: search } },
{ externalId: { contains: search } },
];
}
const students = await db.student.findMany({
where,
orderBy: [{ lastName: 'asc' }, { firstName: 'asc' }],
include: {
school: { select: { id: true, name: true } },
enrollments: {
where: { endDate: null },
include: {
classGroup: {
select: { id: true, name: true, gradeLevel: true },
},
},
},
_count: {
select: {
learningProgressEntries: true,
assessmentResults: true,
},
},
},
});
return NextResponse.json(students);
} catch (error) {
console.error('Students GET error:', error);
return NextResponse.json(
{ error: 'Internal server error' },
{ status: 500 }
);
}
}
export async function POST(request: Request) {
try {
const session = await getSession();
if (!session) {
return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
}
if (
session.user?.role !== 'SUPER_ADMIN' &&
session.user?.role !== 'SCHOOL_ADMIN' &&
session.user?.role !== 'TEACHER'
) {
return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
}
const body = await request.json();
const parsed = createStudentSchema.safeParse(body);
if (!parsed.success) {
return NextResponse.json(
{ error: 'Validation failed', details: parsed.error.issues },
{ status: 400 }
);
}
const student = await db.student.create({
data: parsed.data,
include: {
school: { select: { id: true, name: true } },
},
});
return NextResponse.json(student, { status: 201 });
} catch (error) {
console.error('Students POST error:', error);
return NextResponse.json(
{ error: 'Internal server error' },
{ status: 500 }
);
}
}
export async function PUT(request: Request) {
try {
const session = await getSession();
if (!session) {
return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
}
if (
session.user?.role !== 'SUPER_ADMIN' &&
session.user?.role !== 'SCHOOL_ADMIN' &&
session.user?.role !== 'TEACHER'
) {
return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
}
const body = await request.json();
const updateSchema = z.object({
id: z.string().min(1),
firstName: z.string().min(1).optional(),
lastName: z.string().min(1).optional(),
dateOfBirth: z
.string()
.nullable()
.optional()
.transform((v) => (v ? new Date(v) : v === null ? null : undefined)),
externalId: z.string().nullable().optional(),
});
const parsed = updateSchema.safeParse(body);
if (!parsed.success) {
return NextResponse.json(
{ error: 'Validation failed', details: parsed.error.issues },
{ status: 400 }
);
}
const { id, ...updateData } = parsed.data;
const student = await db.student.update({
where: { id },
data: updateData,
include: {
school: { select: { id: true, name: true } },
},
});
return NextResponse.json(student);
} catch (error) {
console.error('Students PUT error:', error);
return NextResponse.json(
{ error: 'Internal server error' },
{ status: 500 }
);
}
}