placementt-core 1.400.920 → 1.400.922

package/lib/typeDefinitions.d.ts

@@ -905,6 +905,7 @@ export type InstituteData = {
         provider?: string;
     };
     skillsAssessments?: boolean;
+    assessActivitySkills?: boolean;
     skills: string[];
     scheduledSkillsAssessments?: {
         [key in "yearStart" | "yearEnd" | "eachTerm" | "preWorkExperience" | "postWorkExperience" | "employerInteraction"]?: {
@@ -2111,6 +2112,10 @@ export type LeaverCheckpointResponse = {
     wellbeingScore?: 1 | 2 | 3 | 4 | 5;
     personalEmail?: string;
     date: string;
+    /** Set when the leaver answered the staying-on gate on this form (only shown
+     * when the group permits staying and we didn't already know). true → they're
+     * staying at the school, so the alumni/consent capture is skipped. */
+    stayingAtSchoolSixthForm?: boolean;
     /** Consent / one-time items still outstanding for this leaver, collected on
      * this form and routed to UserData by the backend (never stored here). */
     intentionsCapture?: LeaverConsentCapture;
@@ -2126,6 +2131,7 @@ export type LeaverRequest = Omit<AspirationRequest, "cycleId" | "response"> & {
     response?: LeaverTransitionData;
     alumniId?: string;
     intentionsCapturedAt?: string;
+    stayingAtSchoolSixthForm?: boolean;
     personalEmail?: string;
     token?: string;
     tokenExpiry?: string;
@@ -2679,6 +2685,7 @@ export type SkillAssessment = {
     externalKey?: string;
     userType: "parents" | "employers" | "students";
     skillRequest?: string;
+    activityId?: string;
     email: string;
     forename: string;
     surname: string;
@@ -2763,6 +2770,10 @@ export type StudentActivity = {
     hoursPerSession?: number;
     careerAreas?: string[];
     skillsDeveloped?: string[];
+    skillScores?: {
+        [skill: string]: number;
+    };
+    skillsAssessmentId?: string;
     reflection?: string;
     evidenceFileIds?: string[];
 };
@@ -3025,6 +3036,11 @@ export type LeaverGroup = {
     totalInvited?: number;
     totalResponded?: number;
     aggregates?: LeaverAggregates;
+    /** Staff setup flag — true when every student in this group leaves after this
+     * year (no internal sixth-form option). When false/undefined the leaver form
+     * asks "are you staying on?" first, and stayers skip the alumni / consent
+     * capture (and aren't seeded as alumni). */
+    allStudentsLeave?: boolean;
     /** Post-leaving checkpoint schedule. Absent = checkpoints disabled for this group. */
     checkpointConfig?: {
         resultsDay?: {

package/package.json

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

package/src/typeDefinitions.ts

@@ -900,6 +900,7 @@ export type InstituteData = {
     },
     // SKILLS ASSESSMENT CONFIGURATION
     skillsAssessments?: boolean,
+    assessActivitySkills?: boolean, // ask students to self-assess skills when logging an extracurricular activity
     skills: string[]
     scheduledSkillsAssessments?: {
         [key in "yearStart" | "yearEnd" | "eachTerm" | "preWorkExperience" | "postWorkExperience" | "employerInteraction"]?: {
@@ -2028,6 +2029,10 @@ export type LeaverCheckpointResponse = {
     wellbeingScore?: 1|2|3|4|5,    // christmas only, optional
     personalEmail?: string,        // lets them update their contact email
     date: string,                  // ISO — server-stamped submission time
+    /** Set when the leaver answered the staying-on gate on this form (only shown
+     * when the group permits staying and we didn't already know). true → they're
+     * staying at the school, so the alumni/consent capture is skipped. */
+    stayingAtSchoolSixthForm?: boolean,
     /** Consent / one-time items still outstanding for this leaver, collected on
      * this form and routed to UserData by the backend (never stored here). */
     intentionsCapture?: LeaverConsentCapture,
@@ -2044,6 +2049,7 @@ export type LeaverRequest = Omit<AspirationRequest, "cycleId"|"response"> & {
     response?: LeaverTransitionData,
     alumniId?: string,                  // set when this leaver opted in and an Alumni record was created
     intentionsCapturedAt?: string,      // ISO — set when consent/alumni data was captured via a later checkpoint (intentions form itself was never completed)
+    stayingAtSchoolSixthForm?: boolean, // canonical per-request staying-on answer (from whichever form captured it); gates whether any form re-asks the staying-on question
 
     // ── Post-leaving contact + magic-link auth (set at checkpoint send time) ──
     personalEmail?: string,             // denormalised from response.personalEmail at checkpoint-1 submit
@@ -2608,8 +2614,9 @@ export type SkillAssessment = {
     externalKey?: string,
     userType: "parents"|"employers"|"students",
     skillRequest?: string,
+    activityId?: string, // links a self-assessment to the extracurricular activity it came from
     email: string,
-    forename: string, 
+    forename: string,
     surname: string,
 }
 
@@ -2747,6 +2754,9 @@ export type StudentActivity = {
 
   skillsDeveloped?: string[]; // from skills framework
 
+  skillScores?: { [skill: string]: number }; // student self-assessed 1-10 score per developed skill
+  skillsAssessmentId?: string; // linked skillsAssessments doc created from this activity
+
   reflection?: string;
 
   // -------------------------
@@ -3020,6 +3030,12 @@ export type LeaverGroup = {
     totalResponded?: number,                    // incremented on each completion
     aggregates?: LeaverAggregates,              // pre-aggregated response data for dashboard charts
 
+    /** Staff setup flag — true when every student in this group leaves after this
+     * year (no internal sixth-form option). When false/undefined the leaver form
+     * asks "are you staying on?" first, and stayers skip the alumni / consent
+     * capture (and aren't seeded as alumni). */
+    allStudentsLeave?: boolean,
+
     /** Post-leaving checkpoint schedule. Absent = checkpoints disabled for this group. */
     checkpointConfig?: {
         resultsDay?: {enabled: boolean, sendAt: string, emailTemplateId?: string},   // ISO datetime