@things-factory/compliance 0.0.0-stage → 10.1.255

package/dist-server/service/regulation/regulation-mutation.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegulationMutation = void 0;
+const tslib_1 = require("tslib");
+const GraphQLUpload_js_1 = tslib_1.__importDefault(require("graphql-upload/GraphQLUpload.js"));
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const regulation_1 = require("./regulation");
+const regulation_service_1 = require("./regulation-service");
+const regulation_type_1 = require("./regulation-type");
+const KEEP = '@privilege(category: "regulation", privilege: "mutation", domainOwnerGranted: true)';
+let RegulationMutation = class RegulationMutation {
+    async createRegulation(regulation, context) {
+        return await (0, regulation_service_1.createRegulation)(regulation, context);
+    }
+    async updateRegulation(id, patch, context) {
+        return await (0, regulation_service_1.updateRegulation)(id, patch, context);
+    }
+    async deleteRegulations(ids, context) {
+        return await (0, regulation_service_1.deleteRegulations)(ids, context);
+    }
+    async newRegulationVersion(regulationId, context) {
+        return await (0, regulation_service_1.newRegulationVersion)(regulationId, context);
+    }
+    async updateRegulationVersion(id, patch, context) {
+        return await (0, regulation_service_1.updateRegulationVersion)(id, patch, context);
+    }
+    async deleteRegulationVersion(id, context) {
+        return await (0, regulation_service_1.deleteRegulationVersion)(id, context);
+    }
+    async recordRegulationProcedure(procedure, files, context) {
+        return await (0, regulation_service_1.recordRegulationProcedure)(procedure, files, context);
+    }
+    async deleteRegulationProcedure(id, context) {
+        return await (0, regulation_service_1.deleteRegulationProcedure)(id, context);
+    }
+    async submitRegulationVersion(id, context) {
+        return await (0, regulation_service_1.submitRegulationVersion)(id, context);
+    }
+    async withdrawRegulationVersion(id, context) {
+        return await (0, regulation_service_1.withdrawRegulationVersion)(id, context);
+    }
+};
+exports.RegulationMutation = RegulationMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.Regulation, { description: 'To write a new company rule, with its first version to write (ADR-0187)' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('regulation', type => regulation_type_1.NewRegulation)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [regulation_type_1.NewRegulation, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "createRegulation", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.Regulation, { description: 'To change the name, topics or place of a rule - its kind while none of its versions is adopted' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patch', type => regulation_type_1.RegulationPatch)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, regulation_type_1.RegulationPatch, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "updateRegulation", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'To delete rules none of whose versions was adopted or is in approval' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('ids', type => [String])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "deleteRegulations", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.RegulationVersion, { description: "To start the next version of a rule from the latest one's text" }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('regulationId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "newRegulationVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.RegulationVersion, { description: 'To change a version being written' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patch', type => regulation_type_1.RegulationVersionPatch)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, regulation_type_1.RegulationVersionPatch, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "updateRegulationVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'To delete a version being written' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "deleteRegulationVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.RegulationProcedure, { description: 'To record an opinion heard, a consent given or the filing of a version, with its papers' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('procedure', type => regulation_type_1.NewRegulationProcedure)),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('files', type => [GraphQLUpload_js_1.default], { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [regulation_type_1.NewRegulationProcedure, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "recordRegulationProcedure", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'To take a procedure off a version being written' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "deleteRegulationProcedure", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.RegulationVersion, { description: 'To put a version up for adoption - checked against the procedure the law asks; adopted at once where no approver is named' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "submitRegulationVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => regulation_1.RegulationVersion, { description: 'To take a version in approval back to writing' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationMutation.prototype, "withdrawRegulationVersion", null);
+exports.RegulationMutation = RegulationMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(regulation_1.Regulation),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], RegulationMutation);
+//# sourceMappingURL=regulation-mutation.js.map

package/dist-server/service/regulation/regulation-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulation-mutation.js","sourceRoot":"","sources":["../../../server/service/regulation/regulation-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\nimport { Arg, Ctx, Directive, Mutation, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { SpeakRefusals } from '@things-factory/shell'\n\nimport { Regulation, RegulationProcedure, RegulationVersion } from './regulation'\nimport {\n  createRegulation,\n  deleteRegulationProcedure,\n  deleteRegulations,\n  deleteRegulationVersion,\n  newRegulationVersion,\n  recordRegulationProcedure,\n  submitRegulationVersion,\n  updateRegulation,\n  updateRegulationVersion,\n  withdrawRegulationVersion\n} from './regulation-service'\nimport { NewRegulation, NewRegulationProcedure, RegulationPatch, RegulationVersionPatch } from './regulation-type'\n\nconst KEEP = '@privilege(category: \"regulation\", privilege: \"mutation\", domainOwnerGranted: true)'\n\n@Resolver(Regulation)\n@UseMiddleware(SpeakRefusals)\nexport class RegulationMutation {\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => Regulation, { description: 'To write a new company rule, with its first version to write (ADR-0187)' })\n  async createRegulation(@Arg('regulation', type => NewRegulation) regulation: NewRegulation, @Ctx() context: ResolverContext): Promise<Regulation> {\n    return await createRegulation(regulation, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => Regulation, { description: 'To change the name, topics or place of a rule - its kind while none of its versions is adopted' })\n  async updateRegulation(@Arg('id') id: string, @Arg('patch', type => RegulationPatch) patch: RegulationPatch, @Ctx() context: ResolverContext): Promise<Regulation> {\n    return await updateRegulation(id, patch, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, { description: 'To delete rules none of whose versions was adopted or is in approval' })\n  async deleteRegulations(@Arg('ids', type => [String]) ids: string[], @Ctx() context: ResolverContext): Promise<boolean> {\n    return await deleteRegulations(ids, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => RegulationVersion, { description: \"To start the next version of a rule from the latest one's text\" })\n  async newRegulationVersion(@Arg('regulationId') regulationId: string, @Ctx() context: ResolverContext): Promise<RegulationVersion> {\n    return await newRegulationVersion(regulationId, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => RegulationVersion, { description: 'To change a version being written' })\n  async updateRegulationVersion(@Arg('id') id: string, @Arg('patch', type => RegulationVersionPatch) patch: RegulationVersionPatch, @Ctx() context: ResolverContext): Promise<RegulationVersion> {\n    return await updateRegulationVersion(id, patch, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, { description: 'To delete a version being written' })\n  async deleteRegulationVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    return await deleteRegulationVersion(id, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => RegulationProcedure, { description: 'To record an opinion heard, a consent given or the filing of a version, with its papers' })\n  async recordRegulationProcedure(\n    @Arg('procedure', type => NewRegulationProcedure) procedure: NewRegulationProcedure,\n    @Arg('files', type => [GraphQLUpload], { nullable: true }) files: FileUpload[],\n    @Ctx() context: ResolverContext\n  ): Promise<RegulationProcedure> {\n    return await recordRegulationProcedure(procedure, files, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, { description: 'To take a procedure off a version being written' })\n  async deleteRegulationProcedure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    return await deleteRegulationProcedure(id, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => RegulationVersion, { description: 'To put a version up for adoption - checked against the procedure the law asks; adopted at once where no approver is named' })\n  async submitRegulationVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<RegulationVersion> {\n    return await submitRegulationVersion(id, context)\n  }\n\n  @Directive(KEEP)\n  @Directive('@transaction')\n  @Mutation(returns => RegulationVersion, { description: 'To take a version in approval back to writing' })\n  async withdrawRegulationVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<RegulationVersion> {\n    return await withdrawRegulationVersion(id, context)\n  }\n}\n"]}

package/dist-server/service/regulation/regulation-query.d.ts

@@ -0,0 +1,10 @@
+import { ListParam } from '@things-factory/shell';
+import { RegulationList, RegulationView } from './regulation-type';
+export declare class RegulationQuery {
+    regulations(params: ListParam, context: ResolverContext): Promise<RegulationList>;
+    companyRegulations(topic: string, context: ResolverContext): Promise<RegulationView[]>;
+    companyRegulation(id: string, code: string, context: ResolverContext): Promise<RegulationView>;
+    amIComplianceEmployee(context: ResolverContext): Promise<boolean>;
+    regulationKeeper(context: ResolverContext): Promise<boolean>;
+    activeEmployeeCount(context: ResolverContext): Promise<number>;
+}

package/dist-server/service/regulation/regulation-query.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegulationQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const organization_1 = require("@things-factory/organization");
+const employee_profile_rules_js_1 = require("@things-factory/organization/dist-server/service/employee-profile/employee-profile-rules.js");
+const shell_1 = require("@things-factory/shell");
+const employee_reader_1 = require("../common/employee-reader");
+const regulation_1 = require("./regulation");
+const regulation_read_1 = require("./regulation-read");
+const regulation_type_1 = require("./regulation-type");
+const KEEP = '@privilege(category: "regulation", privilege: "query", domainOwnerGranted: true)';
+let RegulationQuery = class RegulationQuery {
+    async regulations(params, context) {
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            domain: context.state.domain,
+            params,
+            repository: (0, shell_1.getRepository)(regulation_1.Regulation),
+            searchables: ['code', 'name'],
+            alias: 'regulation',
+            defaultSortings: [{ name: 'rank' }, { name: 'name' }]
+        });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async companyRegulations(topic, context) {
+        const keeper = await (0, regulation_read_1.requireRuleReader)(context);
+        const rows = await (0, shell_1.getRepository)(regulation_1.Regulation).find({ where: { domain: { id: context.state.domain.id } }, order: { rank: 'ASC', name: 'ASC' } });
+        const views = await Promise.all(rows.filter(one => !topic || (one.topics ?? []).includes(topic)).map(one => (0, regulation_read_1.viewOfRegulation)(undefined, context, one, keeper)));
+        return views.filter(one => keeper || one.versions.length);
+    }
+    async companyRegulation(id, code, context) {
+        const keeper = await (0, regulation_read_1.requireRuleReader)(context);
+        const where = id ? { id } : { code };
+        const row = await (0, shell_1.getRepository)(regulation_1.Regulation).findOne({ where: { ...where, domain: { id: context.state.domain.id } } });
+        const view = row ? await (0, regulation_read_1.viewOfRegulation)(undefined, context, row, keeper) : null;
+        if (!view || (!keeper && !view.versions.length))
+            throw new shell_1.Refusal('regulation-not-found', {}, 'the rule was not found. reload and try again.');
+        return view;
+    }
+    async amIComplianceEmployee(context) {
+        return !!(await (0, employee_reader_1.workingEmployeeOf)(context));
+    }
+    async regulationKeeper(context) {
+        return await (0, regulation_read_1.keepsRules)(context);
+    }
+    async activeEmployeeCount(context) {
+        const { domain } = context.state;
+        const today = (0, employee_reader_1.todayIn)(domain);
+        return (await (0, shell_1.getRepository)(organization_1.Employee).find({ where: { domain: { id: domain.id } } })).filter(one => (0, employee_profile_rules_js_1.isActiveEmployee)(one, today)).length;
+    }
+};
+exports.RegulationQuery = RegulationQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Query)(returns => regulation_type_1.RegulationList, { description: '규정 관리 - the rules of the company, to their keepers (ADR-0187)' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "regulations", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => [regulation_type_1.RegulationView], {
+        description: "회사 규정 - every rule with its versions as the request may read them: adopted ones to the domain's employees, the rest to the keepers; a partner is refused. `topic` narrows to the rules answering a section of the guide."
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('topic', { nullable: true })),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "companyRegulations", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => regulation_type_1.RegulationView, { description: 'One rule as the request may read it, by id or by code' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id', { nullable: true })),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('code', { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "companyRegulation", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => Boolean, { description: 'Whether the request is an employee of the domain - who reads its rules and opens 「회사 규정과 안내」' }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "amIComplianceEmployee", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => Boolean, { description: 'Whether the request keeps the rules - the screens offer managing them' }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "regulationKeeper", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(KEEP),
+    (0, type_graphql_1.Query)(returns => type_graphql_1.Int, { description: "How many employees work here today - shown beside the workers' count a procedure is of, for reference only" }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RegulationQuery.prototype, "activeEmployeeCount", null);
+exports.RegulationQuery = RegulationQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(regulation_1.Regulation),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], RegulationQuery);
+//# sourceMappingURL=regulation-query.js.map

package/dist-server/service/regulation/regulation-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulation-query.js","sourceRoot":"","sources":["../../../server/service/regulation/regulation-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Args, Ctx, Directive, Int, Query, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { Employee } from '@things-factory/organization'\nimport { isActiveEmployee } from '@things-factory/organization/dist-server/service/employee-profile/employee-profile-rules.js'\nimport { getQueryBuilderFromListParams, getRepository, ListParam, Refusal, SpeakRefusals } from '@things-factory/shell'\n\nimport { todayIn, workingEmployeeOf } from '../common/employee-reader'\nimport { Regulation } from './regulation'\nimport { keepsRules, requireRuleReader, viewOfRegulation } from './regulation-read'\nimport { RegulationList, RegulationView } from './regulation-type'\n\nconst KEEP = '@privilege(category: \"regulation\", privilege: \"query\", domainOwnerGranted: true)'\n\n@Resolver(Regulation)\n@UseMiddleware(SpeakRefusals)\nexport class RegulationQuery {\n  @Directive(KEEP)\n  @Query(returns => RegulationList, { description: '규정 관리 - the rules of the company, to their keepers (ADR-0187)' })\n  async regulations(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<RegulationList> {\n    const queryBuilder = getQueryBuilderFromListParams({\n      domain: context.state.domain,\n      params,\n      repository: getRepository(Regulation),\n      searchables: ['code', 'name'],\n      alias: 'regulation',\n      defaultSortings: [{ name: 'rank' }, { name: 'name' }]\n    })\n    const [items, total] = await queryBuilder.getManyAndCount()\n    return { items, total }\n  }\n\n  @Query(returns => [RegulationView], {\n    description: \"회사 규정 - every rule with its versions as the request may read them: adopted ones to the domain's employees, the rest to the keepers; a partner is refused. `topic` narrows to the rules answering a section of the guide.\"\n  })\n  async companyRegulations(@Arg('topic', { nullable: true }) topic: string, @Ctx() context: ResolverContext): Promise<RegulationView[]> {\n    const keeper = await requireRuleReader(context)\n    const rows = await getRepository(Regulation).find({ where: { domain: { id: context.state.domain.id } } as any, order: { rank: 'ASC', name: 'ASC' } as any })\n    const views = await Promise.all(rows.filter(one => !topic || (one.topics ?? []).includes(topic)).map(one => viewOfRegulation(undefined, context, one, keeper)))\n    return views.filter(one => keeper || one.versions.length)\n  }\n\n  @Query(returns => RegulationView, { description: 'One rule as the request may read it, by id or by code' })\n  async companyRegulation(@Arg('id', { nullable: true }) id: string, @Arg('code', { nullable: true }) code: string, @Ctx() context: ResolverContext): Promise<RegulationView> {\n    const keeper = await requireRuleReader(context)\n    const where = id ? { id } : { code }\n    const row = await getRepository(Regulation).findOne({ where: { ...where, domain: { id: context.state.domain.id } } as any })\n    const view = row ? await viewOfRegulation(undefined, context, row, keeper) : null\n    if (!view || (!keeper && !view.versions.length)) throw new Refusal('regulation-not-found', {}, 'the rule was not found. reload and try again.')\n    return view\n  }\n\n  @Query(returns => Boolean, { description: 'Whether the request is an employee of the domain - who reads its rules and opens 「회사 규정과 안내」' })\n  async amIComplianceEmployee(@Ctx() context: ResolverContext): Promise<boolean> {\n    return !!(await workingEmployeeOf(context))\n  }\n\n  @Query(returns => Boolean, { description: 'Whether the request keeps the rules - the screens offer managing them' })\n  async regulationKeeper(@Ctx() context: ResolverContext): Promise<boolean> {\n    return await keepsRules(context)\n  }\n\n  @Directive(KEEP)\n  @Query(returns => Int, { description: \"How many employees work here today - shown beside the workers' count a procedure is of, for reference only\" })\n  async activeEmployeeCount(@Ctx() context: ResolverContext): Promise<number> {\n    const { domain } = context.state\n    const today = todayIn(domain)\n    return (await getRepository(Employee).find({ where: { domain: { id: domain.id } } as any })).filter(one => isActiveEmployee(one as any, today)).length\n  }\n}\n"]}

package/dist-server/service/regulation/regulation-read.d.ts

@@ -0,0 +1,21 @@
+import { EntityManager } from 'typeorm';
+import { type HelpPart } from '@things-factory/help';
+import { Regulation, RegulationVersion } from './regulation';
+import { RegulationVersionView, RegulationView } from './regulation-type';
+/** Whether the request keeps the rules. */
+export declare const keepsRules: (context: any) => Promise<boolean>;
+/** Whether the request may read the adopted rules - an employee of the domain, or a keeper. */
+export declare function readsRules(context: any): Promise<boolean>;
+/** A version as the request sees it, or nothing when it may not. */
+export declare function viewOfVersion(tx: EntityManager | undefined, context: any, version: RegulationVersion, siblings: RegulationVersion[], keeper: boolean): Promise<RegulationVersionView | null>;
+/** A rule as the request sees it - its versions, the one in force and the one due. */
+export declare function viewOfRegulation(tx: EntityManager | undefined, context: any, regulation: Regulation, keeper: boolean): Promise<RegulationView>;
+/** The request may read the rules, or is refused - a partner is told so. */
+export declare function requireRuleReader(context: any): Promise<boolean>;
+/** The help's parts of the rules: an article of each version in force or due is a part (ADR-0187 decision 12). */
+export declare function regulationParts(domain: {
+    id: string;
+    timezone?: string;
+}): Promise<HelpPart[]>;
+/** The rules' articles in the help's search, and the papers of a procedure to its keepers only. */
+export declare function registerRegulationReaders(): void;

package/dist-server/service/regulation/regulation-read.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keepsRules = void 0;
+exports.readsRules = readsRules;
+exports.viewOfVersion = viewOfVersion;
+exports.viewOfRegulation = viewOfRegulation;
+exports.requireRuleReader = requireRuleReader;
+exports.regulationParts = regulationParts;
+exports.registerRegulationReaders = registerRegulationReaders;
+const typeorm_1 = require("typeorm");
+const announcement_1 = require("@things-factory/announcement");
+const attachment_base_1 = require("@things-factory/attachment-base");
+const help_1 = require("@things-factory/help");
+const shell_1 = require("@things-factory/shell");
+const employee_reader_1 = require("../common/employee-reader");
+const regulation_1 = require("./regulation");
+const regulation_rules_1 = require("./regulation-rules");
+const regulation_service_1 = require("./regulation-service");
+/*
+ * Who reads a company rule (ADR-0187 decision 7), asked by every door - the list, one rule, its papers, the help's search:
+ * an adopted version, past ones too, is read by the domain's employees; a version being written or in approval, the
+ * procedure and its papers by the keepers of the rules (`regulation`) only. A partner reads none.
+ */
+/** Whether the request keeps the rules. */
+const keepsRules = (context) => (0, employee_reader_1.holds)(context, 'regulation', 'query');
+exports.keepsRules = keepsRules;
+/** Whether the request may read the adopted rules - an employee of the domain, or a keeper. */
+async function readsRules(context) {
+    return !!(await (0, employee_reader_1.workingEmployeeOf)(context)) || (await (0, exports.keepsRules)(context));
+}
+/** A version as the request sees it, or nothing when it may not. */
+async function viewOfVersion(tx, context, version, siblings, keeper) {
+    const { domain, user } = context.state;
+    if (version.status !== regulation_1.RegulationVersionStatus.ADOPTED && !keeper)
+        return null;
+    const today = (0, employee_reader_1.todayIn)(domain);
+    const standing = (0, regulation_rules_1.standingOf)(siblings, today);
+    const adopted = siblings.filter(one => one.status === regulation_1.RegulationVersionStatus.ADOPTED && one.effectiveOn).sort((a, b) => (a.effectiveOn < b.effectiveOn ? -1 : 1));
+    const next = adopted.find(one => one.effectiveOn > (version.effectiveOn ?? '') && one.id !== version.id);
+    const clauses = version.status === regulation_1.RegulationVersionStatus.ADOPTED
+        ? await (0, shell_1.getRepository)(regulation_1.RegulationClause, tx).find({ where: { version: { id: version.id } }, order: { rank: 'ASC' } })
+        : (0, regulation_rules_1.clausesOf)(version.body).map((one, rank) => ({ id: `${version.id}:${rank}`, rank, versionId: version.id, ...one }));
+    const before = await (0, regulation_service_1.previousAdopted)((0, shell_1.getRepository)(regulation_1.RegulationVersion, tx).manager, version);
+    const changes = (0, regulation_rules_1.clauseChanges)(before ? (0, regulation_rules_1.clausesOf)(before.body) : [], (0, regulation_rules_1.clausesOf)(version.body)).map(one => ({ ...one, title: one.title ?? undefined }));
+    const announcement = version.announcementId ? (await (0, regulation_service_1.announcementsOfVersions)((0, shell_1.getRepository)(regulation_1.RegulationVersion, tx).manager, domain, [version.id])).get(version.id) : undefined;
+    const receipt = announcement ? (await (0, announcement_1.receiptsOf)([announcement.id], user.id, tx)).get(announcement.id) : undefined;
+    return {
+        version,
+        period: (0, regulation_rules_1.periodOfVersion)(version, standing, today),
+        endsOn: version.status === regulation_1.RegulationVersionStatus.ADOPTED ? next?.effectiveOn : undefined,
+        clauses,
+        changes,
+        procedures: keeper ? (await (0, regulation_service_1.proceduresOf)((0, shell_1.getRepository)(regulation_1.RegulationVersion, tx).manager, domain, [version.id])) : undefined,
+        announcement: keeper ? announcement : undefined,
+        told: announcement?.status === 'PUBLISHED',
+        readAt: receipt?.acknowledgedAt ?? undefined
+    };
+}
+/** A rule as the request sees it - its versions, the one in force and the one due. */
+async function viewOfRegulation(tx, context, regulation, keeper) {
+    const today = (0, employee_reader_1.todayIn)(context.state.domain);
+    const siblings = await (0, shell_1.getRepository)(regulation_1.RegulationVersion, tx).find({ where: { regulation: { id: regulation.id } }, order: { version: 'DESC' } });
+    const views = (await Promise.all(siblings.map(one => viewOfVersion(tx, context, one, siblings, keeper)))).filter(Boolean);
+    const standing = (0, regulation_rules_1.standingOf)(siblings, today);
+    return { regulation, inForce: views.find(one => one.version.id === standing.inForce?.id), due: views.find(one => one.version.id === standing.due?.id), versions: views };
+}
+/** The request may read the rules, or is refused - a partner is told so. */
+async function requireRuleReader(context) {
+    const keeper = await (0, exports.keepsRules)(context);
+    if (!keeper && !(await (0, employee_reader_1.workingEmployeeOf)(context)))
+        throw new shell_1.Refusal('compliance-employees-only', {}, 'only an employee of this company reads its rules');
+    return keeper;
+}
+/** The help's parts of the rules: an article of each version in force or due is a part (ADR-0187 decision 12). */
+async function regulationParts(domain) {
+    const today = (0, employee_reader_1.todayIn)(domain);
+    const regulations = await (0, shell_1.getRepository)(regulation_1.Regulation).find({ where: { domain: { id: domain.id } } });
+    if (!regulations.length)
+        return [];
+    const versions = await (0, shell_1.getRepository)(regulation_1.RegulationVersion).find({ where: { regulation: { id: (0, typeorm_1.In)(regulations.map(one => one.id)) }, status: regulation_1.RegulationVersionStatus.ADOPTED } });
+    const parts = [];
+    for (const regulation of regulations) {
+        const { inForce, due } = (0, regulation_rules_1.standingOf)(versions.filter(one => one.regulationId === regulation.id), today);
+        for (const version of [inForce, due].filter(Boolean)) {
+            const clauses = await (0, shell_1.getRepository)(regulation_1.RegulationClause).find({ where: { version: { id: version.id } }, order: { rank: 'ASC' } });
+            const when = version === due ? `${version.effectiveOn} 시행 예정` : `${version.effectiveOn} 시행`;
+            for (const clause of clauses)
+                parts.push({
+                    topic: `${regulation_service_1.REGULATION_HELP_SOURCE}/${regulation.code}`,
+                    section: clause.number,
+                    lang: '',
+                    title: `${regulation.name} 제${clause.number}조${clause.title ? `(${clause.title})` : ''}`,
+                    documentTitle: regulation.name,
+                    summary: `제${version.version}판 · ${when}.`,
+                    text: `제${version.version}판 · ${when}. ${clause.text}`,
+                    link: `regulations?regulation=${encodeURIComponent(regulation.code)}&clause=${encodeURIComponent(clause.number)}`
+                });
+        }
+    }
+    return parts;
+}
+/** The rules' articles in the help's search, and the papers of a procedure to its keepers only. */
+function registerRegulationReaders() {
+    (0, help_1.registerHelpSource)({ name: regulation_service_1.REGULATION_HELP_SOURCE, partsOf: domain => regulationParts(domain), mayRead: readsRules });
+    (0, attachment_base_1.registerAttachmentReader)(regulation_service_1.REGULATION_PROCEDURE_REF_TYPE, async (attachment, context) => {
+        if (!attachment.refBy || !(await (0, exports.keepsRules)(context)))
+            return false;
+        return !!(await (0, shell_1.getRepository)(regulation_1.RegulationProcedure).findOne({ where: { id: attachment.refBy, domain: { id: context.state.domain.id } } }));
+    });
+}
+//# sourceMappingURL=regulation-read.js.map

package/dist-server/service/regulation/regulation-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulation-read.js","sourceRoot":"","sources":["../../../server/service/regulation/regulation-read.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { receiptsOf } from '@things-factory/announcement'\nimport { registerAttachmentReader } from '@things-factory/attachment-base'\nimport { registerHelpSource, type HelpPart } from '@things-factory/help'\nimport { getRepository, Refusal } from '@things-factory/shell'\n\nimport { holds, todayIn, workingEmployeeOf } from '../common/employee-reader'\nimport { Regulation, RegulationClause, RegulationProcedure, RegulationVersion, RegulationVersionStatus } from './regulation'\nimport { clauseChanges, clausesOf, periodOfVersion, standingOf } from './regulation-rules'\nimport { announcementsOfVersions, previousAdopted, proceduresOf, REGULATION_HELP_SOURCE, REGULATION_PROCEDURE_REF_TYPE } from './regulation-service'\nimport { RegulationVersionView, RegulationView } from './regulation-type'\n\n/*\n * Who reads a company rule (ADR-0187 decision 7), asked by every door - the list, one rule, its papers, the help's search:\n * an adopted version, past ones too, is read by the domain's employees; a version being written or in approval, the\n * procedure and its papers by the keepers of the rules (`regulation`) only. A partner reads none.\n */\n\n/** Whether the request keeps the rules. */\nexport const keepsRules = (context: any) => holds(context, 'regulation', 'query')\n\n/** Whether the request may read the adopted rules - an employee of the domain, or a keeper. */\nexport async function readsRules(context: any): Promise<boolean> {\n  return !!(await workingEmployeeOf(context)) || (await keepsRules(context))\n}\n\n/** A version as the request sees it, or nothing when it may not. */\nexport async function viewOfVersion(tx: EntityManager | undefined, context: any, version: RegulationVersion, siblings: RegulationVersion[], keeper: boolean): Promise<RegulationVersionView | null> {\n  const { domain, user } = context.state\n  if (version.status !== RegulationVersionStatus.ADOPTED && !keeper) return null\n  const today = todayIn(domain)\n  const standing = standingOf(siblings, today)\n  const adopted = siblings.filter(one => one.status === RegulationVersionStatus.ADOPTED && one.effectiveOn).sort((a, b) => (a.effectiveOn! < b.effectiveOn! ? -1 : 1))\n  const next = adopted.find(one => one.effectiveOn! > (version.effectiveOn ?? '') && one.id !== version.id)\n  const clauses =\n    version.status === RegulationVersionStatus.ADOPTED\n      ? await getRepository(RegulationClause, tx).find({ where: { version: { id: version.id } } as any, order: { rank: 'ASC' } as any })\n      : (clausesOf(version.body).map((one, rank) => ({ id: `${version.id}:${rank}`, rank, versionId: version.id, ...one })) as any[])\n  const before = await previousAdopted(getRepository(RegulationVersion, tx).manager, version)\n  const changes = clauseChanges(before ? clausesOf(before.body) : [], clausesOf(version.body)).map(one => ({ ...one, title: one.title ?? undefined }))\n  const announcement = version.announcementId ? (await announcementsOfVersions(getRepository(RegulationVersion, tx).manager, domain, [version.id])).get(version.id) : undefined\n  const receipt = announcement ? (await receiptsOf([announcement.id], user.id, tx)).get(announcement.id) : undefined\n  return {\n    version,\n    period: periodOfVersion(version, standing, today),\n    endsOn: version.status === RegulationVersionStatus.ADOPTED ? next?.effectiveOn : undefined,\n    clauses,\n    changes,\n    procedures: keeper ? ((await proceduresOf(getRepository(RegulationVersion, tx).manager, domain, [version.id])) as any) : undefined,\n    announcement: keeper ? announcement : undefined,\n    told: announcement?.status === 'PUBLISHED',\n    readAt: receipt?.acknowledgedAt ?? undefined\n  }\n}\n\n/** A rule as the request sees it - its versions, the one in force and the one due. */\nexport async function viewOfRegulation(tx: EntityManager | undefined, context: any, regulation: Regulation, keeper: boolean): Promise<RegulationView> {\n  const today = todayIn(context.state.domain)\n  const siblings = await getRepository(RegulationVersion, tx).find({ where: { regulation: { id: regulation.id } } as any, order: { version: 'DESC' } as any })\n  const views = (await Promise.all(siblings.map(one => viewOfVersion(tx, context, one, siblings, keeper)))).filter(Boolean) as RegulationVersionView[]\n  const standing = standingOf(siblings, today)\n  return { regulation, inForce: views.find(one => one.version.id === standing.inForce?.id), due: views.find(one => one.version.id === standing.due?.id), versions: views }\n}\n\n/** The request may read the rules, or is refused - a partner is told so. */\nexport async function requireRuleReader(context: any): Promise<boolean> {\n  const keeper = await keepsRules(context)\n  if (!keeper && !(await workingEmployeeOf(context))) throw new Refusal('compliance-employees-only', {}, 'only an employee of this company reads its rules')\n  return keeper\n}\n\n/** The help's parts of the rules: an article of each version in force or due is a part (ADR-0187 decision 12). */\nexport async function regulationParts(domain: { id: string; timezone?: string }): Promise<HelpPart[]> {\n  const today = todayIn(domain)\n  const regulations = await getRepository(Regulation).find({ where: { domain: { id: domain.id } } as any })\n  if (!regulations.length) return []\n  const versions = await getRepository(RegulationVersion).find({ where: { regulation: { id: In(regulations.map(one => one.id)) }, status: RegulationVersionStatus.ADOPTED } as any })\n  const parts: HelpPart[] = []\n  for (const regulation of regulations) {\n    const { inForce, due } = standingOf(versions.filter(one => one.regulationId === regulation.id), today)\n    for (const version of [inForce, due].filter(Boolean) as RegulationVersion[]) {\n      const clauses = await getRepository(RegulationClause).find({ where: { version: { id: version.id } } as any, order: { rank: 'ASC' } as any })\n      const when = version === due ? `${version.effectiveOn} 시행 예정` : `${version.effectiveOn} 시행`\n      for (const clause of clauses)\n        parts.push({\n          topic: `${REGULATION_HELP_SOURCE}/${regulation.code}`,\n          section: clause.number,\n          lang: '',\n          title: `${regulation.name} 제${clause.number}조${clause.title ? `(${clause.title})` : ''}`,\n          documentTitle: regulation.name,\n          summary: `제${version.version}판 · ${when}.`,\n          text: `제${version.version}판 · ${when}. ${clause.text}`,\n          link: `regulations?regulation=${encodeURIComponent(regulation.code)}&clause=${encodeURIComponent(clause.number)}`\n        })\n    }\n  }\n  return parts\n}\n\n/** The rules' articles in the help's search, and the papers of a procedure to its keepers only. */\nexport function registerRegulationReaders(): void {\n  registerHelpSource({ name: REGULATION_HELP_SOURCE, partsOf: domain => regulationParts(domain as any), mayRead: readsRules })\n  registerAttachmentReader(REGULATION_PROCEDURE_REF_TYPE, async (attachment, context) => {\n    if (!attachment.refBy || !(await keepsRules(context))) return false\n    return !!(await getRepository(RegulationProcedure).findOne({ where: { id: attachment.refBy, domain: { id: (context as any).state.domain.id } } as any }))\n  })\n}\n"]}

package/dist-server/service/regulation/regulation-rules.d.ts

@@ -0,0 +1,83 @@
+import { Refusal } from '@things-factory/shell';
+/** Each kind, and the procedure the law asks before a version of it is adopted. */
+export declare const REGULATION_KINDS: Record<string, {
+    opinion: boolean;
+    consentWhenUnfavourable: boolean;
+    filing: boolean;
+}>;
+/** How an opinion, a consent or a filing was taken. */
+export declare const PROCEDURE_METHODS: Record<string, string[]>;
+export interface Clause {
+    number: string;
+    title: string | null;
+    chapter: string | null;
+    text: string;
+}
+/**
+ * The articles of a text, each from its `제n조(제목)` head up to the next article or chapter. The words before the first
+ * article are no article. A chapter head (`제2장 근로시간`) is kept as the chapter of the articles after it.
+ */
+export declare function clausesOf(body: string | null | undefined): Clause[];
+export interface ClauseChange {
+    number: string;
+    title: string | null;
+    change: 'ADDED' | 'CHANGED' | 'REMOVED';
+}
+/** What a version changed of the one before, article by article - by number; a heading or words that differ is a change. */
+export declare function clauseChanges(before: Clause[], after: Clause[]): ClauseChange[];
+export interface ProcedureFacts {
+    kind: string;
+    day?: string | null;
+    workersCount?: number | null;
+    consentCount?: number | null;
+    files: number;
+}
+export interface VersionFacts {
+    kind: string;
+    body?: string | null;
+    effectiveOn?: string | null;
+    unfavourable?: boolean | null;
+}
+/** What a regulation asks before it is written. */
+export declare function regulationRefusal(input: {
+    code?: string | null;
+    name?: string | null;
+    kind?: string | null;
+}): Refusal | null;
+/**
+ * What a version asks before it is put up for adoption (decision 4). The writer must say whether the change is against
+ * the workers - there is no default. A rule of working conditions needs the majority's opinion with its papers; against
+ * them, the consent of more than half with its papers.
+ */
+export declare function adoptionRefusal(version: VersionFacts, procedures: ProcedureFacts[], today: string): Refusal | null;
+/** What a procedure record asks before it is written. */
+export declare function procedureRefusal(input: {
+    kind?: string | null;
+    day?: string | null;
+    method?: string | null;
+    workersCount?: number | null;
+    consentCount?: number | null;
+}): Refusal | null;
+/** Adopted versions as they stand on `today`: the one in force is the latest whose day has come. */
+export declare function standingOf<V extends {
+    status: string;
+    effectiveOn?: string | null;
+    version: number;
+}>(versions: V[], today: string): {
+    inForce: V | null;
+    due: V | null;
+};
+/** Where an adopted version stands on `today`. */
+export declare function periodOfVersion(version: {
+    status: string;
+    effectiveOn?: string | null;
+    id: string;
+}, standing: {
+    inForce: {
+        id: string;
+    } | null;
+}, today: string): 'DRAFT' | 'IN_APPROVAL' | 'DUE' | 'IN_FORCE' | 'PAST';
+/** What may change on an adopted version - nothing but the workers count the filing reads. A draft changes freely. */
+export declare function changeRefusal(status: string): Refusal | null;
+/** A procedure is recorded on a draft; a filing also after adoption, since it follows it. */
+export declare function procedureWriteRefusal(status: string, kind: string): Refusal | null;