@things-factory/learning 0.0.0-stage → 10.1.261

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

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REGISTER_TEMPLATE = exports.CERTIFICATE_TEMPLATE = exports.LEARNING_REGISTER_KIND = exports.LEARNING_CERTIFICATE_KIND = void 0;
+exports.registerLearningDocuments = registerLearningDocuments;
+/*
+ * The documents this module issues through the pdf module (ADR-0194 decisions 9, 10 · ADR-0176): the certificate of a completed
+ * enrolment (`learning.certificate`) and the completion register of a course (`learning.completion-register`). The pdf module
+ * numbers and prints them with 「우리 회사」 - the company's name, representative and seal as the application keeps them.
+ */
+const auth_base_1 = require("@things-factory/auth-base");
+const pdf_1 = require("@things-factory/pdf");
+const shell_1 = require("@things-factory/shell");
+const course_1 = require("../course/course");
+const course_version_1 = require("../course/course-version");
+const enrollment_1 = require("./enrollment");
+const enrollment_status_1 = require("./enrollment-status");
+exports.LEARNING_CERTIFICATE_KIND = 'learning.certificate';
+exports.LEARNING_REGISTER_KIND = 'learning.completion-register';
+const STYLE = `@page { size: A4; margin: 0 }
+body { margin: 0; font-family: "Apple SD Gothic Neo", "Malgun Gothic", "Noto Sans KR", sans-serif; color: #222 }
+.page { position: relative; box-sizing: border-box; width: 210mm; min-height: 297mm; padding: 30mm 24mm }
+.number { position: absolute; top: 16mm; left: 24mm; font-size: 9.5pt; color: #666 }
+h1 { margin: 6mm 0 16mm; text-align: center; font-size: 26pt; letter-spacing: 12pt }
+table { width: 100%; border-collapse: collapse; font-size: 11.5pt }
+th, td { border: 1px solid #444; padding: 3.2mm 4mm; text-align: left; vertical-align: middle }
+th { background: #f2f2f2; font-weight: 600; text-align: center }
+.statement { margin: 22mm 0 0; text-align: center; font-size: 13pt; line-height: 2 }
+.date { margin-top: 18mm; text-align: center; font-size: 13pt; letter-spacing: 1pt }
+.issuer { position: relative; margin: 20mm auto 0; width: max-content; font-size: 14pt; line-height: 2; text-align: left; padding-right: 22mm }
+.issuer img { position: absolute; right: 0; top: 2mm; width: 22mm; opacity: .9 }`;
+const ISSUER = `<div class="issuer">
+<div>상호 : {{company.name}}</div>
+{{#if company.address}}<div>주소 : {{company.address}}</div>{{/if}}
+<div>대표이사 : {{company.representative}}</div>
+{{#if company.seal}}<img src="{{company.seal}}" alt="">{{/if}}
+</div>`;
+/** The certificate's template in code - a domain's own `PDFTemplate` of the kind prints in its place. */
+exports.CERTIFICATE_TEMPLATE = `<!doctype html><html lang="ko"><head><meta charset="utf-8"><style>
+${STYLE}
+th { width: 32mm }
+</style></head><body><div class="page">
+<div class="number">발급번호 {{issue.number}}</div>
+<h1>수료증</h1>
+<table>
+<tr><th>성명</th><td>{{learner.name}}</td></tr>
+<tr><th>과정</th><td>{{course.name}} (개정본 {{course.version}})</td></tr>
+<tr><th>이수일</th><td>{{completion.completedOn}}</td></tr>
+<tr><th>학습 시간</th><td>{{completion.minutes}}분</td></tr>
+{{#if completion.score}}<tr><th>평가 점수</th><td>{{completion.score}}점</td></tr>{{/if}}
+<tr><th>수료 번호</th><td>{{completion.certificateNo}}</td></tr>
+</table>
+<p class="statement">위 사람은 위 과정을 이수하였음을 증명합니다.</p>
+<div class="date">{{issue.issuedOn}}</div>
+${ISSUER}
+</div></body></html>`;
+/** The completion register's template - one row per completion. */
+exports.REGISTER_TEMPLATE = `<!doctype html><html lang="ko"><head><meta charset="utf-8"><style>
+${STYLE}
+.page { padding: 24mm 16mm }
+h1 { font-size: 20pt; letter-spacing: 4pt; margin-bottom: 8mm }
+.meta { margin-bottom: 6mm; font-size: 10.5pt }
+table { font-size: 9.5pt }
+th, td { padding: 2mm 2.4mm }
+</style></head><body><div class="page">
+<div class="number">발급번호 {{issue.number}}</div>
+<h1>이수 대장</h1>
+<div class="meta">과정 : {{course.name}} · 기준일 : {{issue.asOf}} · 이수자 {{count}}명</div>
+<table>
+<tr><th>번호</th><th>성명</th><th>부서</th><th>개정본</th><th>이수일</th><th>학습 시간(분)</th><th>점수</th><th>수료 번호</th></tr>
+{{#each rows}}<tr><td>{{this.no}}</td><td>{{this.name}}</td><td>{{this.department}}</td><td>{{this.version}}</td><td>{{this.completedOn}}</td><td>{{this.minutes}}</td><td>{{this.score}}</td><td>{{this.certificateNo}}</td></tr>{{/each}}
+</table>
+<div class="date">{{issue.issuedOn}}</div>
+${ISSUER}
+</div></body></html>`;
+const dayOf = (at, timezone) => at ? new Intl.DateTimeFormat('en-CA', { timeZone: timezone || 'UTC', year: 'numeric', month: '2-digit', day: '2-digit' }).format(new Date(at)) : '';
+async function enrollmentFor(context, id) {
+    return id ? await (0, shell_1.getRepository)(enrollment_1.Enrollment, context.state.tx).findOne({ where: { id, domain: { id: context.state.domain.id } } }) : null;
+}
+/** A certificate is issued and read by the person it is of, once completed, and by a manager. */
+async function mayHaveCertificate(context, id) {
+    const enrollment = await enrollmentFor(context, id ?? '');
+    if (!enrollment || enrollment.status !== enrollment_1.EnrollmentStatus.COMPLETED)
+        return false;
+    return enrollment.userId === context.state.user?.id || (await (0, auth_base_1.requestHolds)(context, 'course', 'query'));
+}
+function registerLearningDocuments() {
+    (0, pdf_1.registerIssuedDocumentKind)({
+        kind: exports.LEARNING_CERTIFICATE_KIND,
+        prefix: '수료',
+        refType: 'Enrollment',
+        template: { content_template: exports.CERTIFICATE_TEMPLATE, page_size: 'A4' },
+        async dataOf(context, refId) {
+            const enrollment = await enrollmentFor(context, refId);
+            if (!enrollment || enrollment.status !== enrollment_1.EnrollmentStatus.COMPLETED)
+                throw new shell_1.Refusal('learning-not-completed', {}, 'a certificate is issued for a completed enrolment');
+            const tx = context.state.tx;
+            const course = await (0, shell_1.getRepository)(course_1.Course, tx).findOneBy({ id: enrollment.courseId });
+            const version = await (0, shell_1.getRepository)(course_version_1.CourseVersion, tx).findOne({ where: { id: enrollment.versionId }, withDeleted: true });
+            const learner = await (0, shell_1.getRepository)(auth_base_1.User, tx).findOneBy({ id: enrollment.userId });
+            return {
+                subjectName: `${learner?.name ?? ''} · ${course?.name ?? ''}`,
+                data: {
+                    learner: { name: learner?.name ?? '' },
+                    course: { name: course?.name ?? '', version: version?.number ?? '' },
+                    completion: {
+                        completedOn: dayOf(enrollment.completedAt, context.state.domain.timezone),
+                        minutes: Math.floor((enrollment.learnedSeconds ?? 0) / 60),
+                        score: enrollment.score ?? null,
+                        certificateNo: enrollment.certificateNo ?? ''
+                    }
+                }
+            };
+        },
+        async mayIssue(context, refId) {
+            return await mayHaveCertificate(context, refId);
+        },
+        async mayRead(context, row) {
+            return await mayHaveCertificate(context, row.refId);
+        }
+    });
+    (0, pdf_1.registerIssuedDocumentKind)({
+        kind: exports.LEARNING_REGISTER_KIND,
+        prefix: '이수대장',
+        refType: 'Course',
+        asOf: true,
+        template: { content_template: exports.REGISTER_TEMPLATE, page_size: 'A4' },
+        async dataOf(context, refId, input) {
+            const course = await (0, shell_1.getRepository)(course_1.Course, context.state.tx).findOne({ where: { id: refId, domain: { id: context.state.domain.id } } });
+            if (!course)
+                throw new shell_1.Refusal('learning-not-found', {}, 'the record was not found. reload and try again.');
+            const timezone = context.state.domain.timezone;
+            const rows = (await (0, enrollment_status_1.completionRegister)(course.id, context)).filter(row => !input.asOf || dayOf(row.enrollment.completedAt, timezone) <= input.asOf);
+            return {
+                subjectName: course.name,
+                data: {
+                    course: { name: course.name },
+                    count: rows.length,
+                    rows: rows.map((row, index) => ({
+                        no: index + 1,
+                        name: row.user?.name ?? '',
+                        department: row.departmentName ?? '',
+                        version: row.versionNumber ?? '',
+                        completedOn: dayOf(row.enrollment.completedAt, timezone),
+                        minutes: Math.floor((row.enrollment.learnedSeconds ?? 0) / 60),
+                        score: row.enrollment.score ?? '',
+                        certificateNo: row.enrollment.certificateNo ?? ''
+                    }))
+                }
+            };
+        },
+        async mayIssue(context) {
+            return await (0, auth_base_1.requestHolds)(context, 'course', 'query');
+        },
+        async mayRead(context) {
+            return await (0, auth_base_1.requestHolds)(context, 'course', 'query');
+        }
+    });
+}
+//# sourceMappingURL=learning-documents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-documents.js","sourceRoot":"","sources":["../../../server/service/enrollment/learning-documents.ts"],"names":[],"mappings":";;;AA2FA,8DAuEC;AAlKD;;;;GAIG;AACH,yDAA8D;AAC9D,6CAAgE;AAChE,iDAA8D;AAE9D,6CAAyC;AACzC,6DAAwD;AACxD,6CAA2D;AAC3D,2DAAwD;AAE3C,QAAA,yBAAyB,GAAG,sBAAsB,CAAA;AAClD,QAAA,sBAAsB,GAAG,8BAA8B,CAAA;AAEpE,MAAM,KAAK,GAAG;;;;;;;;;;;iFAWmE,CAAA;AAEjF,MAAM,MAAM,GAAG;;;;;OAKR,CAAA;AAEP,yGAAyG;AAC5F,QAAA,oBAAoB,GAAG;EAClC,KAAK;;;;;;;;;;;;;;;EAeL,MAAM;qBACa,CAAA;AAErB,mEAAmE;AACtD,QAAA,iBAAiB,GAAG;EAC/B,KAAK;;;;;;;;;;;;;;;EAeL,MAAM;qBACa,CAAA;AAErB,MAAM,KAAK,GAAG,CAAC,EAAoC,EAAE,QAAwB,EAAE,EAAE,CAC/E,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAErJ,KAAK,UAAU,aAAa,CAAC,OAAY,EAAE,EAAU;IACnD,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,IAAA,qBAAa,EAAC,uBAAU,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACjJ,CAAC;AAED,iGAAiG;AACjG,KAAK,UAAU,kBAAkB,CAAC,OAAY,EAAE,EAA6B;IAC3E,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IACjF,OAAO,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,IAAA,wBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;AACzG,CAAC;AAED,SAAgB,yBAAyB;IACvC,IAAA,gCAA0B,EAAC;QACzB,IAAI,EAAE,iCAAyB;QAC/B,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,EAAE,gBAAgB,EAAE,4BAAoB,EAAE,SAAS,EAAE,IAAI,EAAE;QACrE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK;YACzB,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YACtD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,6BAAgB,CAAC,SAAS;gBAAE,MAAM,IAAI,eAAO,CAAC,wBAAwB,EAAE,EAAE,EAAE,mDAAmD,CAAC,CAAA;YACzK,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAA;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,eAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,QAAS,EAAE,CAAC,CAAA;YACtF,MAAM,OAAO,GAAG,MAAM,IAAA,qBAAa,EAAC,8BAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,SAAU,EAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;YAClI,MAAM,OAAO,GAAG,MAAM,IAAA,qBAAa,EAAC,gBAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,MAAO,EAAE,CAAC,CAAA;YACnF,OAAO;gBACL,WAAW,EAAE,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE;gBAC7D,IAAI,EAAE;oBACJ,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE;oBACtC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE;oBACpE,UAAU,EAAE;wBACV,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;wBACzE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;wBAC1D,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;wBAC/B,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,EAAE;qBAC9C;iBACF;aACF,CAAA;QACH,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK;YAC3B,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACjD,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG;YACxB,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QACrD,CAAC;KACF,CAAC,CAAA;IAEF,IAAA,gCAA0B,EAAC;QACzB,IAAI,EAAE,8BAAsB;QAC5B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,EAAE,gBAAgB,EAAE,yBAAiB,EAAE,SAAS,EAAE,IAAI,EAAE;QAClE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK;YAChC,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,eAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAS,EAAE,CAAC,CAAA;YAC9I,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,eAAO,CAAC,oBAAoB,EAAE,EAAE,EAAE,iDAAiD,CAAC,CAAA;YAC3G,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAA;YAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,IAAA,sCAAkB,EAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAA;YACnJ,OAAO;gBACL,WAAW,EAAE,MAAM,CAAC,IAAI;gBACxB,IAAI,EAAE;oBACJ,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBAC7B,KAAK,EAAE,IAAI,CAAC,MAAM;oBAClB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;wBAC9B,EAAE,EAAE,KAAK,GAAG,CAAC;wBACb,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;wBAC1B,UAAU,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;wBACpC,OAAO,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;wBAChC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC;wBACxD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;wBAC9D,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;wBACjC,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,aAAa,IAAI,EAAE;qBAClD,CAAC,CAAC;iBACJ;aACF,CAAA;QACH,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,OAAO;YACpB,OAAO,MAAM,IAAA,wBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,OAAO,MAAM,IAAA,wBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC","sourcesContent":["/*\n * The documents this module issues through the pdf module (ADR-0194 decisions 9, 10 · ADR-0176): the certificate of a completed\n * enrolment (`learning.certificate`) and the completion register of a course (`learning.completion-register`). The pdf module\n * numbers and prints them with 「우리 회사」 - the company's name, representative and seal as the application keeps them.\n */\nimport { requestHolds, User } from '@things-factory/auth-base'\nimport { registerIssuedDocumentKind } from '@things-factory/pdf'\nimport { getRepository, Refusal } from '@things-factory/shell'\n\nimport { Course } from '../course/course'\nimport { CourseVersion } from '../course/course-version'\nimport { Enrollment, EnrollmentStatus } from './enrollment'\nimport { completionRegister } from './enrollment-status'\n\nexport const LEARNING_CERTIFICATE_KIND = 'learning.certificate'\nexport const LEARNING_REGISTER_KIND = 'learning.completion-register'\n\nconst STYLE = `@page { size: A4; margin: 0 }\nbody { margin: 0; font-family: \"Apple SD Gothic Neo\", \"Malgun Gothic\", \"Noto Sans KR\", sans-serif; color: #222 }\n.page { position: relative; box-sizing: border-box; width: 210mm; min-height: 297mm; padding: 30mm 24mm }\n.number { position: absolute; top: 16mm; left: 24mm; font-size: 9.5pt; color: #666 }\nh1 { margin: 6mm 0 16mm; text-align: center; font-size: 26pt; letter-spacing: 12pt }\ntable { width: 100%; border-collapse: collapse; font-size: 11.5pt }\nth, td { border: 1px solid #444; padding: 3.2mm 4mm; text-align: left; vertical-align: middle }\nth { background: #f2f2f2; font-weight: 600; text-align: center }\n.statement { margin: 22mm 0 0; text-align: center; font-size: 13pt; line-height: 2 }\n.date { margin-top: 18mm; text-align: center; font-size: 13pt; letter-spacing: 1pt }\n.issuer { position: relative; margin: 20mm auto 0; width: max-content; font-size: 14pt; line-height: 2; text-align: left; padding-right: 22mm }\n.issuer img { position: absolute; right: 0; top: 2mm; width: 22mm; opacity: .9 }`\n\nconst ISSUER = `<div class=\"issuer\">\n<div>상호 : {{company.name}}</div>\n{{#if company.address}}<div>주소 : {{company.address}}</div>{{/if}}\n<div>대표이사 : {{company.representative}}</div>\n{{#if company.seal}}<img src=\"{{company.seal}}\" alt=\"\">{{/if}}\n</div>`\n\n/** The certificate's template in code - a domain's own `PDFTemplate` of the kind prints in its place. */\nexport const CERTIFICATE_TEMPLATE = `<!doctype html><html lang=\"ko\"><head><meta charset=\"utf-8\"><style>\n${STYLE}\nth { width: 32mm }\n</style></head><body><div class=\"page\">\n<div class=\"number\">발급번호 {{issue.number}}</div>\n<h1>수료증</h1>\n<table>\n<tr><th>성명</th><td>{{learner.name}}</td></tr>\n<tr><th>과정</th><td>{{course.name}} (개정본 {{course.version}})</td></tr>\n<tr><th>이수일</th><td>{{completion.completedOn}}</td></tr>\n<tr><th>학습 시간</th><td>{{completion.minutes}}분</td></tr>\n{{#if completion.score}}<tr><th>평가 점수</th><td>{{completion.score}}점</td></tr>{{/if}}\n<tr><th>수료 번호</th><td>{{completion.certificateNo}}</td></tr>\n</table>\n<p class=\"statement\">위 사람은 위 과정을 이수하였음을 증명합니다.</p>\n<div class=\"date\">{{issue.issuedOn}}</div>\n${ISSUER}\n</div></body></html>`\n\n/** The completion register's template - one row per completion. */\nexport const REGISTER_TEMPLATE = `<!doctype html><html lang=\"ko\"><head><meta charset=\"utf-8\"><style>\n${STYLE}\n.page { padding: 24mm 16mm }\nh1 { font-size: 20pt; letter-spacing: 4pt; margin-bottom: 8mm }\n.meta { margin-bottom: 6mm; font-size: 10.5pt }\ntable { font-size: 9.5pt }\nth, td { padding: 2mm 2.4mm }\n</style></head><body><div class=\"page\">\n<div class=\"number\">발급번호 {{issue.number}}</div>\n<h1>이수 대장</h1>\n<div class=\"meta\">과정 : {{course.name}} · 기준일 : {{issue.asOf}} · 이수자 {{count}}명</div>\n<table>\n<tr><th>번호</th><th>성명</th><th>부서</th><th>개정본</th><th>이수일</th><th>학습 시간(분)</th><th>점수</th><th>수료 번호</th></tr>\n{{#each rows}}<tr><td>{{this.no}}</td><td>{{this.name}}</td><td>{{this.department}}</td><td>{{this.version}}</td><td>{{this.completedOn}}</td><td>{{this.minutes}}</td><td>{{this.score}}</td><td>{{this.certificateNo}}</td></tr>{{/each}}\n</table>\n<div class=\"date\">{{issue.issuedOn}}</div>\n${ISSUER}\n</div></body></html>`\n\nconst dayOf = (at: Date | string | null | undefined, timezone?: string | null) =>\n  at ? new Intl.DateTimeFormat('en-CA', { timeZone: timezone || 'UTC', year: 'numeric', month: '2-digit', day: '2-digit' }).format(new Date(at)) : ''\n\nasync function enrollmentFor(context: any, id: string): Promise<Enrollment | null> {\n  return id ? await getRepository(Enrollment, context.state.tx).findOne({ where: { id, domain: { id: context.state.domain.id } } as any }) : null\n}\n\n/** A certificate is issued and read by the person it is of, once completed, and by a manager. */\nasync function mayHaveCertificate(context: any, id: string | null | undefined): Promise<boolean> {\n  const enrollment = await enrollmentFor(context, id ?? '')\n  if (!enrollment || enrollment.status !== EnrollmentStatus.COMPLETED) return false\n  return enrollment.userId === context.state.user?.id || (await requestHolds(context, 'course', 'query'))\n}\n\nexport function registerLearningDocuments(): void {\n  registerIssuedDocumentKind({\n    kind: LEARNING_CERTIFICATE_KIND,\n    prefix: '수료',\n    refType: 'Enrollment',\n    template: { content_template: CERTIFICATE_TEMPLATE, page_size: 'A4' },\n    async dataOf(context, refId) {\n      const enrollment = await enrollmentFor(context, refId)\n      if (!enrollment || enrollment.status !== EnrollmentStatus.COMPLETED) throw new Refusal('learning-not-completed', {}, 'a certificate is issued for a completed enrolment')\n      const tx = context.state.tx\n      const course = await getRepository(Course, tx).findOneBy({ id: enrollment.courseId! })\n      const version = await getRepository(CourseVersion, tx).findOne({ where: { id: enrollment.versionId! } as any, withDeleted: true })\n      const learner = await getRepository(User, tx).findOneBy({ id: enrollment.userId! })\n      return {\n        subjectName: `${learner?.name ?? ''} · ${course?.name ?? ''}`,\n        data: {\n          learner: { name: learner?.name ?? '' },\n          course: { name: course?.name ?? '', version: version?.number ?? '' },\n          completion: {\n            completedOn: dayOf(enrollment.completedAt, context.state.domain.timezone),\n            minutes: Math.floor((enrollment.learnedSeconds ?? 0) / 60),\n            score: enrollment.score ?? null,\n            certificateNo: enrollment.certificateNo ?? ''\n          }\n        }\n      }\n    },\n    async mayIssue(context, refId) {\n      return await mayHaveCertificate(context, refId)\n    },\n    async mayRead(context, row) {\n      return await mayHaveCertificate(context, row.refId)\n    }\n  })\n\n  registerIssuedDocumentKind({\n    kind: LEARNING_REGISTER_KIND,\n    prefix: '이수대장',\n    refType: 'Course',\n    asOf: true,\n    template: { content_template: REGISTER_TEMPLATE, page_size: 'A4' },\n    async dataOf(context, refId, input) {\n      const course = await getRepository(Course, context.state.tx).findOne({ where: { id: refId, domain: { id: context.state.domain.id } } as any })\n      if (!course) throw new Refusal('learning-not-found', {}, 'the record was not found. reload and try again.')\n      const timezone = context.state.domain.timezone\n      const rows = (await completionRegister(course.id, context)).filter(row => !input.asOf || dayOf(row.enrollment.completedAt, timezone) <= input.asOf)\n      return {\n        subjectName: course.name,\n        data: {\n          course: { name: course.name },\n          count: rows.length,\n          rows: rows.map((row, index) => ({\n            no: index + 1,\n            name: row.user?.name ?? '',\n            department: row.departmentName ?? '',\n            version: row.versionNumber ?? '',\n            completedOn: dayOf(row.enrollment.completedAt, timezone),\n            minutes: Math.floor((row.enrollment.learnedSeconds ?? 0) / 60),\n            score: row.enrollment.score ?? '',\n            certificateNo: row.enrollment.certificateNo ?? ''\n          }))\n        }\n      }\n    },\n    async mayIssue(context) {\n      return await requestHolds(context, 'course', 'query')\n    },\n    async mayRead(context) {\n      return await requestHolds(context, 'course', 'query')\n    }\n  })\n}\n"]}

package/dist-server/service/enrollment/learning-outcome.d.ts

@@ -0,0 +1,10 @@
+import type { Enrollment } from './enrollment';
+export interface LearningOutcomeHandler {
+    /** The enrolment was completed - its evidence is on it. Throwing takes the completion back. */
+    completed(enrollment: Enrollment, context: any): Promise<void>;
+    /** A completed enrolment was cancelled by a manager, with the reason. Throwing takes the cancellation back. */
+    cancelled?(enrollment: Enrollment, reason: string, context: any): Promise<void>;
+}
+/** Registers the handler of a source kind (`compliance.training-session`) - a second registration replaces the first. */
+export declare function registerLearningOutcome(sourceKind: string, handler: LearningOutcomeHandler | null): void;
+export declare function learningOutcomeOf(sourceKind: string): LearningOutcomeHandler | undefined;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLearningOutcome = registerLearningOutcome;
+exports.learningOutcomeOf = learningOutcomeOf;
+const handlers = new Map();
+/** Registers the handler of a source kind (`compliance.training-session`) - a second registration replaces the first. */
+function registerLearningOutcome(sourceKind, handler) {
+    if (handler)
+        handlers.set(sourceKind, handler);
+    else
+        handlers.delete(sourceKind);
+}
+function learningOutcomeOf(sourceKind) {
+    return handlers.get(sourceKind);
+}
+//# sourceMappingURL=learning-outcome.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-outcome.js","sourceRoot":"","sources":["../../../server/service/enrollment/learning-outcome.ts"],"names":[],"mappings":";;AAiBA,0DAGC;AAED,8CAEC;AAVD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAA;AAE1D,yHAAyH;AACzH,SAAgB,uBAAuB,CAAC,UAAkB,EAAE,OAAsC;IAChG,IAAI,OAAO;QAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;;QACzC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AAClC,CAAC;AAED,SAAgB,iBAAiB,CAAC,UAAkB;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AACjC,CAAC","sourcesContent":["/*\n * Telling whoever asked for an enrolment that it was completed or cancelled (ADR-0194 decisions 7, 8) - the same shape\n * as accounting's `registerPaymentTarget`. The module that asks for enrolments registers one handler per source kind;\n * this module calls it in the completion's own transaction, so a handler that fails takes the completion back with it.\n */\nimport type { Enrollment } from './enrollment'\n\nexport interface LearningOutcomeHandler {\n  /** The enrolment was completed - its evidence is on it. Throwing takes the completion back. */\n  completed(enrollment: Enrollment, context: any): Promise<void>\n  /** A completed enrolment was cancelled by a manager, with the reason. Throwing takes the cancellation back. */\n  cancelled?(enrollment: Enrollment, reason: string, context: any): Promise<void>\n}\n\nconst handlers = new Map<string, LearningOutcomeHandler>()\n\n/** Registers the handler of a source kind (`compliance.training-session`) - a second registration replaces the first. */\nexport function registerLearningOutcome(sourceKind: string, handler: LearningOutcomeHandler | null): void {\n  if (handler) handlers.set(sourceKind, handler)\n  else handlers.delete(sourceKind)\n}\n\nexport function learningOutcomeOf(sourceKind: string): LearningOutcomeHandler | undefined {\n  return handlers.get(sourceKind)\n}\n"]}

package/dist-server/service/enrollment/progress-rules.d.ts

@@ -0,0 +1,119 @@
+/** The longest a tick is counted for, in seconds - the screen sends one every 15 seconds looked at. */
+export declare const TICK_SECONDS = 15;
+/** How far ahead of what was watched a position still reads as watching - the video's own step between two updates. */
+export declare const POSITION_SLACK_SECONDS = 2;
+/** How long a PDF or a text is looked at to be done when its unit says nothing. */
+export declare const DEFAULT_UNIT_SECONDS = 60;
+export interface ProgressNow {
+    learnedSeconds: number;
+    watchedSeconds: number;
+    /** The furthest page of a PDF arrived at. */
+    pagesSeen?: number | null;
+    /** The furthest page of a PDF read through - looked at for its seconds. */
+    pagesRead?: number | null;
+    /** The seconds looked at on the furthest page arrived at, so far. */
+    pageSeconds?: number | null;
+    /** The page it was on until this tick. */
+    pageAt?: number | null;
+    lastTickAt?: Date | null;
+}
+export interface Tick {
+    /** What the screen says it looked at since its last tick - it may lower what is counted, never raise it. */
+    seconds: number;
+    /** Where it stands - a video's second, a PDF's page (from 1); 0 for a text. */
+    position: number;
+}
+export interface UnitShape {
+    kind: string;
+    durationSeconds?: number | null;
+    pageCount?: number | null;
+    minSeconds?: number | null;
+}
+export type TickVerdict = {
+    refusal: 'position-ahead';
+    allowed: number;
+} | {
+    refusal: 'page-ahead';
+    allowed: number;
+} | {
+    add: number;
+    watchedSeconds: number;
+    positionSeconds: number;
+    pagesSeen: number;
+    pagesRead: number;
+    pageSeconds: number;
+    pageAt: number;
+};
+/** The fewest seconds a PDF page is looked at to count as read - its unit's time shared by its pages, 3 at least. */
+export declare function secondsPerPage(unit: UnitShape): number;
+/**
+ * What one tick does (decision 6). The time added is the gap since the last tick, at most 15 seconds and at most what
+ * the screen says - a tick with no tick before it starts the clock and adds nothing.
+ *
+ * - A video's position may not be ahead of what was watched by more than the time that passed: a move ahead is refused,
+ *   a move back is free.
+ * - A PDF is read page by page (2026-11-08, the user). The seconds since the last tick were spent on the page it was on;
+ *   the furthest page arrived at is read once its own seconds reach `secondsPerPage`. A tick may turn only to a page
+ *   read or the one after the furthest read - two turns at the same moment do not read the page between them; going
+ *   back is free.
+ */
+export declare function tickVerdict(progress: ProgressNow, tick: Tick, now: Date, unit: UnitShape): TickVerdict;
+/** Whether a unit counts toward completion - a link does not: the server cannot know what was watched elsewhere. */
+export declare const counts: (unit: UnitShape) => boolean;
+/**
+ * Whether a unit is done (decision 3): a video watched to its end (its length known) **and** its running time counted
+ * by the server - a skip or a faster playback reaches neither; a PDF with every page read through - the last one too (its
+ * page count known) - and its time; a text looked at for its time. A link is never done - it does not count.
+ */
+export declare function unitDone(unit: UnitShape, progress: {
+    learnedSeconds: number;
+    watchedSeconds: number;
+    pagesRead?: number | null;
+}): boolean;
+export interface CompletionFacts {
+    /** The units that count, and the ones of them done. */
+    units: number;
+    unitsDone: number;
+    learnedSeconds: number;
+    minSeconds: number;
+    /** The version has a quiz - questions and a pass score. */
+    quiz: boolean;
+    passed: boolean;
+    /** The version asks for an acknowledgement. */
+    acknowledgement: boolean;
+    acknowledged: boolean;
+}
+export type Missing = 'units' | 'time' | 'quiz' | 'acknowledgement';
+/**
+ * What still stands between an enrolment and its completion (decision 8) - every unit done, the least time, the quiz
+ * passed when there is one, the acknowledgement confirmed when one is asked. Complete when nothing is missing.
+ */
+export declare function missingOf(facts: CompletionFacts): Missing[];
+export interface QuestionKey {
+    id: string;
+    kind: string;
+    choices: {
+        id: string;
+        correct: boolean;
+    }[];
+}
+/**
+ * A quiz's score, out of 100 (decision 4): each question is right when the choices picked are exactly the right ones -
+ * one for SINGLE and TRUE_FALSE, every right one and no other for MULTIPLE.
+ */
+export declare function scoreOf(questions: QuestionKey[], answers: Record<string, string[]>): number;
+/** The questions an attempt draws - `count` of them (all when empty), in a shuffled order, each with its choices shuffled. */
+export declare function drawQuestions<Q extends {
+    id: string;
+    choices: {
+        id: string;
+    }[];
+}>(questions: Q[], count: number | null | undefined, random?: () => number): {
+    questionId: string;
+    choiceIds: string[];
+}[];
+/** The day an enrolment reads as overdue: open, and its due day before today. */
+export declare const overdue: (enrollment: {
+    status: string;
+    dueOn?: string | null;
+}, today: string) => boolean;

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

@@ -0,0 +1,132 @@
+"use strict";
+/*
+ * What the server decides of learning by itself (ADR-0194 decisions 4, 6, 8) - data in, verdict out, no database: the
+ * time a tick adds, where a video may stand, when a unit is done, whether an enrolment is complete, and a quiz's score.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overdue = exports.counts = exports.DEFAULT_UNIT_SECONDS = exports.POSITION_SLACK_SECONDS = exports.TICK_SECONDS = void 0;
+exports.secondsPerPage = secondsPerPage;
+exports.tickVerdict = tickVerdict;
+exports.unitDone = unitDone;
+exports.missingOf = missingOf;
+exports.scoreOf = scoreOf;
+exports.drawQuestions = drawQuestions;
+/** The longest a tick is counted for, in seconds - the screen sends one every 15 seconds looked at. */
+exports.TICK_SECONDS = 15;
+/** How far ahead of what was watched a position still reads as watching - the video's own step between two updates. */
+exports.POSITION_SLACK_SECONDS = 2;
+/** How long a PDF or a text is looked at to be done when its unit says nothing. */
+exports.DEFAULT_UNIT_SECONDS = 60;
+/** The fewest seconds a PDF page is looked at to count as read - its unit's time shared by its pages, 3 at least. */
+function secondsPerPage(unit) {
+    return Math.max(3, Math.ceil((unit.minSeconds ?? exports.DEFAULT_UNIT_SECONDS) / Math.max(1, unit.pageCount ?? 1)));
+}
+/**
+ * What one tick does (decision 6). The time added is the gap since the last tick, at most 15 seconds and at most what
+ * the screen says - a tick with no tick before it starts the clock and adds nothing.
+ *
+ * - A video's position may not be ahead of what was watched by more than the time that passed: a move ahead is refused,
+ *   a move back is free.
+ * - A PDF is read page by page (2026-11-08, the user). The seconds since the last tick were spent on the page it was on;
+ *   the furthest page arrived at is read once its own seconds reach `secondsPerPage`. A tick may turn only to a page
+ *   read or the one after the furthest read - two turns at the same moment do not read the page between them; going
+ *   back is free.
+ */
+function tickVerdict(progress, tick, now, unit) {
+    const gap = progress.lastTickAt ? Math.max(0, (now.getTime() - new Date(progress.lastTickAt).getTime()) / 1000) : 0;
+    const said = Math.max(0, Number(tick.seconds) || 0);
+    const add = progress.lastTickAt ? Math.floor(Math.min(exports.TICK_SECONDS, gap, said)) : 0;
+    const position = Math.max(0, Math.floor(Number(tick.position) || 0));
+    let seen = progress.pagesSeen ?? 0;
+    let read = progress.pagesRead ?? 0;
+    let onPage = progress.pageSeconds ?? 0;
+    const kept = { pagesSeen: seen, pagesRead: read, pageSeconds: onPage };
+    if (unit.kind === 'VIDEO') {
+        const allowed = progress.watchedSeconds + Math.min(exports.TICK_SECONDS, gap) + exports.POSITION_SLACK_SECONDS;
+        if (position > allowed)
+            return { refusal: 'position-ahead', allowed: Math.floor(progress.watchedSeconds) };
+        return { add, watchedSeconds: Math.max(progress.watchedSeconds, position), positionSeconds: position, ...kept, pageAt: 0 };
+    }
+    if (unit.kind === 'PDF') {
+        /* The time since the last tick goes to the page it was on - it reads the furthest page only when it was there. */
+        const was = progress.pageAt ?? 0;
+        if (was > 0 && was === seen) {
+            onPage += add;
+            if (onPage >= secondsPerPage(unit))
+                read = Math.max(read, seen);
+        }
+        const page = Math.max(1, position);
+        if (page > read + 1)
+            return { refusal: 'page-ahead', allowed: read };
+        if (page > seen) {
+            seen = page;
+            onPage = 0;
+        }
+        return { add, watchedSeconds: progress.watchedSeconds, positionSeconds: 0, pagesSeen: seen, pagesRead: read, pageSeconds: onPage, pageAt: page };
+    }
+    return { add, watchedSeconds: progress.watchedSeconds, positionSeconds: 0, ...kept, pageAt: 0 };
+}
+/** Whether a unit counts toward completion - a link does not: the server cannot know what was watched elsewhere. */
+const counts = (unit) => unit.kind !== 'LINK';
+exports.counts = counts;
+/**
+ * Whether a unit is done (decision 3): a video watched to its end (its length known) **and** its running time counted
+ * by the server - a skip or a faster playback reaches neither; a PDF with every page read through - the last one too (its
+ * page count known) - and its time; a text looked at for its time. A link is never done - it does not count.
+ */
+function unitDone(unit, progress) {
+    if (unit.kind === 'VIDEO')
+        return !!unit.durationSeconds && progress.watchedSeconds >= unit.durationSeconds - exports.POSITION_SLACK_SECONDS && progress.learnedSeconds >= unit.durationSeconds - exports.TICK_SECONDS;
+    if (unit.kind === 'PDF')
+        return !!unit.pageCount && (progress.pagesRead ?? 0) >= unit.pageCount && progress.learnedSeconds >= (unit.minSeconds ?? exports.DEFAULT_UNIT_SECONDS);
+    if (unit.kind === 'MARKDOWN')
+        return progress.learnedSeconds >= (unit.minSeconds ?? exports.DEFAULT_UNIT_SECONDS);
+    return false;
+}
+/**
+ * What still stands between an enrolment and its completion (decision 8) - every unit done, the least time, the quiz
+ * passed when there is one, the acknowledgement confirmed when one is asked. Complete when nothing is missing.
+ */
+function missingOf(facts) {
+    const missing = [];
+    if (facts.unitsDone < facts.units)
+        missing.push('units');
+    if (facts.learnedSeconds < facts.minSeconds)
+        missing.push('time');
+    if (facts.quiz && !facts.passed)
+        missing.push('quiz');
+    if (facts.acknowledgement && !facts.acknowledged)
+        missing.push('acknowledgement');
+    return missing;
+}
+/**
+ * A quiz's score, out of 100 (decision 4): each question is right when the choices picked are exactly the right ones -
+ * one for SINGLE and TRUE_FALSE, every right one and no other for MULTIPLE.
+ */
+function scoreOf(questions, answers) {
+    if (!questions.length)
+        return 0;
+    const right = questions.filter(question => {
+        const picked = new Set(answers?.[question.id] ?? []);
+        const correct = question.choices.filter(one => one.correct).map(one => one.id);
+        return picked.size === correct.length && correct.every(id => picked.has(id));
+    }).length;
+    return Math.round((right / questions.length) * 100);
+}
+/** The questions an attempt draws - `count` of them (all when empty), in a shuffled order, each with its choices shuffled. */
+function drawQuestions(questions, count, random = Math.random) {
+    const shuffle = (items) => {
+        const out = [...items];
+        for (let i = out.length - 1; i > 0; i--) {
+            const j = Math.floor(random() * (i + 1));
+            [out[i], out[j]] = [out[j], out[i]];
+        }
+        return out;
+    };
+    const picked = shuffle(questions).slice(0, count && count > 0 ? count : questions.length);
+    return picked.map(question => ({ questionId: question.id, choiceIds: shuffle(question.choices.map(one => one.id)) }));
+}
+/** The day an enrolment reads as overdue: open, and its due day before today. */
+const overdue = (enrollment, today) => (enrollment.status === 'ASSIGNED' || enrollment.status === 'IN_PROGRESS') && !!enrollment.dueOn && enrollment.dueOn < today;
+exports.overdue = overdue;
+//# sourceMappingURL=progress-rules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress-rules.js","sourceRoot":"","sources":["../../../server/service/enrollment/progress-rules.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2CH,wCAEC;AAaD,kCA8BC;AAUD,4BAMC;AAsBD,8BAOC;AAYD,0BAQC;AAGD,sCAWC;AArKD,uGAAuG;AAC1F,QAAA,YAAY,GAAG,EAAE,CAAA;AAC9B,uHAAuH;AAC1G,QAAA,sBAAsB,GAAG,CAAC,CAAA;AACvC,mFAAmF;AACtE,QAAA,oBAAoB,GAAG,EAAE,CAAA;AAmCtC,qHAAqH;AACrH,SAAgB,cAAc,CAAC,IAAe;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,4BAAoB,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7G,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,QAAqB,EAAE,IAAU,EAAE,GAAS,EAAE,IAAe;IACvF,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAY,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACpE,IAAI,IAAI,GAAG,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAA;IAClC,IAAI,IAAI,GAAG,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAA;IAClC,IAAI,MAAM,GAAG,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAA;IACtE,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAY,EAAE,GAAG,CAAC,GAAG,8BAAsB,CAAA;QAC9F,IAAI,QAAQ,GAAG,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAA;QAC1G,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;IAC5H,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,kHAAkH;QAClH,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAA;QAChC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAA;YACb,IAAI,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC;gBAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjE,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAClC,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACpE,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,IAAI,GAAG,IAAI,CAAA;YACX,MAAM,GAAG,CAAC,CAAA;QACZ,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAClJ,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;AACjG,CAAC;AAED,oHAAoH;AAC7G,MAAM,MAAM,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAA;AAAlD,QAAA,MAAM,UAA4C;AAE/D;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,IAAe,EAAE,QAAuF;IAC/H,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QACvB,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,GAAG,8BAAsB,IAAI,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,GAAG,oBAAY,CAAA;IAC7K,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,4BAAoB,CAAC,CAAA;IACvK,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,4BAAoB,CAAC,CAAA;IACzG,OAAO,KAAK,CAAA;AACd,CAAC;AAkBD;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAsB;IAC9C,MAAM,OAAO,GAAc,EAAE,CAAA;IAC7B,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxD,IAAI,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjE,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrD,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACjF,OAAO,OAAO,CAAA;AAChB,CAAC;AAQD;;;GAGG;AACH,SAAgB,OAAO,CAAC,SAAwB,EAAE,OAAiC;IACjF,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;QACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9E,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAC,MAAM,CAAA;IACT,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAA;AACrD,CAAC;AAED,8HAA8H;AAC9H,SAAgB,aAAa,CAAsD,SAAc,EAAE,KAAgC,EAAE,SAAuB,IAAI,CAAC,MAAM;IACrK,MAAM,OAAO,GAAG,CAAI,KAAU,EAAO,EAAE;QACrC,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;QACtB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CACvC;YAAA,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACzF,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACvH,CAAC;AAED,iFAAiF;AAC1E,MAAM,OAAO,GAAG,CAAC,UAAqD,EAAE,KAAa,EAAE,EAAE,CAC9F,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;AADhH,QAAA,OAAO,WACyG","sourcesContent":["/*\n * What the server decides of learning by itself (ADR-0194 decisions 4, 6, 8) - data in, verdict out, no database: the\n * time a tick adds, where a video may stand, when a unit is done, whether an enrolment is complete, and a quiz's score.\n */\n\n/** The longest a tick is counted for, in seconds - the screen sends one every 15 seconds looked at. */\nexport const TICK_SECONDS = 15\n/** How far ahead of what was watched a position still reads as watching - the video's own step between two updates. */\nexport const POSITION_SLACK_SECONDS = 2\n/** How long a PDF or a text is looked at to be done when its unit says nothing. */\nexport const DEFAULT_UNIT_SECONDS = 60\n\nexport interface ProgressNow {\n  learnedSeconds: number\n  watchedSeconds: number\n  /** The furthest page of a PDF arrived at. */\n  pagesSeen?: number | null\n  /** The furthest page of a PDF read through - looked at for its seconds. */\n  pagesRead?: number | null\n  /** The seconds looked at on the furthest page arrived at, so far. */\n  pageSeconds?: number | null\n  /** The page it was on until this tick. */\n  pageAt?: number | null\n  lastTickAt?: Date | null\n}\n\nexport interface Tick {\n  /** What the screen says it looked at since its last tick - it may lower what is counted, never raise it. */\n  seconds: number\n  /** Where it stands - a video's second, a PDF's page (from 1); 0 for a text. */\n  position: number\n}\n\nexport interface UnitShape {\n  kind: string\n  durationSeconds?: number | null\n  pageCount?: number | null\n  minSeconds?: number | null\n}\n\nexport type TickVerdict =\n  | { refusal: 'position-ahead'; allowed: number }\n  | { refusal: 'page-ahead'; allowed: number }\n  | { add: number; watchedSeconds: number; positionSeconds: number; pagesSeen: number; pagesRead: number; pageSeconds: number; pageAt: number }\n\n/** The fewest seconds a PDF page is looked at to count as read - its unit's time shared by its pages, 3 at least. */\nexport function secondsPerPage(unit: UnitShape): number {\n  return Math.max(3, Math.ceil((unit.minSeconds ?? DEFAULT_UNIT_SECONDS) / Math.max(1, unit.pageCount ?? 1)))\n}\n\n/**\n * What one tick does (decision 6). The time added is the gap since the last tick, at most 15 seconds and at most what\n * the screen says - a tick with no tick before it starts the clock and adds nothing.\n *\n * - A video's position may not be ahead of what was watched by more than the time that passed: a move ahead is refused,\n *   a move back is free.\n * - A PDF is read page by page (2026-11-08, the user). The seconds since the last tick were spent on the page it was on;\n *   the furthest page arrived at is read once its own seconds reach `secondsPerPage`. A tick may turn only to a page\n *   read or the one after the furthest read - two turns at the same moment do not read the page between them; going\n *   back is free.\n */\nexport function tickVerdict(progress: ProgressNow, tick: Tick, now: Date, unit: UnitShape): TickVerdict {\n  const gap = progress.lastTickAt ? Math.max(0, (now.getTime() - new Date(progress.lastTickAt).getTime()) / 1000) : 0\n  const said = Math.max(0, Number(tick.seconds) || 0)\n  const add = progress.lastTickAt ? Math.floor(Math.min(TICK_SECONDS, gap, said)) : 0\n  const position = Math.max(0, Math.floor(Number(tick.position) || 0))\n  let seen = progress.pagesSeen ?? 0\n  let read = progress.pagesRead ?? 0\n  let onPage = progress.pageSeconds ?? 0\n  const kept = { pagesSeen: seen, pagesRead: read, pageSeconds: onPage }\n  if (unit.kind === 'VIDEO') {\n    const allowed = progress.watchedSeconds + Math.min(TICK_SECONDS, gap) + POSITION_SLACK_SECONDS\n    if (position > allowed) return { refusal: 'position-ahead', allowed: Math.floor(progress.watchedSeconds) }\n    return { add, watchedSeconds: Math.max(progress.watchedSeconds, position), positionSeconds: position, ...kept, pageAt: 0 }\n  }\n  if (unit.kind === 'PDF') {\n    /* The time since the last tick goes to the page it was on - it reads the furthest page only when it was there. */\n    const was = progress.pageAt ?? 0\n    if (was > 0 && was === seen) {\n      onPage += add\n      if (onPage >= secondsPerPage(unit)) read = Math.max(read, seen)\n    }\n    const page = Math.max(1, position)\n    if (page > read + 1) return { refusal: 'page-ahead', allowed: read }\n    if (page > seen) {\n      seen = page\n      onPage = 0\n    }\n    return { add, watchedSeconds: progress.watchedSeconds, positionSeconds: 0, pagesSeen: seen, pagesRead: read, pageSeconds: onPage, pageAt: page }\n  }\n  return { add, watchedSeconds: progress.watchedSeconds, positionSeconds: 0, ...kept, pageAt: 0 }\n}\n\n/** Whether a unit counts toward completion - a link does not: the server cannot know what was watched elsewhere. */\nexport const counts = (unit: UnitShape) => unit.kind !== 'LINK'\n\n/**\n * Whether a unit is done (decision 3): a video watched to its end (its length known) **and** its running time counted\n * by the server - a skip or a faster playback reaches neither; a PDF with every page read through - the last one too (its\n * page count known) - and its time; a text looked at for its time. A link is never done - it does not count.\n */\nexport function unitDone(unit: UnitShape, progress: { learnedSeconds: number; watchedSeconds: number; pagesRead?: number | null }): boolean {\n  if (unit.kind === 'VIDEO')\n    return !!unit.durationSeconds && progress.watchedSeconds >= unit.durationSeconds - POSITION_SLACK_SECONDS && progress.learnedSeconds >= unit.durationSeconds - TICK_SECONDS\n  if (unit.kind === 'PDF') return !!unit.pageCount && (progress.pagesRead ?? 0) >= unit.pageCount && progress.learnedSeconds >= (unit.minSeconds ?? DEFAULT_UNIT_SECONDS)\n  if (unit.kind === 'MARKDOWN') return progress.learnedSeconds >= (unit.minSeconds ?? DEFAULT_UNIT_SECONDS)\n  return false\n}\n\nexport interface CompletionFacts {\n  /** The units that count, and the ones of them done. */\n  units: number\n  unitsDone: number\n  learnedSeconds: number\n  minSeconds: number\n  /** The version has a quiz - questions and a pass score. */\n  quiz: boolean\n  passed: boolean\n  /** The version asks for an acknowledgement. */\n  acknowledgement: boolean\n  acknowledged: boolean\n}\n\nexport type Missing = 'units' | 'time' | 'quiz' | 'acknowledgement'\n\n/**\n * What still stands between an enrolment and its completion (decision 8) - every unit done, the least time, the quiz\n * passed when there is one, the acknowledgement confirmed when one is asked. Complete when nothing is missing.\n */\nexport function missingOf(facts: CompletionFacts): Missing[] {\n  const missing: Missing[] = []\n  if (facts.unitsDone < facts.units) missing.push('units')\n  if (facts.learnedSeconds < facts.minSeconds) missing.push('time')\n  if (facts.quiz && !facts.passed) missing.push('quiz')\n  if (facts.acknowledgement && !facts.acknowledged) missing.push('acknowledgement')\n  return missing\n}\n\nexport interface QuestionKey {\n  id: string\n  kind: string\n  choices: { id: string; correct: boolean }[]\n}\n\n/**\n * A quiz's score, out of 100 (decision 4): each question is right when the choices picked are exactly the right ones -\n * one for SINGLE and TRUE_FALSE, every right one and no other for MULTIPLE.\n */\nexport function scoreOf(questions: QuestionKey[], answers: Record<string, string[]>): number {\n  if (!questions.length) return 0\n  const right = questions.filter(question => {\n    const picked = new Set(answers?.[question.id] ?? [])\n    const correct = question.choices.filter(one => one.correct).map(one => one.id)\n    return picked.size === correct.length && correct.every(id => picked.has(id))\n  }).length\n  return Math.round((right / questions.length) * 100)\n}\n\n/** The questions an attempt draws - `count` of them (all when empty), in a shuffled order, each with its choices shuffled. */\nexport function drawQuestions<Q extends { id: string; choices: { id: string }[] }>(questions: Q[], count: number | null | undefined, random: () => number = Math.random) {\n  const shuffle = <T>(items: T[]): T[] => {\n    const out = [...items]\n    for (let i = out.length - 1; i > 0; i--) {\n      const j = Math.floor(random() * (i + 1))\n      ;[out[i], out[j]] = [out[j], out[i]]\n    }\n    return out\n  }\n  const picked = shuffle(questions).slice(0, count && count > 0 ? count : questions.length)\n  return picked.map(question => ({ questionId: question.id, choiceIds: shuffle(question.choices.map(one => one.id)) }))\n}\n\n/** The day an enrolment reads as overdue: open, and its due day before today. */\nexport const overdue = (enrollment: { status: string; dueOn?: string | null }, today: string) =>\n  (enrollment.status === 'ASSIGNED' || enrollment.status === 'IN_PROGRESS') && !!enrollment.dueOn && enrollment.dueOn < today\n"]}

package/dist-server/service/enrollment/quiz-attempt.d.ts

@@ -0,0 +1,34 @@
+import { User } from '@things-factory/auth-base';
+import { Domain } from '@things-factory/shell';
+import { Enrollment } from './enrollment';
+/** One question as an attempt drew it - its choices in the order shown. */
+export interface DrawnQuestion {
+    questionId: string;
+    choiceIds: string[];
+}
+/**
+ * 응시 (ADR-0194 decision 4) - one attempt at a version's quiz: the questions it drew and their choices in shuffled
+ * order, and once sent, the answers and the score the server gave. The drawn questions are kept so the answers are
+ * scored against what was shown.
+ */
+export declare class QuizAttempt {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    enrollment?: Enrollment;
+    enrollmentId?: string;
+    /** The questions drawn, in order, with their choices in the order shown - not a field. */
+    drawn: DrawnQuestion[];
+    /** The choices picked for each question - not a field. */
+    answers?: Record<string, string[]>;
+    submittedAt?: Date;
+    score?: number;
+    passed?: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}