placementt-core 1.400.991 → 1.400.993

package/lib/typeDefinitions.d.ts

@@ -2080,19 +2080,30 @@ export type DestinationsRecipientFilter = {
  */
 export type AspirationSurveySlot = SurveySlot;
 /**
- * Per-year-group leaver settings. Used as an override entry in
+ * Per-year-group leaver settings.
+ *
+ * Each leg is scheduled the way every other survey is: a relative rule ("third
+ * Thursday of August") with a materialised MM-DD alongside it as the concrete
+ * fallback — the same pair SurveySlot carries. Results day is why: the exam boards
+ * move it by a few days each year but it is always a Thursday. Staff can still
+ * correct one year's date on the survey page (updateSurveyCycleSettings). Used as an override entry in
  * DestinationsConfig.leavers.byYearGroup — each field replaces the shared leaver
  * default for that year group only. All MM-DD strings are zero-padded.
  */
 export type LeaverYearGroupConfig = {
     intentionsSendMMDD: string;
+    /** Relative rule for the intentions form, materialised into intentionsSendMMDD.
+     * Absent on configs written before leaver dates became rules. */
+    intentionsRule?: SurveyDateRule;
     resultsDay: {
         enabled: boolean;
         sendMMDD: string;
+        rule?: SurveyDateRule;
     };
     christmas: {
         enabled: boolean;
         sendMMDD: string;
+        rule?: SurveyDateRule;
     };
     allStudentsLeave?: boolean;
 };
@@ -2107,7 +2118,8 @@ export type DestinationsConfig = {
     aspirations: {
         enabled: boolean;
         yearGroups: number[];
-        /** Shared schedule applied to every selected year group (1–3 sends/year). */
+        /** Shared schedule applied to every selected year group. Any number of sends
+         * per year — a school running one a term is as valid as one a year. */
         surveys: AspirationSurveySlot[];
         /** Optional per-year-group override. When a year group key is present its
          * schedule REPLACES `surveys` for that year group only. */
@@ -2122,13 +2134,16 @@ export type DestinationsConfig = {
         enabled: boolean;
         yearGroups: number[];
         intentionsSendMMDD: string;
+        intentionsRule?: SurveyDateRule;
         resultsDay: {
             enabled: boolean;
             sendMMDD: string;
+            rule?: SurveyDateRule;
         };
         christmas: {
             enabled: boolean;
             sendMMDD: string;
+            rule?: SurveyDateRule;
         };
         /** true → every student in these groups leaves (no internal sixth form). */
         allStudentsLeave?: boolean;
@@ -2146,6 +2161,11 @@ export type DestinationsConfig = {
         approveAlumni: boolean;
         alumniConversations: boolean;
         visibleToStudents: boolean;
+        /** Chase each alumnus once a year for an update. Deliberately the only
+         * scheduling a check-in has: unlike every other kind it isn't a cohort send,
+         * so its date is a year on from that person's last reply, not a date the
+         * school picks. Absent = on, matching the behaviour before the toggle. */
+        annualCheckIns?: boolean;
     };
     /** MM-DD on which each new academic year's objects are created. Default "09-01". */
     provisionMMDD: string;

package/package.json

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

package/src/typeDefinitions.ts

@@ -2022,14 +2022,23 @@ export type DestinationsRecipientFilter = {k: string, e?: WhereFilterOp, v: unkn
 export type AspirationSurveySlot = SurveySlot;
 
 /**
- * Per-year-group leaver settings. Used as an override entry in
+ * Per-year-group leaver settings.
+ *
+ * Each leg is scheduled the way every other survey is: a relative rule ("third
+ * Thursday of August") with a materialised MM-DD alongside it as the concrete
+ * fallback — the same pair SurveySlot carries. Results day is why: the exam boards
+ * move it by a few days each year but it is always a Thursday. Staff can still
+ * correct one year's date on the survey page (updateSurveyCycleSettings). Used as an override entry in
  * DestinationsConfig.leavers.byYearGroup — each field replaces the shared leaver
  * default for that year group only. All MM-DD strings are zero-padded.
  */
 export type LeaverYearGroupConfig = {
     intentionsSendMMDD: string,
-    resultsDay: {enabled: boolean, sendMMDD: string},
-    christmas: {enabled: boolean, sendMMDD: string},
+    /** Relative rule for the intentions form, materialised into intentionsSendMMDD.
+     * Absent on configs written before leaver dates became rules. */
+    intentionsRule?: SurveyDateRule,
+    resultsDay: {enabled: boolean, sendMMDD: string, rule?: SurveyDateRule},
+    christmas: {enabled: boolean, sendMMDD: string, rule?: SurveyDateRule},
     allStudentsLeave?: boolean,
 };
 
@@ -2045,7 +2054,8 @@ export type DestinationsConfig = {
     aspirations: {
         enabled: boolean,
         yearGroups: number[],                   // e.g. [7,8,9,10,11]
-        /** Shared schedule applied to every selected year group (1–3 sends/year). */
+        /** Shared schedule applied to every selected year group. Any number of sends
+         * per year — a school running one a term is as valid as one a year. */
         surveys: AspirationSurveySlot[],
         /** Optional per-year-group override. When a year group key is present its
          * schedule REPLACES `surveys` for that year group only. */
@@ -2058,9 +2068,12 @@ export type DestinationsConfig = {
     leavers: {
         enabled: boolean,
         yearGroups: number[],                   // subset of [11, 13]
+        // Each leg is scheduled by relative rule with the MM-DD as its materialised
+        // fallback, the same pair aspiration and skills slots use.
         intentionsSendMMDD: string,             // Form B, before they leave — default "06-15"
-        resultsDay: {enabled: boolean, sendMMDD: string},   // default "08-29"
-        christmas: {enabled: boolean, sendMMDD: string},    // default "12-08"
+        intentionsRule?: SurveyDateRule,
+        resultsDay: {enabled: boolean, sendMMDD: string, rule?: SurveyDateRule},   // default "08-29"
+        christmas: {enabled: boolean, sendMMDD: string, rule?: SurveyDateRule},    // default "12-08"
         /** true → every student in these groups leaves (no internal sixth form). */
         allStudentsLeave?: boolean,
         /** Optional per-year-group override. When a year group key is present its
@@ -2076,6 +2089,11 @@ export type DestinationsConfig = {
         approveAlumni: boolean,
         alumniConversations: boolean,
         visibleToStudents: boolean,             // default visibility for new alumni records
+        /** Chase each alumnus once a year for an update. Deliberately the only
+         * scheduling a check-in has: unlike every other kind it isn't a cohort send,
+         * so its date is a year on from that person's last reply, not a date the
+         * school picks. Absent = on, matching the behaviour before the toggle. */
+        annualCheckIns?: boolean,
     },
     /** MM-DD on which each new academic year's objects are created. Default "09-01". */
     provisionMMDD: string,