placementt-core 1.400.970 → 1.400.971

package/lib/typeDefinitions.d.ts

@@ -938,9 +938,12 @@ export type InstituteData = {
     /** Only meaningful when skillsFramework is "custom": the selected skillsLabels ids
      * (generic public labels and/or the school's own custom labels). */
     skills: string[];
-    /** Staff-defined rules serving specific skills to specific students based on their
-     * detail fields (studentsFields). Evaluated at assessment view time. */
+    /** Staff-defined student groups serving specific skills to specific students based
+     * on their detail fields (studentsFields). Evaluated at assessment view time. */
     skillsMappings?: SkillsMapping[];
+    /** Annual survey schedule for the default "All students" group. Auto-provisioned
+     * into each academic year by the daily cron. */
+    skillsSurveys?: SkillsSurveySlot[];
     scheduledSkillsAssessments?: {
         [key in "yearStart" | "yearEnd" | "eachTerm" | "preWorkExperience" | "postWorkExperience" | "employerInteraction"]?: {
             students?: boolean;
@@ -2876,13 +2879,25 @@ export type SkillLabel = {
      * Absent for platform-wide labels. */
     oId?: string;
 };
+/** One scheduled skills survey in a group's annual programme. `sendMMDD` is "MM-DD".
+ * Auto-provisioned into each new academic year by the daily cron (mirrors the
+ * aspirations AspirationSurveySlot model). */
+export type SkillsSurveySlot = {
+    sendMMDD: string;
+    label?: string;
+    students?: boolean;
+    parents?: boolean;
+};
 /**
- * A staff-defined rule mapping students to the skills they are served on assessments.
- * `filters` keys are student detail field names (from InstituteData.studentsFields);
- * values are the accepted values for that field. A student matches a rule when EVERY
- * filtered field's value is one of the accepted values (values within a field are OR,
- * fields are AND). A student matching multiple rules is served the UNION of their
- * skills. A student matching no rule falls back to the institute's full base set.
+ * A staff-defined student group mapping students to the skills they are served on
+ * assessments. `filters` keys are student detail field names (from
+ * InstituteData.studentsFields); values are the accepted values for that field. A
+ * student matches a group when EVERY filtered field's value is one of the accepted
+ * values (values within a field are OR, fields are AND). A student matching multiple
+ * groups is served the UNION of their skills. A student matching no group falls back
+ * to the institute's "All students" base set (skillsFramework/skills).
+ * Each group carries its own annual survey schedule; the "All students" default
+ * group's schedule lives on InstituteData.skillsSurveys.
  */
 export type SkillsMapping = {
     id: string;
@@ -2891,6 +2906,7 @@ export type SkillsMapping = {
         [field: string]: string[];
     };
     skills: string[];
+    surveys?: SkillsSurveySlot[];
 };
 /** Rater types for skills assessments (mirrors SkillAssessment.userType). */
 export type SkillRater = "students" | "parents" | "employers";
@@ -2982,6 +2998,8 @@ export type SkillAssessmentRequest = {
     oId: string;
     academicYear?: string;
     yearGroup?: number;
+    groupId?: string;
+    preResolved?: boolean;
     sendTime?: string;
     students: string;
     requestParents?: boolean;

package/package.json

@@ -2,7 +2,7 @@
   "private": false,
   "name": "placementt-core",
   "author": "Placementt",
-  "version": "1.400.970",
+  "version": "1.400.971",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {

package/src/typeDefinitions.ts

@@ -947,9 +947,12 @@ export type InstituteData = {
     /** Only meaningful when skillsFramework is "custom": the selected skillsLabels ids
      * (generic public labels and/or the school's own custom labels). */
     skills: string[]
-    /** Staff-defined rules serving specific skills to specific students based on their
-     * detail fields (studentsFields). Evaluated at assessment view time. */
+    /** Staff-defined student groups serving specific skills to specific students based
+     * on their detail fields (studentsFields). Evaluated at assessment view time. */
     skillsMappings?: SkillsMapping[],
+    /** Annual survey schedule for the default "All students" group. Auto-provisioned
+     * into each academic year by the daily cron. */
+    skillsSurveys?: SkillsSurveySlot[],
     scheduledSkillsAssessments?: {
         [key in "yearStart" | "yearEnd" | "eachTerm" | "preWorkExperience" | "postWorkExperience" | "employerInteraction"]?: {
             students?: boolean,
@@ -2797,19 +2800,33 @@ export type SkillLabel = {
     oId?: string,
 }
 
+/** One scheduled skills survey in a group's annual programme. `sendMMDD` is "MM-DD".
+ * Auto-provisioned into each new academic year by the daily cron (mirrors the
+ * aspirations AspirationSurveySlot model). */
+export type SkillsSurveySlot = {
+    sendMMDD: string,
+    label?: string,
+    students?: boolean,
+    parents?: boolean,
+}
+
 /**
- * A staff-defined rule mapping students to the skills they are served on assessments.
- * `filters` keys are student detail field names (from InstituteData.studentsFields);
- * values are the accepted values for that field. A student matches a rule when EVERY
- * filtered field's value is one of the accepted values (values within a field are OR,
- * fields are AND). A student matching multiple rules is served the UNION of their
- * skills. A student matching no rule falls back to the institute's full base set.
+ * A staff-defined student group mapping students to the skills they are served on
+ * assessments. `filters` keys are student detail field names (from
+ * InstituteData.studentsFields); values are the accepted values for that field. A
+ * student matches a group when EVERY filtered field's value is one of the accepted
+ * values (values within a field are OR, fields are AND). A student matching multiple
+ * groups is served the UNION of their skills. A student matching no group falls back
+ * to the institute's "All students" base set (skillsFramework/skills).
+ * Each group carries its own annual survey schedule; the "All students" default
+ * group's schedule lives on InstituteData.skillsSurveys.
  */
 export type SkillsMapping = {
     id: string,
     name?: string,
     filters: {[field: string]: string[]},
     skills: string[],
+    surveys?: SkillsSurveySlot[],
 }
 
 /** Rater types for skills assessments (mirrors SkillAssessment.userType). */
@@ -2903,6 +2920,9 @@ export type SkillAssessmentRequest = {
     // documents stay valid — legacy requests without them surface as "Ungrouped".
     academicYear?: string,                      // e.g. "2024-25", derived from sendTime/creation
     yearGroup?: number,                         // the single year group this request targets
+    // ── Auto-provisioned group surveys (set by the daily cron) ──
+    groupId?: string,                           // SkillsMapping.id, or "all" for the All students group
+    preResolved?: boolean,                      // per-student assessments created by the cron — onRequestCreated skips fan-out
     sendTime?: string,
     students: string // JSON stringify
     // {