@things-factory/learning 0.0.0-stage → 10.1.261

package/dist-server/service/enrollment/enrollment-status.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENROLLMENT_STATES = void 0;
+exports.rowsOf = rowsOf;
+exports.headedDepartmentsOf = headedDepartmentsOf;
+exports.statusOnly = statusOnly;
+exports.completionRegister = completionRegister;
+exports.teamReachOf = teamReachOf;
+exports.reachOf = reachOf;
+exports.enrollmentPage = enrollmentPage;
+exports.enrollmentStateCounts = enrollmentStateCounts;
+/*
+ * Where enrolments stand, for managers and department heads (ADR-0194 decisions 10, 11): every enrolment of a course or
+ * a source with its progress and evidence for a manager (`course` query); for a department head, whether each person
+ * of their departments is done - status and days only, never a score or an attempt.
+ */
+const typeorm_1 = require("typeorm");
+const auth_base_1 = require("@things-factory/auth-base");
+const organization_1 = require("@things-factory/organization");
+const shell_1 = require("@things-factory/shell");
+const course_1 = require("../course/course");
+const course_unit_1 = require("../course/course-unit");
+const course_version_1 = require("../course/course-version");
+const course_service_1 = require("../course/course-service");
+const enrollment_1 = require("./enrollment");
+const enrollment_service_1 = require("./enrollment-service");
+const progress_rules_1 = require("./progress-rules");
+const unit_progress_1 = require("./unit-progress");
+/** The working employee record of each user given - for the department a row names. */
+async function employeesOf(tx, domain, userIds) {
+    if (!userIds.length)
+        return new Map();
+    const rows = await tx.getRepository(organization_1.Employee).find({ where: { domain: { id: domain.id }, user: { id: (0, typeorm_1.In)(userIds) } }, relations: ['department'] });
+    const out = new Map();
+    for (const row of rows)
+        if (row.active !== false && (!out.has(row.userId) || out.get(row.userId).active === false))
+            out.set(row.userId, row);
+    return out;
+}
+/** The rows of the enrolments given - each with its person, course, department, state today and units done. */
+async function rowsOf(tx, domain, enrollments) {
+    if (!enrollments.length)
+        return [];
+    const today = (0, enrollment_service_1.todayIn)(domain);
+    const users = await tx.getRepository(auth_base_1.User).find({ where: { id: (0, typeorm_1.In)([...new Set(enrollments.map(one => one.userId))]) } });
+    const courses = await tx.getRepository(course_1.Course).find({ where: { id: (0, typeorm_1.In)([...new Set(enrollments.map(one => one.courseId))]) } });
+    const employees = await employeesOf(tx, domain, users.map(one => one.id));
+    const versionIds = new Set();
+    const shown = new Map();
+    for (const enrollment of enrollments) {
+        const id = enrollment.versionId ?? (await (0, course_service_1.publishedVersionOf)(tx, domain, enrollment.courseId))?.id ?? null;
+        shown.set(enrollment.id, id);
+        if (id)
+            versionIds.add(id);
+    }
+    const versions = versionIds.size ? await tx.getRepository(course_version_1.CourseVersion).find({ where: { id: (0, typeorm_1.In)([...versionIds]) }, withDeleted: true }) : [];
+    const units = versionIds.size ? (await tx.getRepository(course_unit_1.CourseUnit).find({ where: { version: { id: (0, typeorm_1.In)([...versionIds]) } } })).filter(progress_rules_1.counts) : [];
+    const progress = await tx.getRepository(unit_progress_1.UnitProgress).find({ where: { enrollment: { id: (0, typeorm_1.In)(enrollments.map(one => one.id)) } } });
+    return enrollments.map(enrollment => {
+        const versionId = shown.get(enrollment.id);
+        const mine = units.filter(unit => unit.versionId === versionId);
+        return {
+            enrollment,
+            user: users.find(one => one.id === enrollment.userId) ?? null,
+            course: courses.find(one => one.id === enrollment.courseId) ?? null,
+            departmentName: employees.get(enrollment.userId)?.department?.name ?? null,
+            state: (0, progress_rules_1.overdue)(enrollment, today) ? 'OVERDUE' : enrollment.status,
+            units: mine.length,
+            unitsDone: mine.filter(unit => progress.some(one => one.enrollmentId === enrollment.id && one.unitId === unit.id && one.doneAt)).length,
+            versionNumber: enrollment.versionId ? (versions.find(one => one.id === enrollment.versionId)?.number ?? null) : null
+        };
+    });
+}
+/** The departments the request's person heads, with those under them - none for anyone else. */
+async function headedDepartmentsOf(context) {
+    const { domain, user } = context.state;
+    const tx = (0, course_service_1.learningManagerOf)(context);
+    const me = (await employeesOf(tx, domain, [user.id])).get(user.id);
+    if (!me)
+        return [];
+    const managed = await tx.getRepository(organization_1.Department).find({ where: { domain: { id: domain.id }, manager: { id: me.id } } });
+    if (!managed.length)
+        return [];
+    return (0, organization_1.withDescendants)(managed.map(one => one.id), await (0, organization_1.departmentTreeOf)(domain, tx));
+}
+/** An enrolment as a department head reads it - where it stands and its days, nothing of how it went. */
+function statusOnly(enrollment) {
+    const { score, attempts, learnedSeconds, acknowledgedAt, certificateNo, cancelReason, ...kept } = enrollment;
+    return { ...kept, score: null, attempts: null, learnedSeconds: null, acknowledgedAt: null, certificateNo: null, cancelReason: null };
+}
+/** The completion register of a course - every completed enrolment, by completion day (decision 10). */
+async function completionRegister(courseId, context) {
+    const { domain } = context.state;
+    const tx = (0, course_service_1.learningManagerOf)(context);
+    const enrollments = await tx.getRepository(enrollment_1.Enrollment).find({ where: { domain: { id: domain.id }, course: { id: courseId }, status: enrollment_1.EnrollmentStatus.COMPLETED }, order: { completedAt: 'ASC' } });
+    return await rowsOf(tx, domain, enrollments);
+}
+/* ================================================================ the list rule */
+/** Where an enrolment stands as a list shows it - OVERDUE is an open one past its due day, read on the day. */
+exports.ENROLLMENT_STATES = ['ASSIGNED', 'IN_PROGRESS', 'COMPLETED', 'OVERDUE', 'CANCELLED'];
+/** The people of the request's departments, refused to anyone who heads none. */
+async function teamReachOf(context) {
+    const { domain } = context.state;
+    const headed = await headedDepartmentsOf(context);
+    if (!headed.length)
+        throw new shell_1.Refusal('learning-not-a-department-head', {}, 'only a department head reads where their people stand');
+    const people = await (0, course_service_1.learningManagerOf)(context).getRepository(organization_1.Employee).find({ where: { domain: { id: domain.id }, department: { id: (0, typeorm_1.In)(headed) } } });
+    return { kind: 'team', userIds: [...new Set(people.filter(one => one.active !== false && one.userId).map(one => one.userId))] };
+}
+/** The widest reach the request has - a manager's, a department head's, or their own. */
+async function reachOf(context) {
+    if (await (0, auth_base_1.requestHolds)(context, 'course', 'query'))
+        return { kind: 'all' };
+    if ((await headedDepartmentsOf(context)).length)
+        return await teamReachOf(context);
+    return { kind: 'own', userId: context.state.user.id };
+}
+/*
+ * The list's names (getQueryBuilderFromListParams): `course` a course id, `learner` and `courseName` the words a search
+ * reads, `sourceKind` and `sourceId` who asked. `state` is not a column - narrowed below.
+ */
+const LIST = {
+    alias: 'E',
+    searchables: ['learner', 'courseName'],
+    columnExpressions: { course: 'C.id', learner: 'U.name', courseName: 'C.name' },
+    sortables: ['dueOn', 'createdAt', 'startedAt', 'completedAt', 'learner', 'courseName'],
+    defaultSortings: [{ name: 'dueOn' }, { name: 'createdAt' }]
+};
+const valuesOf = (filter) => (Array.isArray(filter.value) ? filter.value : [filter.value]).map(String).filter(Boolean);
+/** The SQL of the states named - the parameters keyed apart so two conditions in one query never meet. */
+function stateClause(states, today, key) {
+    const parameters = { [`${key}Open`]: enrollment_1.OPEN_ENROLLMENT_STATUSES, [`${key}Today`]: today };
+    const parts = states
+        .filter(state => exports.ENROLLMENT_STATES.includes(state))
+        .map((state, i) => {
+        if (state === 'OVERDUE')
+            return `(E.status IN (:...${key}Open) AND E.dueOn IS NOT NULL AND E.dueOn < :${key}Today)`;
+        parameters[`${key}S${i}`] = state;
+        if (enrollment_1.OPEN_ENROLLMENT_STATUSES.includes(state))
+            return `(E.status = :${key}S${i} AND (E.dueOn IS NULL OR E.dueOn >= :${key}Today))`;
+        return `E.status = :${key}S${i}`;
+    });
+    return parts.length ? { sql: `(${parts.join(' OR ')})`, parameters } : null;
+}
+let narrowSeq = 0;
+/** The joins the list's names read, the reach, and the `state` filter as SQL. */
+function narrow(builder, reach, state, today, extra) {
+    const key = `learningList${narrowSeq++}`;
+    builder.leftJoin('E.user', 'U').leftJoin('E.course', 'C');
+    if (reach.kind === 'own')
+        builder.andWhere(`U.id = :${key}Me`, { [`${key}Me`]: reach.userId });
+    if (reach.kind === 'team') {
+        if (!reach.userIds.length)
+            builder.andWhere('1 = 0');
+        else
+            builder.andWhere(`U.id IN (:...${key}Team)`, { [`${key}Team`]: reach.userIds }).andWhere(`E.status IN (:...${key}Shown)`, { [`${key}Shown`]: [...enrollment_1.OPEN_ENROLLMENT_STATUSES, enrollment_1.EnrollmentStatus.COMPLETED] });
+    }
+    const clause = state ? stateClause(valuesOf(state), today, `${key}State`) : null;
+    if (clause)
+        builder.andWhere(['noteq', 'notin'].includes(state.operator) ? `NOT ${clause.sql}` : clause.sql, clause.parameters);
+    extra?.(builder);
+}
+/** The filters but `state`, and the `state` one. */
+function splitState(params) {
+    const filters = params?.filters ?? [];
+    return { rest: filters.filter(one => one.name !== 'state'), state: filters.find(one => one.name === 'state') };
+}
+/**
+ * One page of the enrolments a list asks for, within a reach - its conditions, search, sort and page by the framework's
+ * list rule, the rows then read with their people, courses and units. A department head's rows are status only.
+ */
+async function enrollmentPage(params, reach, context, extra) {
+    const { domain } = context.state;
+    const tx = (0, course_service_1.learningManagerOf)(context);
+    const { rest, state } = splitState(params);
+    const builder = (0, shell_1.getQueryBuilderFromListParams)({ ...LIST, repository: tx.getRepository(enrollment_1.Enrollment), params: { ...params, filters: rest }, domain });
+    narrow(builder, reach, state, (0, enrollment_service_1.todayIn)(domain), extra);
+    const [enrollments, total] = await builder.getManyAndCount();
+    const rows = await rowsOf(tx, domain, enrollments);
+    return { rows: reach.kind === 'team' ? rows.map(row => ({ ...row, enrollment: statusOnly(row.enrollment) })) : rows, total };
+}
+/** How many enrolments stand in each state under the list's other conditions - every state, in order. */
+async function enrollmentStateCounts(params, reach, context) {
+    const { domain } = context.state;
+    const tx = (0, course_service_1.learningManagerOf)(context);
+    const today = (0, enrollment_service_1.todayIn)(domain);
+    const { rest } = splitState(params);
+    const common = { ...LIST, repository: tx.getRepository(enrollment_1.Enrollment), domain, params: { filters: rest, search: params?.search, inherited: params?.inherited }, field: 'status' };
+    const all = await (0, shell_1.countListByField)({ ...common, narrow: builder => narrow(builder, reach, undefined, today) });
+    const late = await (0, shell_1.countListByField)({ ...common, narrow: builder => narrow(builder, reach, { name: 'state', operator: 'eq', value: 'OVERDUE' }, today) });
+    const overdueCount = [...late.values()].reduce((sum, one) => sum + one, 0);
+    return exports.ENROLLMENT_STATES.map(value => ({ value, count: value === 'OVERDUE' ? overdueCount : (all.get(value) ?? 0) - (late.get(value) ?? 0) }));
+}
+//# sourceMappingURL=enrollment-status.js.map

package/dist-server/service/enrollment/enrollment-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-status.js","sourceRoot":"","sources":["../../../server/service/enrollment/enrollment-status.ts"],"names":[],"mappings":";;;AA0CA,wBA8BC;AAGD,kDAQC;AAGD,gCAGC;AAGD,gDAKC;AAeD,kCAMC;AAGD,0BAIC;AAwDD,wCASC;AAGD,sDAUC;AA3MD;;;;GAIG;AACH,qCAA+D;AAE/D,yDAA8D;AAC9D,+DAAsG;AACtG,iDAAmI;AAEnI,6CAAyC;AACzC,uDAAkD;AAClD,6DAAwD;AACxD,6DAAgF;AAChF,6CAAqF;AACrF,6DAA8C;AAC9C,qDAAkD;AAClD,mDAA8C;AAc9C,uFAAuF;AACvF,KAAK,UAAU,WAAW,CAAC,EAAiB,EAAE,MAAsB,EAAE,OAAiB;IACrF,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IACrC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,OAAO,CAAC,EAAE,EAAS,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACzJ,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAA;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAO,CAAE,CAAC,MAAM,KAAK,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAO,EAAE,GAAG,CAAC,CAAA;IAChJ,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,+GAA+G;AACxG,KAAK,UAAU,MAAM,CAAC,EAAiB,EAAE,MAAW,EAAE,WAAyB;IACpF,IAAI,CAAC,WAAW,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,IAAA,4BAAO,EAAC,MAAM,CAAC,CAAA;IAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,gBAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,eAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,EAAS,EAAE,CAAC,CAAA;IACtI,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACzE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC9C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,MAAM,IAAA,mCAAkB,EAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,QAAS,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;QAC3G,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC5B,IAAI,EAAE;YAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,8BAAa,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACpJ,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,wBAAU,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACzJ,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAY,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAS,EAAE,CAAC,CAAA;IACxI,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;QAC/D,OAAO;YACL,UAAU;YACV,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI;YAC7D,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI;YACnE,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,MAAO,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,IAAI;YAC3E,KAAK,EAAE,IAAA,wBAAO,EAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM;YACjE,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACvI,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;SACrH,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,gGAAgG;AACzF,KAAK,UAAU,mBAAmB,CAAC,OAAY;IACpD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IACtC,MAAM,EAAE,GAAG,IAAA,kCAAiB,EAAC,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClE,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAA;IAClB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,yBAAU,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAA;IAChI,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAC9B,OAAO,IAAA,8BAAe,EAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,IAAA,+BAAgB,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AACxF,CAAC;AAED,yGAAyG;AACzG,SAAgB,UAAU,CAAC,UAAsB;IAC/C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,UAAiB,CAAA;IACnH,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAgB,CAAA;AACpJ,CAAC;AAED,wGAAwG;AACjG,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAY;IACrE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAChC,MAAM,EAAE,GAAG,IAAA,kCAAiB,EAAC,OAAO,CAAC,CAAA;IACrC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,SAAS,EAAS,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAS,EAAE,CAAC,CAAA;IAChN,OAAO,MAAM,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;AAC9C,CAAC;AAGD,oFAAoF;AAEpF,+GAA+G;AAClG,QAAA,iBAAiB,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,CAAU,CAAA;AAQ1G,iFAAiF;AAC1E,KAAK,UAAU,WAAW,CAAC,OAAY;IAC5C,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAChC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,eAAO,CAAC,gCAAgC,EAAE,EAAE,EAAE,uDAAuD,CAAC,CAAA;IACpI,MAAM,MAAM,GAAG,MAAM,IAAA,kCAAiB,EAAC,OAAO,CAAC,CAAC,aAAa,CAAC,uBAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,MAAM,CAAC,EAAE,EAAS,EAAE,CAAC,CAAA;IAC7J,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAO,CAAC,CAAC,CAAC,EAAE,CAAA;AAClI,CAAC;AAED,yFAAyF;AAClF,KAAK,UAAU,OAAO,CAAC,OAAY;IACxC,IAAI,MAAM,IAAA,wBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC1E,IAAI,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;IAClF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,GAAG;IACV,WAAW,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IACtC,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;IAC9E,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC;IACtF,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAC5D,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAE9H,0GAA0G;AAC1G,SAAS,WAAW,CAAC,MAAgB,EAAE,KAAa,EAAE,GAAW;IAC/D,MAAM,UAAU,GAAwB,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,qCAAwB,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;IAC5G,MAAM,KAAK,GAAG,MAAM;SACjB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAE,yBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACzE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAChB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,qBAAqB,GAAG,gDAAgD,GAAG,QAAQ,CAAA;QACnH,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAA;QACjC,IAAK,qCAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,gBAAgB,GAAG,IAAI,CAAC,wCAAwC,GAAG,SAAS,CAAA;QAC/I,OAAO,eAAe,GAAG,IAAI,CAAC,EAAE,CAAA;IAClC,CAAC,CAAC,CAAA;IACJ,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7E,CAAC;AAED,IAAI,SAAS,GAAG,CAAC,CAAA;AAEjB,iFAAiF;AACjF,SAAS,MAAM,CAAC,OAAuC,EAAE,KAAsB,EAAE,KAAyB,EAAE,KAAa,EAAE,KAAyD;IAClL,MAAM,GAAG,GAAG,eAAe,SAAS,EAAE,EAAE,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9F,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;;YAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,GAAG,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,qCAAwB,EAAE,6BAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IAChN,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAChF,IAAI,MAAM;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAChI,KAAK,EAAE,CAAC,OAAO,CAAC,CAAA;AAClB,CAAC;AAED,oDAAoD;AACpD,SAAS,UAAU,CAAC,MAA6B;IAC/C,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAA;IACrC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAA;AAChH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,MAAiB,EAAE,KAAsB,EAAE,OAAY,EAAE,KAAyD;IACrJ,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAChC,MAAM,EAAE,GAAG,IAAA,kCAAiB,EAAC,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAA,qCAA6B,EAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAClJ,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAA,4BAAO,EAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAA;IACrD,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAA;IAC5D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;IAClD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AAC9H,CAAC;AAED,yGAAyG;AAClG,KAAK,UAAU,qBAAqB,CAAC,MAAiB,EAAE,KAAsB,EAAE,OAAY;IACjG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAChC,MAAM,EAAE,GAAG,IAAA,kCAAiB,EAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,IAAA,4BAAO,EAAC,MAAM,CAAC,CAAA;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC9K,MAAM,GAAG,GAAG,MAAM,IAAA,wBAAgB,EAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAC9G,MAAM,IAAI,GAAG,MAAM,IAAA,wBAAgB,EAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAY,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACnK,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;IAC1E,OAAO,yBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAChJ,CAAC","sourcesContent":["/*\n * Where enrolments stand, for managers and department heads (ADR-0194 decisions 10, 11): every enrolment of a course or\n * a source with its progress and evidence for a manager (`course` query); for a department head, whether each person\n * of their departments is done - status and days only, never a score or an attempt.\n */\nimport { EntityManager, In, SelectQueryBuilder } from 'typeorm'\n\nimport { requestHolds, User } from '@things-factory/auth-base'\nimport { Department, departmentTreeOf, Employee, withDescendants } from '@things-factory/organization'\nimport { countListByField, Filter, getQueryBuilderFromListParams, ListParam, ListValueCount, Refusal } from '@things-factory/shell'\n\nimport { Course } from '../course/course'\nimport { CourseUnit } from '../course/course-unit'\nimport { CourseVersion } from '../course/course-version'\nimport { learningManagerOf, publishedVersionOf } from '../course/course-service'\nimport { Enrollment, EnrollmentStatus, OPEN_ENROLLMENT_STATUSES } from './enrollment'\nimport { todayIn } from './enrollment-service'\nimport { counts, overdue } from './progress-rules'\nimport { UnitProgress } from './unit-progress'\n\nexport interface StatusRow {\n  enrollment: Enrollment\n  user: User | null\n  course: Course | null\n  departmentName: string | null\n  /** The status as it reads today - OVERDUE for an open one past its due day. */\n  state: string\n  units: number\n  unitsDone: number\n  versionNumber: number | null\n}\n\n/** The working employee record of each user given - for the department a row names. */\nasync function employeesOf(tx: EntityManager, domain: { id: string }, userIds: string[]): Promise<Map<string, Employee>> {\n  if (!userIds.length) return new Map()\n  const rows = await tx.getRepository(Employee).find({ where: { domain: { id: domain.id }, user: { id: In(userIds) } } as any, relations: ['department'] })\n  const out = new Map<string, Employee>()\n  for (const row of rows) if (row.active !== false && (!out.has(row.userId!) || out.get(row.userId!)!.active === false)) out.set(row.userId!, row)\n  return out\n}\n\n/** The rows of the enrolments given - each with its person, course, department, state today and units done. */\nexport async function rowsOf(tx: EntityManager, domain: any, enrollments: Enrollment[]): Promise<StatusRow[]> {\n  if (!enrollments.length) return []\n  const today = todayIn(domain)\n  const users = await tx.getRepository(User).find({ where: { id: In([...new Set(enrollments.map(one => one.userId!))]) } })\n  const courses = await tx.getRepository(Course).find({ where: { id: In([...new Set(enrollments.map(one => one.courseId!))]) } as any })\n  const employees = await employeesOf(tx, domain, users.map(one => one.id))\n  const versionIds = new Set<string>()\n  const shown = new Map<string, string | null>()\n  for (const enrollment of enrollments) {\n    const id = enrollment.versionId ?? (await publishedVersionOf(tx, domain, enrollment.courseId!))?.id ?? null\n    shown.set(enrollment.id, id)\n    if (id) versionIds.add(id)\n  }\n  const versions = versionIds.size ? await tx.getRepository(CourseVersion).find({ where: { id: In([...versionIds]) } as any, withDeleted: true }) : []\n  const units = versionIds.size ? (await tx.getRepository(CourseUnit).find({ where: { version: { id: In([...versionIds]) } } as any })).filter(counts) : []\n  const progress = await tx.getRepository(UnitProgress).find({ where: { enrollment: { id: In(enrollments.map(one => one.id)) } } as any })\n  return enrollments.map(enrollment => {\n    const versionId = shown.get(enrollment.id)\n    const mine = units.filter(unit => unit.versionId === versionId)\n    return {\n      enrollment,\n      user: users.find(one => one.id === enrollment.userId) ?? null,\n      course: courses.find(one => one.id === enrollment.courseId) ?? null,\n      departmentName: employees.get(enrollment.userId!)?.department?.name ?? null,\n      state: overdue(enrollment, today) ? 'OVERDUE' : enrollment.status,\n      units: mine.length,\n      unitsDone: mine.filter(unit => progress.some(one => one.enrollmentId === enrollment.id && one.unitId === unit.id && one.doneAt)).length,\n      versionNumber: enrollment.versionId ? (versions.find(one => one.id === enrollment.versionId)?.number ?? null) : null\n    }\n  })\n}\n\n/** The departments the request's person heads, with those under them - none for anyone else. */\nexport async function headedDepartmentsOf(context: any): Promise<string[]> {\n  const { domain, user } = context.state\n  const tx = learningManagerOf(context)\n  const me = (await employeesOf(tx, domain, [user.id])).get(user.id)\n  if (!me) return []\n  const managed = await tx.getRepository(Department).find({ where: { domain: { id: domain.id }, manager: { id: me.id } } as any })\n  if (!managed.length) return []\n  return withDescendants(managed.map(one => one.id), await departmentTreeOf(domain, tx))\n}\n\n/** An enrolment as a department head reads it - where it stands and its days, nothing of how it went. */\nexport function statusOnly(enrollment: Enrollment): Enrollment {\n  const { score, attempts, learnedSeconds, acknowledgedAt, certificateNo, cancelReason, ...kept } = enrollment as any\n  return { ...kept, score: null, attempts: null, learnedSeconds: null, acknowledgedAt: null, certificateNo: null, cancelReason: null } as Enrollment\n}\n\n/** The completion register of a course - every completed enrolment, by completion day (decision 10). */\nexport async function completionRegister(courseId: string, context: any): Promise<StatusRow[]> {\n  const { domain } = context.state\n  const tx = learningManagerOf(context)\n  const enrollments = await tx.getRepository(Enrollment).find({ where: { domain: { id: domain.id }, course: { id: courseId }, status: EnrollmentStatus.COMPLETED } as any, order: { completedAt: 'ASC' } as any })\n  return await rowsOf(tx, domain, enrollments)\n}\n\n\n/* ================================================================ the list rule */\n\n/** Where an enrolment stands as a list shows it - OVERDUE is an open one past its due day, read on the day. */\nexport const ENROLLMENT_STATES = ['ASSIGNED', 'IN_PROGRESS', 'COMPLETED', 'OVERDUE', 'CANCELLED'] as const\n\n/**\n * Whose enrolments a request reads (decision 11): a manager everyone's; a department head the people of their\n * departments - open and completed ones, status only; anyone else their own.\n */\nexport type EnrollmentReach = { kind: 'all' } | { kind: 'team'; userIds: string[] } | { kind: 'own'; userId: string }\n\n/** The people of the request's departments, refused to anyone who heads none. */\nexport async function teamReachOf(context: any): Promise<EnrollmentReach> {\n  const { domain } = context.state\n  const headed = await headedDepartmentsOf(context)\n  if (!headed.length) throw new Refusal('learning-not-a-department-head', {}, 'only a department head reads where their people stand')\n  const people = await learningManagerOf(context).getRepository(Employee).find({ where: { domain: { id: domain.id }, department: { id: In(headed) } } as any })\n  return { kind: 'team', userIds: [...new Set(people.filter(one => one.active !== false && one.userId).map(one => one.userId!))] }\n}\n\n/** The widest reach the request has - a manager's, a department head's, or their own. */\nexport async function reachOf(context: any): Promise<EnrollmentReach> {\n  if (await requestHolds(context, 'course', 'query')) return { kind: 'all' }\n  if ((await headedDepartmentsOf(context)).length) return await teamReachOf(context)\n  return { kind: 'own', userId: context.state.user.id }\n}\n\n/*\n * The list's names (getQueryBuilderFromListParams): `course` a course id, `learner` and `courseName` the words a search\n * reads, `sourceKind` and `sourceId` who asked. `state` is not a column - narrowed below.\n */\nconst LIST = {\n  alias: 'E',\n  searchables: ['learner', 'courseName'],\n  columnExpressions: { course: 'C.id', learner: 'U.name', courseName: 'C.name' },\n  sortables: ['dueOn', 'createdAt', 'startedAt', 'completedAt', 'learner', 'courseName'],\n  defaultSortings: [{ name: 'dueOn' }, { name: 'createdAt' }]\n}\n\nconst valuesOf = (filter: Filter) => (Array.isArray(filter.value) ? filter.value : [filter.value]).map(String).filter(Boolean)\n\n/** The SQL of the states named - the parameters keyed apart so two conditions in one query never meet. */\nfunction stateClause(states: string[], today: string, key: string): { sql: string; parameters: Record<string, any> } | null {\n  const parameters: Record<string, any> = { [`${key}Open`]: OPEN_ENROLLMENT_STATUSES, [`${key}Today`]: today }\n  const parts = states\n    .filter(state => (ENROLLMENT_STATES as readonly string[]).includes(state))\n    .map((state, i) => {\n      if (state === 'OVERDUE') return `(E.status IN (:...${key}Open) AND E.dueOn IS NOT NULL AND E.dueOn < :${key}Today)`\n      parameters[`${key}S${i}`] = state\n      if ((OPEN_ENROLLMENT_STATUSES as string[]).includes(state)) return `(E.status = :${key}S${i} AND (E.dueOn IS NULL OR E.dueOn >= :${key}Today))`\n      return `E.status = :${key}S${i}`\n    })\n  return parts.length ? { sql: `(${parts.join(' OR ')})`, parameters } : null\n}\n\nlet narrowSeq = 0\n\n/** The joins the list's names read, the reach, and the `state` filter as SQL. */\nfunction narrow(builder: SelectQueryBuilder<Enrollment>, reach: EnrollmentReach, state: Filter | undefined, today: string, extra?: (builder: SelectQueryBuilder<Enrollment>) => void): void {\n  const key = `learningList${narrowSeq++}`\n  builder.leftJoin('E.user', 'U').leftJoin('E.course', 'C')\n  if (reach.kind === 'own') builder.andWhere(`U.id = :${key}Me`, { [`${key}Me`]: reach.userId })\n  if (reach.kind === 'team') {\n    if (!reach.userIds.length) builder.andWhere('1 = 0')\n    else builder.andWhere(`U.id IN (:...${key}Team)`, { [`${key}Team`]: reach.userIds }).andWhere(`E.status IN (:...${key}Shown)`, { [`${key}Shown`]: [...OPEN_ENROLLMENT_STATUSES, EnrollmentStatus.COMPLETED] })\n  }\n  const clause = state ? stateClause(valuesOf(state), today, `${key}State`) : null\n  if (clause) builder.andWhere(['noteq', 'notin'].includes(state!.operator) ? `NOT ${clause.sql}` : clause.sql, clause.parameters)\n  extra?.(builder)\n}\n\n/** The filters but `state`, and the `state` one. */\nfunction splitState(params: ListParam | undefined): { rest: Filter[]; state?: Filter } {\n  const filters = params?.filters ?? []\n  return { rest: filters.filter(one => one.name !== 'state'), state: filters.find(one => one.name === 'state') }\n}\n\n/**\n * One page of the enrolments a list asks for, within a reach - its conditions, search, sort and page by the framework's\n * list rule, the rows then read with their people, courses and units. A department head's rows are status only.\n */\nexport async function enrollmentPage(params: ListParam, reach: EnrollmentReach, context: any, extra?: (builder: SelectQueryBuilder<Enrollment>) => void): Promise<{ rows: StatusRow[]; total: number }> {\n  const { domain } = context.state\n  const tx = learningManagerOf(context)\n  const { rest, state } = splitState(params)\n  const builder = getQueryBuilderFromListParams({ ...LIST, repository: tx.getRepository(Enrollment), params: { ...params, filters: rest }, domain })\n  narrow(builder, reach, state, todayIn(domain), extra)\n  const [enrollments, total] = await builder.getManyAndCount()\n  const rows = await rowsOf(tx, domain, enrollments)\n  return { rows: reach.kind === 'team' ? rows.map(row => ({ ...row, enrollment: statusOnly(row.enrollment) })) : rows, total }\n}\n\n/** How many enrolments stand in each state under the list's other conditions - every state, in order. */\nexport async function enrollmentStateCounts(params: ListParam, reach: EnrollmentReach, context: any): Promise<ListValueCount[]> {\n  const { domain } = context.state\n  const tx = learningManagerOf(context)\n  const today = todayIn(domain)\n  const { rest } = splitState(params)\n  const common = { ...LIST, repository: tx.getRepository(Enrollment), domain, params: { filters: rest, search: params?.search, inherited: params?.inherited }, field: 'status' }\n  const all = await countListByField({ ...common, narrow: builder => narrow(builder, reach, undefined, today) })\n  const late = await countListByField({ ...common, narrow: builder => narrow(builder, reach, { name: 'state', operator: 'eq', value: 'OVERDUE' } as Filter, today) })\n  const overdueCount = [...late.values()].reduce((sum, one) => sum + one, 0)\n  return ENROLLMENT_STATES.map(value => ({ value, count: value === 'OVERDUE' ? overdueCount : (all.get(value) ?? 0) - (late.get(value) ?? 0) }))\n}\n"]}

package/dist-server/service/enrollment/enrollment-type.d.ts

@@ -0,0 +1,82 @@
+import { User } from '@things-factory/auth-base';
+import { Course } from '../course/course';
+import { CourseUnit } from '../course/course-unit';
+import { Enrollment } from './enrollment';
+import { UnitProgress } from './unit-progress';
+export declare class LearningUnit {
+    unit: CourseUnit;
+    progress?: UnitProgress | null;
+    counts: boolean;
+}
+export declare class QuizChoiceView {
+    id: string;
+    text: string;
+}
+export declare class QuizQuestionView {
+    id: string;
+    kind: string;
+    text: string;
+    choices: QuizChoiceView[];
+}
+export declare class QuizAttemptView {
+    attemptId: string;
+    questions: QuizQuestionView[];
+}
+export declare class QuizResultView {
+    score: number;
+    passed: boolean;
+    attemptsLeft?: number | null;
+    enrollment: Enrollment;
+}
+export declare class LearningTickResult {
+    enrollment: Enrollment;
+    progress: UnitProgress;
+}
+export declare class EnrollmentStatusRow {
+    id: string;
+    enrollment: Enrollment;
+    user?: User | null;
+    course?: Course | null;
+    departmentName?: string | null;
+    state: string;
+    units: number;
+    unitsDone: number;
+    versionNumber?: number | null;
+}
+export declare class EnrollmentStatusList {
+    items: EnrollmentStatusRow[];
+    total: number;
+}
+export declare class LearningAudienceInput {
+    scope: string;
+    targetId: string;
+    targetName?: string;
+}
+export declare class LearningEnrollmentRow {
+    id: string;
+    learner: string;
+    departmentName?: string | null;
+    course: string;
+    state: string;
+    dueOn?: string | null;
+    daysLeft?: number | null;
+    startedAt?: Date | null;
+    completedAt?: Date | null;
+    unitsDone: number;
+    units: number;
+}
+export declare class LearningEnrollmentList {
+    items: LearningEnrollmentRow[];
+    total: number;
+}
+export declare class LearningContentUnit {
+    seq: number;
+    kind: string;
+    name: string;
+    text?: string | null;
+}
+export declare class LearningContent {
+    course: string;
+    version: number;
+    units: LearningContentUnit[];
+}

package/dist-server/service/enrollment/enrollment-type.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LearningContent = exports.LearningContentUnit = exports.LearningEnrollmentList = exports.LearningEnrollmentRow = exports.LearningAudienceInput = exports.EnrollmentStatusList = exports.EnrollmentStatusRow = exports.LearningTickResult = exports.QuizResultView = exports.QuizAttemptView = exports.QuizQuestionView = exports.QuizChoiceView = exports.LearningUnit = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const auth_base_1 = require("@things-factory/auth-base");
+const course_1 = require("../course/course");
+const course_unit_1 = require("../course/course-unit");
+const enrollment_1 = require("./enrollment");
+const unit_progress_1 = require("./unit-progress");
+let LearningUnit = class LearningUnit {
+};
+exports.LearningUnit = LearningUnit;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => course_unit_1.CourseUnit, { description: 'The unit.' }),
+    tslib_1.__metadata("design:type", course_unit_1.CourseUnit)
+], LearningUnit.prototype, "unit", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => unit_progress_1.UnitProgress, { nullable: true, description: 'How far the learner went - none before they started it.' }),
+    tslib_1.__metadata("design:type", unit_progress_1.UnitProgress)
+], LearningUnit.prototype, "progress", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Whether it counts toward completion - a link does not.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], LearningUnit.prototype, "counts", void 0);
+exports.LearningUnit = LearningUnit = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A unit as its learner sees it - with how far they went through it' })
+], LearningUnit);
+let QuizChoiceView = class QuizChoiceView {
+};
+exports.QuizChoiceView = QuizChoiceView;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The choice id.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizChoiceView.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'What it says.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizChoiceView.prototype, "text", void 0);
+exports.QuizChoiceView = QuizChoiceView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A choice as a learner is drawn it - never whether it is right' })
+], QuizChoiceView);
+let QuizQuestionView = class QuizQuestionView {
+};
+exports.QuizQuestionView = QuizQuestionView;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The question id.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizQuestionView.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'SINGLE, MULTIPLE or TRUE_FALSE.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizQuestionView.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'What it asks.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizQuestionView.prototype, "text", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [QuizChoiceView], { description: 'Its choices, shuffled.' }),
+    tslib_1.__metadata("design:type", Array)
+], QuizQuestionView.prototype, "choices", void 0);
+exports.QuizQuestionView = QuizQuestionView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A question as a learner is drawn it - its choices in the order shown, no answer' })
+], QuizQuestionView);
+let QuizAttemptView = class QuizAttemptView {
+};
+exports.QuizAttemptView = QuizAttemptView;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The attempt id - its answers are sent with it.' }),
+    tslib_1.__metadata("design:type", String)
+], QuizAttemptView.prototype, "attemptId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [QuizQuestionView], { description: 'The questions drawn, shuffled.' }),
+    tslib_1.__metadata("design:type", Array)
+], QuizAttemptView.prototype, "questions", void 0);
+exports.QuizAttemptView = QuizAttemptView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'An attempt as a learner is drawn it' })
+], QuizAttemptView);
+let QuizResultView = class QuizResultView {
+};
+exports.QuizResultView = QuizResultView;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The score, out of 100.' }),
+    tslib_1.__metadata("design:type", Number)
+], QuizResultView.prototype, "score", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Whether it passed.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], QuizResultView.prototype, "passed", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Attempts left - no limit when empty.' }),
+    tslib_1.__metadata("design:type", Number)
+], QuizResultView.prototype, "attemptsLeft", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => enrollment_1.Enrollment, { description: 'The enrolment after it - completed when nothing else is missing.' }),
+    tslib_1.__metadata("design:type", enrollment_1.Enrollment)
+], QuizResultView.prototype, "enrollment", void 0);
+exports.QuizResultView = QuizResultView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: "An attempt's result - the score and whether it passed; never the right answers" })
+], QuizResultView);
+let LearningTickResult = class LearningTickResult {
+};
+exports.LearningTickResult = LearningTickResult;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => enrollment_1.Enrollment, { description: 'The enrolment.' }),
+    tslib_1.__metadata("design:type", enrollment_1.Enrollment)
+], LearningTickResult.prototype, "enrollment", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => unit_progress_1.UnitProgress, { description: "The unit's progress." }),
+    tslib_1.__metadata("design:type", unit_progress_1.UnitProgress)
+], LearningTickResult.prototype, "progress", void 0);
+exports.LearningTickResult = LearningTickResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: "A tick's result - the unit's progress and the enrolment after it" })
+], LearningTickResult);
+let EnrollmentStatusRow = class EnrollmentStatusRow {
+};
+exports.EnrollmentStatusRow = EnrollmentStatusRow;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The enrolment id.' }),
+    tslib_1.__metadata("design:type", String)
+], EnrollmentStatusRow.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => enrollment_1.Enrollment, { description: 'The enrolment - for a department head its status and days only.' }),
+    tslib_1.__metadata("design:type", enrollment_1.Enrollment)
+], EnrollmentStatusRow.prototype, "enrollment", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who takes it.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], EnrollmentStatusRow.prototype, "user", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => course_1.Course, { nullable: true, description: 'The course.' }),
+    tslib_1.__metadata("design:type", course_1.Course)
+], EnrollmentStatusRow.prototype, "course", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Their department.' }),
+    tslib_1.__metadata("design:type", String)
+], EnrollmentStatusRow.prototype, "departmentName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'ASSIGNED, IN_PROGRESS, COMPLETED, CANCELLED, or OVERDUE for an open one past its due day.' }),
+    tslib_1.__metadata("design:type", String)
+], EnrollmentStatusRow.prototype, "state", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The units that count.' }),
+    tslib_1.__metadata("design:type", Number)
+], EnrollmentStatusRow.prototype, "units", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The units done.' }),
+    tslib_1.__metadata("design:type", Number)
+], EnrollmentStatusRow.prototype, "unitsDone", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The version taken.' }),
+    tslib_1.__metadata("design:type", Number)
+], EnrollmentStatusRow.prototype, "versionNumber", void 0);
+exports.EnrollmentStatusRow = EnrollmentStatusRow = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One enrolment as the status reads it' })
+], EnrollmentStatusRow);
+let EnrollmentStatusList = class EnrollmentStatusList {
+};
+exports.EnrollmentStatusList = EnrollmentStatusList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [EnrollmentStatusRow], { description: 'The enrolments of the page.' }),
+    tslib_1.__metadata("design:type", Array)
+], EnrollmentStatusList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many there are under the conditions.' }),
+    tslib_1.__metadata("design:type", Number)
+], EnrollmentStatusList.prototype, "total", void 0);
+exports.EnrollmentStatusList = EnrollmentStatusList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of enrolments as the status reads them' })
+], EnrollmentStatusList);
+let LearningAudienceInput = class LearningAudienceInput {
+};
+exports.LearningAudienceInput = LearningAudienceInput;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'DOMAIN | DEPARTMENT | ROLE | USER.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningAudienceInput.prototype, "scope", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The id of the domain, department, role or user.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningAudienceInput.prototype, "targetId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Its name, as shown.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningAudienceInput.prototype, "targetName", void 0);
+exports.LearningAudienceInput = LearningAudienceInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'One target of an audience - the domain, a department (with those under it), a role or a person' })
+], LearningAudienceInput);
+let LearningEnrollmentRow = class LearningEnrollmentRow {
+};
+exports.LearningEnrollmentRow = LearningEnrollmentRow;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The enrolment id.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Who takes it.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "learner", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Their department.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "departmentName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The course.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "course", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'ASSIGNED, IN_PROGRESS, COMPLETED or OVERDUE.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "state", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'YYYY-MM-DD it is due.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningEnrollmentRow.prototype, "dueOn", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Days to the due day - negative past it.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningEnrollmentRow.prototype, "daysLeft", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When it was started.' }),
+    tslib_1.__metadata("design:type", Date)
+], LearningEnrollmentRow.prototype, "startedAt", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When it was completed.' }),
+    tslib_1.__metadata("design:type", Date)
+], LearningEnrollmentRow.prototype, "completedAt", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Units done.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningEnrollmentRow.prototype, "unitsDone", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Units that count.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningEnrollmentRow.prototype, "units", void 0);
+exports.LearningEnrollmentRow = LearningEnrollmentRow = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'An enrolment as the assistant lists it' })
+], LearningEnrollmentRow);
+let LearningEnrollmentList = class LearningEnrollmentList {
+};
+exports.LearningEnrollmentList = LearningEnrollmentList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [LearningEnrollmentRow], { description: 'The enrolments.' }),
+    tslib_1.__metadata("design:type", Array)
+], LearningEnrollmentList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many there are.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningEnrollmentList.prototype, "total", void 0);
+exports.LearningEnrollmentList = LearningEnrollmentList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of enrolments as the assistant lists them' })
+], LearningEnrollmentList);
+let LearningContentUnit = class LearningContentUnit {
+};
+exports.LearningContentUnit = LearningContentUnit;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Its place.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningContentUnit.prototype, "seq", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'VIDEO, PDF, MARKDOWN or LINK.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningContentUnit.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Its name.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningContentUnit.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The text of a MARKDOWN unit, the address of a LINK.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningContentUnit.prototype, "text", void 0);
+exports.LearningContentUnit = LearningContentUnit = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A unit as the assistant reads it' })
+], LearningContentUnit);
+let LearningContent = class LearningContent {
+};
+exports.LearningContent = LearningContent;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The course.' }),
+    tslib_1.__metadata("design:type", String)
+], LearningContent.prototype, "course", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'The version number.' }),
+    tslib_1.__metadata("design:type", Number)
+], LearningContent.prototype, "version", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [LearningContentUnit], { description: 'Its units.' }),
+    tslib_1.__metadata("design:type", Array)
+], LearningContent.prototype, "units", void 0);
+exports.LearningContent = LearningContent = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'The units of one course version, as the assistant reads them' })
+], LearningContent);
+//# sourceMappingURL=enrollment-type.js.map