@things-factory/work-shift 10.1.33 → 10.1.35

package/helps/page/work-shift.ko.md

@@ -1,5 +1,21 @@
 # 근무 교대
 
-<!--
-  자리만 잡아 둔 문서다. 답해야 할 것은 en 판과 같다(`work-shift.md`).
--->
+현재 편성과 변경안을 함께 관리합니다. 리비전 번호는 편성 전체의 개정 번호이며 교대 이름과는 다릅니다.
+
+## 변경 절차
+
+1. **변경안 작성**을 누르고 교대 이름, 시작·종료 시각, 전일/당일/익일, 근무 요일을 입력합니다.
+2. 편성 시간대, 변경 사유와 적용 시작을 확인합니다. 적용 시작 입력 옆의 시간대는 입력·표시 기준이며 편성 시간대와 별개입니다.
+3. **초안 저장** 후 **승인 요청**합니다. 비규제 현장은 정책에 따라 발행합니다. 저장만으로 현재 편성이 바뀌지 않습니다.
+
+규제 현장은 결재선이 필요하며 작성자는 자기 변경을 승인할 수 없습니다. 상신 후 수정하려면 새 변경안을 작성합니다.
+
+## 상태와 상세
+
+현재 카드에서 지금 적용되는 편성을 보고, 이력에서 초안·승인대기·반려·현재·예약 적용과 적용 구간을 확인합니다. 리비전 번호를 누르면 내용과 전후 차이를, **결재 보기**를 누르면 결재 상태와 의견을 봅니다.
+
+결재 화면의 변경 전·후 링크를 직접 누르면 해당 개정의 전체 내용이 공통 360 도크에 표시됩니다. 승인된 미래 변경은 적용 시각까지 예약 상태입니다. 반려된 변경은 적용되지 않습니다.
+
+야간 교대의 요일은 조업일의 요일입니다. 예를 들어 금요일 22시~익일 06시는 토요일 새벽에도 금요일 교대입니다. 이미 기록된 실적은 당시 교대 근거를 유지하며 사용된 구간의 소급 변경은 거절될 수 있습니다.
+
+휴일·정비일·위치별 교대 선택은 별도 설정입니다. 편성 승인이 그 설정까지 개정하지는 않습니다.

package/helps/page/work-shift.md

@@ -1,13 +1,21 @@
-# work shifts
+# Work shifts
 
-<!--
-  자리만 잡아 둔 문서다. **내용은 전담 에이전트가 쓴다** — 여기서는 배치만 했다.
+Manage the current arrangement and proposed changes together. A revision number identifies the whole arrangement, not a shift name.
 
-  이 문서를 가리키는 화면:
-    · work-shift/work-shift.ts
+## Change an arrangement
 
-  전에는 그 화면의 도움말 아이콘이 **없는 문서를 가리켜 404 로 갔다.** 아이콘이 있으니 답이
-  있는 줄 알고 누르는데 아무것도 없었다 — 없는 것보다 나쁘다.
+1. Select **Create change** and enter shift names, start/end clocks, previous/work/next-day offsets and weekdays.
+2. Check the arrangement time zone, reason and effective start. The input/display time zone beside effective start is separate from the arrangement time zone.
+3. **Save draft**, then **Request approval**. Non-regulated sites publish under their declared policy. Saving a draft does not change current values.
 
-  쓸 때 답해야 하는 것은 **그 화면의 독자가 무엇을 묻는가**다. 화면을 열어 보고 정한다.
--->
+Regulated sites need an approval line and a different approver. Submitted content is frozen; corrections require a new draft.
+
+## Read status and details
+
+The current card shows the effective arrangement. History distinguishes drafts, pending approvals, rejection, current and scheduled revisions with effective intervals. Select a revision for its content and differences, or **Approval details** for decisions and comments.
+
+Explicitly select a before/after link in approval to open that exact revision in the shared Entity360 dock. Approved future revisions remain scheduled until their effective instant. Rejected changes do not apply.
+
+Weekdays belong to the work date: Friday 22:00–next-day 06:00 still belongs to Friday on Saturday morning. Recorded executions retain their original basis, and retroactive changes affecting them may be refused.
+
+Holidays, maintenance periods and location-specific shift selection remain separate settings. Approval here does not revise those settings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/work-shift",
-  "version": "10.1.33",
+  "version": "10.1.35",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -25,13 +25,16 @@
     "clean:server": "npx rimraf dist-server",
     "clean": "npm run clean:server && npm run clean:client",
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration",
-    "test": "node --import ./test/resolve-ts-siblings.mjs --test --test-force-exit test/*.test.ts"
+    "test": "npm run test:unit && npm run test:db",
+    "test:unit": "node --import ./test/resolve-ts-siblings.mjs --test --test-force-exit test/*.test.ts",
+    "test:db": "npm run build:server && node --test --test-force-exit test/*.db.test.cjs"
   },
   "dependencies": {
-    "@things-factory/auth-base": "^10.1.33",
+    "@things-factory/auth-base": "^10.1.34",
     "@things-factory/env": "^10.1.20",
-    "@things-factory/shell": "^10.1.33",
+    "@things-factory/ops-master": "^10.1.35",
+    "@things-factory/shell": "^10.1.34",
     "moment-timezone": "^0.5.40"
   },
-  "gitHead": "7fb7b6587846b5ff6ee7a4983652d9561b4d6b2c"
+  "gitHead": "396f43b648b704f1938a2d890ab2f6efa33fdb86"
 }

package/dist-server/service/work-shift/work-shift-revision-query.d.ts

@@ -1,20 +0,0 @@
-import { User } from '@things-factory/auth-base';
-import { Domain, ListParam } from '@things-factory/shell';
-import { WorkShiftRevision } from './work-shift-revision';
-import { WorkShiftRevisionList } from './work-shift-type';
-/**
- * 지나간 편성을 읽는다. **읽기만 있다** — 지나간 것은 고치는 것이 아니다.
- */
-export declare class WorkShiftRevisionQuery {
-    workShiftRevisions(params: ListParam, context: ResolverContext): Promise<WorkShiftRevisionList>;
-    /**
-     * 편성 한 벌을 **JSON 글자로** 내보낸다.
-     *
-     * 이 칸은 `simple-json` 이라 값이 배열이다. 스키마에 `String` 으로 적어 두고 배열을 그대로 내보내면
-     * GraphQL 이 「String cannot represent value」로 응답을 통째로 버린다 — 화면에서 예고를 넣고 나서야
-     * 드러났다. 목록이 비어 있는 동안에는 이 자리를 지나지 않기 때문이다.
-     */
-    shifts(revision: WorkShiftRevision): string;
-    domain(revision: WorkShiftRevision): Promise<Domain>;
-    creator(revision: WorkShiftRevision): Promise<User | null>;
-}

package/dist-server/service/work-shift/work-shift-revision-query.js

@@ -1,74 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkShiftRevisionQuery = void 0;
-const tslib_1 = require("tslib");
-const type_graphql_1 = require("type-graphql");
-const auth_base_1 = require("@things-factory/auth-base");
-const shell_1 = require("@things-factory/shell");
-const work_shift_revision_1 = require("./work-shift-revision");
-const work_shift_type_1 = require("./work-shift-type");
-/**
- * 지나간 편성을 읽는다. **읽기만 있다** — 지나간 것은 고치는 것이 아니다.
- */
-let WorkShiftRevisionQuery = class WorkShiftRevisionQuery {
-    async workShiftRevisions(params, context) {
-        const { domain } = context.state;
-        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
-            repository: (0, shell_1.getRepository)(work_shift_revision_1.WorkShiftRevision),
-            params,
-            domain
-        });
-        const [items, total] = await queryBuilder.getManyAndCount();
-        return { items, total };
-    }
-    /**
-     * 편성 한 벌을 **JSON 글자로** 내보낸다.
-     *
-     * 이 칸은 `simple-json` 이라 값이 배열이다. 스키마에 `String` 으로 적어 두고 배열을 그대로 내보내면
-     * GraphQL 이 「String cannot represent value」로 응답을 통째로 버린다 — 화면에서 예고를 넣고 나서야
-     * 드러났다. 목록이 비어 있는 동안에는 이 자리를 지나지 않기 때문이다.
-     */
-    shifts(revision) {
-        return JSON.stringify(revision.shifts ?? []);
-    }
-    async domain(revision) {
-        return await (0, shell_1.getRepository)(shell_1.Domain).findOneBy({ id: revision.domainId });
-    }
-    async creator(revision) {
-        return revision.creatorId ? await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: revision.creatorId }) : null;
-    }
-};
-exports.WorkShiftRevisionQuery = WorkShiftRevisionQuery;
-tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => work_shift_type_1.WorkShiftRevisionList, { description: 'To fetch work shift arrangements that used to be in force' }),
-    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)
-], WorkShiftRevisionQuery.prototype, "workShiftRevisions", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.FieldResolver)(type => String),
-    tslib_1.__param(0, (0, type_graphql_1.Root)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [work_shift_revision_1.WorkShiftRevision]),
-    tslib_1.__metadata("design:returntype", String)
-], WorkShiftRevisionQuery.prototype, "shifts", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.FieldResolver)(type => shell_1.Domain),
-    tslib_1.__param(0, (0, type_graphql_1.Root)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [work_shift_revision_1.WorkShiftRevision]),
-    tslib_1.__metadata("design:returntype", Promise)
-], WorkShiftRevisionQuery.prototype, "domain", null);
-tslib_1.__decorate([
-    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User, { nullable: true }),
-    tslib_1.__param(0, (0, type_graphql_1.Root)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [work_shift_revision_1.WorkShiftRevision]),
-    tslib_1.__metadata("design:returntype", Promise)
-], WorkShiftRevisionQuery.prototype, "creator", null);
-exports.WorkShiftRevisionQuery = WorkShiftRevisionQuery = tslib_1.__decorate([
-    (0, type_graphql_1.Resolver)(work_shift_revision_1.WorkShiftRevision)
-], WorkShiftRevisionQuery);
-//# sourceMappingURL=work-shift-revision-query.js.map

package/dist-server/service/work-shift/work-shift-revision-query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"work-shift-revision-query.js","sourceRoot":"","sources":["../../../server/service/work-shift/work-shift-revision-query.ts"],"names":[],"mappings":";;;;AAAA,+CAA8E;AAE9E,yDAAgD;AAChD,iDAAuG;AAEvG,+DAAyD;AACzD,uDAAyD;AAEzD;;GAEG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAE3B,AAAN,KAAK,CAAC,kBAAkB,CACG,MAAiB,EACnC,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,YAAY,GAAG,IAAA,qCAA6B,EAAC;YACjD,UAAU,EAAE,IAAA,qBAAa,EAAC,uCAAiB,CAAC;YAC5C,MAAM;YACN,MAAM;SACP,CAAC,CAAA;QAEF,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,CAAA;QAE3D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACzB,CAAC;IAED;;;;;;OAMG;IAEH,MAAM,CAAS,QAA2B;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAS,QAA2B;QAC9C,OAAO,MAAM,IAAA,qBAAa,EAAC,cAAM,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACzE,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAS,QAA2B;QAC/C,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAA,qBAAa,EAAC,gBAAI,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACpG,CAAC;CACF,CAAA;AAxCY,wDAAsB;AAE3B;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,uCAAqB,EAAE,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;IAEnH,mBAAA,IAAA,mBAAI,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAS,CAAC,CAAA;IACvB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAD2B,iBAAS;;gEAc3C;AAUD;IADC,IAAA,4BAAa,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;IACtB,mBAAA,IAAA,mBAAI,GAAE,CAAA;;6CAAW,uCAAiB;;oDAEzC;AAGK;IADL,IAAA,4BAAa,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IAChB,mBAAA,IAAA,mBAAI,GAAE,CAAA;;6CAAW,uCAAiB;;oDAE/C;AAGK;IADL,IAAA,4BAAa,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjC,mBAAA,IAAA,mBAAI,GAAE,CAAA;;6CAAW,uCAAiB;;qDAEhD;iCAvCU,sBAAsB;IADlC,IAAA,uBAAQ,EAAC,uCAAiB,CAAC;GACf,sBAAsB,CAwClC","sourcesContent":["import { Args, Ctx, FieldResolver, Query, Resolver, Root } from 'type-graphql'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'\n\nimport { WorkShiftRevision } from './work-shift-revision'\nimport { WorkShiftRevisionList } from './work-shift-type'\n\n/**\n * 지나간 편성을 읽는다. **읽기만 있다** — 지나간 것은 고치는 것이 아니다.\n */\n@Resolver(WorkShiftRevision)\nexport class WorkShiftRevisionQuery {\n  @Query(returns => WorkShiftRevisionList, { description: 'To fetch work shift arrangements that used to be in force' })\n  async workShiftRevisions(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<WorkShiftRevisionList> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(WorkShiftRevision),\n      params,\n      domain\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  /**\n   * 편성 한 벌을 **JSON 글자로** 내보낸다.\n   *\n   * 이 칸은 `simple-json` 이라 값이 배열이다. 스키마에 `String` 으로 적어 두고 배열을 그대로 내보내면\n   * GraphQL 이 「String cannot represent value」로 응답을 통째로 버린다 — 화면에서 예고를 넣고 나서야\n   * 드러났다. 목록이 비어 있는 동안에는 이 자리를 지나지 않기 때문이다.\n   */\n  @FieldResolver(type => String)\n  shifts(@Root() revision: WorkShiftRevision): string {\n    return JSON.stringify(revision.shifts ?? [])\n  }\n\n  @FieldResolver(type => Domain)\n  async domain(@Root() revision: WorkShiftRevision): Promise<Domain> {\n    return await getRepository(Domain).findOneBy({ id: revision.domainId })\n  }\n\n  @FieldResolver(type => User, { nullable: true })\n  async creator(@Root() revision: WorkShiftRevision): Promise<User | null> {\n    return revision.creatorId ? await getRepository(User).findOneBy({ id: revision.creatorId }) : null\n  }\n}\n"]}