@things-factory/learning 0.0.0-stage → 10.1.261

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

@@ -0,0 +1,427 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOpen = exports.certificateNoOf = exports.todayIn = exports.learningAddressOf = exports.DIRECT_SOURCE_KIND = void 0;
+exports.enroll = enroll;
+exports.withdraw = withdraw;
+exports.cancelEnrollment = cancelEnrollment;
+exports.learnersOf = learnersOf;
+exports.enrollmentOf = enrollmentOf;
+exports.myEnrollmentOf = myEnrollmentOf;
+exports.shownVersionOf = shownVersionOf;
+exports.progressesOf = progressesOf;
+exports.missingFor = missingFor;
+exports.recordTick = recordTick;
+exports.acknowledgeEnrollment = acknowledgeEnrollment;
+exports.forLearner = forLearner;
+exports.startQuizAttempt = startQuizAttempt;
+exports.submitQuizAttempt = submitQuizAttempt;
+exports.completeIfMet = completeIfMet;
+exports.myEnrollments = myEnrollments;
+/*
+ * What the doors of enrolments do with the database (ADR-0194 decisions 5-8): enrolling people for whoever asks and
+ * withdrawing them, the to-do of each, the time the server counts from ticks, the quiz the server scores, the
+ * acknowledgement, and completing an enrolment with its evidence in the same transaction as the handler of whoever
+ * asked. Nothing here deletes an enrolment or its progress.
+ */
+const typeorm_1 = require("typeorm");
+const auth_base_1 = require("@things-factory/auth-base");
+const organization_1 = require("@things-factory/organization");
+const env_1 = require("@things-factory/env");
+const translator_1 = require("@things-factory/i18n-base/translator");
+const shell_1 = require("@things-factory/shell");
+const worklist_1 = require("@things-factory/worklist");
+const activities_1 = require("../../activities");
+const course_question_1 = require("../course/course-question");
+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 learning_outcome_1 = require("./learning-outcome");
+const progress_rules_1 = require("./progress-rules");
+const quiz_attempt_1 = require("./quiz-attempt");
+const unit_progress_1 = require("./unit-progress");
+exports.DIRECT_SOURCE_KIND = 'learning.direct';
+/** The learner's screen of one enrolment - where the to-do leads. */
+const learningAddressOf = (enrollmentId) => `learning-view?id=${enrollmentId}`;
+exports.learningAddressOf = learningAddressOf;
+const todayIn = (domain, now = new Date()) => (0, shell_1.calendarDay)(domain?.timezone, now);
+exports.todayIn = todayIn;
+const notFound = () => new shell_1.Refusal('learning-not-found', {}, 'the record was not found. reload and try again.');
+const isOpen = (status) => enrollment_1.OPEN_ENROLLMENT_STATUSES.includes(status);
+exports.isOpen = isOpen;
+/* ---------------------------------------------------------------- the to-do (decision 5) */
+/** The to-do is issued as its own assignee: nobody else hands it out. worklist speaks its refusals through `t`. */
+function todoContextOf(tx, domain, user) {
+    const t = (0, translator_1.translatorFor)(user.locale || 'ko');
+    return { state: { domain, user, tx }, t: (key, options) => t(key, options) };
+}
+/** Hands out 「<과정> 수강」 to the person, with the due day - nothing where the domain has not installed the to-do. */
+async function issueTodo(tx, domain, enrollment, course, person) {
+    const activity = await tx.getRepository(worklist_1.Activity).findOne({ where: { domain: { id: domain.id }, name: activities_1.LEARNING_COURSE_ACTIVITY } });
+    if (!activity) {
+        env_1.logger.warn(`[learning] ${domain.subdomain}: the activity "${activities_1.LEARNING_COURSE_ACTIVITY}" is not installed - "${course.name}" not handed out`);
+        return null;
+    }
+    const t = (0, translator_1.translatorFor)(person.locale || 'ko');
+    const name = t('text.learning-todo-name', { course: course.name });
+    const headline = enrollment.dueOn ? t('text.learning-todo-headline', { dueOn: enrollment.dueOn }) : t('text.learning-todo-headline-no-due');
+    const dueAt = enrollment.dueOn ? dueAtOf(enrollment.dueOn, domain.timezone) : undefined;
+    const context = todoContextOf(tx, domain, person);
+    const input = { enrollmentId: enrollment.id, headline, address: (0, exports.learningAddressOf)(enrollment.id) };
+    const instance = await (0, worklist_1.issue)({ name, description: headline, activityId: activity.id, input, assignees: [], threadsMin: 0, dueAt }, context);
+    await (0, worklist_1.assign)({ id: instance.id, assignees: [person.email], dueAt, reason: name }, context);
+    return instance.id;
+}
+/** The end of the due day in the domain's time zone. */
+function dueAtOf(dueOn, timezone) {
+    const end = new Date(`${dueOn}T23:59:59Z`);
+    const zone = timezone || 'UTC';
+    const asLocal = new Date(end.toLocaleString('en-US', { timeZone: zone }));
+    const asUtc = new Date(end.toLocaleString('en-US', { timeZone: 'UTC' }));
+    return new Date(end.getTime() - (asLocal.getTime() - asUtc.getTime()));
+}
+async function todoOpen(tx, instanceId) {
+    return (await tx.getRepository(worklist_1.ActivityThread).count({ where: { activityInstance: { id: instanceId }, state: (0, typeorm_1.In)(['assigned', 'started', 'unassigned']) } })) > 0;
+}
+/** Ends the to-do as done once the course is completed. */
+async function completeTodo(tx, domain, enrollment, by) {
+    if (!enrollment.todoInstanceId || !(await todoOpen(tx, enrollment.todoInstanceId)))
+        return;
+    await (0, worklist_1.complete)({ id: enrollment.todoInstanceId, reason: 'course completed' }, todoContextOf(tx, domain, by));
+}
+/** Aborts the to-do of an enrolment withdrawn or cancelled. */
+async function abortTodo(tx, domain, enrollment, by, reason) {
+    if (!enrollment.todoInstanceId || !(await todoOpen(tx, enrollment.todoInstanceId)))
+        return;
+    await (0, worklist_1.abort)({ id: enrollment.todoInstanceId, reason }, todoContextOf(tx, domain, by));
+}
+/* ---------------------------------------------------------------- enrolling and withdrawing (decision 7) */
+/**
+ * Enrols people in a course for whoever asks (`source`), to be completed by `dueOn` - the server function a using module
+ * calls with the people it chose. One open enrolment per person, course and source: a person who has one is left with
+ * it. Each new enrolment hands out its to-do. Answers the open enrolments of everyone given.
+ */
+async function enroll(source, userIds, courseId, dueOn, context) {
+    const { domain, user, tx } = context.state;
+    if (!source?.kind)
+        throw new shell_1.Refusal('learning-source-required', {}, 'an enrolment names who asked for it');
+    if (dueOn && !/^\d{4}-\d{2}-\d{2}$/.test(dueOn))
+        throw new shell_1.Refusal('learning-due-invalid', {}, 'the due day is YYYY-MM-DD');
+    const course = await (0, course_service_1.courseOf)(tx, domain, courseId);
+    if (!(await (0, course_service_1.publishedVersionOf)(tx, domain, course.id)))
+        throw new shell_1.Refusal('learning-course-not-published', { course: course.name }, `${course.name} has no published version`);
+    const ids = [...new Set(userIds)].filter(Boolean);
+    if (!ids.length)
+        return [];
+    const people = await tx.getRepository(auth_base_1.User).find({ where: { id: (0, typeorm_1.In)(ids) }, relations: ['domains'] });
+    const sourceId = source.id ?? '';
+    const repository = tx.getRepository(enrollment_1.Enrollment);
+    const out = [];
+    for (const id of ids) {
+        const person = people.find(one => one.id === id);
+        if (!person || !(person.domains ?? []).some(one => one.id === domain.id))
+            throw new shell_1.Refusal('learning-learner-unknown', {}, 'a learner must be a user of this domain');
+        const open = await repository.findOne({ where: { domain: { id: domain.id }, user: { id }, course: { id: course.id }, sourceKind: source.kind, sourceId, status: (0, typeorm_1.In)(enrollment_1.OPEN_ENROLLMENT_STATUSES) } });
+        if (open) {
+            out.push(open);
+            continue;
+        }
+        const saved = await repository.save({ domain, user: person, course, dueOn: dueOn || null, sourceKind: source.kind, sourceId, status: enrollment_1.EnrollmentStatus.ASSIGNED, learnedSeconds: 0, attempts: 0, creator: user, updater: user });
+        const todo = await issueTodo(tx, domain, saved, course, person);
+        if (todo)
+            await repository.update(saved.id, { todoInstanceId: todo });
+        out.push((await repository.findOneBy({ id: saved.id })));
+    }
+    return out;
+}
+/**
+ * Withdraws the open enrolments a source asked for - the record they were for was taken back. Each is cancelled with
+ * the reason and its to-do aborted; completed ones stay. Answers how many were withdrawn.
+ */
+async function withdraw(source, reason, context) {
+    const { domain, user, tx } = context.state;
+    const rows = await tx.getRepository(enrollment_1.Enrollment).find({ where: { domain: { id: domain.id }, sourceKind: source.kind, sourceId: source.id ?? '', status: (0, typeorm_1.In)(enrollment_1.OPEN_ENROLLMENT_STATUSES) } });
+    let count = 0;
+    for (const row of rows)
+        if (await cancelOpen(tx, domain, row, user, reason))
+            count++;
+    return count;
+}
+/** Cancels an open enrolment - claimed by an update only an open one matches, so a completion at the same time wins once. */
+async function cancelOpen(tx, domain, row, by, reason) {
+    const claimed = await tx.getRepository(enrollment_1.Enrollment).update({ id: row.id, status: (0, typeorm_1.In)(enrollment_1.OPEN_ENROLLMENT_STATUSES) }, { status: enrollment_1.EnrollmentStatus.CANCELLED, cancelledAt: new Date(), cancelReason: reason, updater: by });
+    if (!claimed.affected)
+        return false;
+    await abortTodo(tx, domain, row, by, reason);
+    return true;
+}
+/**
+ * A manager cancels an enrolment with a reason (decision 8). An open one is withdrawn; a completed one stays on record as
+ * cancelled - never deleted - and whoever asked for it is told in the same transaction.
+ */
+async function cancelEnrollment(id, reason, context) {
+    const { domain, user, tx } = context.state;
+    if (!reason?.trim())
+        throw new shell_1.Refusal('learning-cancel-reason-required', {}, 'say why it is cancelled');
+    const row = await enrollmentOf(tx, domain, id);
+    if (isOpen(row.status)) {
+        if (!(await cancelOpen(tx, domain, row, user, reason.trim())))
+            throw new shell_1.Refusal('learning-enrollment-moved', {}, 'the enrolment changed meanwhile - reload and try again');
+    }
+    else if (row.status === enrollment_1.EnrollmentStatus.COMPLETED) {
+        const claimed = await tx.getRepository(enrollment_1.Enrollment).update({ id: row.id, status: enrollment_1.EnrollmentStatus.COMPLETED }, { status: enrollment_1.EnrollmentStatus.CANCELLED, cancelledAt: new Date(), cancelReason: reason.trim(), updater: user });
+        if (!claimed.affected)
+            throw new shell_1.Refusal('learning-enrollment-moved', {}, 'the enrolment changed meanwhile - reload and try again');
+        await (0, learning_outcome_1.learningOutcomeOf)(row.sourceKind)?.cancelled?.((await enrollmentOf(tx, domain, id)), reason.trim(), context);
+    }
+    else
+        throw new shell_1.Refusal('learning-enrollment-cancelled', {}, 'the enrolment is cancelled already');
+    return await enrollmentOf(tx, domain, id);
+}
+/**
+ * The people an audience names now - the domain, departments with those under them, roles and people, by organization's
+ * one rule (ADR-0163). Each target must be of this domain.
+ */
+async function learnersOf(audiences, context) {
+    const { domain, tx } = context.state;
+    if (!audiences?.length)
+        throw new shell_1.Refusal('learning-audience-required', {}, 'pick who takes the course');
+    const departmentIds = [...(await (0, organization_1.departmentTreeOf)(domain, tx)).keys()];
+    const roleIds = (await (0, organization_1.domainRolesOf)(domain, undefined, tx)).map(one => one.id);
+    for (const target of audiences) {
+        const why = (0, organization_1.audienceTargetRefusal)(target, { domainId: domain.id, departmentIds, roleIds });
+        if (why)
+            throw new shell_1.Refusal('learning-audience-invalid', { target: target.targetName ?? target.targetId }, `${target.targetName ?? target.targetId} is not of this domain (${why})`);
+    }
+    return await (0, organization_1.audienceUserIds)(domain, audiences, tx);
+}
+/* ---------------------------------------------------------------- reading */
+async function enrollmentOf(tx, domain, id) {
+    const row = id && /^[0-9a-f-]{36}$/i.test(id) ? await tx.getRepository(enrollment_1.Enrollment).findOne({ where: { id, domain: { id: domain.id } } }) : null;
+    if (!row)
+        throw notFound();
+    return row;
+}
+/** The request's own enrolment - one answer for "none" and "not yours". */
+async function myEnrollmentOf(context, id, tx = (0, course_service_1.learningManagerOf)(context)) {
+    const row = await enrollmentOf(tx, context.state.domain, id);
+    if (row.userId !== context.state.user.id)
+        throw notFound();
+    return row;
+}
+/** The version an enrolment shows: its own once started, the published one before. */
+async function shownVersionOf(tx, domain, enrollment) {
+    if (enrollment.versionId)
+        return await tx.getRepository(course_version_1.CourseVersion).findOne({ where: { id: enrollment.versionId }, withDeleted: true });
+    return await (0, course_service_1.publishedVersionOf)(tx, domain, enrollment.courseId);
+}
+async function progressesOf(tx, enrollmentId) {
+    return await tx.getRepository(unit_progress_1.UnitProgress).find({ where: { enrollment: { id: enrollmentId } } });
+}
+/** What still stands between an enrolment and its completion - nothing for a completed one. */
+async function missingFor(tx, domain, enrollment) {
+    if (enrollment.status === enrollment_1.EnrollmentStatus.COMPLETED)
+        return [];
+    const version = await shownVersionOf(tx, domain, enrollment);
+    if (!version)
+        return ['units'];
+    const units = (await (0, course_service_1.unitsOf)(tx, version.id)).filter(progress_rules_1.counts);
+    const progress = await progressesOf(tx, enrollment.id);
+    const questions = version.passScore != null ? await tx.getRepository(course_question_1.CourseQuestion).count({ where: { version: { id: version.id } } }) : 0;
+    return (0, progress_rules_1.missingOf)({
+        units: units.length,
+        unitsDone: units.filter(unit => progress.some(one => one.unitId === unit.id && one.doneAt)).length,
+        learnedSeconds: enrollment.learnedSeconds,
+        minSeconds: version.minSeconds ?? 0,
+        quiz: version.passScore != null && questions > 0,
+        passed: enrollment.score != null && enrollment.score >= (version.passScore ?? 101),
+        acknowledgement: !!version.acknowledgement,
+        acknowledged: !!enrollment.acknowledgedAt
+    });
+}
+/* ---------------------------------------------------------------- learning (decision 6) */
+/** The enrolment, started if it was not: its version fixed to the one published now, in progress from now on. */
+async function started(tx, domain, enrollment, user) {
+    if (enrollment.status === enrollment_1.EnrollmentStatus.CANCELLED)
+        throw new shell_1.Refusal('learning-enrollment-cancelled', {}, 'the enrolment is cancelled');
+    if (enrollment.versionId) {
+        if (enrollment.status === enrollment_1.EnrollmentStatus.ASSIGNED)
+            await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id, status: enrollment_1.EnrollmentStatus.ASSIGNED }, { status: enrollment_1.EnrollmentStatus.IN_PROGRESS, startedAt: new Date() });
+        return await enrollmentOf(tx, domain, enrollment.id);
+    }
+    const version = await (0, course_service_1.publishedVersionOf)(tx, domain, enrollment.courseId);
+    if (!version)
+        throw new shell_1.Refusal('learning-course-not-published', {}, 'the course has no published version');
+    await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id, status: (0, typeorm_1.In)(enrollment_1.OPEN_ENROLLMENT_STATUSES) }, { version, status: enrollment_1.EnrollmentStatus.IN_PROGRESS, startedAt: enrollment.startedAt ?? new Date(), updater: user });
+    return await enrollmentOf(tx, domain, enrollment.id);
+}
+async function unitOfVersion(tx, version, unitId) {
+    const unit = await tx.getRepository(course_unit_1.CourseUnit).findOne({ where: { id: unitId, version: { id: version.id } } });
+    if (!unit)
+        throw notFound();
+    return unit;
+}
+/**
+ * One tick of the learner's screen on a unit (decision 6): the server adds the gap since the unit's last tick, at most
+ * 15 seconds and at most what the screen says, and refuses a video position ahead of what was watched. A total the
+ * screen sends is never taken. A unit that reaches its condition is done, and the enrolment is completed when nothing is
+ * missing any more.
+ */
+async function recordTick(enrollmentId, unitId, seconds, position, context, now = new Date()) {
+    const { domain, user, tx } = context.state;
+    let enrollment = await myEnrollmentOf(context, enrollmentId, tx);
+    enrollment = await started(tx, domain, enrollment, user);
+    const unit = await unitOfVersion(tx, { id: enrollment.versionId }, unitId);
+    if (unit.kind === course_unit_1.CourseUnitKind.LINK)
+        throw new shell_1.Refusal('learning-link-not-counted', {}, 'a link is not counted');
+    const repository = tx.getRepository(unit_progress_1.UnitProgress);
+    const progress = (await repository.findOne({ where: { enrollment: { id: enrollment.id }, unit: { id: unit.id } } })) ??
+        (await repository.save({ domain, enrollment, unit, learnedSeconds: 0, watchedSeconds: 0, positionSeconds: 0, pagesSeen: 0, pagesRead: 0, pageSeconds: 0, pageAt: 0, creator: user, updater: user }));
+    if (enrollment.status === enrollment_1.EnrollmentStatus.COMPLETED)
+        return { enrollment, progress };
+    const verdict = (0, progress_rules_1.tickVerdict)(progress, { seconds, position }, now, unit);
+    if ('refusal' in verdict) {
+        if (verdict.refusal === 'page-ahead')
+            throw new shell_1.Refusal('learning-page-ahead', { allowed: verdict.allowed }, `a page cannot be ahead of the one after the last read (${verdict.allowed})`);
+        throw new shell_1.Refusal('learning-position-ahead', { allowed: verdict.allowed }, `the video cannot be ahead of what was watched (${verdict.allowed} s)`);
+    }
+    progress.learnedSeconds += verdict.add;
+    progress.watchedSeconds = verdict.watchedSeconds;
+    progress.positionSeconds = verdict.positionSeconds;
+    progress.pagesSeen = verdict.pagesSeen;
+    progress.pagesRead = verdict.pagesRead;
+    progress.pageSeconds = verdict.pageSeconds;
+    progress.pageAt = verdict.pageAt;
+    progress.lastTickAt = now;
+    if (!progress.doneAt && (0, progress_rules_1.unitDone)(unit, progress))
+        progress.doneAt = now;
+    progress.updater = user;
+    await repository.save(progress);
+    if (verdict.add)
+        await tx.getRepository(enrollment_1.Enrollment).increment({ id: enrollment.id }, 'learnedSeconds', verdict.add);
+    /* Where the learner was - the course opens on this unit again (2026-11-08). */
+    if (enrollment.lastUnitId !== unit.id)
+        await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id }, { lastUnitId: unit.id });
+    enrollment = await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context);
+    return { enrollment, progress };
+}
+/** The learner confirms the version's acknowledgement - recorded once, when they did. */
+async function acknowledgeEnrollment(enrollmentId, context) {
+    const { domain, user, tx } = context.state;
+    let enrollment = await started(tx, domain, await myEnrollmentOf(context, enrollmentId, tx), user);
+    const version = await shownVersionOf(tx, domain, enrollment);
+    if (!version?.acknowledgement)
+        throw new shell_1.Refusal('learning-no-acknowledgement', {}, 'the course asks for no acknowledgement');
+    if (!enrollment.acknowledgedAt)
+        await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id }, { acknowledgedAt: new Date(), updater: user });
+    return await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context);
+}
+/** The questions of an attempt as the learner is drawn them - the choices in the order shown, never whether one is right. */
+function forLearner(attempt, questions) {
+    return {
+        attempt,
+        questions: attempt.drawn.map(drawn => {
+            const question = questions.find(one => one.id === drawn.questionId);
+            return {
+                id: question.id,
+                kind: question.kind,
+                text: question.text,
+                choices: drawn.choiceIds.map(id => question.choices.find(one => one.id === id)).map(one => ({ id: one.id, text: one.text }))
+            };
+        })
+    };
+}
+/**
+ * Starts an attempt at the quiz: the questions drawn and shuffled, their choices shuffled. An attempt not sent yet is
+ * answered again; the version's limit on attempts holds.
+ */
+/**
+ * Holds the enrolment for the rest of the request's transaction - an update takes its row lock on every driver, so two
+ * attempts of one enrolment are started, counted and sent one after the other. Two starts at once made two unsent
+ * attempts, and a limit of one let both be sent (2026-11-08).
+ */
+async function holdEnrollment(tx, domain, enrollment, user) {
+    await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id }, { updater: user });
+    return await enrollmentOf(tx, domain, enrollment.id);
+}
+async function startQuizAttempt(enrollmentId, context) {
+    const { domain, user, tx } = context.state;
+    const held = await holdEnrollment(tx, domain, await myEnrollmentOf(context, enrollmentId, tx), user);
+    const enrollment = await started(tx, domain, held, user);
+    if (enrollment.status === enrollment_1.EnrollmentStatus.COMPLETED)
+        throw new shell_1.Refusal('learning-enrollment-completed', {}, 'the course is completed');
+    const version = (await shownVersionOf(tx, domain, enrollment));
+    const questions = await (0, course_service_1.questionsOf)(tx, version.id);
+    if (version.passScore == null || !questions.length)
+        throw new shell_1.Refusal('learning-no-quiz', {}, 'the course has no quiz');
+    const repository = tx.getRepository(quiz_attempt_1.QuizAttempt);
+    const pending = await repository.findOne({ where: { enrollment: { id: enrollment.id }, submittedAt: (0, typeorm_1.IsNull)() } });
+    if (pending)
+        return forLearner(pending, questions);
+    if (version.attemptLimit != null && enrollment.attempts >= version.attemptLimit)
+        throw new shell_1.Refusal('learning-attempts-used', { limit: version.attemptLimit }, `all ${version.attemptLimit} attempts are used`);
+    const attempt = await repository.save({ domain, enrollment, drawn: (0, progress_rules_1.drawQuestions)(questions, version.questionCount), creator: user, updater: user });
+    return forLearner(attempt, questions);
+}
+/**
+ * Scores an attempt's answers on the server against what it drew (decision 4) - only the score and whether it passed go
+ * back, never the right answers. The best score stays on the enrolment; passing may complete it.
+ */
+async function submitQuizAttempt(attemptId, answers, context) {
+    const { domain, user, tx } = context.state;
+    const attempt = await tx.getRepository(quiz_attempt_1.QuizAttempt).findOne({ where: { id: attemptId, domain: { id: domain.id } } });
+    if (!attempt)
+        throw notFound();
+    const enrollment = await holdEnrollment(tx, domain, await myEnrollmentOf(context, attempt.enrollmentId, tx), user);
+    const version = (await shownVersionOf(tx, domain, enrollment));
+    if (version.attemptLimit != null && enrollment.attempts >= version.attemptLimit)
+        throw new shell_1.Refusal('learning-attempts-used', { limit: version.attemptLimit }, `all ${version.attemptLimit} attempts are used`);
+    const questions = await (0, course_service_1.questionsOf)(tx, version.id);
+    const drawn = attempt.drawn.map(one => questions.find(question => question.id === one.questionId)).filter(Boolean);
+    const kept = Object.fromEntries(drawn.map(question => [question.id, (answers?.[question.id] ?? []).map(String)]));
+    const score = (0, progress_rules_1.scoreOf)(drawn, kept);
+    const passed = score >= (version.passScore ?? 101);
+    const claimed = await tx.getRepository(quiz_attempt_1.QuizAttempt).update({ id: attempt.id, submittedAt: (0, typeorm_1.IsNull)() }, { answers: kept, score, passed, submittedAt: new Date(), updater: user });
+    if (!claimed.affected)
+        throw new shell_1.Refusal('learning-attempt-sent', {}, 'the attempt was sent already');
+    await tx.getRepository(enrollment_1.Enrollment).increment({ id: enrollment.id }, 'attempts', 1);
+    await tx.getRepository(enrollment_1.Enrollment).update({ id: enrollment.id }, { score: Math.max(enrollment.score ?? 0, score), updater: user });
+    const after = await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context);
+    return { enrollment: after, score, passed, attemptsLeft: version.attemptLimit != null ? Math.max(0, version.attemptLimit - after.attempts) : null };
+}
+/* ---------------------------------------------------------------- completing (decision 8) */
+/** A certificate number: the day completed and the enrolment's own id - one per completion, never reused. */
+const certificateNoOf = (enrollment, day) => `LMS-${day.replace(/-/g, '')}-${enrollment.id.replace(/-/g, '').slice(0, 8).toUpperCase()}`;
+exports.certificateNoOf = certificateNoOf;
+/**
+ * Completes an open enrolment when nothing is missing - every unit done, the least time, the quiz passed, the
+ * acknowledgement confirmed. The evidence stays on it; whoever asked for it is told in this same transaction (a handler
+ * that fails takes the completion back), and the to-do ends as done.
+ */
+async function completeIfMet(tx, domain, enrollment, context) {
+    if (!isOpen(enrollment.status) || !enrollment.versionId)
+        return enrollment;
+    if ((await missingFor(tx, domain, enrollment)).length)
+        return enrollment;
+    const now = new Date();
+    const claimed = await tx
+        .getRepository(enrollment_1.Enrollment)
+        .update({ id: enrollment.id, status: (0, typeorm_1.In)(enrollment_1.OPEN_ENROLLMENT_STATUSES) }, { status: enrollment_1.EnrollmentStatus.COMPLETED, completedAt: now, certificateNo: (0, exports.certificateNoOf)(enrollment, (0, exports.todayIn)(domain, now)), updater: context.state.user });
+    if (!claimed.affected)
+        return await enrollmentOf(tx, domain, enrollment.id);
+    const completed = await enrollmentOf(tx, domain, enrollment.id);
+    await (0, learning_outcome_1.learningOutcomeOf)(completed.sourceKind)?.completed(completed, context);
+    await completeTodo(tx, domain, completed, context.state.user);
+    return completed;
+}
+/* ---------------------------------------------------------------- whom an enrolment is for */
+/** The open and completed enrolments of the request's person, the open first and the soonest due first. */
+async function myEnrollments(context) {
+    const { domain, user } = context.state;
+    const rows = await (0, course_service_1.learningManagerOf)(context)
+        .getRepository(enrollment_1.Enrollment)
+        .find({ where: { domain: { id: domain.id }, user: { id: user.id }, status: (0, typeorm_1.In)([...enrollment_1.OPEN_ENROLLMENT_STATUSES, enrollment_1.EnrollmentStatus.COMPLETED]) } });
+    const rank = (one) => (isOpen(one.status) ? 0 : 1);
+    return rows.sort((a, b) => rank(a) - rank(b) || String(a.dueOn ?? '9999').localeCompare(String(b.dueOn ?? '9999')) || +new Date(b.createdAt) - +new Date(a.createdAt));
+}
+//# sourceMappingURL=enrollment-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-service.js","sourceRoot":"","sources":["../../../server/service/enrollment/enrollment-service.ts"],"names":[],"mappings":";;;AAqGA,wBA0BC;AAMD,4BAMC;AAcD,4CAYC;AAMD,gCAUC;AAID,oCAIC;AAGD,wCAIC;AAGD,wCAGC;AAED,oCAEC;AAGD,gCAiBC;AAkCD,gCAiCC;AAGD,sDAOC;AAUD,gCAaC;AAgBD,4CAcC;AAaD,8CAkBC;AAYD,sCAYC;AAKD,sCAOC;AAvaD;;;;;GAKG;AACH,qCAAmD;AAEnD,yDAAgD;AAChD,+DAAsH;AACtH,6CAA4C;AAC5C,qEAAoE;AACpE,iDAA2E;AAC3E,uDAAmG;AAEnG,iDAA2D;AAE3D,+DAA0D;AAC1D,uDAAkE;AAClE,6DAAwD;AACxD,6DAAgH;AAChH,6CAAqF;AACrF,yDAAsD;AACtD,qDAA4G;AAC5G,iDAA4C;AAC5C,mDAA8C;AAQjC,QAAA,kBAAkB,GAAG,iBAAiB,CAAA;AAEnD,qEAAqE;AAC9D,MAAM,iBAAiB,GAAG,CAAC,YAAoB,EAAE,EAAE,CAAC,oBAAoB,YAAY,EAAE,CAAA;AAAhF,QAAA,iBAAiB,qBAA+D;AAEtF,MAAM,OAAO,GAAG,CAAC,MAAoC,EAAE,MAAY,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;AAA9G,QAAA,OAAO,WAAuG;AAE3H,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,eAAO,CAAC,oBAAoB,EAAE,EAAE,EAAE,iDAAiD,CAAC,CAAA;AAC/G,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAAE,qCAAqC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAgYjF,wBAAM;AA9Xf,6FAA6F;AAE7F,mHAAmH;AACnH,SAAS,aAAa,CAAC,EAAiB,EAAE,MAAW,EAAE,IAAU;IAC/D,MAAM,CAAC,GAAG,IAAA,0BAAa,EAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAA;IAC5C,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAW,EAAE,OAAa,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,EAAS,CAAA;AACnG,CAAC;AAED,kHAAkH;AAClH,KAAK,UAAU,SAAS,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,MAAc,EAAE,MAAY;IAC3G,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,mBAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,qCAAwB,EAAS,EAAE,CAAC,CAAA;IAC1I,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,YAAM,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,SAAS,mBAAmB,qCAAwB,yBAAyB,MAAM,CAAC,IAAI,kBAAkB,CAAC,CAAA;QAC5I,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,GAAG,IAAA,0BAAa,EAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAA;IAC3I,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACvF,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAA,yBAAiB,EAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAA;IAClG,MAAM,QAAQ,GAAG,MAAM,IAAA,gBAAK,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAS,EAAE,OAAO,CAAC,CAAA;IAClJ,MAAM,IAAA,iBAAM,EAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IAC1F,OAAO,QAAQ,CAAC,EAAE,CAAA;AACpB,CAAC;AAED,wDAAwD;AACxD,SAAS,OAAO,CAAC,KAAa,EAAE,QAAwB;IACtD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,YAAY,CAAC,CAAA;IAC1C,MAAM,IAAI,GAAG,QAAQ,IAAI,KAAK,CAAA;IAC9B,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IACxE,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,EAAiB,EAAE,UAAkB;IAC3D,OAAO,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,yBAAc,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAA,YAAE,EAAC,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,EAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AACzK,CAAC;AAED,2DAA2D;AAC3D,KAAK,UAAU,YAAY,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,EAAQ;IAC1F,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QAAE,OAAM;IAC1F,MAAM,IAAA,mBAAQ,EAAC,EAAE,EAAE,EAAE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAC9G,CAAC;AAED,+DAA+D;AAC/D,KAAK,UAAU,SAAS,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,EAAQ,EAAE,MAAc;IACvG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QAAE,OAAM;IAC1F,MAAM,IAAA,gBAAK,EAAC,EAAE,EAAE,EAAE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAS,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAC9F,CAAC;AAED,6GAA6G;AAE7G;;;;GAIG;AACI,KAAK,UAAU,MAAM,CAAC,MAAsB,EAAE,OAAiB,EAAE,QAAgB,EAAE,KAAgC,EAAE,OAAY;IACtI,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,IAAI,CAAC,MAAM,EAAE,IAAI;QAAE,MAAM,IAAI,eAAO,CAAC,0BAA0B,EAAE,EAAE,EAAE,qCAAqC,CAAC,CAAA;IAC3G,IAAI,KAAK,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,eAAO,CAAC,sBAAsB,EAAE,EAAE,EAAE,2BAA2B,CAAC,CAAA;IAC3H,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAQ,EAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;IACnD,IAAI,CAAC,CAAC,MAAM,IAAA,mCAAkB,EAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAAE,MAAM,IAAI,eAAO,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,2BAA2B,CAAC,CAAA;IAC9K,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,MAAO,EAAoB,CAAC,aAAa,CAAC,gBAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACvH,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;IAChC,MAAM,UAAU,GAAI,EAAoB,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAA;IAClE,MAAM,GAAG,GAAiB,EAAE,CAAA;IAC5B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,eAAO,CAAC,0BAA0B,EAAE,EAAE,EAAE,yCAAyC,CAAC,CAAA;QACtK,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,qCAAwB,CAAC,EAAS,EAAE,CAAC,CAAA;QACxM,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACd,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,6BAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;QACtO,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/D,IAAI,IAAI;YAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAS,CAAC,CAAA;QAC5E,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,QAAQ,CAAC,MAAsB,EAAE,MAAc,EAAE,OAAY;IACjF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,MAAM,IAAI,GAAG,MAAO,EAAoB,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,qCAAwB,CAAC,EAAS,EAAE,CAAC,CAAA;IAClN,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,IAAI,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;YAAE,KAAK,EAAE,CAAA;IACpF,OAAO,KAAK,CAAA;AACd,CAAC;AAED,6HAA6H;AAC7H,KAAK,UAAU,UAAU,CAAC,EAAiB,EAAE,MAAW,EAAE,GAAe,EAAE,EAAQ,EAAE,MAAc;IACjG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,qCAAwB,CAAC,EAAS,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAS,CAAC,CAAA;IACjO,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IACnC,MAAM,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CAAC,EAAU,EAAE,MAAc,EAAE,OAAY;IAC7E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,eAAO,CAAC,iCAAiC,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAA;IACxG,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IAC9C,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAAE,MAAM,IAAI,eAAO,CAAC,2BAA2B,EAAE,EAAE,EAAE,wDAAwD,CAAC,CAAA;IAC7K,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,SAAS,EAAS,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;QACxO,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,eAAO,CAAC,2BAA2B,EAAE,EAAE,EAAE,wDAAwD,CAAC,CAAA;QACnI,MAAM,IAAA,oCAAiB,EAAC,GAAG,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAE,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IACrH,CAAC;;QAAM,MAAM,IAAI,eAAO,CAAC,+BAA+B,EAAE,EAAE,EAAE,oCAAoC,CAAC,CAAA;IACnG,OAAO,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,UAAU,CAAC,SAAqE,EAAE,OAAY;IAClH,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IACpC,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,MAAM,IAAI,eAAO,CAAC,4BAA4B,EAAE,EAAE,EAAE,2BAA2B,CAAC,CAAA;IACxG,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,MAAM,IAAA,+BAAgB,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,CAAC,MAAM,IAAA,4BAAa,EAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC/E,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAA,oCAAqB,EAAC,MAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAA;QACjG,IAAI,GAAG;YAAE,MAAM,IAAI,eAAO,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,2BAA2B,GAAG,GAAG,CAAC,CAAA;IACrL,CAAC;IACD,OAAO,MAAM,IAAA,8BAAe,EAAC,MAAM,EAAE,SAAgB,EAAE,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,8EAA8E;AAEvE,KAAK,UAAU,YAAY,CAAC,EAAiB,EAAE,MAAsB,EAAE,EAAU;IACtF,MAAM,GAAG,GAAG,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtJ,IAAI,CAAC,GAAG;QAAE,MAAM,QAAQ,EAAE,CAAA;IAC1B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,2EAA2E;AACpE,KAAK,UAAU,cAAc,CAAC,OAAY,EAAE,EAAU,EAAE,KAAoB,IAAA,kCAAiB,EAAC,OAAO,CAAC;IAC3G,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC5D,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,QAAQ,EAAE,CAAA;IAC1D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,sFAAsF;AAC/E,KAAK,UAAU,cAAc,CAAC,EAAiB,EAAE,MAAsB,EAAE,UAAsB;IACpG,IAAI,UAAU,CAAC,SAAS;QAAE,OAAO,MAAM,EAAE,CAAC,aAAa,CAAC,8BAAa,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,SAAS,EAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IACjJ,OAAO,MAAM,IAAA,mCAAkB,EAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,QAAS,CAAC,CAAA;AACnE,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,EAAiB,EAAE,YAAoB;IACxE,OAAO,MAAM,EAAE,CAAC,aAAa,CAAC,4BAAY,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAS,EAAE,CAAC,CAAA;AAC1G,CAAC;AAED,+FAA+F;AACxF,KAAK,UAAU,UAAU,CAAC,EAAiB,EAAE,MAAsB,EAAE,UAAsB;IAChG,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IAC/D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IAC5D,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,CAAC,MAAM,IAAA,wBAAO,EAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAM,CAAC,CAAA;IAC5D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,gCAAc,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjJ,OAAO,IAAA,0BAAS,EAAC;QACf,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAClG,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,IAAI,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,SAAS,GAAG,CAAC;QAChD,MAAM,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI,IAAI,UAAU,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;QAClF,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe;QAC1C,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc;KAC1C,CAAC,CAAA;AACJ,CAAC;AAED,4FAA4F;AAE5F,iHAAiH;AACjH,KAAK,UAAU,OAAO,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,IAAU;IACvF,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;QAAE,MAAM,IAAI,eAAO,CAAC,+BAA+B,EAAE,EAAE,EAAE,4BAA4B,CAAC,CAAA;IAC1I,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,QAAQ;YAAE,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,QAAQ,EAAS,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAS,CAAC,CAAA;QACvO,OAAO,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAA,mCAAkB,EAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,QAAS,CAAC,CAAA;IAC1E,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,eAAO,CAAC,+BAA+B,EAAE,EAAE,EAAE,qCAAqC,CAAC,CAAA;IAC3G,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,qCAAwB,CAAC,EAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,6BAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IACrO,OAAO,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,EAAiB,EAAE,OAAuB,EAAE,MAAc;IACrF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,wBAAU,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAA;IACtH,IAAI,CAAC,IAAI;QAAE,MAAM,QAAQ,EAAE,CAAA;IAC3B,OAAO,IAAI,CAAA;AACb,CAAC;AAOD;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,YAAoB,EAAE,MAAc,EAAE,OAAe,EAAE,QAAgB,EAAE,OAAY,EAAE,MAAY,IAAI,IAAI,EAAE;IAC5I,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,IAAI,UAAU,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,CAAA;IAChE,UAAU,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,SAAU,EAAE,EAAE,MAAM,CAAC,CAAA;IAC3E,IAAI,IAAI,CAAC,IAAI,KAAK,4BAAc,CAAC,IAAI;QAAE,MAAM,IAAI,eAAO,CAAC,2BAA2B,EAAE,EAAE,EAAE,uBAAuB,CAAC,CAAA;IAClH,MAAM,UAAU,GAAI,EAAoB,CAAC,aAAa,CAAC,4BAAY,CAAC,CAAA;IACpE,MAAM,QAAQ,GACZ,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAC;QAC1G,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAC,CAAA;IAC7M,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;IAErF,MAAM,OAAO,GAAG,IAAA,4BAAW,EAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IACvE,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,OAAO,KAAK,YAAY;YAAE,MAAM,IAAI,eAAO,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,0DAA0D,OAAO,CAAC,OAAO,GAAG,CAAC,CAAA;QAC1L,MAAM,IAAI,eAAO,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,kDAAkD,OAAO,CAAC,OAAO,KAAK,CAAC,CAAA;IACpJ,CAAC;IACD,QAAQ,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,QAAQ,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAA;IAChD,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAA;IAClD,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACtC,QAAQ,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAA;IAC1C,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAChC,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAA;IACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAA,yBAAQ,EAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAA;IACvE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAA;IACvB,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/B,IAAI,OAAO,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC1H,+EAA+E;IAC/E,IAAI,UAAU,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAS,CAAC,CAAA;IAC9I,UAAU,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;IACpG,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC;AAED,yFAAyF;AAClF,KAAK,UAAU,qBAAqB,CAAC,YAAoB,EAAE,OAAY;IAC5E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,IAAI,UAAU,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACjG,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IAC5D,IAAI,CAAC,OAAO,EAAE,eAAe;QAAE,MAAM,IAAI,eAAO,CAAC,6BAA6B,EAAE,EAAE,EAAE,wCAAwC,CAAC,CAAA;IAC7H,IAAI,CAAC,UAAU,CAAC,cAAc;QAAE,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,EAAE,cAAc,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IAC7J,OAAO,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;AAChG,CAAC;AASD,6HAA6H;AAC7H,SAAgB,UAAU,CAAC,OAAoB,EAAE,SAA2B;IAC1E,OAAO;QACL,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACnC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,UAAU,CAAE,CAAA;YACpE,OAAO;gBACL,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;aAC9H,CAAA;QACH,CAAC,CAAC;KACH,CAAA;AACH,CAAC;AAED;;;GAGG;AACH;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,IAAU;IAC9F,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IACjG,OAAO,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;AACtD,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,YAAoB,EAAE,OAAY;IACvE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACpG,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;QAAE,MAAM,IAAI,eAAO,CAAC,+BAA+B,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAA;IACvI,MAAM,OAAO,GAAG,CAAC,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAE,CAAA;IAC/D,MAAM,SAAS,GAAG,MAAM,IAAA,4BAAW,EAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IACnD,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,MAAM,IAAI,eAAO,CAAC,kBAAkB,EAAE,EAAE,EAAE,wBAAwB,CAAC,CAAA;IACvH,MAAM,UAAU,GAAI,EAAoB,CAAC,aAAa,CAAC,0BAAW,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAA,gBAAM,GAAE,EAAS,EAAE,CAAC,CAAA;IACxH,IAAI,OAAO;QAAE,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAClD,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,IAAI,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY;QAAE,MAAM,IAAI,eAAO,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,OAAO,OAAO,CAAC,YAAY,oBAAoB,CAAC,CAAA;IAC9M,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAA,8BAAa,EAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IAC1J,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AACvC,CAAC;AASD;;;GAGG;AACI,KAAK,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAiC,EAAE,OAAY;IACxG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAC1C,MAAM,OAAO,GAAG,MAAO,EAAoB,CAAC,aAAa,CAAC,0BAAW,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAA;IAC9I,IAAI,CAAC,OAAO;QAAE,MAAM,QAAQ,EAAE,CAAA;IAC9B,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,YAAa,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACnH,MAAM,OAAO,GAAG,CAAC,MAAM,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAE,CAAA;IAC/D,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,IAAI,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY;QAAE,MAAM,IAAI,eAAO,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,OAAO,OAAO,CAAC,YAAY,oBAAoB,CAAC,CAAA;IAC9M,MAAM,SAAS,GAAG,MAAM,IAAA,4BAAW,EAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAqB,CAAA;IACtI,MAAM,IAAI,GAA6B,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3I,MAAM,KAAK,GAAG,IAAA,wBAAO,EAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,CAAA;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,0BAAW,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,IAAA,gBAAM,GAAE,EAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IAC7L,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,MAAM,IAAI,eAAO,CAAC,uBAAuB,EAAE,EAAE,EAAE,8BAA8B,CAAC,CAAA;IACrG,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACzF,MAAM,EAAE,CAAC,aAAa,CAAC,uBAAU,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAS,CAAC,CAAA;IAChJ,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;IACrG,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACrJ,CAAC;AAED,8FAA8F;AAE9F,6GAA6G;AACtG,MAAM,eAAe,GAAG,CAAC,UAA0B,EAAE,GAAW,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAA;AAA1J,QAAA,eAAe,mBAA2I;AAEvK;;;;GAIG;AACI,KAAK,UAAU,aAAa,CAAC,EAAiB,EAAE,MAAW,EAAE,UAAsB,EAAE,OAAY;IACtG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QAAE,OAAO,UAAU,CAAA;IAC1E,IAAI,CAAC,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,UAAU,CAAA;IACxE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,OAAO,GAAG,MAAM,EAAE;SACrB,aAAa,CAAC,uBAAU,CAAC;SACzB,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,qCAAwB,CAAC,EAAS,EAAE,EAAE,MAAM,EAAE,6BAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,IAAA,uBAAe,EAAC,UAAU,EAAE,IAAA,eAAO,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAS,CAAC,CAAA;IAC7O,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3E,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IAC/D,MAAM,IAAA,oCAAiB,EAAC,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC5E,MAAM,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7D,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,+FAA+F;AAE/F,2GAA2G;AACpG,KAAK,UAAU,aAAa,CAAC,OAAY;IAC9C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,IAAA,kCAAiB,EAAC,OAAO,CAAC;SAC1C,aAAa,CAAC,uBAAU,CAAC;SACzB,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAA,YAAE,EAAC,CAAC,GAAG,qCAAwB,EAAE,6BAAgB,CAAC,SAAS,CAAC,CAAC,EAAS,EAAE,CAAC,CAAA;IACtJ,MAAM,IAAI,GAAG,CAAC,GAAe,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAU,CAAC,CAAC,CAAA;AAC1K,CAAC","sourcesContent":["/*\n * What the doors of enrolments do with the database (ADR-0194 decisions 5-8): enrolling people for whoever asks and\n * withdrawing them, the to-do of each, the time the server counts from ticks, the quiz the server scores, the\n * acknowledgement, and completing an enrolment with its evidence in the same transaction as the handler of whoever\n * asked. Nothing here deletes an enrolment or its progress.\n */\nimport { EntityManager, In, IsNull } from 'typeorm'\n\nimport { User } from '@things-factory/auth-base'\nimport { audienceTargetRefusal, audienceUserIds, departmentTreeOf, domainRolesOf } from '@things-factory/organization'\nimport { logger } from '@things-factory/env'\nimport { translatorFor } from '@things-factory/i18n-base/translator'\nimport { calendarDay, getRepository, Refusal } from '@things-factory/shell'\nimport { abort, Activity, ActivityThread, assign, complete, issue } from '@things-factory/worklist'\n\nimport { LEARNING_COURSE_ACTIVITY } from '../../activities'\nimport { Course } from '../course/course'\nimport { CourseQuestion } from '../course/course-question'\nimport { CourseUnit, CourseUnitKind } from '../course/course-unit'\nimport { CourseVersion } from '../course/course-version'\nimport { courseOf, learningManagerOf, publishedVersionOf, questionsOf, unitsOf } from '../course/course-service'\nimport { Enrollment, EnrollmentStatus, OPEN_ENROLLMENT_STATUSES } from './enrollment'\nimport { learningOutcomeOf } from './learning-outcome'\nimport { counts, drawQuestions, missingOf, Missing, scoreOf, tickVerdict, unitDone } from './progress-rules'\nimport { QuizAttempt } from './quiz-attempt'\nimport { UnitProgress } from './unit-progress'\n\n/** Who asked for an enrolment - a module's kind of record and the record. A manager's own is `learning.direct`. */\nexport interface LearningSource {\n  kind: string\n  id?: string | null\n}\n\nexport const DIRECT_SOURCE_KIND = 'learning.direct'\n\n/** The learner's screen of one enrolment - where the to-do leads. */\nexport const learningAddressOf = (enrollmentId: string) => `learning-view?id=${enrollmentId}`\n\nexport const todayIn = (domain: { timezone?: string | null }, now: Date = new Date()) => calendarDay(domain?.timezone, now)\n\nconst notFound = () => new Refusal('learning-not-found', {}, 'the record was not found. reload and try again.')\nconst isOpen = (status: string) => (OPEN_ENROLLMENT_STATUSES as string[]).includes(status)\n\n/* ---------------------------------------------------------------- the to-do (decision 5) */\n\n/** The to-do is issued as its own assignee: nobody else hands it out. worklist speaks its refusals through `t`. */\nfunction todoContextOf(tx: EntityManager, domain: any, user: User) {\n  const t = translatorFor(user.locale || 'ko')\n  return { state: { domain, user, tx }, t: (key: string, options?: any) => t(key, options) } as any\n}\n\n/** Hands out 「<과정> 수강」 to the person, with the due day - nothing where the domain has not installed the to-do. */\nasync function issueTodo(tx: EntityManager, domain: any, enrollment: Enrollment, course: Course, person: User): Promise<string | null> {\n  const activity = await tx.getRepository(Activity).findOne({ where: { domain: { id: domain.id }, name: LEARNING_COURSE_ACTIVITY } as any })\n  if (!activity) {\n    logger.warn(`[learning] ${domain.subdomain}: the activity \"${LEARNING_COURSE_ACTIVITY}\" is not installed - \"${course.name}\" not handed out`)\n    return null\n  }\n  const t = translatorFor(person.locale || 'ko')\n  const name = t('text.learning-todo-name', { course: course.name })\n  const headline = enrollment.dueOn ? t('text.learning-todo-headline', { dueOn: enrollment.dueOn }) : t('text.learning-todo-headline-no-due')\n  const dueAt = enrollment.dueOn ? dueAtOf(enrollment.dueOn, domain.timezone) : undefined\n  const context = todoContextOf(tx, domain, person)\n  const input = { enrollmentId: enrollment.id, headline, address: learningAddressOf(enrollment.id) }\n  const instance = await issue({ name, description: headline, activityId: activity.id, input, assignees: [], threadsMin: 0, dueAt } as any, context)\n  await assign({ id: instance.id, assignees: [person.email], dueAt, reason: name }, context)\n  return instance.id\n}\n\n/** The end of the due day in the domain's time zone. */\nfunction dueAtOf(dueOn: string, timezone?: string | null): Date {\n  const end = new Date(`${dueOn}T23:59:59Z`)\n  const zone = timezone || 'UTC'\n  const asLocal = new Date(end.toLocaleString('en-US', { timeZone: zone }))\n  const asUtc = new Date(end.toLocaleString('en-US', { timeZone: 'UTC' }))\n  return new Date(end.getTime() - (asLocal.getTime() - asUtc.getTime()))\n}\n\nasync function todoOpen(tx: EntityManager, instanceId: string): Promise<boolean> {\n  return (await tx.getRepository(ActivityThread).count({ where: { activityInstance: { id: instanceId }, state: In(['assigned', 'started', 'unassigned']) } as any })) > 0\n}\n\n/** Ends the to-do as done once the course is completed. */\nasync function completeTodo(tx: EntityManager, domain: any, enrollment: Enrollment, by: User): Promise<void> {\n  if (!enrollment.todoInstanceId || !(await todoOpen(tx, enrollment.todoInstanceId))) return\n  await complete({ id: enrollment.todoInstanceId, reason: 'course completed' }, todoContextOf(tx, domain, by))\n}\n\n/** Aborts the to-do of an enrolment withdrawn or cancelled. */\nasync function abortTodo(tx: EntityManager, domain: any, enrollment: Enrollment, by: User, reason: string): Promise<void> {\n  if (!enrollment.todoInstanceId || !(await todoOpen(tx, enrollment.todoInstanceId))) return\n  await abort({ id: enrollment.todoInstanceId, reason } as any, todoContextOf(tx, domain, by))\n}\n\n/* ---------------------------------------------------------------- enrolling and withdrawing (decision 7) */\n\n/**\n * Enrols people in a course for whoever asks (`source`), to be completed by `dueOn` - the server function a using module\n * calls with the people it chose. One open enrolment per person, course and source: a person who has one is left with\n * it. Each new enrolment hands out its to-do. Answers the open enrolments of everyone given.\n */\nexport async function enroll(source: LearningSource, userIds: string[], courseId: string, dueOn: string | null | undefined, context: any): Promise<Enrollment[]> {\n  const { domain, user, tx } = context.state\n  if (!source?.kind) throw new Refusal('learning-source-required', {}, 'an enrolment names who asked for it')\n  if (dueOn && !/^\\d{4}-\\d{2}-\\d{2}$/.test(dueOn)) throw new Refusal('learning-due-invalid', {}, 'the due day is YYYY-MM-DD')\n  const course = await courseOf(tx, domain, courseId)\n  if (!(await publishedVersionOf(tx, domain, course.id))) throw new Refusal('learning-course-not-published', { course: course.name }, `${course.name} has no published version`)\n  const ids = [...new Set(userIds)].filter(Boolean)\n  if (!ids.length) return []\n  const people = await (tx as EntityManager).getRepository(User).find({ where: { id: In(ids) }, relations: ['domains'] })\n  const sourceId = source.id ?? ''\n  const repository = (tx as EntityManager).getRepository(Enrollment)\n  const out: Enrollment[] = []\n  for (const id of ids) {\n    const person = people.find(one => one.id === id)\n    if (!person || !(person.domains ?? []).some(one => one.id === domain.id)) throw new Refusal('learning-learner-unknown', {}, 'a learner must be a user of this domain')\n    const open = await repository.findOne({ where: { domain: { id: domain.id }, user: { id }, course: { id: course.id }, sourceKind: source.kind, sourceId, status: In(OPEN_ENROLLMENT_STATUSES) } as any })\n    if (open) {\n      out.push(open)\n      continue\n    }\n    const saved = await repository.save({ domain, user: person, course, dueOn: dueOn || null, sourceKind: source.kind, sourceId, status: EnrollmentStatus.ASSIGNED, learnedSeconds: 0, attempts: 0, creator: user, updater: user } as any)\n    const todo = await issueTodo(tx, domain, saved, course, person)\n    if (todo) await repository.update(saved.id, { todoInstanceId: todo } as any)\n    out.push((await repository.findOneBy({ id: saved.id }))!)\n  }\n  return out\n}\n\n/**\n * Withdraws the open enrolments a source asked for - the record they were for was taken back. Each is cancelled with\n * the reason and its to-do aborted; completed ones stay. Answers how many were withdrawn.\n */\nexport async function withdraw(source: LearningSource, reason: string, context: any): Promise<number> {\n  const { domain, user, tx } = context.state\n  const rows = await (tx as EntityManager).getRepository(Enrollment).find({ where: { domain: { id: domain.id }, sourceKind: source.kind, sourceId: source.id ?? '', status: In(OPEN_ENROLLMENT_STATUSES) } as any })\n  let count = 0\n  for (const row of rows) if (await cancelOpen(tx, domain, row, user, reason)) count++\n  return count\n}\n\n/** Cancels an open enrolment - claimed by an update only an open one matches, so a completion at the same time wins once. */\nasync function cancelOpen(tx: EntityManager, domain: any, row: Enrollment, by: User, reason: string): Promise<boolean> {\n  const claimed = await tx.getRepository(Enrollment).update({ id: row.id, status: In(OPEN_ENROLLMENT_STATUSES) } as any, { status: EnrollmentStatus.CANCELLED, cancelledAt: new Date(), cancelReason: reason, updater: by } as any)\n  if (!claimed.affected) return false\n  await abortTodo(tx, domain, row, by, reason)\n  return true\n}\n\n/**\n * A manager cancels an enrolment with a reason (decision 8). An open one is withdrawn; a completed one stays on record as\n * cancelled - never deleted - and whoever asked for it is told in the same transaction.\n */\nexport async function cancelEnrollment(id: string, reason: string, context: any): Promise<Enrollment> {\n  const { domain, user, tx } = context.state\n  if (!reason?.trim()) throw new Refusal('learning-cancel-reason-required', {}, 'say why it is cancelled')\n  const row = await enrollmentOf(tx, domain, id)\n  if (isOpen(row.status)) {\n    if (!(await cancelOpen(tx, domain, row, user, reason.trim()))) throw new Refusal('learning-enrollment-moved', {}, 'the enrolment changed meanwhile - reload and try again')\n  } else if (row.status === EnrollmentStatus.COMPLETED) {\n    const claimed = await tx.getRepository(Enrollment).update({ id: row.id, status: EnrollmentStatus.COMPLETED } as any, { status: EnrollmentStatus.CANCELLED, cancelledAt: new Date(), cancelReason: reason.trim(), updater: user } as any)\n    if (!claimed.affected) throw new Refusal('learning-enrollment-moved', {}, 'the enrolment changed meanwhile - reload and try again')\n    await learningOutcomeOf(row.sourceKind)?.cancelled?.((await enrollmentOf(tx, domain, id))!, reason.trim(), context)\n  } else throw new Refusal('learning-enrollment-cancelled', {}, 'the enrolment is cancelled already')\n  return await enrollmentOf(tx, domain, id)\n}\n\n/**\n * The people an audience names now - the domain, departments with those under them, roles and people, by organization's\n * one rule (ADR-0163). Each target must be of this domain.\n */\nexport async function learnersOf(audiences: { scope: string; targetId: string; targetName?: string }[], context: any): Promise<string[]> {\n  const { domain, tx } = context.state\n  if (!audiences?.length) throw new Refusal('learning-audience-required', {}, 'pick who takes the course')\n  const departmentIds = [...(await departmentTreeOf(domain, tx)).keys()]\n  const roleIds = (await domainRolesOf(domain, undefined, tx)).map(one => one.id)\n  for (const target of audiences) {\n    const why = audienceTargetRefusal(target as any, { domainId: domain.id, departmentIds, roleIds })\n    if (why) throw new Refusal('learning-audience-invalid', { target: target.targetName ?? target.targetId }, `${target.targetName ?? target.targetId} is not of this domain (${why})`)\n  }\n  return await audienceUserIds(domain, audiences as any, tx)\n}\n\n/* ---------------------------------------------------------------- reading */\n\nexport async function enrollmentOf(tx: EntityManager, domain: { id: string }, id: string): Promise<Enrollment> {\n  const row = id && /^[0-9a-f-]{36}$/i.test(id) ? await tx.getRepository(Enrollment).findOne({ where: { id, domain: { id: domain.id } } as any }) : null\n  if (!row) throw notFound()\n  return row\n}\n\n/** The request's own enrolment - one answer for \"none\" and \"not yours\". */\nexport async function myEnrollmentOf(context: any, id: string, tx: EntityManager = learningManagerOf(context)): Promise<Enrollment> {\n  const row = await enrollmentOf(tx, context.state.domain, id)\n  if (row.userId !== context.state.user.id) throw notFound()\n  return row\n}\n\n/** The version an enrolment shows: its own once started, the published one before. */\nexport async function shownVersionOf(tx: EntityManager, domain: { id: string }, enrollment: Enrollment): Promise<CourseVersion | null> {\n  if (enrollment.versionId) return await tx.getRepository(CourseVersion).findOne({ where: { id: enrollment.versionId } as any, withDeleted: true })\n  return await publishedVersionOf(tx, domain, enrollment.courseId!)\n}\n\nexport async function progressesOf(tx: EntityManager, enrollmentId: string): Promise<UnitProgress[]> {\n  return await tx.getRepository(UnitProgress).find({ where: { enrollment: { id: enrollmentId } } as any })\n}\n\n/** What still stands between an enrolment and its completion - nothing for a completed one. */\nexport async function missingFor(tx: EntityManager, domain: { id: string }, enrollment: Enrollment): Promise<Missing[]> {\n  if (enrollment.status === EnrollmentStatus.COMPLETED) return []\n  const version = await shownVersionOf(tx, domain, enrollment)\n  if (!version) return ['units']\n  const units = (await unitsOf(tx, version.id)).filter(counts)\n  const progress = await progressesOf(tx, enrollment.id)\n  const questions = version.passScore != null ? await tx.getRepository(CourseQuestion).count({ where: { version: { id: version.id } } as any }) : 0\n  return missingOf({\n    units: units.length,\n    unitsDone: units.filter(unit => progress.some(one => one.unitId === unit.id && one.doneAt)).length,\n    learnedSeconds: enrollment.learnedSeconds,\n    minSeconds: version.minSeconds ?? 0,\n    quiz: version.passScore != null && questions > 0,\n    passed: enrollment.score != null && enrollment.score >= (version.passScore ?? 101),\n    acknowledgement: !!version.acknowledgement,\n    acknowledged: !!enrollment.acknowledgedAt\n  })\n}\n\n/* ---------------------------------------------------------------- learning (decision 6) */\n\n/** The enrolment, started if it was not: its version fixed to the one published now, in progress from now on. */\nasync function started(tx: EntityManager, domain: any, enrollment: Enrollment, user: User): Promise<Enrollment> {\n  if (enrollment.status === EnrollmentStatus.CANCELLED) throw new Refusal('learning-enrollment-cancelled', {}, 'the enrolment is cancelled')\n  if (enrollment.versionId) {\n    if (enrollment.status === EnrollmentStatus.ASSIGNED) await tx.getRepository(Enrollment).update({ id: enrollment.id, status: EnrollmentStatus.ASSIGNED } as any, { status: EnrollmentStatus.IN_PROGRESS, startedAt: new Date() } as any)\n    return await enrollmentOf(tx, domain, enrollment.id)\n  }\n  const version = await publishedVersionOf(tx, domain, enrollment.courseId!)\n  if (!version) throw new Refusal('learning-course-not-published', {}, 'the course has no published version')\n  await tx.getRepository(Enrollment).update({ id: enrollment.id, status: In(OPEN_ENROLLMENT_STATUSES) } as any, { version, status: EnrollmentStatus.IN_PROGRESS, startedAt: enrollment.startedAt ?? new Date(), updater: user } as any)\n  return await enrollmentOf(tx, domain, enrollment.id)\n}\n\nasync function unitOfVersion(tx: EntityManager, version: { id: string }, unitId: string): Promise<CourseUnit> {\n  const unit = await tx.getRepository(CourseUnit).findOne({ where: { id: unitId, version: { id: version.id } } as any })\n  if (!unit) throw notFound()\n  return unit\n}\n\nexport interface TickResult {\n  enrollment: Enrollment\n  progress: UnitProgress\n}\n\n/**\n * One tick of the learner's screen on a unit (decision 6): the server adds the gap since the unit's last tick, at most\n * 15 seconds and at most what the screen says, and refuses a video position ahead of what was watched. A total the\n * screen sends is never taken. A unit that reaches its condition is done, and the enrolment is completed when nothing is\n * missing any more.\n */\nexport async function recordTick(enrollmentId: string, unitId: string, seconds: number, position: number, context: any, now: Date = new Date()): Promise<TickResult> {\n  const { domain, user, tx } = context.state\n  let enrollment = await myEnrollmentOf(context, enrollmentId, tx)\n  enrollment = await started(tx, domain, enrollment, user)\n  const unit = await unitOfVersion(tx, { id: enrollment.versionId! }, unitId)\n  if (unit.kind === CourseUnitKind.LINK) throw new Refusal('learning-link-not-counted', {}, 'a link is not counted')\n  const repository = (tx as EntityManager).getRepository(UnitProgress)\n  const progress =\n    (await repository.findOne({ where: { enrollment: { id: enrollment.id }, unit: { id: unit.id } } as any })) ??\n    (await repository.save({ domain, enrollment, unit, learnedSeconds: 0, watchedSeconds: 0, positionSeconds: 0, pagesSeen: 0, pagesRead: 0, pageSeconds: 0, pageAt: 0, creator: user, updater: user } as any))\n  if (enrollment.status === EnrollmentStatus.COMPLETED) return { enrollment, progress }\n\n  const verdict = tickVerdict(progress, { seconds, position }, now, unit)\n  if ('refusal' in verdict) {\n    if (verdict.refusal === 'page-ahead') throw new Refusal('learning-page-ahead', { allowed: verdict.allowed }, `a page cannot be ahead of the one after the last read (${verdict.allowed})`)\n    throw new Refusal('learning-position-ahead', { allowed: verdict.allowed }, `the video cannot be ahead of what was watched (${verdict.allowed} s)`)\n  }\n  progress.learnedSeconds += verdict.add\n  progress.watchedSeconds = verdict.watchedSeconds\n  progress.positionSeconds = verdict.positionSeconds\n  progress.pagesSeen = verdict.pagesSeen\n  progress.pagesRead = verdict.pagesRead\n  progress.pageSeconds = verdict.pageSeconds\n  progress.pageAt = verdict.pageAt\n  progress.lastTickAt = now\n  if (!progress.doneAt && unitDone(unit, progress)) progress.doneAt = now\n  progress.updater = user\n  await repository.save(progress)\n  if (verdict.add) await tx.getRepository(Enrollment).increment({ id: enrollment.id } as any, 'learnedSeconds', verdict.add)\n  /* Where the learner was - the course opens on this unit again (2026-11-08). */\n  if (enrollment.lastUnitId !== unit.id) await tx.getRepository(Enrollment).update({ id: enrollment.id } as any, { lastUnitId: unit.id } as any)\n  enrollment = await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context)\n  return { enrollment, progress }\n}\n\n/** The learner confirms the version's acknowledgement - recorded once, when they did. */\nexport async function acknowledgeEnrollment(enrollmentId: string, context: any): Promise<Enrollment> {\n  const { domain, user, tx } = context.state\n  let enrollment = await started(tx, domain, await myEnrollmentOf(context, enrollmentId, tx), user)\n  const version = await shownVersionOf(tx, domain, enrollment)\n  if (!version?.acknowledgement) throw new Refusal('learning-no-acknowledgement', {}, 'the course asks for no acknowledgement')\n  if (!enrollment.acknowledgedAt) await tx.getRepository(Enrollment).update({ id: enrollment.id } as any, { acknowledgedAt: new Date(), updater: user } as any)\n  return await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context)\n}\n\n/* ---------------------------------------------------------------- the quiz (decision 4) */\n\nexport interface DrawnForLearner {\n  attempt: QuizAttempt\n  questions: { id: string; kind: string; text: string; choices: { id: string; text: string }[] }[]\n}\n\n/** The questions of an attempt as the learner is drawn them - the choices in the order shown, never whether one is right. */\nexport function forLearner(attempt: QuizAttempt, questions: CourseQuestion[]): DrawnForLearner {\n  return {\n    attempt,\n    questions: attempt.drawn.map(drawn => {\n      const question = questions.find(one => one.id === drawn.questionId)!\n      return {\n        id: question.id,\n        kind: question.kind,\n        text: question.text,\n        choices: drawn.choiceIds.map(id => question.choices.find(one => one.id === id)!).map(one => ({ id: one.id, text: one.text }))\n      }\n    })\n  }\n}\n\n/**\n * Starts an attempt at the quiz: the questions drawn and shuffled, their choices shuffled. An attempt not sent yet is\n * answered again; the version's limit on attempts holds.\n */\n/**\n * Holds the enrolment for the rest of the request's transaction - an update takes its row lock on every driver, so two\n * attempts of one enrolment are started, counted and sent one after the other. Two starts at once made two unsent\n * attempts, and a limit of one let both be sent (2026-11-08).\n */\nasync function holdEnrollment(tx: EntityManager, domain: any, enrollment: Enrollment, user: User): Promise<Enrollment> {\n  await tx.getRepository(Enrollment).update({ id: enrollment.id } as any, { updater: user } as any)\n  return await enrollmentOf(tx, domain, enrollment.id)\n}\n\nexport async function startQuizAttempt(enrollmentId: string, context: any): Promise<DrawnForLearner> {\n  const { domain, user, tx } = context.state\n  const held = await holdEnrollment(tx, domain, await myEnrollmentOf(context, enrollmentId, tx), user)\n  const enrollment = await started(tx, domain, held, user)\n  if (enrollment.status === EnrollmentStatus.COMPLETED) throw new Refusal('learning-enrollment-completed', {}, 'the course is completed')\n  const version = (await shownVersionOf(tx, domain, enrollment))!\n  const questions = await questionsOf(tx, version.id)\n  if (version.passScore == null || !questions.length) throw new Refusal('learning-no-quiz', {}, 'the course has no quiz')\n  const repository = (tx as EntityManager).getRepository(QuizAttempt)\n  const pending = await repository.findOne({ where: { enrollment: { id: enrollment.id }, submittedAt: IsNull() } as any })\n  if (pending) return forLearner(pending, questions)\n  if (version.attemptLimit != null && enrollment.attempts >= version.attemptLimit) throw new Refusal('learning-attempts-used', { limit: version.attemptLimit }, `all ${version.attemptLimit} attempts are used`)\n  const attempt = await repository.save({ domain, enrollment, drawn: drawQuestions(questions, version.questionCount), creator: user, updater: user } as any)\n  return forLearner(attempt, questions)\n}\n\nexport interface QuizResult {\n  enrollment: Enrollment\n  score: number\n  passed: boolean\n  attemptsLeft: number | null\n}\n\n/**\n * Scores an attempt's answers on the server against what it drew (decision 4) - only the score and whether it passed go\n * back, never the right answers. The best score stays on the enrolment; passing may complete it.\n */\nexport async function submitQuizAttempt(attemptId: string, answers: Record<string, string[]>, context: any): Promise<QuizResult> {\n  const { domain, user, tx } = context.state\n  const attempt = await (tx as EntityManager).getRepository(QuizAttempt).findOne({ where: { id: attemptId, domain: { id: domain.id } } as any })\n  if (!attempt) throw notFound()\n  const enrollment = await holdEnrollment(tx, domain, await myEnrollmentOf(context, attempt.enrollmentId!, tx), user)\n  const version = (await shownVersionOf(tx, domain, enrollment))!\n  if (version.attemptLimit != null && enrollment.attempts >= version.attemptLimit) throw new Refusal('learning-attempts-used', { limit: version.attemptLimit }, `all ${version.attemptLimit} attempts are used`)\n  const questions = await questionsOf(tx, version.id)\n  const drawn = attempt.drawn.map(one => questions.find(question => question.id === one.questionId)).filter(Boolean) as CourseQuestion[]\n  const kept: Record<string, string[]> = Object.fromEntries(drawn.map(question => [question.id, (answers?.[question.id] ?? []).map(String)]))\n  const score = scoreOf(drawn, kept)\n  const passed = score >= (version.passScore ?? 101)\n  const claimed = await tx.getRepository(QuizAttempt).update({ id: attempt.id, submittedAt: IsNull() } as any, { answers: kept, score, passed, submittedAt: new Date(), updater: user } as any)\n  if (!claimed.affected) throw new Refusal('learning-attempt-sent', {}, 'the attempt was sent already')\n  await tx.getRepository(Enrollment).increment({ id: enrollment.id } as any, 'attempts', 1)\n  await tx.getRepository(Enrollment).update({ id: enrollment.id } as any, { score: Math.max(enrollment.score ?? 0, score), updater: user } as any)\n  const after = await completeIfMet(tx, domain, await enrollmentOf(tx, domain, enrollment.id), context)\n  return { enrollment: after, score, passed, attemptsLeft: version.attemptLimit != null ? Math.max(0, version.attemptLimit - after.attempts) : null }\n}\n\n/* ---------------------------------------------------------------- completing (decision 8) */\n\n/** A certificate number: the day completed and the enrolment's own id - one per completion, never reused. */\nexport const certificateNoOf = (enrollment: { id: string }, day: string) => `LMS-${day.replace(/-/g, '')}-${enrollment.id.replace(/-/g, '').slice(0, 8).toUpperCase()}`\n\n/**\n * Completes an open enrolment when nothing is missing - every unit done, the least time, the quiz passed, the\n * acknowledgement confirmed. The evidence stays on it; whoever asked for it is told in this same transaction (a handler\n * that fails takes the completion back), and the to-do ends as done.\n */\nexport async function completeIfMet(tx: EntityManager, domain: any, enrollment: Enrollment, context: any): Promise<Enrollment> {\n  if (!isOpen(enrollment.status) || !enrollment.versionId) return enrollment\n  if ((await missingFor(tx, domain, enrollment)).length) return enrollment\n  const now = new Date()\n  const claimed = await tx\n    .getRepository(Enrollment)\n    .update({ id: enrollment.id, status: In(OPEN_ENROLLMENT_STATUSES) } as any, { status: EnrollmentStatus.COMPLETED, completedAt: now, certificateNo: certificateNoOf(enrollment, todayIn(domain, now)), updater: context.state.user } as any)\n  if (!claimed.affected) return await enrollmentOf(tx, domain, enrollment.id)\n  const completed = await enrollmentOf(tx, domain, enrollment.id)\n  await learningOutcomeOf(completed.sourceKind)?.completed(completed, context)\n  await completeTodo(tx, domain, completed, context.state.user)\n  return completed\n}\n\n/* ---------------------------------------------------------------- whom an enrolment is for */\n\n/** The open and completed enrolments of the request's person, the open first and the soonest due first. */\nexport async function myEnrollments(context: any): Promise<Enrollment[]> {\n  const { domain, user } = context.state\n  const rows = await learningManagerOf(context)\n    .getRepository(Enrollment)\n    .find({ where: { domain: { id: domain.id }, user: { id: user.id }, status: In([...OPEN_ENROLLMENT_STATUSES, EnrollmentStatus.COMPLETED]) } as any })\n  const rank = (one: Enrollment) => (isOpen(one.status) ? 0 : 1)\n  return rows.sort((a, b) => rank(a) - rank(b) || String(a.dueOn ?? '9999').localeCompare(String(b.dueOn ?? '9999')) || +new Date(b.createdAt!) - +new Date(a.createdAt!))\n}\n\nexport { isOpen }\n"]}

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

@@ -0,0 +1,53 @@
+import { EntityManager, SelectQueryBuilder } from 'typeorm';
+import { User } from '@things-factory/auth-base';
+import { ListParam, ListValueCount } from '@things-factory/shell';
+import { Course } from '../course/course';
+import { Enrollment } from './enrollment';
+export interface StatusRow {
+    enrollment: Enrollment;
+    user: User | null;
+    course: Course | null;
+    departmentName: string | null;
+    /** The status as it reads today - OVERDUE for an open one past its due day. */
+    state: string;
+    units: number;
+    unitsDone: number;
+    versionNumber: number | null;
+}
+/** The rows of the enrolments given - each with its person, course, department, state today and units done. */
+export declare function rowsOf(tx: EntityManager, domain: any, enrollments: Enrollment[]): Promise<StatusRow[]>;
+/** The departments the request's person heads, with those under them - none for anyone else. */
+export declare function headedDepartmentsOf(context: any): Promise<string[]>;
+/** An enrolment as a department head reads it - where it stands and its days, nothing of how it went. */
+export declare function statusOnly(enrollment: Enrollment): Enrollment;
+/** The completion register of a course - every completed enrolment, by completion day (decision 10). */
+export declare function completionRegister(courseId: string, context: any): Promise<StatusRow[]>;
+/** Where an enrolment stands as a list shows it - OVERDUE is an open one past its due day, read on the day. */
+export declare const ENROLLMENT_STATES: readonly ["ASSIGNED", "IN_PROGRESS", "COMPLETED", "OVERDUE", "CANCELLED"];
+/**
+ * Whose enrolments a request reads (decision 11): a manager everyone's; a department head the people of their
+ * departments - open and completed ones, status only; anyone else their own.
+ */
+export type EnrollmentReach = {
+    kind: 'all';
+} | {
+    kind: 'team';
+    userIds: string[];
+} | {
+    kind: 'own';
+    userId: string;
+};
+/** The people of the request's departments, refused to anyone who heads none. */
+export declare function teamReachOf(context: any): Promise<EnrollmentReach>;
+/** The widest reach the request has - a manager's, a department head's, or their own. */
+export declare function reachOf(context: any): Promise<EnrollmentReach>;
+/**
+ * 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.
+ */
+export declare function enrollmentPage(params: ListParam, reach: EnrollmentReach, context: any, extra?: (builder: SelectQueryBuilder<Enrollment>) => void): Promise<{
+    rows: StatusRow[];
+    total: number;
+}>;
+/** How many enrolments stand in each state under the list's other conditions - every state, in order. */
+export declare function enrollmentStateCounts(params: ListParam, reach: EnrollmentReach, context: any): Promise<ListValueCount[]>;