@things-factory/integration-data-go-kr 10.0.0-beta.108

package/dist-server/engine/spec/weather/mid-term-forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mid-term-forecast.js","sourceRoot":"","sources":["../../../../server/engine/spec/weather/mid-term-forecast.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAM,YAAY,GAAyB;IACzC;QACE,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,mFAAmF;QACrF,OAAO,EAAE,UAAU;KACpB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,cAAc;KACxB;CACF,CAAA;AAEY,QAAA,yBAAyB,GAAgB;IACpD,SAAS,EAAE,4BAA4B;IACvC,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,+BAA+B;IAC5C,QAAQ,EAAE,iDAAiD;IAC3D,UAAU,EAAE;QACV,UAAU,EAAE;YACV,WAAW,EAAE,YAAY;YACzB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,kBAAkB;YAC/B,MAAM,EAAE,YAAY;SACrB;QACD,cAAc,EAAE;YACd,WAAW,EAAE,gBAAgB;YAC7B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,2BAA2B;YACxC,MAAM,EAAE,YAAY;SACrB;QACD,QAAQ,EAAE;YACR,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,wBAAwB;YACrC,MAAM,EAAE,YAAY;SACrB;QACD,aAAa,EAAE;YACb,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,kBAAkB;YAC/B,MAAM,EAAE,YAAY;SACrB;KACF;CACF,CAAA","sourcesContent":["import { OperationParamSpec, ServiceSpec } from '../types'\n\n/**\n * 기상청_중기예보 조회서비스 (data.go.kr 데이터셋 15059468).\n *\n * 3~10일 전망. 광역 권역(regId) 단위로 06·18시 발표.\n */\nconst sharedParams: OperationParamSpec[] = [\n  {\n    name: 'regId',\n    required: true,\n    description:\n      '광역 권역 코드. 육상은 `11B00000`(서울/인천/경기) 등, 기온은 `11B10101`(서울) 등 더 세분화. KMA 권역 코드 표 참조.',\n    example: '11B00000'\n  },\n  {\n    name: 'tmFc',\n    required: true,\n    length: 12,\n    description: '발표시각 YYYYMMDDHHMM. 중기예보는 06·18시 발표.',\n    example: '202604250600'\n  }\n]\n\nexport const KmaMidTermForecastService: ServiceSpec = {\n  serviceId: '1360000/MidFcstInfoService',\n  label: '기상청_중기예보 조회서비스',\n  description: '3~10일 중기예보. 육상·기온·해상 별 오퍼레이션.',\n  homepage: 'https://www.data.go.kr/data/15059468/openapi.do',\n  operations: {\n    getMidFcst: {\n      operationId: 'getMidFcst',\n      label: '중기예보 종합',\n      description: '중기 전망 텍스트 (해석본).',\n      params: sharedParams\n    },\n    getMidLandFcst: {\n      operationId: 'getMidLandFcst',\n      label: '육상 중기예보',\n      description: '육상 권역의 강수확률·하늘상태 (3~10일).',\n      params: sharedParams\n    },\n    getMidTa: {\n      operationId: 'getMidTa',\n      label: '중기 기온예보',\n      description: '아침 최저·낮 최고 기온 (3~10일).',\n      params: sharedParams\n    },\n    getMidSeaFcst: {\n      operationId: 'getMidSeaFcst',\n      label: '해상 중기예보',\n      description: '해상 권역의 풍향·풍속·파고.',\n      params: sharedParams\n    }\n  }\n}\n"]}

package/dist-server/engine/spec/weather/short-term-forecast.d.ts

@@ -0,0 +1,2 @@
+import { ServiceSpec } from '../types';
+export declare const KmaShortTermForecastService: ServiceSpec;

package/dist-server/engine/spec/weather/short-term-forecast.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KmaShortTermForecastService = void 0;
+/**
+ * 기상청_단기예보 조회서비스 v2 (data.go.kr 데이터셋 15084084).
+ *
+ * 동네예보 + 초단기예보 + 초단기실황. 모두 KMA 5km 격자좌표(nx, ny) 기준.
+ */
+const sharedParams = [
+    {
+        name: 'base_date',
+        label: 'label.base-date',
+        required: true,
+        length: 8,
+        description: '발표일자 YYYYMMDD',
+        example: '20260425'
+    },
+    {
+        name: 'base_time',
+        label: 'label.base-time',
+        required: true,
+        length: 4,
+        description: '발표시각 HHMM. 단기예보는 0200·0500·0800·1100·1400·1700·2000·2300, 초단기 시리즈는 매시각 정시.',
+        example: '1100'
+    },
+    {
+        name: 'nx',
+        label: 'label.nx',
+        required: true,
+        description: 'KMA 5km 격자 X좌표 (위경도 → 격자 변환은 task/weather/grid-converter 헬퍼).',
+        example: '60'
+    },
+    {
+        name: 'ny',
+        label: 'label.ny',
+        required: true,
+        description: 'KMA 5km 격자 Y좌표.',
+        example: '127'
+    }
+];
+exports.KmaShortTermForecastService = {
+    serviceId: '1360000/VilageFcstInfoService_2.0',
+    label: '기상청_단기예보 조회서비스',
+    description: '동네예보(3일치)·초단기예보(6시간)·초단기실황 3개 오퍼레이션. KMA 5km 격자좌표 기준.',
+    homepage: 'https://www.data.go.kr/data/15084084/openapi.do',
+    operations: {
+        getVilageFcst: {
+            operationId: 'getVilageFcst',
+            label: '단기예보 조회',
+            description: '동네예보. 02·05·08·11·14·17·20·23시 (각 +10분 후 제공) 발표, 3일치 3시간 간격 카테고리 (POP·PCP·SKY·REH·T1H·UUU·VVV·VEC·WSD·TMN·TMX 등).',
+            params: sharedParams,
+            responseNotes: 'items.item 이 (카테고리×시점) 조합으로 매우 많이 반환됨 (3일치 약 800+건). numOfRows 를 충분히 크게 (1000+) 잡거나 페이징.',
+            externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'
+        },
+        getUltraSrtFcst: {
+            operationId: 'getUltraSrtFcst',
+            label: '초단기예보 조회',
+            description: '발표시각 +45분 후 제공. 매시각 발표. 향후 6시간 예보 (1시간 단위).',
+            params: sharedParams,
+            externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'
+        },
+        getUltraSrtNcst: {
+            operationId: 'getUltraSrtNcst',
+            label: '초단기실황 조회',
+            description: '발표시각 +10분 후 제공. 매시각 발표. 현재 관측값 (T1H·RN1·UUU·VVV·REH·PTY·VEC·WSD).',
+            params: sharedParams,
+            externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'
+        }
+    }
+};
+//# sourceMappingURL=short-term-forecast.js.map

package/dist-server/engine/spec/weather/short-term-forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-term-forecast.js","sourceRoot":"","sources":["../../../../server/engine/spec/weather/short-term-forecast.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAM,YAAY,GAAyB;IACzC;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,UAAU;KACpB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EACT,4EAA4E;QAC9E,OAAO,EAAE,MAAM;KAChB;IACD;QACE,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,+DAA+D;QAC5E,OAAO,EAAE,IAAI;KACd;IACD;QACE,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,KAAK;KACf;CACF,CAAA;AAEY,QAAA,2BAA2B,GAAgB;IACtD,SAAS,EAAE,mCAAmC;IAC9C,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,uDAAuD;IACpE,QAAQ,EAAE,iDAAiD;IAC3D,UAAU,EAAE;QACV,aAAa,EAAE;YACb,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,mHAAmH;YACrH,MAAM,EAAE,YAAY;YACpB,aAAa,EACX,0FAA0F;YAC5F,eAAe,EAAE,iDAAiD;SACnE;QACD,eAAe,EAAE;YACf,WAAW,EAAE,iBAAiB;YAC9B,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,6CAA6C;YAC1D,MAAM,EAAE,YAAY;YACpB,eAAe,EAAE,iDAAiD;SACnE;QACD,eAAe,EAAE;YACf,WAAW,EAAE,iBAAiB;YAC9B,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,mEAAmE;YAChF,MAAM,EAAE,YAAY;YACpB,eAAe,EAAE,iDAAiD;SACnE;KACF;CACF,CAAA","sourcesContent":["import { OperationParamSpec, ServiceSpec } from '../types'\n\n/**\n * 기상청_단기예보 조회서비스 v2 (data.go.kr 데이터셋 15084084).\n *\n * 동네예보 + 초단기예보 + 초단기실황. 모두 KMA 5km 격자좌표(nx, ny) 기준.\n */\nconst sharedParams: OperationParamSpec[] = [\n  {\n    name: 'base_date',\n    label: 'label.base-date',\n    required: true,\n    length: 8,\n    description: '발표일자 YYYYMMDD',\n    example: '20260425'\n  },\n  {\n    name: 'base_time',\n    label: 'label.base-time',\n    required: true,\n    length: 4,\n    description:\n      '발표시각 HHMM. 단기예보는 0200·0500·0800·1100·1400·1700·2000·2300, 초단기 시리즈는 매시각 정시.',\n    example: '1100'\n  },\n  {\n    name: 'nx',\n    label: 'label.nx',\n    required: true,\n    description: 'KMA 5km 격자 X좌표 (위경도 → 격자 변환은 task/weather/grid-converter 헬퍼).',\n    example: '60'\n  },\n  {\n    name: 'ny',\n    label: 'label.ny',\n    required: true,\n    description: 'KMA 5km 격자 Y좌표.',\n    example: '127'\n  }\n]\n\nexport const KmaShortTermForecastService: ServiceSpec = {\n  serviceId: '1360000/VilageFcstInfoService_2.0',\n  label: '기상청_단기예보 조회서비스',\n  description: '동네예보(3일치)·초단기예보(6시간)·초단기실황 3개 오퍼레이션. KMA 5km 격자좌표 기준.',\n  homepage: 'https://www.data.go.kr/data/15084084/openapi.do',\n  operations: {\n    getVilageFcst: {\n      operationId: 'getVilageFcst',\n      label: '단기예보 조회',\n      description:\n        '동네예보. 02·05·08·11·14·17·20·23시 (각 +10분 후 제공) 발표, 3일치 3시간 간격 카테고리 (POP·PCP·SKY·REH·T1H·UUU·VVV·VEC·WSD·TMN·TMX 등).',\n      params: sharedParams,\n      responseNotes:\n        'items.item 이 (카테고리×시점) 조합으로 매우 많이 반환됨 (3일치 약 800+건). numOfRows 를 충분히 크게 (1000+) 잡거나 페이징.',\n      externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'\n    },\n    getUltraSrtFcst: {\n      operationId: 'getUltraSrtFcst',\n      label: '초단기예보 조회',\n      description: '발표시각 +45분 후 제공. 매시각 발표. 향후 6시간 예보 (1시간 단위).',\n      params: sharedParams,\n      externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'\n    },\n    getUltraSrtNcst: {\n      operationId: 'getUltraSrtNcst',\n      label: '초단기실황 조회',\n      description: '발표시각 +10분 후 제공. 매시각 발표. 현재 관측값 (T1H·RN1·UUU·VVV·REH·PTY·VEC·WSD).',\n      params: sharedParams,\n      externalDocsUrl: 'https://www.data.go.kr/data/15084084/openapi.do'\n    }\n  }\n}\n"]}

package/dist-server/engine/spec/weather/warning.d.ts

@@ -0,0 +1,2 @@
+import { ServiceSpec } from '../types';
+export declare const KmaWeatherWarningService: ServiceSpec;

package/dist-server/engine/spec/weather/warning.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KmaWeatherWarningService = void 0;
+/**
+ * 기상청_기상특보 조회서비스 (data.go.kr 데이터셋 15059092).
+ *
+ * 호우·태풍·강풍·풍랑·대설 등 특보의 발효 현황 및 상세 내용.
+ */
+const sharedParams = [
+    { name: 'stnId', required: true, description: '발표 관할 지점 ID. 전국=108. KMA 지점 코드 표 참조.', example: '108' },
+    { name: 'fromTmFc', required: true, length: 8, description: '검색시작일 YYYYMMDD', example: '20260425' },
+    { name: 'toTmFc', required: true, length: 8, description: '검색종료일 YYYYMMDD', example: '20260425' }
+];
+exports.KmaWeatherWarningService = {
+    serviceId: '1360000/WthrWrnInfoService',
+    label: '기상청_기상특보 조회서비스',
+    description: '기상특보(호우·태풍·강풍·풍랑·대설 등) 발효 현황 및 상세 내용 조회.',
+    homepage: 'https://www.data.go.kr/data/15059092/openapi.do',
+    operations: {
+        getWthrWrnList: {
+            operationId: 'getWthrWrnList',
+            label: '특보 목록 조회',
+            description: '발표 시각 범위 내의 특보 목록.',
+            params: sharedParams
+        },
+        getWthrWrnInfo: {
+            operationId: 'getWthrWrnInfo',
+            label: '특보 상세 조회',
+            description: '발효 중인 특정 특보의 상세 발표문.',
+            params: sharedParams
+        }
+    }
+};
+//# sourceMappingURL=warning.js.map

package/dist-server/engine/spec/weather/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","sourceRoot":"","sources":["../../../../server/engine/spec/weather/warning.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAM,YAAY,GAAyB;IACzC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sCAAsC,EAAE,OAAO,EAAE,KAAK,EAAE;IACtG,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE;IACnG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE;CAClG,CAAA;AAEY,QAAA,wBAAwB,GAAgB;IACnD,SAAS,EAAE,4BAA4B;IACvC,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,0CAA0C;IACvD,QAAQ,EAAE,iDAAiD;IAC3D,UAAU,EAAE;QACV,cAAc,EAAE;YACd,WAAW,EAAE,gBAAgB;YAC7B,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,oBAAoB;YACjC,MAAM,EAAE,YAAY;SACrB;QACD,cAAc,EAAE;YACd,WAAW,EAAE,gBAAgB;YAC7B,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,sBAAsB;YACnC,MAAM,EAAE,YAAY;SACrB;KACF;CACF,CAAA","sourcesContent":["import { OperationParamSpec, ServiceSpec } from '../types'\n\n/**\n * 기상청_기상특보 조회서비스 (data.go.kr 데이터셋 15059092).\n *\n * 호우·태풍·강풍·풍랑·대설 등 특보의 발효 현황 및 상세 내용.\n */\nconst sharedParams: OperationParamSpec[] = [\n  { name: 'stnId', required: true, description: '발표 관할 지점 ID. 전국=108. KMA 지점 코드 표 참조.', example: '108' },\n  { name: 'fromTmFc', required: true, length: 8, description: '검색시작일 YYYYMMDD', example: '20260425' },\n  { name: 'toTmFc', required: true, length: 8, description: '검색종료일 YYYYMMDD', example: '20260425' }\n]\n\nexport const KmaWeatherWarningService: ServiceSpec = {\n  serviceId: '1360000/WthrWrnInfoService',\n  label: '기상청_기상특보 조회서비스',\n  description: '기상특보(호우·태풍·강풍·풍랑·대설 등) 발효 현황 및 상세 내용 조회.',\n  homepage: 'https://www.data.go.kr/data/15059092/openapi.do',\n  operations: {\n    getWthrWrnList: {\n      operationId: 'getWthrWrnList',\n      label: '특보 목록 조회',\n      description: '발표 시각 범위 내의 특보 목록.',\n      params: sharedParams\n    },\n    getWthrWrnInfo: {\n      operationId: 'getWthrWrnInfo',\n      label: '특보 상세 조회',\n      description: '발효 중인 특정 특보의 상세 발표문.',\n      params: sharedParams\n    }\n  }\n}\n"]}

package/dist-server/engine/task/building-ledger/general.d.ts

@@ -0,0 +1,30 @@
+import { Context } from '@things-factory/integration-base';
+import { BuildingLedgerResult } from '../../types';
+/**
+ * 건축물대장 표제부(`getBrTitleInfo`) 조회 태스크.
+ *
+ * 순수 fetch 만 수행 — 응답 items 를 그대로 반환한다. 다동 필지 집계·단위 변환
+ * 같은 도메인 가공은 소비자 측 후속 스텝(data-mapper / jsonata / 자체 태스크) 에서
+ * 처리하도록 책임을 분리.
+ *
+ * 왜 전용 태스크인가:
+ *  - 범용 `data-go-kr-call` 로도 호출 가능하지만, 필요한 operationRef 와 PNU 5요소
+ *    파라미터를 매번 입력하는 대신 파라미터 폼을 명시적으로 제공해 운영/시나리오
+ *    작성 부담을 줄인다.
+ *  - 건축물대장은 dssp/dkpi·건산연·공인중개·자산관리 등 자주 쓰이는 도메인이므로
+ *    범용보다 한 단계 전용화된 표면을 둘 가치가 충분.
+ */
+declare function BuildingLedgerTask(step: any, context: Context): Promise<{
+    data: BuildingLedgerResult;
+}>;
+declare namespace BuildingLedgerTask {
+    var parameterSpec: {
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+        description: string;
+    }[];
+    var help: string;
+}
+export default BuildingLedgerTask;

package/dist-server/engine/task/building-ledger/general.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const integration_base_1 = require("@things-factory/integration-base");
+const building_ledger_1 = require("../../spec/building-ledger");
+/**
+ * 건축물대장 표제부(`getBrTitleInfo`) 조회 태스크.
+ *
+ * 순수 fetch 만 수행 — 응답 items 를 그대로 반환한다. 다동 필지 집계·단위 변환
+ * 같은 도메인 가공은 소비자 측 후속 스텝(data-mapper / jsonata / 자체 태스크) 에서
+ * 처리하도록 책임을 분리.
+ *
+ * 왜 전용 태스크인가:
+ *  - 범용 `data-go-kr-call` 로도 호출 가능하지만, 필요한 operationRef 와 PNU 5요소
+ *    파라미터를 매번 입력하는 대신 파라미터 폼을 명시적으로 제공해 운영/시나리오
+ *    작성 부담을 줄인다.
+ *  - 건축물대장은 dssp/dkpi·건산연·공인중개·자산관리 등 자주 쓰이는 도메인이므로
+ *    범용보다 한 단계 전용화된 표면을 둘 가치가 충분.
+ */
+async function BuildingLedgerTask(step, context) {
+    const { connection: connectionName, params } = step;
+    const { domain, user, data, variables, lng, logger } = context;
+    const instance = await integration_base_1.ConnectionManager.getConnectionInstanceByName(domain, connectionName);
+    if (!instance?.client) {
+        throw new Error(`data-go-kr connection '${connectionName}' is not established.`);
+    }
+    const scope = { domain, user, lng, data, variables, console };
+    const evalString = (value) => {
+        if (value === undefined || value === null || value === '')
+            return undefined;
+        try {
+            return (0, integration_base_1.evaluateTemplate)(String(value), scope);
+        }
+        catch (err) {
+            throw new Error(`data-go-kr-building-ledger: failed to evaluate parameter: ${err.message}`);
+        }
+    };
+    const sigunguCd = evalString(params.sigunguCd);
+    const bjdongCd = evalString(params.bjdongCd);
+    const bun = evalString(params.bun);
+    if (!sigunguCd)
+        throw new Error('data-go-kr-building-ledger: sigunguCd is required');
+    if (!bjdongCd)
+        throw new Error('data-go-kr-building-ledger: bjdongCd is required');
+    if (!bun)
+        throw new Error('data-go-kr-building-ledger: bun is required');
+    const servicePath = `${building_ledger_1.BldRgstHubService.serviceId}/getBrTitleInfo`;
+    const normalizedParams = {
+        sigunguCd,
+        bjdongCd,
+        platGbCd: evalString(params.platGbCd) || '0',
+        bun: zpad(bun, 4),
+        ji: zpad(evalString(params.ji) || '0', 4),
+        numOfRows: 100,
+        pageNo: 1
+    };
+    logger?.info?.(`[data-go-kr] ${servicePath} params=${JSON.stringify(normalizedParams)}`);
+    const items = await instance.client.getItems(servicePath, normalizedParams);
+    if (items.length === 0) {
+        throw new Error(`data-go-kr-building-ledger: no 표제부 records for PNU ` +
+            `${normalizedParams.sigunguCd}-${normalizedParams.bjdongCd}-${normalizedParams.platGbCd}-` +
+            `${normalizedParams.bun}-${normalizedParams.ji}. ` +
+            `Possible causes: PNU is wrong, building is pre-approval, or the lot has no registered building.`);
+    }
+    logger?.info?.(`[data-go-kr] items=${items.length} first.bldNm='${items[0].bldNm || ''}'`);
+    return { data: { items } };
+}
+function zpad(value, width) {
+    const s = String(value);
+    return s.length >= width ? s : '0'.repeat(width - s.length) + s;
+}
+/*
+ * 컨텍스트 데이터 액세서 사용 예시 (이전 step 의 juso-resolve-address 결과 활용):
+ *   sigunguCd: `${data.pnu.sigunguCd}`
+ *   bjdongCd:  `${data.pnu.bjdongCd}`
+ *   platGbCd:  `${data.pnu.platGbCd}`
+ *   bun:       `${data.pnu.bun}`
+ *   ji:        `${data.pnu.ji}`
+ * 시나리오 흐름: [juso-resolve-address] → data.pnu → [data-go-kr-building-ledger]
+ *
+ * 모든 파라미터는 evaluateTemplate 로 평가되므로 `${...}` 표현식 그대로 입력 가능.
+ */
+BuildingLedgerTask.parameterSpec = [
+    {
+        type: 'string',
+        name: 'sigunguCd',
+        label: 'label.sigungu-cd',
+        placeholder: '예) 11680 또는 ${data.pnu.sigunguCd}',
+        description: '시군구코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.sigunguCd}`'
+    },
+    {
+        type: 'string',
+        name: 'bjdongCd',
+        label: 'label.bjdong-cd',
+        placeholder: '예) 10300 또는 ${data.pnu.bjdongCd}',
+        description: '법정동코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.bjdongCd}`'
+    },
+    {
+        type: 'string',
+        name: 'platGbCd',
+        label: 'label.plat-gb-cd',
+        placeholder: '0=대지, 1=산, 2=블록 — 또는 ${data.pnu.platGbCd}',
+        description: '대지구분 1자리. 정적값 0/1/2 또는 액세서 표현식 입력 가능. ' +
+            'juso → PNU 흐름이면 `${data.pnu.platGbCd}`.'
+    },
+    {
+        type: 'string',
+        name: 'bun',
+        label: 'label.bun',
+        placeholder: '예) 223 또는 ${data.pnu.bun}',
+        description: '본번. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.bun}`'
+    },
+    {
+        type: 'string',
+        name: 'ji',
+        label: 'label.ji',
+        placeholder: '예) 0 또는 ${data.pnu.ji}',
+        description: '부번. 없으면 0. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.ji}`'
+    }
+];
+BuildingLedgerTask.help = 'integration/task/building-ledger';
+integration_base_1.TaskRegistry.registerTaskHandler('data-go-kr-building-ledger', BuildingLedgerTask);
+exports.default = BuildingLedgerTask;
+//# sourceMappingURL=general.js.map

package/dist-server/engine/task/building-ledger/general.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.js","sourceRoot":"","sources":["../../../../server/engine/task/building-ledger/general.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConnectionManager, Context, TaskRegistry, evaluateTemplate } from '@things-factory/integration-base'\n\nimport { DataGoKrConnectionInstance } from '../../connector/data-go-kr-connector'\nimport { BldRgstHubService } from '../../spec/building-ledger'\nimport { BrTitleItem, BuildingLedgerResult } from '../../types'\n\n/**\n * 건축물대장 표제부(`getBrTitleInfo`) 조회 태스크.\n *\n * 순수 fetch 만 수행 — 응답 items 를 그대로 반환한다. 다동 필지 집계·단위 변환\n * 같은 도메인 가공은 소비자 측 후속 스텝(data-mapper / jsonata / 자체 태스크) 에서\n * 처리하도록 책임을 분리.\n *\n * 왜 전용 태스크인가:\n *  - 범용 `data-go-kr-call` 로도 호출 가능하지만, 필요한 operationRef 와 PNU 5요소\n *    파라미터를 매번 입력하는 대신 파라미터 폼을 명시적으로 제공해 운영/시나리오\n *    작성 부담을 줄인다.\n *  - 건축물대장은 dssp/dkpi·건산연·공인중개·자산관리 등 자주 쓰이는 도메인이므로\n *    범용보다 한 단계 전용화된 표면을 둘 가치가 충분.\n */\nasync function BuildingLedgerTask(step, context: Context): Promise<{ data: BuildingLedgerResult }> {\n  const { connection: connectionName, params } = step\n  const { domain, user, data, variables, lng, logger } = context\n\n  const instance: DataGoKrConnectionInstance = await ConnectionManager.getConnectionInstanceByName(\n    domain,\n    connectionName\n  )\n  if (!instance?.client) {\n    throw new Error(`data-go-kr connection '${connectionName}' is not established.`)\n  }\n\n  const scope = { domain, user, lng, data, variables, console }\n  const evalString = (value: string | undefined) => {\n    if (value === undefined || value === null || value === '') return undefined\n    try {\n      return evaluateTemplate(String(value), scope)\n    } catch (err) {\n      throw new Error(`data-go-kr-building-ledger: failed to evaluate parameter: ${(err as Error).message}`)\n    }\n  }\n\n  const sigunguCd = evalString(params.sigunguCd)\n  const bjdongCd = evalString(params.bjdongCd)\n  const bun = evalString(params.bun)\n\n  if (!sigunguCd) throw new Error('data-go-kr-building-ledger: sigunguCd is required')\n  if (!bjdongCd) throw new Error('data-go-kr-building-ledger: bjdongCd is required')\n  if (!bun) throw new Error('data-go-kr-building-ledger: bun is required')\n\n  const servicePath = `${BldRgstHubService.serviceId}/getBrTitleInfo`\n\n  const normalizedParams = {\n    sigunguCd,\n    bjdongCd,\n    platGbCd: evalString(params.platGbCd) || '0',\n    bun: zpad(bun, 4),\n    ji: zpad(evalString(params.ji) || '0', 4),\n    numOfRows: 100,\n    pageNo: 1\n  }\n\n  logger?.info?.(`[data-go-kr] ${servicePath} params=${JSON.stringify(normalizedParams)}`)\n\n  const items: BrTitleItem[] = await instance.client.getItems(servicePath, normalizedParams)\n\n  if (items.length === 0) {\n    throw new Error(\n      `data-go-kr-building-ledger: no 표제부 records for PNU ` +\n        `${normalizedParams.sigunguCd}-${normalizedParams.bjdongCd}-${normalizedParams.platGbCd}-` +\n        `${normalizedParams.bun}-${normalizedParams.ji}. ` +\n        `Possible causes: PNU is wrong, building is pre-approval, or the lot has no registered building.`\n    )\n  }\n\n  logger?.info?.(`[data-go-kr] items=${items.length} first.bldNm='${items[0].bldNm || ''}'`)\n\n  return { data: { items } }\n}\n\nfunction zpad(value: string, width: number): string {\n  const s = String(value)\n  return s.length >= width ? s : '0'.repeat(width - s.length) + s\n}\n\n/*\n * 컨텍스트 데이터 액세서 사용 예시 (이전 step 의 juso-resolve-address 결과 활용):\n *   sigunguCd: `${data.pnu.sigunguCd}`\n *   bjdongCd:  `${data.pnu.bjdongCd}`\n *   platGbCd:  `${data.pnu.platGbCd}`\n *   bun:       `${data.pnu.bun}`\n *   ji:        `${data.pnu.ji}`\n * 시나리오 흐름: [juso-resolve-address] → data.pnu → [data-go-kr-building-ledger]\n *\n * 모든 파라미터는 evaluateTemplate 로 평가되므로 `${...}` 표현식 그대로 입력 가능.\n */\nBuildingLedgerTask.parameterSpec = [\n  {\n    type: 'string',\n    name: 'sigunguCd',\n    label: 'label.sigungu-cd',\n    placeholder: '예) 11680 또는 ${data.pnu.sigunguCd}',\n    description: '시군구코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.sigunguCd}`'\n  },\n  {\n    type: 'string',\n    name: 'bjdongCd',\n    label: 'label.bjdong-cd',\n    placeholder: '예) 10300 또는 ${data.pnu.bjdongCd}',\n    description: '법정동코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.bjdongCd}`'\n  },\n  {\n    type: 'string',\n    name: 'platGbCd',\n    label: 'label.plat-gb-cd',\n    placeholder: '0=대지, 1=산, 2=블록 — 또는 ${data.pnu.platGbCd}',\n    description:\n      '대지구분 1자리. 정적값 0/1/2 또는 액세서 표현식 입력 가능. ' +\n      'juso → PNU 흐름이면 `${data.pnu.platGbCd}`.'\n  },\n  {\n    type: 'string',\n    name: 'bun',\n    label: 'label.bun',\n    placeholder: '예) 223 또는 ${data.pnu.bun}',\n    description: '본번. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.bun}`'\n  },\n  {\n    type: 'string',\n    name: 'ji',\n    label: 'label.ji',\n    placeholder: '예) 0 또는 ${data.pnu.ji}',\n    description: '부번. 없으면 0. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.ji}`'\n  }\n]\n\nBuildingLedgerTask.help = 'integration/task/building-ledger'\n\nTaskRegistry.registerTaskHandler('data-go-kr-building-ledger', BuildingLedgerTask)\n\nexport default BuildingLedgerTask\n"]}

package/dist-server/engine/task/building-ledger/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 건축물대장 도메인 전용 태스크 그룹.
+ *
+ * 공통 경로(`data-go-kr-call` + SpecRegistry) 로 커버 가능한 호출은 굳이 전용 태스크를
+ * 만들지 말 것 — 이 폴더는 **공통으로 표현하기 어려운 도메인 특화 로직** 이 필요한
+ * 태스크만 들어가는 자리이다.
+ *
+ * 향후 추가 예시:
+ *  - apt.ts   : data-go-kr-building-ledger-apt   (집합건축물/아파트 전용)
+ *  - recap.ts : data-go-kr-building-ledger-recap (총괄표제부 전용 변형)
+ */
+import './general';
+import './summary';

package/dist-server/engine/task/building-ledger/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 건축물대장 도메인 전용 태스크 그룹.
+ *
+ * 공통 경로(`data-go-kr-call` + SpecRegistry) 로 커버 가능한 호출은 굳이 전용 태스크를
+ * 만들지 말 것 — 이 폴더는 **공통으로 표현하기 어려운 도메인 특화 로직** 이 필요한
+ * 태스크만 들어가는 자리이다.
+ *
+ * 향후 추가 예시:
+ *  - apt.ts   : data-go-kr-building-ledger-apt   (집합건축물/아파트 전용)
+ *  - recap.ts : data-go-kr-building-ledger-recap (총괄표제부 전용 변형)
+ */
+require("./general");
+require("./summary");
+//# sourceMappingURL=index.js.map

package/dist-server/engine/task/building-ledger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/task/building-ledger/index.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;GAUG;AACH,qBAAkB;AAClB,qBAAkB","sourcesContent":["/**\n * 건축물대장 도메인 전용 태스크 그룹.\n *\n * 공통 경로(`data-go-kr-call` + SpecRegistry) 로 커버 가능한 호출은 굳이 전용 태스크를\n * 만들지 말 것 — 이 폴더는 **공통으로 표현하기 어려운 도메인 특화 로직** 이 필요한\n * 태스크만 들어가는 자리이다.\n *\n * 향후 추가 예시:\n *  - apt.ts   : data-go-kr-building-ledger-apt   (집합건축물/아파트 전용)\n *  - recap.ts : data-go-kr-building-ledger-recap (총괄표제부 전용 변형)\n */\nimport './general'\nimport './summary'\n"]}

package/dist-server/engine/task/building-ledger/summary.d.ts

@@ -0,0 +1,95 @@
+import { Context } from '@things-factory/integration-base';
+import { BrTitleItem } from '../../types';
+/**
+ * 건축물 4 핵심 KPI (연면적·용적률·지상층수·지하층수) 만 **단일 객체** 로 반환하는
+ * 요약 태스크. PNU 한 번 입력으로 케이스 (집합·단동) 자동 분기 + 단일값 보장.
+ *
+ * 내부 흐름:
+ *   1) `getBrRecapTitleInfo` (총괄표제부) 호출
+ *      - 응답 items 가 1건 이상이면 단지 단위 row 그대로 사용 (source='recap')
+ *      - 0건이면 일반건축물 가능성 → 2 단계로
+ *   2) `getBrTitleInfo` (표제부) 호출
+ *      - items[0] 사용 (source='title')
+ *      - 단동이면 1건, 다동이면 첫 동 (일반건축물 분기라 보통 단동)
+ *   3) 둘 다 0건이면 에러
+ *
+ * 출력 (`data`):
+ *   {
+ *     totArea:    number | null,   // 연면적 (㎡)
+ *     vlRat:      number | null,   // 용적률 (%)
+ *     grndFlrCnt: number | null,   // 지상층수
+ *     ugrndFlrCnt:number | null,   // 지하층수
+ *     bldNm:      string | null,
+ *     useAprDay:  string | null,   // 사용승인일 YYYYMMDD
+ *     source:     'recap' | 'title',
+ *     raw:        BrTitleItem     // 원본 (집합·단동 케이스 모두의 단일 row)
+ *   }
+ *
+ * 시나리오 사용 예 (juso 결합):
+ *   [juso-resolve-address] → data.pnu
+ *   [data-go-kr-building-summary]
+ *       sigunguCd = ${data.pnu.sigunguCd}
+ *       bjdongCd  = ${data.pnu.bjdongCd}
+ *       platGbCd  = ${data.pnu.platGbCd}
+ *       bun       = ${data.pnu.bun}
+ *       ji        = ${data.pnu.ji}
+ *   다음 step 에서 ${data.totArea}, ${data.vlRat} 등 직접 접근.
+ */
+export interface BuildingSummary {
+    totArea: number | null;
+    /** 대지면적 (㎡) — 집합건축물 총괄표제부에 있음 */
+    platArea: number | null;
+    /** 건축면적 (㎡) */
+    archArea: number | null;
+    /** 건폐율 (%) */
+    bcRat: number | null;
+    vlRat: number | null;
+    grndFlrCnt: number | null;
+    ugrndFlrCnt: number | null;
+    /** 주구조 코드 (예: '21'=철근콘크리트구조, '22'=철골철근콘크리트구조(SRC), '14'=프리캐스트콘크리트(PC) …) */
+    strctCd: string | null;
+    /** 주구조 이름 (예: '철근콘크리트구조', '철골철근콘크리트구조') */
+    strctCdNm: string | null;
+    /** 기타구조 자유텍스트 (도면상 상세 표기) */
+    etcStrct: string | null;
+    /** 주용도 코드 (예: '02000'=공동주택, '03000'=제1종근린생활시설 …) */
+    mainPurpsCd: string | null;
+    /** 주용도 이름 (예: '공동주택', '제1종근린생활시설') — DSSP SiteType 매핑 원천 */
+    mainPurpsCdNm: string | null;
+    /** 기타용도 자유텍스트 (도면상 상세 표기) */
+    etcPurps: string | null;
+    /** 세대수 — 집합건축물 */
+    hhldCnt: number | null;
+    /** 가구수 */
+    fmlyCnt: number | null;
+    /** 호수 (상가/근린 등) */
+    hoCnt: number | null;
+    /** 주건축물수 (단지 동 수) — recap 에서 노출 */
+    mainBldCnt: number | null;
+    /** 부속건축물수 */
+    atchBldCnt: number | null;
+    /** 건물 높이 (m) */
+    heit: number | null;
+    bldNm: string | null;
+    useAprDay: string | null;
+    /** 건축허가일 YYYYMMDD */
+    pmsDay: string | null;
+    /** 착공일 YYYYMMDD */
+    stcnsDay: string | null;
+    source: 'recap' | 'title';
+    raw: BrTitleItem;
+}
+declare function BuildingSummaryTask(step: any, context: Context): Promise<{
+    data: BuildingSummary;
+}>;
+declare namespace BuildingSummaryTask {
+    var parameterSpec: {
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+        description: string;
+    }[];
+    var help: string;
+}
+export default BuildingSummaryTask;

package/dist-server/engine/task/building-ledger/summary.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const integration_base_1 = require("@things-factory/integration-base");
+const building_ledger_1 = require("../../spec/building-ledger");
+async function BuildingSummaryTask(step, context) {
+    const { connection: connectionName, params } = step;
+    const { domain, user, data, variables, lng, logger } = context;
+    const instance = await integration_base_1.ConnectionManager.getConnectionInstanceByName(domain, connectionName);
+    if (!instance?.client) {
+        throw new Error(`data-go-kr connection '${connectionName}' is not established.`);
+    }
+    const scope = { domain, user, lng, data, variables, console };
+    const evalString = (value) => {
+        if (value === undefined || value === null || value === '')
+            return undefined;
+        try {
+            return (0, integration_base_1.evaluateTemplate)(String(value), scope);
+        }
+        catch (err) {
+            throw new Error(`data-go-kr-building-summary: failed to evaluate parameter: ${err.message}`);
+        }
+    };
+    const sigunguCd = evalString(params.sigunguCd);
+    const bjdongCd = evalString(params.bjdongCd);
+    const bun = evalString(params.bun);
+    if (!sigunguCd)
+        throw new Error('data-go-kr-building-summary: sigunguCd is required');
+    if (!bjdongCd)
+        throw new Error('data-go-kr-building-summary: bjdongCd is required');
+    if (!bun)
+        throw new Error('data-go-kr-building-summary: bun is required');
+    const pnu = {
+        sigunguCd,
+        bjdongCd,
+        platGbCd: evalString(params.platGbCd) || '0',
+        bun: zpad(bun, 4),
+        ji: zpad(evalString(params.ji) || '0', 4),
+        numOfRows: 100,
+        pageNo: 1
+    };
+    // 두 API 모두 호출 — recap 결과가 있어도 strctCdNm 등 동 단위 정보는
+    // 표제부의 주건축물 row 에서 보완.
+    const recapPath = `${building_ledger_1.BldRgstHubService.serviceId}/getBrRecapTitleInfo`;
+    const titlePath = `${building_ledger_1.BldRgstHubService.serviceId}/getBrTitleInfo`;
+    logger?.info?.(`[data-go-kr] fetch recap + title params=${JSON.stringify(pnu)}`);
+    const [recapItems, titleItems] = await Promise.all([
+        instance.client
+            .getItems(recapPath, pnu)
+            .catch(err => {
+            logger?.warn?.(`[data-go-kr] recap call failed: ${err.message}`);
+            return [];
+        }),
+        instance.client
+            .getItems(titlePath, pnu)
+            .catch(err => {
+            logger?.warn?.(`[data-go-kr] title call failed: ${err.message}`);
+            return [];
+        })
+    ]);
+    if (recapItems.length === 0 && titleItems.length === 0) {
+        throw new Error(`data-go-kr-building-summary: PNU ${pnu.sigunguCd}-${pnu.bjdongCd}-${pnu.platGbCd}-${pnu.bun}-${pnu.ji} ` +
+            `에 대해 총괄표제부·표제부 모두 0건. PNU 오류, 미준공 건물, 또는 미등록 필지 가능성.`);
+    }
+    // 집합건축물 = recap 있음 → 단지 단위 4 KPI 정확.
+    // 일반건축물 = recap 없음 → title 첫 row 가 답.
+    // 두 경우 모두 구조정보(strctCdNm 등) 는 title 의 **주건축물** row 에서 가져오는
+    // 게 정확. recap 에는 단지 대표 구조가 노출 안 될 수 있음.
+    const recap = recapItems[0];
+    const mainTitle = titleItems.find(t => t.mainAtchGbCd === '0') || // 주건축물 우선
+        titleItems[0];
+    const source = recap ? 'recap' : 'title';
+    logger?.info?.(`[data-go-kr] summary source=${source} recap=${recapItems.length} title=${titleItems.length} mainBldNm='${mainTitle?.bldNm || ''}'`);
+    return { data: toSummary(recap, mainTitle, source) };
+}
+/**
+ * 4 KPI + 구조 정보 + 메타를 단일 객체로 추출.
+ *
+ * - 4 KPI (totArea/vlRat/grndFlrCnt/ugrndFlrCnt) : 집합이면 recap 우선, 단동이면 title.
+ * - 구조 정보 (strctCd/Nm/etcStrct) : 동 단위라 title 의 주건축물 row 에서 가져옴.
+ *   title 에 정보 없으면 recap 에서 fallback.
+ */
+function toSummary(recap, mainTitle, source) {
+    const num = (v) => {
+        if (v === undefined || v === null || v === '' || v === ' ')
+            return null;
+        const n = Number(v);
+        return Number.isFinite(n) ? n : null;
+    };
+    const str = (v) => {
+        if (v === undefined || v === null)
+            return null;
+        const s = String(v).trim();
+        return s ? s : null;
+    };
+    // KPI 베이스 — 집합이면 recap, 아니면 title
+    const base = recap || mainTitle || {};
+    // 구조 — title 의 주건축물 우선, 없으면 recap
+    const structSrc = mainTitle || recap || {};
+    // 단지 차원 수치 (대지면적/건폐율/세대수/동수 등) 는 recap 에 명시. 단동이면 title.
+    return {
+        totArea: num(base.totArea),
+        platArea: num(base.platArea) || num(structSrc.platArea),
+        archArea: num(base.archArea) || num(structSrc.archArea),
+        bcRat: num(base.bcRat) || num(structSrc.bcRat),
+        vlRat: num(base.vlRat),
+        grndFlrCnt: num(base.grndFlrCnt),
+        ugrndFlrCnt: num(base.ugrndFlrCnt),
+        strctCd: str(structSrc.strctCd) || str(base.strctCd),
+        strctCdNm: str(structSrc.strctCdNm) || str(base.strctCdNm),
+        etcStrct: str(structSrc.etcStrct) || str(base.etcStrct),
+        // 주용도도 구조와 같이 title 의 주건축물 row 가 신뢰할 만함 — 단지 단위 recap
+        // 에 단일값으로 노출 안 되는 경우가 있음.
+        mainPurpsCd: str(structSrc.mainPurpsCd) || str(base.mainPurpsCd),
+        mainPurpsCdNm: str(structSrc.mainPurpsCdNm) || str(base.mainPurpsCdNm),
+        etcPurps: str(structSrc.etcPurps) || str(base.etcPurps),
+        hhldCnt: num(base.hhldCnt) || num(structSrc.hhldCnt),
+        fmlyCnt: num(base.fmlyCnt) || num(structSrc.fmlyCnt),
+        hoCnt: num(base.hoCnt) || num(structSrc.hoCnt),
+        mainBldCnt: num(base.mainBldCnt) || num(structSrc.mainBldCnt),
+        atchBldCnt: num(base.atchBldCnt) || num(structSrc.atchBldCnt),
+        heit: num(structSrc.heit) || num(base.heit),
+        bldNm: str(base.bldNm) || str(structSrc.bldNm),
+        useAprDay: str(base.useAprDay) || str(structSrc.useAprDay),
+        pmsDay: str(base.pmsDay) || str(structSrc.pmsDay),
+        stcnsDay: str(base.stcnsDay) || str(structSrc.stcnsDay),
+        source,
+        raw: base
+    };
+}
+function zpad(value, width) {
+    const s = String(value);
+    return s.length >= width ? s : '0'.repeat(width - s.length) + s;
+}
+BuildingSummaryTask.parameterSpec = [
+    {
+        type: 'string',
+        name: 'sigunguCd',
+        label: 'label.sigungu-cd',
+        placeholder: '예) 11680 또는 ${data.pnu.sigunguCd}',
+        description: '시군구코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.sigunguCd}`'
+    },
+    {
+        type: 'string',
+        name: 'bjdongCd',
+        label: 'label.bjdong-cd',
+        placeholder: '예) 10300 또는 ${data.pnu.bjdongCd}',
+        description: '법정동코드 5자리. 이전 step 결과 액세서 사용 예: `${data.pnu.bjdongCd}`'
+    },
+    {
+        type: 'string',
+        name: 'platGbCd',
+        label: 'label.plat-gb-cd',
+        placeholder: '0=대지, 1=산, 2=블록 — 또는 ${data.pnu.platGbCd}',
+        description: '대지구분 1자리. 정적값 0/1/2 또는 액세서 표현식.'
+    },
+    {
+        type: 'string',
+        name: 'bun',
+        label: 'label.bun',
+        placeholder: '예) 223 또는 ${data.pnu.bun}',
+        description: '본번. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.bun}`'
+    },
+    {
+        type: 'string',
+        name: 'ji',
+        label: 'label.ji',
+        placeholder: '예) 0 또는 ${data.pnu.ji}',
+        description: '부번. 없으면 0. 자동 4자리 zero-pad. 액세서 사용 예: `${data.pnu.ji}`'
+    }
+];
+BuildingSummaryTask.help = 'integration/task/building-summary';
+integration_base_1.TaskRegistry.registerTaskHandler('data-go-kr-building-summary', BuildingSummaryTask);
+exports.default = BuildingSummaryTask;
+//# sourceMappingURL=summary.js.map