@things-factory/integration-data-go-kr 10.0.0-zeta.3 → 10.0.0

package/dist-server/engine/spec/building-permit/hub.d.ts

@@ -0,0 +1,17 @@
+import { ServiceSpec } from '../types';
+/**
+ * 국토교통부_건축HUB 건축인허가정보 서비스 (data.go.kr 데이터셋 15134730).
+ *
+ * 세움터(EAIS) 원천의 **건축 인허가(허가·착공·사용승인 전) 단계** 정보를 조회한다.
+ * 건축물대장(BldRgstHubService)이 "사용승인 완료된 건물"만 담는 것과 달리, 이 서비스는
+ * **준공 전(시공 중) 현장**의 허가 개요·동별·층별 정보를 제공한다 → 진행 중 프로젝트의
+ * 연면적·용적률·층수·구조 등을 대장 생성 이전에 확보하는 유일한 공공 경로.
+ *
+ * 모든 오퍼레이션은 건축물대장과 동일한 PNU 구성요소로 조회한다:
+ *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4) + ji(4)
+ *
+ * 주의: 한 필지에 여러 허가(mgmPmsrgstPk)가 존재할 수 있고, 공사용 가설건축물
+ * (컨테이너 현장사무소 등) 이 다수 섞여 내려온다. 본건물 개요를 얻으려면
+ * `mainPurpsCdNm='가설건축물'` 을 걸러내고 주건축물(mainAtchGbCd='0') 을 선택해야 한다.
+ */
+export declare const ArchPmsHubService: ServiceSpec;

package/dist-server/engine/spec/building-permit/hub.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchPmsHubService = void 0;
+/**
+ * PNU 5요소 파라미터 스펙 — ArchPmsHubService 의 모든 오퍼레이션이 공유.
+ * (건축물대장 허브와 동일 구성. 별도 선언으로 서비스 간 독립성 유지.)
+ */
+const pnuParams = [
+    {
+        name: 'sigunguCd',
+        label: 'label.sigungu-cd',
+        required: true,
+        length: 5,
+        description: '시군구코드 5자리 (법정동코드 10자리의 앞 5자리).',
+        example: '11500'
+    },
+    {
+        name: 'bjdongCd',
+        label: 'label.bjdong-cd',
+        required: true,
+        length: 5,
+        description: '법정동코드 5자리 (법정동코드 10자리의 뒤 5자리).',
+        example: '10500'
+    },
+    {
+        name: 'platGbCd',
+        label: 'label.plat-gb-cd',
+        default: '0',
+        length: 1,
+        description: '대지구분 1자리. `0` 대지 / `1` 산 / `2` 블록.',
+        example: '0',
+        enum: [
+            { value: '0', label: '대지' },
+            { value: '1', label: '산' },
+            { value: '2', label: '블록' }
+        ]
+    },
+    {
+        name: 'bun',
+        label: 'label.bun',
+        required: true,
+        pad: 4,
+        description: '본번. 자동으로 4자리 zero-pad 됨 (예: `747` → `0747`).',
+        example: '747'
+    },
+    {
+        name: 'ji',
+        label: 'label.ji',
+        default: '0',
+        pad: 4,
+        description: '부번. 없으면 `0`. 자동 4자리 zero-pad.',
+        example: '1'
+    }
+];
+/**
+ * 국토교통부_건축HUB 건축인허가정보 서비스 (data.go.kr 데이터셋 15134730).
+ *
+ * 세움터(EAIS) 원천의 **건축 인허가(허가·착공·사용승인 전) 단계** 정보를 조회한다.
+ * 건축물대장(BldRgstHubService)이 "사용승인 완료된 건물"만 담는 것과 달리, 이 서비스는
+ * **준공 전(시공 중) 현장**의 허가 개요·동별·층별 정보를 제공한다 → 진행 중 프로젝트의
+ * 연면적·용적률·층수·구조 등을 대장 생성 이전에 확보하는 유일한 공공 경로.
+ *
+ * 모든 오퍼레이션은 건축물대장과 동일한 PNU 구성요소로 조회한다:
+ *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4) + ji(4)
+ *
+ * 주의: 한 필지에 여러 허가(mgmPmsrgstPk)가 존재할 수 있고, 공사용 가설건축물
+ * (컨테이너 현장사무소 등) 이 다수 섞여 내려온다. 본건물 개요를 얻으려면
+ * `mainPurpsCdNm='가설건축물'` 을 걸러내고 주건축물(mainAtchGbCd='0') 을 선택해야 한다.
+ */
+exports.ArchPmsHubService = {
+    serviceId: '1613000/ArchPmsHubService',
+    label: '국토교통부_건축HUB 건축인허가정보 서비스',
+    description: '세움터(EAIS) 원천의 건축 인허가 정보를 조회한다. 기본개요·동별개요·층별개요·주택·부설주차장 등 오퍼레이션 제공. 준공 전(시공 중) 현장 조회에 사용.',
+    homepage: 'https://www.data.go.kr/data/15134730/openapi.do',
+    operations: {
+        getApBasisOulnInfo: {
+            operationId: 'getApBasisOulnInfo',
+            label: '기본개요 조회',
+            description: '허가 기본개요(대지면적·건축면적·건폐율·용적률·연면적·주용도·허가일·착공(예정)일·사용승인일 등) 를 조회. 한 필지에 허가가 여러 건이면 복수 레코드로 내려온다 (mgmPmsrgstPk 로 구분).',
+            params: [...pnuParams],
+            responseNotes: '지상/지하 층수(grndFlrCnt/ugrndFlrCnt) 는 기본개요에 없고 동별개요/층별개요에 있음. 숫자 필드가 문자열/공백으로 올 수 있음.',
+            externalDocsUrl: 'https://www.data.go.kr/data/15134730/openapi.do',
+            examples: [
+                {
+                    label: '서울 강서구 마곡동 747-1',
+                    params: { sigunguCd: '11500', bjdongCd: '10500', bun: '747', ji: '1' }
+                }
+            ]
+        },
+        getApDongOulnInfo: {
+            operationId: 'getApDongOulnInfo',
+            label: '동별개요 조회',
+            description: '동(棟) 별 개요(주부속구분·주용도·구조·동 연면적·세대수·지상/지하 층수 등) 를 조회. 주건축물/부속건축물, 가설건축물 여부 판별의 기준.',
+            params: [...pnuParams],
+            responseNotes: 'mainAtchGbCd(0=주건축물,1=부속) / mainPurpsCdNm(가설건축물 여부) 로 본건물 필터링. mgmPmsrgstPk·mgmDongOulnPk 로 기본개요/층별개요와 조인.'
+        },
+        getApFlrOulnInfo: {
+            operationId: 'getApFlrOulnInfo',
+            label: '층별개요 조회',
+            description: '층별 주용도·구조·면적을 조회. flrGbCd(지상/지하) + flrNo 로 동별 지상/지하 층수 산출에 사용.',
+            params: [...pnuParams],
+            responseNotes: 'mgmDongOulnPk 로 특정 동의 층만 필터. 한 필지 다동이면 결과 건수가 많음.'
+        },
+        getApHousInfo: {
+            operationId: 'getApHousInfo',
+            label: '주택 조회',
+            description: '주택 관련 세부(가구/세대/호 수 등) 를 조회.',
+            params: [...pnuParams]
+        },
+        getApAtchParkngPlcInfo: {
+            operationId: 'getApAtchParkngPlcInfo',
+            label: '부설주차장 조회',
+            description: '부설주차장 설치 계획(옥내/옥외/면수) 을 조회.',
+            params: [...pnuParams]
+        }
+    }
+};
+//# sourceMappingURL=hub.js.map

package/dist-server/engine/spec/building-permit/hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.js","sourceRoot":"","sources":["../../../../server/engine/spec/building-permit/hub.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAM,SAAS,GAAyB;IACtC;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE;YACJ,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE;YAC3B,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE;YAC1B,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5B;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC;QACN,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,KAAK;KACf;IACD;QACE,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,GAAG;QACZ,GAAG,EAAE,CAAC;QACN,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,GAAG;KACb;CACF,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACU,QAAA,iBAAiB,GAAgB;IAC5C,SAAS,EAAE,2BAA2B;IACtC,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,0FAA0F;IAC5F,QAAQ,EAAE,iDAAiD;IAC3D,UAAU,EAAE;QACV,kBAAkB,EAAE;YAClB,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,iHAAiH;YACnH,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EACX,oFAAoF;YACtF,eAAe,EAAE,iDAAiD;YAClE,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,kBAAkB;oBACzB,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE;iBACvE;aACF;SACF;QACD,iBAAiB,EAAE;YACjB,WAAW,EAAE,mBAAmB;YAChC,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,iFAAiF;YACnF,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EAAE,4GAA4G;SAC5H;QACD,gBAAgB,EAAE;YAChB,WAAW,EAAE,kBAAkB;YAC/B,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,gEAAgE;YAClE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EAAE,mDAAmD;SACnE;QACD,aAAa,EAAE;YACb,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,6BAA6B;YAC1C,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;SACvB;QACD,sBAAsB,EAAE;YACtB,WAAW,EAAE,wBAAwB;YACrC,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,6BAA6B;YAC1C,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;SACvB;KACF;CACF,CAAA","sourcesContent":["import { OperationParamSpec, ServiceSpec } from '../types'\n\n/**\n * PNU 5요소 파라미터 스펙 — ArchPmsHubService 의 모든 오퍼레이션이 공유.\n * (건축물대장 허브와 동일 구성. 별도 선언으로 서비스 간 독립성 유지.)\n */\nconst pnuParams: OperationParamSpec[] = [\n  {\n    name: 'sigunguCd',\n    label: 'label.sigungu-cd',\n    required: true,\n    length: 5,\n    description: '시군구코드 5자리 (법정동코드 10자리의 앞 5자리).',\n    example: '11500'\n  },\n  {\n    name: 'bjdongCd',\n    label: 'label.bjdong-cd',\n    required: true,\n    length: 5,\n    description: '법정동코드 5자리 (법정동코드 10자리의 뒤 5자리).',\n    example: '10500'\n  },\n  {\n    name: 'platGbCd',\n    label: 'label.plat-gb-cd',\n    default: '0',\n    length: 1,\n    description: '대지구분 1자리. `0` 대지 / `1` 산 / `2` 블록.',\n    example: '0',\n    enum: [\n      { value: '0', label: '대지' },\n      { value: '1', label: '산' },\n      { value: '2', label: '블록' }\n    ]\n  },\n  {\n    name: 'bun',\n    label: 'label.bun',\n    required: true,\n    pad: 4,\n    description: '본번. 자동으로 4자리 zero-pad 됨 (예: `747` → `0747`).',\n    example: '747'\n  },\n  {\n    name: 'ji',\n    label: 'label.ji',\n    default: '0',\n    pad: 4,\n    description: '부번. 없으면 `0`. 자동 4자리 zero-pad.',\n    example: '1'\n  }\n]\n\n/**\n * 국토교통부_건축HUB 건축인허가정보 서비스 (data.go.kr 데이터셋 15134730).\n *\n * 세움터(EAIS) 원천의 **건축 인허가(허가·착공·사용승인 전) 단계** 정보를 조회한다.\n * 건축물대장(BldRgstHubService)이 \"사용승인 완료된 건물\"만 담는 것과 달리, 이 서비스는\n * **준공 전(시공 중) 현장**의 허가 개요·동별·층별 정보를 제공한다 → 진행 중 프로젝트의\n * 연면적·용적률·층수·구조 등을 대장 생성 이전에 확보하는 유일한 공공 경로.\n *\n * 모든 오퍼레이션은 건축물대장과 동일한 PNU 구성요소로 조회한다:\n *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4) + ji(4)\n *\n * 주의: 한 필지에 여러 허가(mgmPmsrgstPk)가 존재할 수 있고, 공사용 가설건축물\n * (컨테이너 현장사무소 등) 이 다수 섞여 내려온다. 본건물 개요를 얻으려면\n * `mainPurpsCdNm='가설건축물'` 을 걸러내고 주건축물(mainAtchGbCd='0') 을 선택해야 한다.\n */\nexport const ArchPmsHubService: ServiceSpec = {\n  serviceId: '1613000/ArchPmsHubService',\n  label: '국토교통부_건축HUB 건축인허가정보 서비스',\n  description:\n    '세움터(EAIS) 원천의 건축 인허가 정보를 조회한다. 기본개요·동별개요·층별개요·주택·부설주차장 등 오퍼레이션 제공. 준공 전(시공 중) 현장 조회에 사용.',\n  homepage: 'https://www.data.go.kr/data/15134730/openapi.do',\n  operations: {\n    getApBasisOulnInfo: {\n      operationId: 'getApBasisOulnInfo',\n      label: '기본개요 조회',\n      description:\n        '허가 기본개요(대지면적·건축면적·건폐율·용적률·연면적·주용도·허가일·착공(예정)일·사용승인일 등) 를 조회. 한 필지에 허가가 여러 건이면 복수 레코드로 내려온다 (mgmPmsrgstPk 로 구분).',\n      params: [...pnuParams],\n      responseNotes:\n        '지상/지하 층수(grndFlrCnt/ugrndFlrCnt) 는 기본개요에 없고 동별개요/층별개요에 있음. 숫자 필드가 문자열/공백으로 올 수 있음.',\n      externalDocsUrl: 'https://www.data.go.kr/data/15134730/openapi.do',\n      examples: [\n        {\n          label: '서울 강서구 마곡동 747-1',\n          params: { sigunguCd: '11500', bjdongCd: '10500', bun: '747', ji: '1' }\n        }\n      ]\n    },\n    getApDongOulnInfo: {\n      operationId: 'getApDongOulnInfo',\n      label: '동별개요 조회',\n      description:\n        '동(棟) 별 개요(주부속구분·주용도·구조·동 연면적·세대수·지상/지하 층수 등) 를 조회. 주건축물/부속건축물, 가설건축물 여부 판별의 기준.',\n      params: [...pnuParams],\n      responseNotes: 'mainAtchGbCd(0=주건축물,1=부속) / mainPurpsCdNm(가설건축물 여부) 로 본건물 필터링. mgmPmsrgstPk·mgmDongOulnPk 로 기본개요/층별개요와 조인.'\n    },\n    getApFlrOulnInfo: {\n      operationId: 'getApFlrOulnInfo',\n      label: '층별개요 조회',\n      description:\n        '층별 주용도·구조·면적을 조회. flrGbCd(지상/지하) + flrNo 로 동별 지상/지하 층수 산출에 사용.',\n      params: [...pnuParams],\n      responseNotes: 'mgmDongOulnPk 로 특정 동의 층만 필터. 한 필지 다동이면 결과 건수가 많음.'\n    },\n    getApHousInfo: {\n      operationId: 'getApHousInfo',\n      label: '주택 조회',\n      description: '주택 관련 세부(가구/세대/호 수 등) 를 조회.',\n      params: [...pnuParams]\n    },\n    getApAtchParkngPlcInfo: {\n      operationId: 'getApAtchParkngPlcInfo',\n      label: '부설주차장 조회',\n      description: '부설주차장 설치 계획(옥내/옥외/면수) 을 조회.',\n      params: [...pnuParams]\n    }\n  }\n}\n"]}

package/dist-server/engine/spec/building-permit/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 건축인허가 도메인 서비스 스펙 묶음.
+ *
+ * 건축물대장(building-ledger)이 "완공 건물"을 담는 것과 대비되는, "허가/시공 단계"
+ * 원천 서비스. 새 변종 추가 시 이 폴더에 파일을 만들고 본 index 에 export.
+ */
+export { ArchPmsHubService } from './hub';

package/dist-server/engine/spec/building-permit/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchPmsHubService = void 0;
+/**
+ * 건축인허가 도메인 서비스 스펙 묶음.
+ *
+ * 건축물대장(building-ledger)이 "완공 건물"을 담는 것과 대비되는, "허가/시공 단계"
+ * 원천 서비스. 새 변종 추가 시 이 폴더에 파일을 만들고 본 index 에 export.
+ */
+var hub_1 = require("./hub");
+Object.defineProperty(exports, "ArchPmsHubService", { enumerable: true, get: function () { return hub_1.ArchPmsHubService; } });
+//# sourceMappingURL=index.js.map

package/dist-server/engine/spec/building-permit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/spec/building-permit/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6BAAyC;AAAhC,wGAAA,iBAAiB,OAAA","sourcesContent":["/**\n * 건축인허가 도메인 서비스 스펙 묶음.\n *\n * 건축물대장(building-ledger)이 \"완공 건물\"을 담는 것과 대비되는, \"허가/시공 단계\"\n * 원천 서비스. 새 변종 추가 시 이 폴더에 파일을 만들고 본 index 에 export.\n */\nexport { ArchPmsHubService } from './hub'\n"]}

package/dist-server/engine/spec/housing-permit/hub.d.ts

@@ -0,0 +1,16 @@
+import { ServiceSpec } from '../types';
+/**
+ * 국토교통부_건축HUB 주택인허가정보 서비스 (data.go.kr 데이터셋 15136560).
+ *
+ * 세움터(EAIS) 원천의 **주택건설 사업계획승인** 단계 정보를 조회한다. 건축인허가
+ * (ArchPmsHubService)가 개별 필지 건축허가를 담는 것과 달리, 이 서비스는 **공동주택 단지/
+ * 택지지구 사업** 을 블록 단위로 담아 — **지번이 없는 블록형 단지(예: LH/SH 택지지구
+ * 공공주택)** 의 연면적·용적률·동/층수를 준공(건축물대장 생성) 이전에 확보하는 경로다.
+ *
+ * 조회는 건축인허가와 동일한 PNU 구성이나 **platGbCd=2(블록) + bun=블록번호** 가 핵심.
+ *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4=블록번호) + ji(4)
+ *
+ * 응답: 기본개요에 연면적(totArea)·용적률(vlRat)·건폐율(bcRat)·대지면적(platArea) 등.
+ * 한 사업/블록에 여러 승인(mgmPmsrgstPk)·여러 동이 존재할 수 있다.
+ */
+export declare const HsPmsHubService: ServiceSpec;

package/dist-server/engine/spec/housing-permit/hub.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HsPmsHubService = void 0;
+/**
+ * PNU 5요소 파라미터 스펙 — HsPmsHubService(주택인허가) 오퍼레이션 공유.
+ *
+ * 건축인허가(ArchPmsHubService)와 동일 구성이나, **주택건설 사업계획승인**은 택지지구/
+ * 정비사업처럼 개별 지번이 아닌 **블록(platGbCd=2) + 블록번호(bun)** 로 등록되는 경우가
+ * 많다. 따라서 `platGbCd=2`(블록) 조회가 1급 시나리오다.
+ */
+const pnuParams = [
+    {
+        name: 'sigunguCd',
+        label: 'label.sigungu-cd',
+        required: true,
+        length: 5,
+        description: '시군구코드 5자리 (법정동코드 10자리의 앞 5자리).',
+        example: '11740'
+    },
+    {
+        name: 'bjdongCd',
+        label: 'label.bjdong-cd',
+        required: true,
+        length: 5,
+        description: '법정동코드 5자리 (법정동코드 10자리의 뒤 5자리).',
+        example: '10600'
+    },
+    {
+        name: 'platGbCd',
+        label: 'label.plat-gb-cd',
+        default: '0',
+        length: 1,
+        description: '대지구분 1자리. `0` 대지 / `1` 산 / `2` 블록. 택지지구·정비사업 단지는 대개 `2`(블록).',
+        example: '2',
+        enum: [
+            { value: '0', label: '대지' },
+            { value: '1', label: '산' },
+            { value: '2', label: '블록' }
+        ]
+    },
+    {
+        name: 'bun',
+        label: 'label.bun',
+        required: true,
+        pad: 4,
+        description: '본번. 블록 조회 시 **블록번호**. 자동 4자리 zero-pad (예: `1` → `0001`).',
+        example: '1'
+    },
+    {
+        name: 'ji',
+        label: 'label.ji',
+        default: '0',
+        pad: 4,
+        description: '부번. 없으면 `0`. 자동 4자리 zero-pad.',
+        example: '0'
+    }
+];
+/**
+ * 국토교통부_건축HUB 주택인허가정보 서비스 (data.go.kr 데이터셋 15136560).
+ *
+ * 세움터(EAIS) 원천의 **주택건설 사업계획승인** 단계 정보를 조회한다. 건축인허가
+ * (ArchPmsHubService)가 개별 필지 건축허가를 담는 것과 달리, 이 서비스는 **공동주택 단지/
+ * 택지지구 사업** 을 블록 단위로 담아 — **지번이 없는 블록형 단지(예: LH/SH 택지지구
+ * 공공주택)** 의 연면적·용적률·동/층수를 준공(건축물대장 생성) 이전에 확보하는 경로다.
+ *
+ * 조회는 건축인허가와 동일한 PNU 구성이나 **platGbCd=2(블록) + bun=블록번호** 가 핵심.
+ *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4=블록번호) + ji(4)
+ *
+ * 응답: 기본개요에 연면적(totArea)·용적률(vlRat)·건폐율(bcRat)·대지면적(platArea) 등.
+ * 한 사업/블록에 여러 승인(mgmPmsrgstPk)·여러 동이 존재할 수 있다.
+ */
+exports.HsPmsHubService = {
+    serviceId: '1613000/HsPmsHubService',
+    label: '국토교통부_건축HUB 주택인허가정보 서비스',
+    description: '세움터(EAIS) 원천의 주택건설 사업계획승인 정보를 조회한다. 기본개요·동별개요·층별개요·호별개요·대지위치 등 제공. 블록(platGbCd=2) 단위 단지 조회에 사용 — 지번 없는 택지지구/정비사업 단지의 연면적·용적률 확보.',
+    homepage: 'https://www.data.go.kr/data/15136560/openapi.do',
+    operations: {
+        getHpBasisOulnInfo: {
+            operationId: 'getHpBasisOulnInfo',
+            label: '기본개요 조회',
+            description: '사업계획승인 기본개요(대지면적·건축면적·건폐율·용적률·연면적·주용도·승인일 등) 를 조회. 한 사업/블록에 승인이 여러 건이면 복수 레코드로 내려온다 (mgmPmsrgstPk 로 구분).',
+            params: [...pnuParams],
+            responseNotes: '연면적 totArea / 용적률 vlRat / 건폐율 bcRat / 대지면적 platArea. 지상/지하 층수는 기본개요에 없고 동별개요/층별개요에 있음. 숫자 필드가 문자열/공백으로 올 수 있음.',
+            externalDocsUrl: 'https://www.data.go.kr/data/15136560/openapi.do',
+            examples: [
+                {
+                    label: '서울 강동구 강일동 1블록 (고덕강일3단지)',
+                    params: { sigunguCd: '11740', bjdongCd: '10600', platGbCd: '2', bun: '1', ji: '0' }
+                }
+            ]
+        },
+        getHpDongOulnInfo: {
+            operationId: 'getHpDongOulnInfo',
+            label: '동별개요 조회',
+            description: '동(棟) 별 개요(주부속구분·주용도·구조·동 연면적·세대수·지상/지하 층수 등) 를 조회. 주건축물/부속건축물 판별 기준.',
+            params: [...pnuParams],
+            responseNotes: 'mainAtchGbCd(0=주건축물,1=부속) 로 본건물 필터링. mgmPmsrgstPk·mgmDongOulnPk 로 기본개요/층별개요와 조인.'
+        },
+        getHpFlrOulnInfo: {
+            operationId: 'getHpFlrOulnInfo',
+            label: '층별개요 조회',
+            description: '층별 주용도·구조·면적을 조회. flrGbCd(지상/지하) + flrNo 로 동별 지상/지하 층수 산출에 사용.',
+            params: [...pnuParams],
+            responseNotes: 'mgmDongOulnPk 로 특정 동의 층만 필터. 한 사업 다동이면 결과 건수가 많음.'
+        },
+        getHpPlatPlcInfo: {
+            operationId: 'getHpPlatPlcInfo',
+            label: '대지위치 조회',
+            description: '사업의 대지위치(지번/도로명) 목록을 조회. 블록에 포함된 실제 필지 확인용.',
+            params: [...pnuParams]
+        }
+    }
+};
+//# sourceMappingURL=hub.js.map

package/dist-server/engine/spec/housing-permit/hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.js","sourceRoot":"","sources":["../../../../server/engine/spec/housing-permit/hub.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAM,SAAS,GAAyB;IACtC;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,8DAA8D;QAC3E,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE;YACJ,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE;YAC3B,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE;YAC1B,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5B;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC;QACN,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,GAAG;KACb;IACD;QACE,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,GAAG;QACZ,GAAG,EAAE,CAAC;QACN,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,GAAG;KACb;CACF,CAAA;AAED;;;;;;;;;;;;;GAaG;AACU,QAAA,eAAe,GAAgB;IAC1C,SAAS,EAAE,yBAAyB;IACpC,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,kIAAkI;IACpI,QAAQ,EAAE,iDAAiD;IAC3D,UAAU,EAAE;QACV,kBAAkB,EAAE;YAClB,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,0GAA0G;YAC5G,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EACX,gHAAgH;YAClH,eAAe,EAAE,iDAAiD;YAClE,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,0BAA0B;oBACjC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE;iBACpF;aACF;SACF;QACD,iBAAiB,EAAE;YACjB,WAAW,EAAE,mBAAmB;YAChC,KAAK,EAAE,SAAS;YAChB,WAAW,EACT,sEAAsE;YACxE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EACX,kFAAkF;SACrF;QACD,gBAAgB,EAAE;YAChB,WAAW,EAAE,kBAAkB;YAC/B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,gEAAgE;YAC7E,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;YACtB,aAAa,EAAE,mDAAmD;SACnE;QACD,gBAAgB,EAAE;YAChB,WAAW,EAAE,kBAAkB;YAC/B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,6CAA6C;YAC1D,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;SACvB;KACF;CACF,CAAA","sourcesContent":["import { OperationParamSpec, ServiceSpec } from '../types'\n\n/**\n * PNU 5요소 파라미터 스펙 — HsPmsHubService(주택인허가) 오퍼레이션 공유.\n *\n * 건축인허가(ArchPmsHubService)와 동일 구성이나, **주택건설 사업계획승인**은 택지지구/\n * 정비사업처럼 개별 지번이 아닌 **블록(platGbCd=2) + 블록번호(bun)** 로 등록되는 경우가\n * 많다. 따라서 `platGbCd=2`(블록) 조회가 1급 시나리오다.\n */\nconst pnuParams: OperationParamSpec[] = [\n  {\n    name: 'sigunguCd',\n    label: 'label.sigungu-cd',\n    required: true,\n    length: 5,\n    description: '시군구코드 5자리 (법정동코드 10자리의 앞 5자리).',\n    example: '11740'\n  },\n  {\n    name: 'bjdongCd',\n    label: 'label.bjdong-cd',\n    required: true,\n    length: 5,\n    description: '법정동코드 5자리 (법정동코드 10자리의 뒤 5자리).',\n    example: '10600'\n  },\n  {\n    name: 'platGbCd',\n    label: 'label.plat-gb-cd',\n    default: '0',\n    length: 1,\n    description: '대지구분 1자리. `0` 대지 / `1` 산 / `2` 블록. 택지지구·정비사업 단지는 대개 `2`(블록).',\n    example: '2',\n    enum: [\n      { value: '0', label: '대지' },\n      { value: '1', label: '산' },\n      { value: '2', label: '블록' }\n    ]\n  },\n  {\n    name: 'bun',\n    label: 'label.bun',\n    required: true,\n    pad: 4,\n    description: '본번. 블록 조회 시 **블록번호**. 자동 4자리 zero-pad (예: `1` → `0001`).',\n    example: '1'\n  },\n  {\n    name: 'ji',\n    label: 'label.ji',\n    default: '0',\n    pad: 4,\n    description: '부번. 없으면 `0`. 자동 4자리 zero-pad.',\n    example: '0'\n  }\n]\n\n/**\n * 국토교통부_건축HUB 주택인허가정보 서비스 (data.go.kr 데이터셋 15136560).\n *\n * 세움터(EAIS) 원천의 **주택건설 사업계획승인** 단계 정보를 조회한다. 건축인허가\n * (ArchPmsHubService)가 개별 필지 건축허가를 담는 것과 달리, 이 서비스는 **공동주택 단지/\n * 택지지구 사업** 을 블록 단위로 담아 — **지번이 없는 블록형 단지(예: LH/SH 택지지구\n * 공공주택)** 의 연면적·용적률·동/층수를 준공(건축물대장 생성) 이전에 확보하는 경로다.\n *\n * 조회는 건축인허가와 동일한 PNU 구성이나 **platGbCd=2(블록) + bun=블록번호** 가 핵심.\n *  - sigunguCd(5) + bjdongCd(5) + platGbCd(1) + bun(4=블록번호) + ji(4)\n *\n * 응답: 기본개요에 연면적(totArea)·용적률(vlRat)·건폐율(bcRat)·대지면적(platArea) 등.\n * 한 사업/블록에 여러 승인(mgmPmsrgstPk)·여러 동이 존재할 수 있다.\n */\nexport const HsPmsHubService: ServiceSpec = {\n  serviceId: '1613000/HsPmsHubService',\n  label: '국토교통부_건축HUB 주택인허가정보 서비스',\n  description:\n    '세움터(EAIS) 원천의 주택건설 사업계획승인 정보를 조회한다. 기본개요·동별개요·층별개요·호별개요·대지위치 등 제공. 블록(platGbCd=2) 단위 단지 조회에 사용 — 지번 없는 택지지구/정비사업 단지의 연면적·용적률 확보.',\n  homepage: 'https://www.data.go.kr/data/15136560/openapi.do',\n  operations: {\n    getHpBasisOulnInfo: {\n      operationId: 'getHpBasisOulnInfo',\n      label: '기본개요 조회',\n      description:\n        '사업계획승인 기본개요(대지면적·건축면적·건폐율·용적률·연면적·주용도·승인일 등) 를 조회. 한 사업/블록에 승인이 여러 건이면 복수 레코드로 내려온다 (mgmPmsrgstPk 로 구분).',\n      params: [...pnuParams],\n      responseNotes:\n        '연면적 totArea / 용적률 vlRat / 건폐율 bcRat / 대지면적 platArea. 지상/지하 층수는 기본개요에 없고 동별개요/층별개요에 있음. 숫자 필드가 문자열/공백으로 올 수 있음.',\n      externalDocsUrl: 'https://www.data.go.kr/data/15136560/openapi.do',\n      examples: [\n        {\n          label: '서울 강동구 강일동 1블록 (고덕강일3단지)',\n          params: { sigunguCd: '11740', bjdongCd: '10600', platGbCd: '2', bun: '1', ji: '0' }\n        }\n      ]\n    },\n    getHpDongOulnInfo: {\n      operationId: 'getHpDongOulnInfo',\n      label: '동별개요 조회',\n      description:\n        '동(棟) 별 개요(주부속구분·주용도·구조·동 연면적·세대수·지상/지하 층수 등) 를 조회. 주건축물/부속건축물 판별 기준.',\n      params: [...pnuParams],\n      responseNotes:\n        'mainAtchGbCd(0=주건축물,1=부속) 로 본건물 필터링. mgmPmsrgstPk·mgmDongOulnPk 로 기본개요/층별개요와 조인.'\n    },\n    getHpFlrOulnInfo: {\n      operationId: 'getHpFlrOulnInfo',\n      label: '층별개요 조회',\n      description: '층별 주용도·구조·면적을 조회. flrGbCd(지상/지하) + flrNo 로 동별 지상/지하 층수 산출에 사용.',\n      params: [...pnuParams],\n      responseNotes: 'mgmDongOulnPk 로 특정 동의 층만 필터. 한 사업 다동이면 결과 건수가 많음.'\n    },\n    getHpPlatPlcInfo: {\n      operationId: 'getHpPlatPlcInfo',\n      label: '대지위치 조회',\n      description: '사업의 대지위치(지번/도로명) 목록을 조회. 블록에 포함된 실제 필지 확인용.',\n      params: [...pnuParams]\n    }\n  }\n}\n"]}

package/dist-server/engine/spec/housing-permit/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 주택인허가 도메인 서비스 스펙 묶음.
+ * 주택건설 사업계획승인(블록 단위) 정보 — 지번 없는 택지지구/정비사업 단지 대응.
+ */
+export { HsPmsHubService } from './hub';

package/dist-server/engine/spec/housing-permit/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HsPmsHubService = void 0;
+/**
+ * 주택인허가 도메인 서비스 스펙 묶음.
+ * 주택건설 사업계획승인(블록 단위) 정보 — 지번 없는 택지지구/정비사업 단지 대응.
+ */
+var hub_1 = require("./hub");
+Object.defineProperty(exports, "HsPmsHubService", { enumerable: true, get: function () { return hub_1.HsPmsHubService; } });
+//# sourceMappingURL=index.js.map

package/dist-server/engine/spec/housing-permit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/spec/housing-permit/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,6BAAuC;AAA9B,sGAAA,eAAe,OAAA","sourcesContent":["/**\n * 주택인허가 도메인 서비스 스펙 묶음.\n * 주택건설 사업계획승인(블록 단위) 정보 — 지번 없는 택지지구/정비사업 단지 대응.\n */\nexport { HsPmsHubService } from './hub'\n"]}

package/dist-server/engine/spec/index.d.ts

@@ -1,6 +1,8 @@
 import { OperationSpec, ServiceSpec } from './types';
 export * from './types';
 export * from './building-ledger';
+export * from './building-permit';
+export * from './housing-permit';
 export * from './weather';
 export declare const SpecRegistry: {
     /** 등록된 모든 서비스 스펙을 반환. */

package/dist-server/engine/spec/index.js

@@ -5,9 +5,13 @@ const tslib_1 = require("tslib");
 const types_1 = require("./types");
 /* 도메인별 서비스 스펙 — 새 도메인 추가 시 폴더 추가 + 본 import 한 줄 */
 const buildingLedger = tslib_1.__importStar(require("./building-ledger"));
+const buildingPermit = tslib_1.__importStar(require("./building-permit"));
+const housingPermit = tslib_1.__importStar(require("./housing-permit"));
 const weather = tslib_1.__importStar(require("./weather"));
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./building-ledger"), exports);
+tslib_1.__exportStar(require("./building-permit"), exports);
+tslib_1.__exportStar(require("./housing-permit"), exports);
 tslib_1.__exportStar(require("./weather"), exports);
 const services = new Map();
 function registerService(spec) {
@@ -28,6 +32,8 @@ function isServiceSpec(value) {
         typeof value.operations === 'object');
 }
 registerDomain(buildingLedger);
+registerDomain(buildingPermit);
+registerDomain(housingPermit);
 registerDomain(weather);
 exports.SpecRegistry = {
     /** 등록된 모든 서비스 스펙을 반환. */

package/dist-server/engine/spec/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/spec/index.ts"],"names":[],"mappings":";;;;AAAA,mCAAuE;AAEvE,mDAAmD;AACnD,0EAAmD;AACnD,2DAAoC;AAEpC,kDAAuB;AACvB,4DAAiC;AACjC,oDAAyB;AAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;AAE/C,SAAS,eAAe,CAAC,IAAiB;IACxC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;qCACqC;AACrC,SAAS,cAAc,CAAC,MAA+B;IACrD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;AACH,CAAC;AACD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAa,CAAC,SAAS,KAAK,QAAQ;QAC5C,OAAQ,KAAa,CAAC,UAAU,KAAK,QAAQ,CAC9C,CAAA;AACH,CAAC;AAED,cAAc,CAAC,cAAc,CAAC,CAAA;AAC9B,cAAc,CAAC,OAAO,CAAC,CAAA;AAEV,QAAA,YAAY,GAAG;IAC1B,yBAAyB;IACzB,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACtC,CAAC;IAED,0BAA0B;IAC1B,UAAU,CAAC,SAAiB;QAC1B,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,YAAoB;QAC1B,MAAM,KAAK,GAAG,IAAA,yBAAiB,EAAC,YAAY,CAAC,CAAA;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAA;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACvD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC/B,CAAC;IAED,gCAAgC;IAChC,QAAQ,CAAC,IAAiB;QACxB,eAAe,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;CACF,CAAA","sourcesContent":["import { OperationSpec, ServiceSpec, parseOperationRef } from './types'\n\n/* 도메인별 서비스 스펙 — 새 도메인 추가 시 폴더 추가 + 본 import 한 줄 */\nimport * as buildingLedger from './building-ledger'\nimport * as weather from './weather'\n\nexport * from './types'\nexport * from './building-ledger'\nexport * from './weather'\n\nconst services = new Map<string, ServiceSpec>()\n\nfunction registerService(spec: ServiceSpec) {\n  services.set(spec.serviceId, spec)\n}\n\n/* 도메인 모듈에서 export 된 모든 ServiceSpec 인스턴스를 자동 등록.\n   추가 도메인 import 만 늘리면 이하 코드는 그대로. */\nfunction registerDomain(domain: Record<string, unknown>) {\n  for (const value of Object.values(domain)) {\n    if (isServiceSpec(value)) registerService(value)\n  }\n}\nfunction isServiceSpec(value: unknown): value is ServiceSpec {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as any).serviceId === 'string' &&\n    typeof (value as any).operations === 'object'\n  )\n}\n\nregisterDomain(buildingLedger)\nregisterDomain(weather)\n\nexport const SpecRegistry = {\n  /** 등록된 모든 서비스 스펙을 반환. */\n  listServices(): ServiceSpec[] {\n    return Array.from(services.values())\n  },\n\n  /** 서비스 ID 로 서비스 스펙 조회. */\n  getService(serviceId: string): ServiceSpec | undefined {\n    return services.get(serviceId)\n  },\n\n  /** `<serviceId>.<operationId>` 참조 문자열로 오퍼레이션 스펙 조회. */\n  resolve(operationRef: string): { service: ServiceSpec; operation: OperationSpec } | undefined {\n    const parts = parseOperationRef(operationRef)\n    if (!parts) return undefined\n    const service = services.get(parts.serviceId)\n    if (!service) return undefined\n    const operation = service.operations[parts.operationId]\n    if (!operation) return undefined\n    return { service, operation }\n  },\n\n  /** (확장용) 외부에서 서비스 스펙을 추가 등록. */\n  register(spec: ServiceSpec) {\n    registerService(spec)\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/spec/index.ts"],"names":[],"mappings":";;;;AAAA,mCAAuE;AAEvE,mDAAmD;AACnD,0EAAmD;AACnD,0EAAmD;AACnD,wEAAiD;AACjD,2DAAoC;AAEpC,kDAAuB;AACvB,4DAAiC;AACjC,4DAAiC;AACjC,2DAAgC;AAChC,oDAAyB;AAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;AAE/C,SAAS,eAAe,CAAC,IAAiB;IACxC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;qCACqC;AACrC,SAAS,cAAc,CAAC,MAA+B;IACrD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;AACH,CAAC;AACD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAa,CAAC,SAAS,KAAK,QAAQ;QAC5C,OAAQ,KAAa,CAAC,UAAU,KAAK,QAAQ,CAC9C,CAAA;AACH,CAAC;AAED,cAAc,CAAC,cAAc,CAAC,CAAA;AAC9B,cAAc,CAAC,cAAc,CAAC,CAAA;AAC9B,cAAc,CAAC,aAAa,CAAC,CAAA;AAC7B,cAAc,CAAC,OAAO,CAAC,CAAA;AAEV,QAAA,YAAY,GAAG;IAC1B,yBAAyB;IACzB,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACtC,CAAC;IAED,0BAA0B;IAC1B,UAAU,CAAC,SAAiB;QAC1B,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,YAAoB;QAC1B,MAAM,KAAK,GAAG,IAAA,yBAAiB,EAAC,YAAY,CAAC,CAAA;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAA;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACvD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAA;QAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IAC/B,CAAC;IAED,gCAAgC;IAChC,QAAQ,CAAC,IAAiB;QACxB,eAAe,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;CACF,CAAA","sourcesContent":["import { OperationSpec, ServiceSpec, parseOperationRef } from './types'\n\n/* 도메인별 서비스 스펙 — 새 도메인 추가 시 폴더 추가 + 본 import 한 줄 */\nimport * as buildingLedger from './building-ledger'\nimport * as buildingPermit from './building-permit'\nimport * as housingPermit from './housing-permit'\nimport * as weather from './weather'\n\nexport * from './types'\nexport * from './building-ledger'\nexport * from './building-permit'\nexport * from './housing-permit'\nexport * from './weather'\n\nconst services = new Map<string, ServiceSpec>()\n\nfunction registerService(spec: ServiceSpec) {\n  services.set(spec.serviceId, spec)\n}\n\n/* 도메인 모듈에서 export 된 모든 ServiceSpec 인스턴스를 자동 등록.\n   추가 도메인 import 만 늘리면 이하 코드는 그대로. */\nfunction registerDomain(domain: Record<string, unknown>) {\n  for (const value of Object.values(domain)) {\n    if (isServiceSpec(value)) registerService(value)\n  }\n}\nfunction isServiceSpec(value: unknown): value is ServiceSpec {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as any).serviceId === 'string' &&\n    typeof (value as any).operations === 'object'\n  )\n}\n\nregisterDomain(buildingLedger)\nregisterDomain(buildingPermit)\nregisterDomain(housingPermit)\nregisterDomain(weather)\n\nexport const SpecRegistry = {\n  /** 등록된 모든 서비스 스펙을 반환. */\n  listServices(): ServiceSpec[] {\n    return Array.from(services.values())\n  },\n\n  /** 서비스 ID 로 서비스 스펙 조회. */\n  getService(serviceId: string): ServiceSpec | undefined {\n    return services.get(serviceId)\n  },\n\n  /** `<serviceId>.<operationId>` 참조 문자열로 오퍼레이션 스펙 조회. */\n  resolve(operationRef: string): { service: ServiceSpec; operation: OperationSpec } | undefined {\n    const parts = parseOperationRef(operationRef)\n    if (!parts) return undefined\n    const service = services.get(parts.serviceId)\n    if (!service) return undefined\n    const operation = service.operations[parts.operationId]\n    if (!operation) return undefined\n    return { service, operation }\n  },\n\n  /** (확장용) 외부에서 서비스 스펙을 추가 등록. */\n  register(spec: ServiceSpec) {\n    registerService(spec)\n  }\n}\n"]}

package/dist-server/engine/task/building-info.d.ts

@@ -0,0 +1,30 @@
+import { Context } from '@things-factory/integration-base';
+/**
+ * 건축물 정보 통합 조회 (`data-go-kr-building-info`).
+ *
+ * **건축물대장(완공) 우선 → 없으면 건축인허가(시공 전) 폴백** 하는 단일 진입점.
+ *
+ * - 완공 건물: 건축물대장(`data-go-kr-building-summary`)에 연면적·용적률·층수·사용승인
+ *   등이 정확히 있음 → 우선 사용 (source='ledger').
+ * - 시공 중 현장: 대장이 아직 없음(0건) → 건축인허가(`data-go-kr-building-permit`)로
+ *   허가/착공 단계 개요 확보 (source='permit', 가설만 있으면 provisionalOnly=true).
+ * - 둘 다 없음: 빈 결과(found=false) — 시나리오 HALT 방지.
+ *
+ * 출력 스키마는 두 태스크와 동일(area/vlRat/층수/…)이라 시나리오 result 스크립트를
+ * 바꿀 필요가 없다. 시나리오 fetch step 의 task 를 `data-go-kr-building-info` 로만
+ * 바꾸면 완공·시공중 모두 커버된다.
+ */
+declare function BuildingInfoTask(step: any, context: Context): Promise<{
+    data: any;
+}>;
+declare namespace BuildingInfoTask {
+    var parameterSpec: {
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+        description: string;
+    }[];
+    var help: string;
+}
+export default BuildingInfoTask;

package/dist-server/engine/task/building-info.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const integration_base_1 = require("@things-factory/integration-base");
+const summary_1 = tslib_1.__importDefault(require("./building-ledger/summary"));
+const summary_2 = tslib_1.__importDefault(require("./building-permit/summary"));
+/**
+ * 건축물 정보 통합 조회 (`data-go-kr-building-info`).
+ *
+ * **건축물대장(완공) 우선 → 없으면 건축인허가(시공 전) 폴백** 하는 단일 진입점.
+ *
+ * - 완공 건물: 건축물대장(`data-go-kr-building-summary`)에 연면적·용적률·층수·사용승인
+ *   등이 정확히 있음 → 우선 사용 (source='ledger').
+ * - 시공 중 현장: 대장이 아직 없음(0건) → 건축인허가(`data-go-kr-building-permit`)로
+ *   허가/착공 단계 개요 확보 (source='permit', 가설만 있으면 provisionalOnly=true).
+ * - 둘 다 없음: 빈 결과(found=false) — 시나리오 HALT 방지.
+ *
+ * 출력 스키마는 두 태스크와 동일(area/vlRat/층수/…)이라 시나리오 result 스크립트를
+ * 바꿀 필요가 없다. 시나리오 fetch step 의 task 를 `data-go-kr-building-info` 로만
+ * 바꾸면 완공·시공중 모두 커버된다.
+ */
+async function BuildingInfoTask(step, context) {
+    const { logger } = context;
+    // 1) 건축물대장(완공) 우선. building-summary 는 0건 시 throw → catch 해서 폴백.
+    try {
+        const ledger = await (0, summary_1.default)(step, context);
+        if (ledger?.data) {
+            logger?.info?.('[data-go-kr] building-info: 건축물대장(완공)에서 확보 (source=ledger)');
+            return { data: { ...ledger.data, source: 'ledger', found: true } };
+        }
+    }
+    catch (err) {
+        logger?.warn?.(`[data-go-kr] building-info: 대장 미확보 → 인허가 폴백 (${err.message})`);
+    }
+    // 2) 건축인허가(시공 전) 폴백. permit 태스크는 자체 HALT 방지(빈 결과/found=false) 포함.
+    return await (0, summary_2.default)(step, context);
+}
+// PNU 파라미터 스펙은 두 하위 태스크와 동일하므로 그대로 재사용.
+BuildingInfoTask.parameterSpec = summary_2.default.parameterSpec;
+BuildingInfoTask.help = 'integration/task/building-info';
+integration_base_1.TaskRegistry.registerTaskHandler('data-go-kr-building-info', BuildingInfoTask);
+exports.default = BuildingInfoTask;
+//# sourceMappingURL=building-info.js.map

package/dist-server/engine/task/building-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"building-info.js","sourceRoot":"","sources":["../../../server/engine/task/building-info.ts"],"names":[],"mappings":";;;AAAA,uEAAwE;AAExE,gFAA2D;AAC3D,gFAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,gBAAgB,CAAC,IAAI,EAAE,OAAgB;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAE1B,gEAAgE;IAChE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAmB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACvD,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;YACjB,MAAM,EAAE,IAAI,EAAE,CAAC,4DAA4D,CAAC,CAAA;YAC5E,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAA;QACpE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,CAAC,gDAAiD,GAAa,CAAC,OAAO,GAAG,CAAC,CAAA;IAC3F,CAAC;IAED,kEAAkE;IAClE,OAAO,MAAM,IAAA,iBAAkB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAChD,CAAC;AAED,wCAAwC;AACxC,gBAAgB,CAAC,aAAa,GAAG,iBAAkB,CAAC,aAAa,CAAA;AACjE,gBAAgB,CAAC,IAAI,GAAG,gCAAgC,CAAA;AAExD,+BAAY,CAAC,mBAAmB,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAA;AAE9E,kBAAe,gBAAgB,CAAA","sourcesContent":["import { Context, TaskRegistry } from '@things-factory/integration-base'\n\nimport BuildingSummaryTask from './building-ledger/summary'\nimport BuildingPermitTask from './building-permit/summary'\n\n/**\n * 건축물 정보 통합 조회 (`data-go-kr-building-info`).\n *\n * **건축물대장(완공) 우선 → 없으면 건축인허가(시공 전) 폴백** 하는 단일 진입점.\n *\n * - 완공 건물: 건축물대장(`data-go-kr-building-summary`)에 연면적·용적률·층수·사용승인\n *   등이 정확히 있음 → 우선 사용 (source='ledger').\n * - 시공 중 현장: 대장이 아직 없음(0건) → 건축인허가(`data-go-kr-building-permit`)로\n *   허가/착공 단계 개요 확보 (source='permit', 가설만 있으면 provisionalOnly=true).\n * - 둘 다 없음: 빈 결과(found=false) — 시나리오 HALT 방지.\n *\n * 출력 스키마는 두 태스크와 동일(area/vlRat/층수/…)이라 시나리오 result 스크립트를\n * 바꿀 필요가 없다. 시나리오 fetch step 의 task 를 `data-go-kr-building-info` 로만\n * 바꾸면 완공·시공중 모두 커버된다.\n */\nasync function BuildingInfoTask(step, context: Context): Promise<{ data: any }> {\n  const { logger } = context\n\n  // 1) 건축물대장(완공) 우선. building-summary 는 0건 시 throw → catch 해서 폴백.\n  try {\n    const ledger = await BuildingSummaryTask(step, context)\n    if (ledger?.data) {\n      logger?.info?.('[data-go-kr] building-info: 건축물대장(완공)에서 확보 (source=ledger)')\n      return { data: { ...ledger.data, source: 'ledger', found: true } }\n    }\n  } catch (err) {\n    logger?.warn?.(`[data-go-kr] building-info: 대장 미확보 → 인허가 폴백 (${(err as Error).message})`)\n  }\n\n  // 2) 건축인허가(시공 전) 폴백. permit 태스크는 자체 HALT 방지(빈 결과/found=false) 포함.\n  return await BuildingPermitTask(step, context)\n}\n\n// PNU 파라미터 스펙은 두 하위 태스크와 동일하므로 그대로 재사용.\nBuildingInfoTask.parameterSpec = BuildingPermitTask.parameterSpec\nBuildingInfoTask.help = 'integration/task/building-info'\n\nTaskRegistry.registerTaskHandler('data-go-kr-building-info', BuildingInfoTask)\n\nexport default BuildingInfoTask\n"]}

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

@@ -0,0 +1,8 @@
+/**
+ * 건축인허가 도메인 전용 태스크 그룹.
+ *
+ * 건축물대장(building-ledger)이 완공 건물을 다루는 것과 달리, 준공 전(시공 중) 현장의
+ * 허가 개요를 조회한다. 공통 경로(`data-go-kr-call` + SpecRegistry)로 커버 어려운
+ * 도메인 특화 로직(3종 오퍼레이션 조합 + 가설건축물 필터)이 필요해 전용 태스크로 둔다.
+ */
+import './summary';

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 건축인허가 도메인 전용 태스크 그룹.
+ *
+ * 건축물대장(building-ledger)이 완공 건물을 다루는 것과 달리, 준공 전(시공 중) 현장의
+ * 허가 개요를 조회한다. 공통 경로(`data-go-kr-call` + SpecRegistry)로 커버 어려운
+ * 도메인 특화 로직(3종 오퍼레이션 조합 + 가설건축물 필터)이 필요해 전용 태스크로 둔다.
+ */
+require("./summary");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/task/building-permit/index.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,qBAAkB","sourcesContent":["/**\n * 건축인허가 도메인 전용 태스크 그룹.\n *\n * 건축물대장(building-ledger)이 완공 건물을 다루는 것과 달리, 준공 전(시공 중) 현장의\n * 허가 개요를 조회한다. 공통 경로(`data-go-kr-call` + SpecRegistry)로 커버 어려운\n * 도메인 특화 로직(3종 오퍼레이션 조합 + 가설건축물 필터)이 필요해 전용 태스크로 둔다.\n */\nimport './summary'\n"]}

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

@@ -0,0 +1,72 @@
+import { Context } from '@things-factory/integration-base';
+/**
+ * 건축인허가 요약 태스크 (`data-go-kr-building-permit`).
+ *
+ * 건축물대장(`data-go-kr-building-summary`)이 **완공 건물**만 담는 것과 달리, 이 태스크는
+ * **준공 전(시공 중)** 현장을 건축HUB 건축인허가정보 서비스(ArchPmsHubService)로 조회해
+ * 건축물대장 요약과 **동일한 스키마**(totArea/vlRat/grndFlrCnt/… )로 돌려준다.
+ * → 시나리오 step2 매핑 스크립트를 바꾸지 않고 step1 태스크만 교체/병행 가능.
+ *
+ * 내부 흐름:
+ *   1) getApBasisOulnInfo(기본개요) + getApDongOulnInfo(동별개요) + getApFlrOulnInfo(층별개요)
+ *      3종을 병렬 호출.
+ *   2) 동별개요에서 **본건물** 선택: 가설건축물(mainPurpsCdNm='가설건축물') 제외 + 주건축물
+ *      (mainAtchGbCd='0') 우선 + 연면적(totArea) 최대. 본건물이 없으면(=가설만 존재)
+ *      가장 큰 가설 row 로 폴백하고 `provisionalOnly=true` 로 표시.
+ *   3) 선택 동의 mgmPmsrgstPk 로 기본개요(대지면적·건폐율·용적률·허가일) 를 조인.
+ *   4) 지상/지하 층수는 동별개요 값 우선, 없으면 층별개요(mgmDongOulnPk 매칭) 에서 산출.
+ *
+ * 출력 (`data`) — building-summary 와 호환:
+ *   { totArea, platArea, archArea, bcRat, vlRat, grndFlrCnt, ugrndFlrCnt,
+ *     strctCd, strctCdNm, mainPurpsCd, mainPurpsCdNm, hhldCnt, fmlyCnt, hoCnt,
+ *     mainBldCnt, atchBldCnt, bldNm, useAprDay, pmsDay, stcnsDay,
+ *     source:'permit', provisionalOnly, raw }
+ */
+export interface BuildingPermitSummary {
+    totArea: number | null;
+    platArea: number | null;
+    archArea: number | null;
+    bcRat: number | null;
+    vlRat: number | null;
+    grndFlrCnt: number | null;
+    ugrndFlrCnt: number | null;
+    strctCd: string | null;
+    strctCdNm: string | null;
+    mainPurpsCd: string | null;
+    mainPurpsCdNm: string | null;
+    hhldCnt: number | null;
+    fmlyCnt: number | null;
+    hoCnt: number | null;
+    mainBldCnt: number | null;
+    atchBldCnt: number | null;
+    bldNm: string | null;
+    /** 사용승인일 (인허가 단계에선 대개 공백) */
+    useAprDay: string | null;
+    /** 건축허가일 YYYYMMDD */
+    pmsDay: string | null;
+    /** 착공일(실착공→예정 순) YYYYMMDD */
+    stcnsDay: string | null;
+    source: 'permit';
+    /** 본건물 없이 가설건축물만 등록된 필지면 true (조회값은 가설 기준) */
+    provisionalOnly: boolean;
+    /** 인허가 데이터를 실제로 찾았는지. false 면 빈 결과(HALT 방지 폴백). */
+    found: boolean;
+    raw: {
+        basis: any;
+        dong: any;
+    } | null;
+}
+declare function BuildingPermitTask(step: any, context: Context): Promise<{
+    data: BuildingPermitSummary;
+}>;
+declare namespace BuildingPermitTask {
+    var parameterSpec: {
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+        description: string;
+    }[];
+    var help: string;
+}
+export default BuildingPermitTask;