@things-factory/ops-master 10.1.247 → 10.1.248

package/dist-server/service/location/location-master-resolver.js

@@ -1,313 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OperationalLocationResolver = exports.OperationalLocationList = void 0;
-const tslib_1 = require("tslib");
-const type_graphql_1 = require("type-graphql");
-const applied_when_1 = require("../assignment/applied-when");
-const shell_1 = require("@things-factory/shell");
-const type_graphql_2 = require("type-graphql");
-const shell_2 = require("@things-factory/shell");
-const master_crud_1 = require("../master-crud");
-const master_axis_1 = require("../master-axis");
-const master_list_1 = require("../master-list");
-const operational_location_1 = require("./operational-location");
-const person_1 = require("../personnel/person");
-const equipment_1 = require("../equipment/equipment");
-const physical_asset_1 = require("../asset/physical-asset");
-const referrers_1 = require("../resource/referrers");
-/**
- * 자리 축을 채우고 고친다.
- *
- * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────
- * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의
- * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —
- * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.
- *
- * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.
- */
-let OperationalLocationList = class OperationalLocationList {
-};
-exports.OperationalLocationList = OperationalLocationList;
-tslib_1.__decorate([
-    (0, type_graphql_2.Field)(type => [operational_location_1.OperationalLocation]),
-    tslib_1.__metadata("design:type", Array)
-], OperationalLocationList.prototype, "items", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_2.Field)(type => type_graphql_2.Int),
-    tslib_1.__metadata("design:type", Number)
-], OperationalLocationList.prototype, "total", void 0);
-exports.OperationalLocationList = OperationalLocationList = tslib_1.__decorate([
-    (0, type_graphql_2.ObjectType)({ description: 'A page of operational locations' })
-], OperationalLocationList);
-/**
- * 「바로 아래에 몇이 있나」를 세는 곳.
- *
- * ── 물어본 요청만 센다 ──────────────────────────────────────────────────────
- * 처음에는 목록 리졸버가 늘 세게 했다. 그러면 **개수를 쓰지 않는 조회도 값을 치른다** — 고르기 팝업,
- * 자동완성, 다른 화면의 목록까지 전부. 로케이션 목록은 여러 곳에서 부른다.
- *
- * 그래서 `childCount` 를 필드 리졸버로 둔다. GraphQL 이 **물어본 요청에만** 이것을 부르므로, 안 묻는
- * 조회는 질의가 한 번뿐이다. 「이 목록은 개수가 필요하다/아니다」를 서버 쪽에 플래그로 두지 않아도
- * 된다 — 묻는 것이 곧 그 표시다.
- *
- * ── 물었으면 한 번에 센다 ───────────────────────────────────────────────────
- * 필드 리졸버는 줄마다 불린다. 거기서 그때그때 세면 `limit 20` 에 카운트 20회, 100 이면 100회다 —
- * N+1 이다.
- *
- * 그래서 목록 리졸버가 그 페이지를 요청에 남겨 두고(`locationPage`), 첫 줄이 물을 때 **페이지 전체를
- * 한 번에** 세어 요청 안에 담아 둔다. 담는 것은 **결과가 아니라 약속(Promise)** 이다 — 줄들이 거의
- * 동시에 묻기 때문에, 결과를 담으면 스무 개가 각자 질의를 띄운 뒤에야 채워진다.
- *
- *   SELECT parent_id, COUNT(1) … WHERE domain = ? AND parent_id IN (…) GROUP BY parent_id
- *
- * `IN` 에 들어가는 것은 그 페이지의 아이디와 이름뿐이라 표 전체 크기와 무관하다.
- * `ix_ops_operational_location_1`(도메인 · 상위)이 이 질의를 받는다.
- *
- * ── 상위를 두 가지로 찾는다 ──────────────────────────────────────────────────
- * `parentId` 는 외래 키가 아니라 문자열이라 쓰는 쪽이 정한다. 지금 데이터는 아이디가 아니라 **이름**을
- * 담고 있다(`LINE-1` 의 상위가 `PLANT-1`). 한쪽만 보면 개수가 오류 보고 없이 0 이 된다.
- */
-async function countChildren(locations, domain) {
-    const keys = [...new Set(locations.flatMap(location => [location.id, location.name]).filter(Boolean))];
-    if (!keys.length)
-        return new Map();
-    const counted = await (0, shell_2.getRepository)(operational_location_1.OperationalLocation)
-        .createQueryBuilder('location')
-        .select('location.parentId', 'parentId')
-        .addSelect('COUNT(1)', 'count')
-        .where('location.domain = :domain', { domain: domain.id })
-        .andWhere('location.parentId IN (:...keys)', { keys })
-        .groupBy('location.parentId')
-        .getRawMany();
-    return new Map(counted.map(row => [row.parentId, Number(row.count)]));
-}
-/**
- * 아이디로 적힌 자식과 이름으로 적힌 자식을 **더한다.**
- *
- * 같은 자식이 두 규약으로 중복 등록돼 있으면 개수가 부풀 수 있다. 그런 데이터는 이미 결함이지만, 여기서
- * 한쪽을 조용히 버리지는 않는다 — 버리면 어느 쪽이 빠졌는지 아무도 모른다.
- */
-function sumFor(location, counted) {
-    return (counted.get(location.id) || 0) + (location.name ? counted.get(location.name) || 0 : 0);
-}
-/**
- * **이 자리에 무엇이 있나** — 들어오는 관계.
- *
- * ── 왜 필요한가 ────────────────────────────────────────────────────────────
- * 자리 하나를 열어도 「여기서 누가 일하나 · 무슨 설비가 있나」를 알 수 없었다. 사람 화면을 열어
- * 근무 자리로 걸러야 했고, 설비는 또 설비 화면에서 같은 일을 해야 했다. 다른 화면의 참조 칸을
- * 눌러 자리로 걸어 들어와도 그 자리가 무엇인지는 이름뿐이었다.
- *
- * ── 줄마다 세지 않는다 ─────────────────────────────────────────────────────
- * `childCount` 와 같은 방식이다. 목록 리졸버가 그 페이지를 요청에 남겨 두고, 첫 줄이 물을 때
- * **페이지 전체를 한 번에** 묻는다. 담는 것은 결과가 아니라 **약속**이다 — 줄들이 거의 동시에
- * 물으므로 결과를 담으면 스무 개가 각자 질의를 띄운다.
- *
- * ── 자리를 두 가지로 찾는다 ────────────────────────────────────────────────
- * `homeLocation` 은 외래 키가 아니라 문자열이라 쓰는 쪽이 정한다. 지금 자료는 **이름**을 담는다
- * (`P-ECU-S-0001` 의 근무 자리가 `ECU-SUB-01`). 아이디도 함께 넣어 묻는다 — 한쪽만 보면 목록이
- * 오류 보고 없이 빈다. `childCount` 가 같은 이유로 그렇게 한다.
- */
-/** 한 자리에 보일 이름 수. 넘치면 몇이 남았는지 함께 낸다. */
-const OCCUPANT_SHOWN = 8;
-async function scanOccupants(locations, domain) {
-    const keys = [...new Set(locations.flatMap(one => [one.id, one.name]).filter(Boolean))];
-    if (keys.length === 0) {
-        return { staff: new Map(), equipment: new Map(), assets: new Map() };
-    }
-    const of = async (Entity) => {
-        const rows = await (0, shell_2.getRepository)(Entity)
-            .createQueryBuilder('row')
-            .select(['row.id', 'row.name', 'row.homeLocation'])
-            .where('row.domain_id = :domain', { domain: domain.id })
-            .andWhere('row.home_location IN (:...keys)', { keys })
-            .getMany();
-        return (0, referrers_1.indexReferrers)(rows.map(one => ({ points: one.homeLocation, name: one.name })));
-    };
-    const [staff, equipment, assets] = await Promise.all([of(person_1.Person), of(equipment_1.Equipment), of(physical_asset_1.PhysicalAsset)]);
-    return { staff, equipment, assets };
-}
-/**
- * 이 줄의 답을 낸다.
- *
- * **페이지에 없으면 그 줄만 따로 묻는다.** 한 요청에 목록 조회가 둘 있으면 뒤엣것이 앞엣것의
- * 페이지를 덮어쓰고, 그때 남는 줄들이 「아무도 없다」로 나온다 — 자리가 비어 있는 것과 못 본 것이
- * 같아 보인다. 들어오는 관계는 **비어 있는 것이 기본**이라 이 거짓말이 특히 안 띈다.
- * 틀린 목록보다 질의 한 번이 낫다. `childCount` 가 같은 이유로 같은 자리를 둔다.
- */
-async function occupantsOf(location, context) {
-    const state = context.state;
-    const page = state.locationPage;
-    const inPage = !!page?.some(one => one.id === location.id);
-    if (!inPage) {
-        return scanOccupants([location], state.domain);
-    }
-    /* 요청 안에서 한 번만 훑는다. 약속을 담는다. */
-    state.occupantScan = state.occupantScan || scanOccupants(page, state.domain);
-    return state.occupantScan;
-}
-/**
- * 한 자리의 이름들을 낸다 — 아이디로도 이름으로도 걸린 것을 합친다.
- *
- * 자료가 어느 쪽으로 적혔는지 자리마다 다를 수 있어 둘 다 본다. 합칠 때 겹치는 것은 한 번만 센다.
- */
-function namesAt(index, location) {
-    const found = [...(index.get(location.id) ?? []), ...(index.get(location.name) ?? [])];
-    return [...new Set(found)].sort();
-}
-let OperationalLocationResolver = class OperationalLocationResolver {
-    async operationalLocations(params, context) {
-        const { domain } = context.state;
-        const { items, total } = await (0, master_list_1.listMaster)('operationalLocation', params, domain);
-        const locations = items;
-        /*
-         * 여기서 개수를 세지 않는다. 이 페이지만 요청에 남겨 둔다 — `childCount` 를 **물어본 요청**이
-         * 있으면 그 리졸버가 이것을 보고 한 번에 센다(위 머리말).
-         */
-        context.state.locationPage = locations;
-        return { items: locations, total };
-    }
-    /**
-     * 이 자리 바로 아래에 몇이 있나.
-     *
-     * 계층을 한 단씩 걷는 화면이 이 값으로 「그 줄에 들어갈 것이 있나」를 말한다. 아이콘만으로는 그것을
-     * 말하지 못한다 — 눌러 보기 전에는 안에 무엇이 있는지, 있기는 한지 알 수 없다.
-     *
-     * 세는 방식과 값은 `countChildren` 머리말에 적었다.
-     */
-    /**
-     * 여기서 일하는 사람들.
-     *
-     * **넘치면 몇이 남았는지 말한다**(`occupantOverflow`). 조용히 자르면 「셋이 있다」와 「서른이
-     * 있는데 셋만 보인다」가 같아 보이고, 그 칸을 보고 사람이 판단을 내린다.
-     *
-     * 아무도 없으면 빈 목록이다 — 없는 것은 없다고 낸다.
-     */
-    async staff(location, context) {
-        return (0, referrers_1.cappedList)(namesAt((await occupantsOf(location, context)).staff, location), OCCUPANT_SHOWN).shown;
-    }
-    /** 여기 있는 설비들. */
-    async equipmentHere(location, context) {
-        return (0, referrers_1.cappedList)(namesAt((await occupantsOf(location, context)).equipment, location), OCCUPANT_SHOWN).shown;
-    }
-    /** 여기 있는 자산들 — 공구 · 지그처럼 옮겨 다니는 것. */
-    async assetsHere(location, context) {
-        return (0, referrers_1.cappedList)(namesAt((await occupantsOf(location, context)).assets, location), OCCUPANT_SHOWN).shown;
-    }
-    /**
-     * 위 세 칸에서 **안 보인 것이 몇인가.**
-     *
-     * 셋을 합쳐 하나로 낸다. 칸마다 따로 두면 화면이 숫자 셋을 더 들고 있어야 하는데, 사람이 알고
-     * 싶은 것은 「이 자리에 더 있나」 하나다.
-     */
-    async occupantOverflow(location, context) {
-        const scan = await occupantsOf(location, context);
-        return ((0, referrers_1.cappedList)(namesAt(scan.staff, location), OCCUPANT_SHOWN).hidden +
-            (0, referrers_1.cappedList)(namesAt(scan.equipment, location), OCCUPANT_SHOWN).hidden +
-            (0, referrers_1.cappedList)(namesAt(scan.assets, location), OCCUPANT_SHOWN).hidden);
-    }
-    async childCount(location, context) {
-        const { domain, locationPage } = context.state;
-        const page = locationPage;
-        const inPage = !!page?.some(one => one.id === location.id);
-        /*
-         * 목록 조회가 남긴 페이지에 없으면 그 줄만 센다.
-         *
-         * 한 요청에 목록 조회가 둘 있으면 뒤엣것이 앞엣것의 페이지를 덮어쓴다. 그때 남는 줄들을 조용히 0 으로
-         * 두지 않는다 — 틀린 개수보다 질의 한 번이 낫다.
-         */
-        if (!inPage) {
-            const counted = await countChildren([location], domain);
-            return sumFor(location, counted);
-        }
-        /*
-         * 요청 안에서 한 번만 센다. **약속을 담는다** — 줄들이 거의 동시에 묻기 때문에 결과를 담으면
-         * 스무 개가 각자 질의를 띄운다.
-         */
-        const state = context.state;
-        state.locationChildCounts = state.locationChildCounts || countChildren(page, domain);
-        return sumFor(location, await state.locationChildCounts);
-    }
-    /**
-     * 그리드가 보낸 변경을 한 번에 적용한다.
-     *
-     * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을
-     * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는
-     * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.
-     */
-    async updateMultipleOperationalLocation(patches, context, applied) {
-        const { domain, user, tx } = context.state;
-        const axis = (0, master_axis_1.masterAxisOf)('operationalLocation');
-        const saved = await (0, master_crud_1.saveMasterPatches)(tx, domain, axis.entity, patches, user, {
-            hasEffectivePeriod: axis.hasEffectivePeriod,
-            ...(0, applied_when_1.appliedOptions)(applied)
-        });
-        return saved;
-    }
-};
-exports.OperationalLocationResolver = OperationalLocationResolver;
-tslib_1.__decorate([
-    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
-    (0, type_graphql_2.Query)(returns => OperationalLocationList, { description: 'To fetch operational locations' }),
-    tslib_1.__param(0, (0, type_graphql_2.Args)(type => shell_2.ListParam)),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [shell_2.ListParam, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "operationalLocations", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.FieldResolver)(type => [String], { description: 'People whose home location is here' }),
-    tslib_1.__param(0, (0, type_graphql_2.Root)()),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [operational_location_1.OperationalLocation, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "staff", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.FieldResolver)(type => [String], { description: 'Equipment stationed here' }),
-    tslib_1.__param(0, (0, type_graphql_2.Root)()),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [operational_location_1.OperationalLocation, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "equipmentHere", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.FieldResolver)(type => [String], { description: 'Physical assets kept here' }),
-    tslib_1.__param(0, (0, type_graphql_2.Root)()),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [operational_location_1.OperationalLocation, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "assetsHere", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.FieldResolver)(type => type_graphql_2.Int, { description: 'How many occupants are not shown in the lists above' }),
-    tslib_1.__param(0, (0, type_graphql_2.Root)()),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [operational_location_1.OperationalLocation, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "occupantOverflow", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.FieldResolver)(type => type_graphql_2.Int, { description: 'How many locations sit directly under this one' }),
-    tslib_1.__param(0, (0, type_graphql_2.Root)()),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [operational_location_1.OperationalLocation, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "childCount", null);
-tslib_1.__decorate([
-    (0, type_graphql_2.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
-    (0, type_graphql_2.Directive)('@transaction'),
-    (0, type_graphql_2.Mutation)(returns => [operational_location_1.OperationalLocation], { description: 'To create, change or retire operational locations' }),
-    tslib_1.__param(0, (0, type_graphql_2.Arg)('patches', type => [shell_2.ScalarObject])),
-    tslib_1.__param(1, (0, type_graphql_2.Ctx)()),
-    tslib_1.__param(2, (0, type_graphql_2.Arg)('applied', type => shell_2.ScalarObject, { nullable: true })),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [Array, Object, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], OperationalLocationResolver.prototype, "updateMultipleOperationalLocation", null);
-exports.OperationalLocationResolver = OperationalLocationResolver = tslib_1.__decorate([
-    (0, type_graphql_2.Resolver)(operational_location_1.OperationalLocation),
-    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
-], OperationalLocationResolver);
-//# sourceMappingURL=location-master-resolver.js.map

package/dist-server/service/location/location-master-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"location-master-resolver.js","sourceRoot":"","sources":["../../../server/service/location/location-master-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { UseMiddleware } from 'type-graphql'\nimport { AppliedWhen, appliedOptions } from '../assignment/applied-when'\nimport { SpeakRefusals } from '@things-factory/shell'\nimport { Args, Arg, Ctx, Directive, FieldResolver, Int, Mutation, ObjectType, Field, Query, Resolver, Root } from 'type-graphql'\n\nimport { Domain, ListParam, ScalarObject, getRepository } from '@things-factory/shell'\n\nimport { MasterPatch, saveMasterPatches } from '../master-crud'\nimport { masterAxisOf } from '../master-axis'\nimport { listMaster } from '../master-list'\nimport { OperationalLocation } from './operational-location'\nimport { Person } from '../personnel/person'\nimport { Equipment } from '../equipment/equipment'\nimport { PhysicalAsset } from '../asset/physical-asset'\nimport { cappedList, indexReferrers } from '../resource/referrers'\n\n/**\n * 자리 축을 채우고 고친다.\n *\n * ── 왜 마스터는 그리드에서 고칠 수 있나 ────────────────────────────────────\n * 업무 기록과 달리 마스터는 **선언**이다. 「이 사람이 용접 자격을 갖는다」는 일어난 일이 아니라 지금의\n * 규정이고, 규정은 바뀐다. 없앨 때 행을 지우지 않고 유효 기간의 끝을 채우는 것이 그래서다 —\n * 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.\n *\n * 규칙은 `master-crud.ts` 한 곳에 있다. 여기는 축의 이름만 붙인다.\n */\n\n@ObjectType({ description: 'A page of operational locations' })\nexport class OperationalLocationList {\n  @Field(type => [OperationalLocation])\n  items: OperationalLocation[]\n\n  @Field(type => Int)\n  total: number\n}\n\n/**\n * 「바로 아래에 몇이 있나」를 세는 곳.\n *\n * ── 물어본 요청만 센다 ──────────────────────────────────────────────────────\n * 처음에는 목록 리졸버가 늘 세게 했다. 그러면 **개수를 쓰지 않는 조회도 값을 치른다** — 고르기 팝업,\n * 자동완성, 다른 화면의 목록까지 전부. 로케이션 목록은 여러 곳에서 부른다.\n *\n * 그래서 `childCount` 를 필드 리졸버로 둔다. GraphQL 이 **물어본 요청에만** 이것을 부르므로, 안 묻는\n * 조회는 질의가 한 번뿐이다. 「이 목록은 개수가 필요하다/아니다」를 서버 쪽에 플래그로 두지 않아도\n * 된다 — 묻는 것이 곧 그 표시다.\n *\n * ── 물었으면 한 번에 센다 ───────────────────────────────────────────────────\n * 필드 리졸버는 줄마다 불린다. 거기서 그때그때 세면 `limit 20` 에 카운트 20회, 100 이면 100회다 —\n * N+1 이다.\n *\n * 그래서 목록 리졸버가 그 페이지를 요청에 남겨 두고(`locationPage`), 첫 줄이 물을 때 **페이지 전체를\n * 한 번에** 세어 요청 안에 담아 둔다. 담는 것은 **결과가 아니라 약속(Promise)** 이다 — 줄들이 거의\n * 동시에 묻기 때문에, 결과를 담으면 스무 개가 각자 질의를 띄운 뒤에야 채워진다.\n *\n *   SELECT parent_id, COUNT(1) … WHERE domain = ? AND parent_id IN (…) GROUP BY parent_id\n *\n * `IN` 에 들어가는 것은 그 페이지의 아이디와 이름뿐이라 표 전체 크기와 무관하다.\n * `ix_ops_operational_location_1`(도메인 · 상위)이 이 질의를 받는다.\n *\n * ── 상위를 두 가지로 찾는다 ──────────────────────────────────────────────────\n * `parentId` 는 외래 키가 아니라 문자열이라 쓰는 쪽이 정한다. 지금 데이터는 아이디가 아니라 **이름**을\n * 담고 있다(`LINE-1` 의 상위가 `PLANT-1`). 한쪽만 보면 개수가 오류 보고 없이 0 이 된다.\n */\nasync function countChildren(locations: OperationalLocation[], domain: Domain): Promise<Map<string, number>> {\n  const keys = [...new Set(locations.flatMap(location => [location.id, location.name]).filter(Boolean))]\n\n  if (!keys.length) return new Map()\n\n  const counted = await getRepository(OperationalLocation)\n    .createQueryBuilder('location')\n    .select('location.parentId', 'parentId')\n    .addSelect('COUNT(1)', 'count')\n    .where('location.domain = :domain', { domain: domain.id })\n    .andWhere('location.parentId IN (:...keys)', { keys })\n    .groupBy('location.parentId')\n    .getRawMany()\n\n  return new Map<string, number>(counted.map(row => [row.parentId, Number(row.count)]))\n}\n\n/**\n * 아이디로 적힌 자식과 이름으로 적힌 자식을 **더한다.**\n *\n * 같은 자식이 두 규약으로 중복 등록돼 있으면 개수가 부풀 수 있다. 그런 데이터는 이미 결함이지만, 여기서\n * 한쪽을 조용히 버리지는 않는다 — 버리면 어느 쪽이 빠졌는지 아무도 모른다.\n */\nfunction sumFor(location: OperationalLocation, counted: Map<string, number>): number {\n  return (counted.get(location.id) || 0) + (location.name ? counted.get(location.name) || 0 : 0)\n}\n\n/**\n * **이 자리에 무엇이 있나** — 들어오는 관계.\n *\n * ── 왜 필요한가 ────────────────────────────────────────────────────────────\n * 자리 하나를 열어도 「여기서 누가 일하나 · 무슨 설비가 있나」를 알 수 없었다. 사람 화면을 열어\n * 근무 자리로 걸러야 했고, 설비는 또 설비 화면에서 같은 일을 해야 했다. 다른 화면의 참조 칸을\n * 눌러 자리로 걸어 들어와도 그 자리가 무엇인지는 이름뿐이었다.\n *\n * ── 줄마다 세지 않는다 ─────────────────────────────────────────────────────\n * `childCount` 와 같은 방식이다. 목록 리졸버가 그 페이지를 요청에 남겨 두고, 첫 줄이 물을 때\n * **페이지 전체를 한 번에** 묻는다. 담는 것은 결과가 아니라 **약속**이다 — 줄들이 거의 동시에\n * 물으므로 결과를 담으면 스무 개가 각자 질의를 띄운다.\n *\n * ── 자리를 두 가지로 찾는다 ────────────────────────────────────────────────\n * `homeLocation` 은 외래 키가 아니라 문자열이라 쓰는 쪽이 정한다. 지금 자료는 **이름**을 담는다\n * (`P-ECU-S-0001` 의 근무 자리가 `ECU-SUB-01`). 아이디도 함께 넣어 묻는다 — 한쪽만 보면 목록이\n * 오류 보고 없이 빈다. `childCount` 가 같은 이유로 그렇게 한다.\n */\n\n/** 한 자리에 보일 이름 수. 넘치면 몇이 남았는지 함께 낸다. */\nconst OCCUPANT_SHOWN = 8\n\ninterface OccupantScan {\n  staff: Map<string, string[]>\n  equipment: Map<string, string[]>\n  assets: Map<string, string[]>\n}\n\nasync function scanOccupants(locations: OperationalLocation[], domain: Domain): Promise<OccupantScan> {\n  const keys = [...new Set(locations.flatMap(one => [one.id, one.name]).filter(Boolean))] as string[]\n\n  if (keys.length === 0) {\n    return { staff: new Map(), equipment: new Map(), assets: new Map() }\n  }\n\n  const of = async (Entity: any) => {\n    const rows = await getRepository(Entity)\n      .createQueryBuilder('row')\n      .select(['row.id', 'row.name', 'row.homeLocation'])\n      .where('row.domain_id = :domain', { domain: domain.id })\n      .andWhere('row.home_location IN (:...keys)', { keys })\n      .getMany()\n\n    return indexReferrers((rows as any[]).map(one => ({ points: one.homeLocation, name: one.name })))\n  }\n\n  const [staff, equipment, assets] = await Promise.all([of(Person), of(Equipment), of(PhysicalAsset)])\n\n  return { staff, equipment, assets }\n}\n\n/**\n * 이 줄의 답을 낸다.\n *\n * **페이지에 없으면 그 줄만 따로 묻는다.** 한 요청에 목록 조회가 둘 있으면 뒤엣것이 앞엣것의\n * 페이지를 덮어쓰고, 그때 남는 줄들이 「아무도 없다」로 나온다 — 자리가 비어 있는 것과 못 본 것이\n * 같아 보인다. 들어오는 관계는 **비어 있는 것이 기본**이라 이 거짓말이 특히 안 띈다.\n * 틀린 목록보다 질의 한 번이 낫다. `childCount` 가 같은 이유로 같은 자리를 둔다.\n */\nasync function occupantsOf(location: OperationalLocation, context: ResolverContext): Promise<OccupantScan> {\n  const state = context.state as {\n    domain: Domain\n    locationPage?: OperationalLocation[]\n    occupantScan?: Promise<OccupantScan>\n  }\n\n  const page = state.locationPage\n  const inPage = !!page?.some(one => one.id === location.id)\n\n  if (!inPage) {\n    return scanOccupants([location], state.domain)\n  }\n\n  /* 요청 안에서 한 번만 훑는다. 약속을 담는다. */\n  state.occupantScan = state.occupantScan || scanOccupants(page!, state.domain)\n\n  return state.occupantScan\n}\n\n/**\n * 한 자리의 이름들을 낸다 — 아이디로도 이름으로도 걸린 것을 합친다.\n *\n * 자료가 어느 쪽으로 적혔는지 자리마다 다를 수 있어 둘 다 본다. 합칠 때 겹치는 것은 한 번만 센다.\n */\nfunction namesAt(index: Map<string, string[]>, location: OperationalLocation): string[] {\n  const found = [...(index.get(location.id) ?? []), ...(index.get(location.name) ?? [])]\n\n  return [...new Set(found)].sort()\n}\n\n@Resolver(OperationalLocation)\n@UseMiddleware(SpeakRefusals)\nexport class OperationalLocationResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => OperationalLocationList, { description: 'To fetch operational locations' })\n  async operationalLocations(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<OperationalLocationList> {\n    const { domain } = context.state\n    const { items, total } = await listMaster('operationalLocation', params, domain)\n\n    const locations = items as OperationalLocation[]\n\n    /*\n     * 여기서 개수를 세지 않는다. 이 페이지만 요청에 남겨 둔다 — `childCount` 를 **물어본 요청**이\n     * 있으면 그 리졸버가 이것을 보고 한 번에 센다(위 머리말).\n     */\n    context.state.locationPage = locations\n\n    return { items: locations, total }\n  }\n\n  /**\n   * 이 자리 바로 아래에 몇이 있나.\n   *\n   * 계층을 한 단씩 걷는 화면이 이 값으로 「그 줄에 들어갈 것이 있나」를 말한다. 아이콘만으로는 그것을\n   * 말하지 못한다 — 눌러 보기 전에는 안에 무엇이 있는지, 있기는 한지 알 수 없다.\n   *\n   * 세는 방식과 값은 `countChildren` 머리말에 적었다.\n   */\n  /**\n   * 여기서 일하는 사람들.\n   *\n   * **넘치면 몇이 남았는지 말한다**(`occupantOverflow`). 조용히 자르면 「셋이 있다」와 「서른이\n   * 있는데 셋만 보인다」가 같아 보이고, 그 칸을 보고 사람이 판단을 내린다.\n   *\n   * 아무도 없으면 빈 목록이다 — 없는 것은 없다고 낸다.\n   */\n  @FieldResolver(type => [String], { description: 'People whose home location is here' })\n  async staff(@Root() location: OperationalLocation, @Ctx() context: ResolverContext): Promise<string[]> {\n    return cappedList(namesAt((await occupantsOf(location, context)).staff, location), OCCUPANT_SHOWN).shown\n  }\n\n  /** 여기 있는 설비들. */\n  @FieldResolver(type => [String], { description: 'Equipment stationed here' })\n  async equipmentHere(@Root() location: OperationalLocation, @Ctx() context: ResolverContext): Promise<string[]> {\n    return cappedList(namesAt((await occupantsOf(location, context)).equipment, location), OCCUPANT_SHOWN).shown\n  }\n\n  /** 여기 있는 자산들 — 공구 · 지그처럼 옮겨 다니는 것. */\n  @FieldResolver(type => [String], { description: 'Physical assets kept here' })\n  async assetsHere(@Root() location: OperationalLocation, @Ctx() context: ResolverContext): Promise<string[]> {\n    return cappedList(namesAt((await occupantsOf(location, context)).assets, location), OCCUPANT_SHOWN).shown\n  }\n\n  /**\n   * 위 세 칸에서 **안 보인 것이 몇인가.**\n   *\n   * 셋을 합쳐 하나로 낸다. 칸마다 따로 두면 화면이 숫자 셋을 더 들고 있어야 하는데, 사람이 알고\n   * 싶은 것은 「이 자리에 더 있나」 하나다.\n   */\n  @FieldResolver(type => Int, { description: 'How many occupants are not shown in the lists above' })\n  async occupantOverflow(@Root() location: OperationalLocation, @Ctx() context: ResolverContext): Promise<number> {\n    const scan = await occupantsOf(location, context)\n\n    return (\n      cappedList(namesAt(scan.staff, location), OCCUPANT_SHOWN).hidden +\n      cappedList(namesAt(scan.equipment, location), OCCUPANT_SHOWN).hidden +\n      cappedList(namesAt(scan.assets, location), OCCUPANT_SHOWN).hidden\n    )\n  }\n\n  @FieldResolver(type => Int, { description: 'How many locations sit directly under this one' })\n  async childCount(@Root() location: OperationalLocation, @Ctx() context: ResolverContext): Promise<number> {\n    const { domain, locationPage } = context.state as { domain: Domain; locationPage?: OperationalLocation[] }\n\n    const page = locationPage as OperationalLocation[] | undefined\n    const inPage = !!page?.some(one => one.id === location.id)\n\n    /*\n     * 목록 조회가 남긴 페이지에 없으면 그 줄만 센다.\n     *\n     * 한 요청에 목록 조회가 둘 있으면 뒤엣것이 앞엣것의 페이지를 덮어쓴다. 그때 남는 줄들을 조용히 0 으로\n     * 두지 않는다 — 틀린 개수보다 질의 한 번이 낫다.\n     */\n    if (!inPage) {\n      const counted = await countChildren([location], domain)\n      return sumFor(location, counted)\n    }\n\n    /*\n     * 요청 안에서 한 번만 센다. **약속을 담는다** — 줄들이 거의 동시에 묻기 때문에 결과를 담으면\n     * 스무 개가 각자 질의를 띄운다.\n     */\n    const state = context.state as { locationChildCounts?: Promise<Map<string, number>> }\n    state.locationChildCounts = state.locationChildCounts || countChildren(page!, domain)\n\n    return sumFor(location, await state.locationChildCounts)\n  }\n\n  /**\n   * 그리드가 보낸 변경을 한 번에 적용한다.\n   *\n   * 패치를 `ScalarObject` 로 받는다 — 축마다 입력 타입을 따로 만들면 칸을 하나 더할 때마다 두 곳을\n   * 고쳐야 하고, 한쪽을 빠뜨리면 그 칸이 오류 보고 없이 저장되지 않는다. 돌려주는 것은 타입이 있는\n   * 엔티티라 무엇이 저장됐는지 스키마로 확인할 수 있다.\n   */\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [OperationalLocation], { description: 'To create, change or retire operational locations' })\n  async updateMultipleOperationalLocation(\n    @Arg('patches', type => [ScalarObject]) patches: MasterPatch[],\n    @Ctx() context: ResolverContext,\n    /** **언제부터 그러한가** — 근무조 선언과 부모 관계를 고칠 때만 온다(§`applied-when`). */\n    @Arg('applied', type => ScalarObject, { nullable: true }) applied?: AppliedWhen\n  ): Promise<OperationalLocation[]> {\n    const { domain, user, tx } = context.state\n    const axis = masterAxisOf('operationalLocation')\n\n    const saved = await saveMasterPatches(tx, domain, axis.entity, patches, user, {\n      hasEffectivePeriod: axis.hasEffectivePeriod,\n      ...appliedOptions(applied)\n    })\n\n    return saved as OperationalLocation[]\n  }\n}\n"]}

package/dist-server/service/location/location-master.d.ts

@@ -1,26 +0,0 @@
-import type { OperationalLocation } from './operational-location';
-/** 트윈 `ReferenceMaster.locations` 의 한 항목. */
-export interface LocationEntry {
-    id: string;
-    type: string;
-    capacity?: number;
-    parallelism?: number;
-    parentId?: string;
-    level?: string;
-    /** 이 자리를 정의하는 영역(`wms` · `mes` …) — 같은 현장을 비추는 렌즈가 자기 자리와 참조할 자리를 가른다(ADR-0081 보탬). */
-    system?: string;
-    properties?: unknown[];
-    testSpecificationIds?: string[];
-    effectiveStart?: string;
-    effectiveEnd?: string;
-}
-/**
- * 자리를 트윈이 받는 모양으로 옮긴다.
- *
- * **용량이 없으면 칸을 만들지 않는다.** 계약은 `capacity` 를 필수로 적지만, 모르는 값을 임의로 채우면
- * 물품 하나에 포화 경고가 난다. 비워 보내고 받는 쪽이 「모른다」로 다루게 한다.
- */
-export declare function toLocationEntry(location: OperationalLocation): LocationEntry;
-export declare function locationMaster(locations: OperationalLocation[]): {
-    locations: LocationEntry[];
-};

package/dist-server/service/location/location-master.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toLocationEntry = toLocationEntry;
-exports.locationMaster = locationMaster;
-const resource_class_1 = require("../resource/resource-class");
-/**
- * 자리를 트윈이 받는 모양으로 옮긴다.
- *
- * **용량이 없으면 칸을 만들지 않는다.** 계약은 `capacity` 를 필수로 적지만, 모르는 값을 임의로 채우면
- * 물품 하나에 포화 경고가 난다. 비워 보내고 받는 쪽이 「모른다」로 다루게 한다.
- */
-function toLocationEntry(location) {
-    const out = { id: location.name, type: location.type };
-    (0, resource_class_1.put)(out, 'capacity', location.capacity === undefined || location.capacity === null ? undefined : Number(location.capacity));
-    (0, resource_class_1.put)(out, 'parallelism', location.parallelism === undefined || location.parallelism === null ? undefined : Number(location.parallelism));
-    (0, resource_class_1.put)(out, 'parentId', location.parentId);
-    (0, resource_class_1.put)(out, 'level', location.level);
-    (0, resource_class_1.put)(out, 'system', location.system);
-    (0, resource_class_1.put)(out, 'properties', location.properties);
-    (0, resource_class_1.put)(out, 'testSpecificationIds', location.testSpecificationIds);
-    (0, resource_class_1.put)(out, 'effectiveStart', (0, resource_class_1.iso)(location.effectiveStart));
-    (0, resource_class_1.put)(out, 'effectiveEnd', (0, resource_class_1.iso)(location.effectiveEnd));
-    return out;
-}
-function locationMaster(locations) {
-    return { locations: locations.map(toLocationEntry) };
-}
-//# sourceMappingURL=location-master.js.map

package/dist-server/service/location/location-master.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"location-master.js","sourceRoot":"","sources":["../../../server/service/location/location-master.ts"],"names":[],"mappings":";;AAyBA,0CAcC;AAED,wCAEC;AA3CD,+DAAqD;AAmBrD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,QAA6B;IAC3D,MAAM,GAAG,GAA4B,EAAE,EAAE,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAA;IAE/E,IAAA,oBAAG,EAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC3H,IAAA,oBAAG,EAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IACvI,IAAA,oBAAG,EAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACvC,IAAA,oBAAG,EAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjC,IAAA,oBAAG,EAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACnC,IAAA,oBAAG,EAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC3C,IAAA,oBAAG,EAAC,GAAG,EAAE,sBAAsB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAC/D,IAAA,oBAAG,EAAC,GAAG,EAAE,gBAAgB,EAAE,IAAA,oBAAG,EAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAA;IACxD,IAAA,oBAAG,EAAC,GAAG,EAAE,cAAc,EAAE,IAAA,oBAAG,EAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAEpD,OAAO,GAA+B,CAAA;AACxC,CAAC;AAED,SAAgB,cAAc,CAAC,SAAgC;IAC7D,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAA;AACtD,CAAC","sourcesContent":["import { iso, put } from '../resource/resource-class'\nimport type { OperationalLocation } from './operational-location'\n\n/** 트윈 `ReferenceMaster.locations` 의 한 항목. */\nexport interface LocationEntry {\n  id: string\n  type: string\n  capacity?: number\n  parallelism?: number\n  parentId?: string\n  level?: string\n  /** 이 자리를 정의하는 영역(`wms` · `mes` …) — 같은 현장을 비추는 렌즈가 자기 자리와 참조할 자리를 가른다(ADR-0081 보탬). */\n  system?: string\n  properties?: unknown[]\n  testSpecificationIds?: string[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 자리를 트윈이 받는 모양으로 옮긴다.\n *\n * **용량이 없으면 칸을 만들지 않는다.** 계약은 `capacity` 를 필수로 적지만, 모르는 값을 임의로 채우면\n * 물품 하나에 포화 경고가 난다. 비워 보내고 받는 쪽이 「모른다」로 다루게 한다.\n */\nexport function toLocationEntry(location: OperationalLocation): LocationEntry {\n  const out: Record<string, unknown> = { id: location.name, type: location.type }\n\n  put(out, 'capacity', location.capacity === undefined || location.capacity === null ? undefined : Number(location.capacity))\n  put(out, 'parallelism', location.parallelism === undefined || location.parallelism === null ? undefined : Number(location.parallelism))\n  put(out, 'parentId', location.parentId)\n  put(out, 'level', location.level)\n  put(out, 'system', location.system)\n  put(out, 'properties', location.properties)\n  put(out, 'testSpecificationIds', location.testSpecificationIds)\n  put(out, 'effectiveStart', iso(location.effectiveStart))\n  put(out, 'effectiveEnd', iso(location.effectiveEnd))\n\n  return out as unknown as LocationEntry\n}\n\nexport function locationMaster(locations: OperationalLocation[]): { locations: LocationEntry[] } {\n  return { locations: locations.map(toLocationEntry) }\n}\n"]}

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

@@ -1,15 +0,0 @@
-export declare class LocationMaster {
-    locations: string;
-    /**
-     * 더 있나 — **이 값을 안 보고 쓰면 조용히 잘린 마스터로 트윈을 세우게 된다.**
-     *
-     * 거짓이 될 때까지 `next` 를 `after` 로 넘겨 이어 받는다.
-     */
-    hasMore: boolean;
-    /** 이어 받을 자리. 더 없으면 없다. */
-    next?: string;
-}
-export declare class LocationQuery {
-    /** 자리 축 전체 — 자리가 상위 자리를 가리키므로 한 번에 낸다. */
-    locationMaster(after: string | undefined, limit: number | undefined, context: ResolverContext): Promise<LocationMaster>;
-}

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

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocationQuery = exports.LocationMaster = void 0;
-const tslib_1 = require("tslib");
-const type_graphql_1 = require("type-graphql");
-const master_page_query_1 = require("../master-page-query");
-const location_master_1 = require("./location-master");
-const operational_location_1 = require("./operational-location");
-let LocationMaster = class LocationMaster {
-};
-exports.LocationMaster = LocationMaster;
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => String, { description: 'ReferenceMaster locations[] as JSON text' }),
-    tslib_1.__metadata("design:type", String)
-], LocationMaster.prototype, "locations", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ description: 'true when more rows remain — keep pulling with next as after' }),
-    tslib_1.__metadata("design:type", Boolean)
-], LocationMaster.prototype, "hasMore", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => String, { nullable: true, description: 'cursor for the next page — the last name in this page' }),
-    tslib_1.__metadata("design:type", String)
-], LocationMaster.prototype, "next", void 0);
-exports.LocationMaster = LocationMaster = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)({ description: 'Location master as the twin receives it' })
-], LocationMaster);
-let LocationQuery = class LocationQuery {
-    /** 자리 축 전체 — 자리가 상위 자리를 가리키므로 한 번에 낸다. */
-    async locationMaster(after, limit, context) {
-        const { domain } = context.state;
-        const request = { after, limit };
-        const page = await (0, master_page_query_1.pullPage)(operational_location_1.OperationalLocation, domain, request);
-        /* 통째로 달라고 했는데 한도를 넘으면 **자르지 않고 거절한다**(§`master-page`). */
-        (0, master_page_query_1.refuseIfTooLarge)('자리', request, page);
-        const locations = page.rows;
-        return {
-            locations: JSON.stringify((0, location_master_1.locationMaster)(locations).locations),
-            hasMore: page.hasMore,
-            ...(page.next ? { next: page.next } : {})
-        };
-    }
-};
-exports.LocationQuery = LocationQuery;
-tslib_1.__decorate([
-    (0, type_graphql_1.Query)(returns => LocationMaster, { description: 'Location master for the twin to pull' }),
-    tslib_1.__param(0, (0, type_graphql_1.Arg)('after', { nullable: true, description: 'resume after this name — the previous page\'s next' })),
-    tslib_1.__param(1, (0, type_graphql_1.Arg)('limit', type => type_graphql_1.Int, { nullable: true, description: 'rows per page — omit only when the axis is small enough to pull whole' })),
-    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [String, Number, Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], LocationQuery.prototype, "locationMaster", null);
-exports.LocationQuery = LocationQuery = tslib_1.__decorate([
-    (0, type_graphql_1.Resolver)(operational_location_1.OperationalLocation)
-], LocationQuery);
-//# sourceMappingURL=location-query.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"location-query.js","sourceRoot":"","sources":["../../../server/service/location/location-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAgF;AAIhF,4DAAiE;AAEjE,uDAAyE;AACzE,iEAA4D;AAGrD,IAAM,cAAc,GAApB,MAAM,cAAc;CAgB1B,CAAA;AAhBY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;;iDAClE;AAQjB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;;+CACvE;AAIhB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;;4CACnG;yBAdF,cAAc;IAD1B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;GAC1D,cAAc,CAgB1B;AAGM,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,0CAA0C;IAEpC,AAAN,KAAK,CAAC,cAAc,CACmF,KAAyB,EACO,KAAyB,EACvJ,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,IAAA,4BAAQ,EAAsB,0CAAmB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAEtF,0DAA0D;QAC1D,IAAA,oCAAgB,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QAErC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAA;QAE3B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,CAAC,SAAS,CAAC;YACnE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAA;IACH,CAAC;CACF,CAAA;AAxBY,sCAAa;AAGlB;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;IAEvF,mBAAA,IAAA,kBAAG,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC,CAAA;IACnG,mBAAA,IAAA,kBAAG,EAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uEAAuE,EAAE,CAAC,CAAA;IACnI,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;mDAiBP;wBAvBU,aAAa;IADzB,IAAA,uBAAQ,EAAC,0CAAmB,CAAC;GACjB,aAAa,CAwBzB","sourcesContent":["import { Arg, Ctx, Field, Int, ObjectType, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { pullPage, refuseIfTooLarge } from '../master-page-query'\n\nimport { locationMaster as buildLocationMaster } from './location-master'\nimport { OperationalLocation } from './operational-location'\n\n@ObjectType({ description: 'Location master as the twin receives it' })\nexport class LocationMaster {\n  @Field(type => String, { description: 'ReferenceMaster locations[] as JSON text' })\n  locations: string\n\n  /**\n   * 더 있나 — **이 값을 안 보고 쓰면 조용히 잘린 마스터로 트윈을 세우게 된다.**\n   *\n   * 거짓이 될 때까지 `next` 를 `after` 로 넘겨 이어 받는다.\n   */\n  @Field({ description: 'true when more rows remain — keep pulling with next as after' })\n  hasMore: boolean\n\n  /** 이어 받을 자리. 더 없으면 없다. */\n  @Field(type => String, { nullable: true, description: 'cursor for the next page — the last name in this page' })\n  next?: string\n\n}\n\n@Resolver(OperationalLocation)\nexport class LocationQuery {\n  /** 자리 축 전체 — 자리가 상위 자리를 가리키므로 한 번에 낸다. */\n  @Query(returns => LocationMaster, { description: 'Location master for the twin to pull' })\n  async locationMaster(\n    @Arg('after', { nullable: true, description: 'resume after this name — the previous page\\'s next' }) after: string | undefined,\n    @Arg('limit', type => Int, { nullable: true, description: 'rows per page — omit only when the axis is small enough to pull whole' }) limit: number | undefined,\n    @Ctx() context: ResolverContext\n  ): Promise<LocationMaster> {\n    const { domain } = context.state\n\n    const request = { after, limit }\n    const page = await pullPage<OperationalLocation>(OperationalLocation, domain, request)\n\n    /* 통째로 달라고 했는데 한도를 넘으면 **자르지 않고 거절한다**(§`master-page`). */\n    refuseIfTooLarge('자리', request, page)\n\n    const locations = page.rows\n\n    return {\n      locations: JSON.stringify(buildLocationMaster(locations).locations),\n      hasMore: page.hasMore,\n      ...(page.next ? { next: page.next } : {})\n    }\n  }\n}\n"]}

package/dist-server/service/location/operational-location.d.ts

@@ -1,116 +0,0 @@
-import { type DomainSystem } from '@operato/ops-contract';
-import { Domain } from '@things-factory/shell';
-import { User } from '@things-factory/auth-base';
-/**
- * 자리 — **ISA-95 `OperationalLocation`**.
- *
- * 표준 원문은 「자원이 놓이거나 놓일 것으로 예상되는 논리적·물리적 장소」다. 자기 계층을 재귀로 갖고,
- * 설비는 자기 자리를 이것으로 가리킨다. 자리와 설비를 나눠 두는 것은 표준의 구조다.
- *
- * ── 용량을 지어내지 않는다 ──────────────────────────────────────────────────
- * `capacity` 는 그 자리에 몇이 들어가는가다. 모르면 비워 둔다. 실측에서 임의로 1 을 넣었더니 물품
- * 하나에 포화 경고가 났다 — 없는 것보다 나쁜 수다.
- */
-export declare class OperationalLocation {
-    readonly id: string;
-    domain?: Domain;
-    domainId?: string;
-    /** 표준 `ID` — 트윈으로 나갈 때 `locations[].id` 가 된다. */
-    name: string;
-    description?: string;
-    /** 자리 타입 — 도메인 카탈로그가 정한 키(`raw-store` · `weld-station` 같은 것). */
-    type: string;
-    /**
-     * **이 자리의 주인 영역** — 창고(`wms`) · 야드(`yms`) · 공장(`mes`) · 에너지(`ems`)(ADR-0081).
-     *
-     * ── 왜 칸이어야 하나 (2026-09-19 에 세어 보고 정함) ─────────────────────────
-     * 한 현장에 제품이 둘 서면 「이 자리는 누구 것인가」를 물어야 한다. 창고의 재고는 **창고가 주인인 자리에
-     * 선 것**이고, 라인 쪽 자리에 선 물건은 공장의 것이다. 그 답이 없으면 불출한 자재가 창고 재고에 그대로
-     * 남아 가용 수와 할당 후보에 든다.
-     *
-     * 있는 칸으로는 가를 수 없다 — 전부 **추론**이 된다.
-     *
-     * ```
-     * type        WMS 타입(dock · storage …)과 MES 타입(raw-store · weld-station …)이 한 칸에 섞인다.
-     *             현장이 자기 타입을 선언할 수 있어(DomainDefinition.locationTypes) 새 타입이 생기는 날 틀린다
-     * level       ISA-95 단이라 같은 문제다
-     * properties  열린 Record 라 읽는 쪽마다 키를 정하고, 그러면 방언이 된다
-     * parentId    「창고 아래」로 가를 수는 있으나 그 뿌리가 누구 것인지는 여전히 선언이 없다
-     * ```
-     *
-     * ── 모르면 모르는 것이다 ───────────────────────────────────────────────────
-     * 비어 있으면 **어느 제품의 재고에도 들지 않는다.** `type` 을 보고 채우는 대체값을 두지 않는다 — 그 추론이
-     * 틀리는 날 남의 자리에 선 물건이 우리 재고가 되고, 아무도 오류를 보지 못한다. 선언되지 않은 자리의 수는
-     * 화면이 말한다.
-     *
-     * 낱말은 계약의 `DOMAIN_SYSTEMS` 다. 글자로 다시 적지 않는다.
-     */
-    system?: DomainSystem;
-    /**
-     * ISA-95 설비 계층 단 — `ProductionLine` · `WorkCell` · `StorageZone` · `ProcessCell` · `Unit` 등.
-     *
-     * 적지 않으면 타입으로 알아낸다. 적으면 그것이 기준이다 — 현장이 자기 계층을 더 잘 안다.
-     */
-    level?: string;
-    /** 이 자리에 몇이 들어가나. **모르면 비운다.** */
-    capacity?: number;
-    /** 동시에 몇을 처리하나(대기 이론의 서버 수). 표준에 없는 우리 축이다. */
-    parallelism?: number;
-    /** 상위 자리 — 표준 `OperationalLocationChild`(재귀)의 반대 방향. */
-    parentId?: string;
-    /**
-     * 바로 아래에 몇이 있나. **저장하지 않는다** — 목록 리졸버가 채운다(`attachChildCounts`).
-     *
-     * 계층을 한 단씩 걷는 화면이 이 값으로 「그 줄에 들어갈 것이 있나」를 말한다. 세어서 넣는 값이라
-     * 컬럼이 아니다 — 컬럼으로 두면 자식이 생기고 없어질 때마다 이 줄을 함께 고쳐야 하고, 한 번 빠뜨리면
-     * 틀린 개수가 남는다.
-     */
-    childCount?: number;
-    /** 자리 속성 — 표준 `OperationalLocationProperty`. */
-    properties?: Record<string, unknown>[];
-    /**
-     * 이 자리에서 도는 **근무조 이름들** — 아래 단이 물려받는다.
-     *
-     * ── 왜 자리가 드나 (2026-09-07) ─────────────────────────────────────────
-     * 근무조는 지금까지 도메인 단위 선언이고 **어디에 걸리는지가 없었다.** 그래서 씨앗이 설비마다
-     * 사본을 뿌렸고(`Equipment.workCalendar`), 한 공장 22대가 같은 값을 22벌 들고 있었다. 3교대를
-     * 2교대로 바꾸면 22줄을 고쳐야 하고, 한 줄을 빠뜨리면 그 설비만 조용히 옛 근무로 계산된다.
-     *
-     * 근무조는 **사람의 일정**이다. 사람은 기계 한 대가 아니라 라인·셀에 배치된다. 그래서 자리가
-     * 들고 아래가 물려받는다 — 공장에 한 줄 적으면 그 아래 전부가 그것으로 돈다.
-     *
-     * ── 비어 있는 것이 정상이다 ───────────────────────────────────────────────
-     * 채우는 것은 **위와 다를 때뿐**이다. 라인 하나만 주간이면 그 라인에만 적는다. 아무 데도 안 적으면
-     * 도메인의 근무조 전부로 떨어져 지금 거동 그대로다 — 이 칸이 생겼다고 기존 공장이 바뀌지 않는다.
-     *
-     * ── 설비에는 적지 않는다 ──────────────────────────────────────────────────
-     * 「이 기계만 24시간 돈다」는 근무조가 다른 것이 아니라 **자기 가동 계획이 다른 것**이다(에이징
-     * 로가 그렇다). 그 사실은 `Equipment.workCalendar` — 이 설비가 가동하도록 계획된 시간 — 에 적힌다.
-     * 근무조로 적으면 아무도 근무하지 않는 시간이 근무 시간으로 기록된다.
-     *
-     * ── 거는 단은 work center 급 이상이다 — 규칙이지 제약이 아니다 ────────────
-     * ISA-95 Part 1 이 일정과 능력을 work center 에 둔다. 사람은 라인에 배치되지 기계 한 대에
-     * 배치되지 않으므로, `Site` · `Area` · `ProductionLine` · `WorkCenter` 가 이 칸을 든다.
-     *
-     * **거절하지는 않는다.** 아래 단에 적어도 상속이 그것을 먼저 만나 그냥 돈다. 셀 단위 근무가
-     * 실제로 있는 현장에서 저장을 막으면 그 현장은 모델링 자체가 안 된다 — 적합성 표에 줄 하나가
-     * 서는 것보다 나쁘다. 어긋난 것은 성숙도가 이름과 함께 낸다.
-     */
-    workShiftNames?: string[];
-    /** 이 자리에 걸리는 `TestSpecification` 참조들 — 구역 온도 기준 같은 것이 여기 붙는다. */
-    testSpecificationIds?: string[];
-    /** 언제부터 유효한가 — 표준 `EffectiveStartDate`. */
-    effectiveStart?: Date;
-    /**
-     * 언제까지 유효한가 — 표준 `EffectiveEndDate`.
-     *
-     * **없앨 때 행을 지우지 않고 이 칸을 채운다.** 지우면 그것을 가리키는 지난 기록이 가리킬 것을 잃는다.
-     */
-    effectiveEnd?: Date;
-    createdAt?: Date;
-    updatedAt?: Date;
-    creator?: User;
-    creatorId?: string;
-    updater?: User;
-    updaterId?: string;
-}