AHMADJAN-New/nazim-exams
.cursor/skills/nazim-exams/SKILL.md
Exams module patterns for Nazim. Use when working on exams, exam classes, subjects, timetable, enrollment, marks, attendance, or reports. Covers class_subjects dependency, hooks, exam flow, academic year, exam types, permissions.
data-ai
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add AHMADJAN-New/nazim-web nazim-examsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 10:49 PM4.3s2 files scanned
SKILL.md
- name:
- nazim-exams
- description:
- Exams module patterns for Nazim. Use when working on exams, exam classes, subjects, timetable, enrollment, marks, attendance, or reports. Covers class_subjects dependency, hooks, exam flow, academic year, exam types, permissions.
Nazim Exams
Exams are scoped to an academic year. Exam subjects come from class_subjects (not subjects directly). See nazim-class-subjects for the two-step subject workflow.
Class Subjects Dependency
- Exam subjects use
class_subject_id— subjects must be assigned to the class academic year (via class_subjects) before enrolling in an exam - When enrolling a subject to an exam:
useEnrollSubjectToExamexpectsexam_id,exam_class_id,class_subject_id, and optionaltotal_marks,passing_marks,scheduled_at - Do NOT link exams to the
subjectstable directly; always use class_subjects
Exam Flow
- Exam — Created for an academic year; has status:
draft|scheduled|in_progress|completed|archived - Exam classes — Assign class academic years to the exam (
useAssignClassToExam,exam_classeswithclass_academic_year_id) - Exam subjects — Enroll class subjects per exam class (
useEnrollSubjectToExam,class_subject_id) - Exam times — Timetable (date, startTime, endTime, room, invigilator) per exam subject
Hooks (useExams.tsx)
- Exams:
useExams(organizationId?),useLatestExamFromCurrentYear(organizationId?),useExam(examId?),useCreateExam,useUpdateExam,useUpdateExamStatus,useDeleteExam - Exam classes:
useExamClasses(examId?),useAssignClassToExam,useRemoveClassFromExam - Exam subjects:
useExamSubjects(examId?, examClassId?),useEnrollSubjectToExam,useUpdateExamSubject,useRemoveExamSubject - Exam times:
useExamTimes(examId?, examClassId?),useCreateExamTime,useUpdateExamTime,useDeleteExamTime - Enrollment / results / attendance:
useExamStudents,useExamResults,useExamAttendance, and related report/attendance hooks
Query keys include profile?.organization_id, profile?.default_school_id. Use useCurrentAcademicYear when scoping to current year.
Academic Year and Exam Types
- Exams belong to an academic year (
academicYearId); useuseCurrentAcademicYearfor “current year” filters - Exam types (e.g. Mid-term, Final) are in Settings > Exam Types;
useExamTypes
Permissions
exams.read,exams.create,exams.update,exams.delete— use for menu visibility and backend checks- Use
useHasPermission('exams.read')etc. in main app (not platform admin)
Pages
- Exams list, Exam timetable, Exam enrollment, Exam student enrollment, Exam marks, Exam attendance
- Exam roll numbers, Secret numbers, Number reports, Reports hub, Consolidated mark sheet, Class-subject mark sheet, Student exam report
- Question bank, Exam paper templates, Exam papers, Print tracking, Exam documents, Exam classes/subjects page
Types and Mapper
- Domain: frontend/src/types/domain/exam.ts — Exam, ExamClass, ExamSubject, ExamTime, ExamStatus, report types
- API: frontend/src/types/api/exam.ts
- Mapper: frontend/src/mappers/examMapper.ts
Multi-Tenancy
- Query keys include
organization_idanddefault_school_idwhere applicable - Follow nazim-multi-tenancy for new exam endpoints
Checklist
- [ ] Use class_subject_id for exam subjects (never subject_id only)
- [ ] Scope exams by academic year
- [ ] Invalidate exam-classes and exam-subjects when removing class from exam
- [ ] Check permissions (exams.read, exams.create, etc.) for UI and backend
Additional Resources
- Exam status values, report types, permission names: reference.md
Related Skills
AHMADJAN-New/nazim-toast
tools
VerifiedTrustedCommunity
Toast notifications for Nazim. Use when showing success/error/info messages. ALWAYS use showToast from @/lib/toast with translation keys; never toast from sonner directly. RTL positioning is automatic.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-status-badges
tools
VerifiedTrustedCommunity
Enforces status badge patterns for Nazim UI. Use when displaying status in tables, cards, or dialogs. Covers Badge variants, semantic colors, statusBadgeVariant, statusOptions with color.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-responsive
development
VerifiedTrustedCommunity
Enforces mobile-first responsive patterns for Nazim UI. Use when building pages, tables, forms, charts, or buttons. Covers page container, FilterPanel, tabs, grids, tables, charts, cards, buttons.
SKILL.mdUpdated Apr 16, 2026
AHMADJAN-New/nazim-reports
development
VerifiedTrustedCommunity
PDF and Excel report generation for Nazim. Use when adding or changing reports. Backend uses ReportService and ReportConfig; frontend uses useServerReport. Covers branding, DateConversionService, RTL, acceptance criteria.
SKILL.mdUpdated Apr 16, 2026