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

package/helps/integration/connector/data-go-kr-connector.md

@@ -0,0 +1,39 @@
+# data.go.kr Connector
+
+대한민국 공공데이터포털 **[data.go.kr](https://www.data.go.kr)** 의 모든 Open API 에 대한 공용 커넥터.
+
+- **원천**: 각 부처·공공기관 DB (세움터·대법원·통계청·국세청·교통·에너지 등)
+- **공용 URL 체계**: `https://apis.data.go.kr/<기관코드>/<서비스명>/<오퍼레이션>`
+- **인증**: 발급받은 `ServiceKey` 를 쿼리 파라미터로 전달 (Encoding/Decoding 두 형태 모두 수용)
+- **비용**: 무료 (서비스별 활용신청 후 승인)
+
+하나의 ServiceKey 로 등록 앱의 **구독 중인 모든 서비스** 를 호출할 수 있으므로, Connection 은 보통 앱·법인당 1개만 생성한다.
+
+## 파라미터
+
+| 이름 | 필수 | 설명 |
+| --- | --- | --- |
+| `serviceKey` | O | data.go.kr 일반 인증키 (Decoding/Encoding 모두 허용). 도메인 시크릿으로 저장 권장 |
+| `origin` | △ | API 오리진 오버라이드 (모의 서버/사설 프록시). 기본 `https://apis.data.go.kr` |
+
+> Connection 엔티티의 `endpoint` 필드는 무시됩니다. 오리진 변경은 `origin` 파라미터 사용.
+
+## 관련 태스크
+
+- [`data-go-kr-call`](../task/data-go-kr-call.md) — 범용 오퍼레이션 호출 태스크
+- [`data-go-kr-building-ledger`](../task/building-ledger.md) — 건축물대장 표제부 조회
+
+## ServiceKey 발급 (요약)
+
+1. [https://www.data.go.kr](https://www.data.go.kr) 가입
+2. 사용하려는 **서비스 상세 페이지** → 활용신청 (1~3영업일 자동 승인)
+3. 마이페이지 → 개발계정 → **일반 인증키 (Decoding)** 복사 → Connection 의 `serviceKey`
+4. 개발계정 일 한도(기본 10,000건) 초과 시 운영계정 신청
+
+## 서비스 카탈로그
+
+등록된 서비스 스펙은 코드상 `SpecRegistry.listServices()` 로 확인 가능. 현재 등록된 서비스:
+
+- [`1613000/BldRgstService_v2` — 국토교통부_건축물대장정보 서비스 v2](../services/building-ledger.md)
+
+추가 예정 서비스는 [ROADMAP](https://github.com/hatiolab/things-factory/blob/main/packages/integration-data-go-kr/ROADMAP.md) 참조.

package/helps/integration/services/building-ledger.md

@@ -0,0 +1,109 @@
+# 건축물대장정보 서비스 v2 (`1613000/BldRgstService_v2`)
+
+> 세움터(EAIS) 원천의 건축물대장 정보 Open API. 표제부·총괄표제부·층별개요·부속지번·전유공용면적·주택가격·소유자현황·기본개요 등 **8개 오퍼레이션** 제공.
+
+- **data.go.kr 페이지**: https://www.data.go.kr/data/15044713/openapi.do
+- **원천**: 국토교통부 세움터 DB
+- **비용**: 무료 (활용신청 후 개발 1만건/일)
+
+## 공통 파라미터 — PNU 5요소
+
+모든 오퍼레이션이 동일한 PNU 구성요소로 조회한다:
+
+| 파라미터 | 설명 | 예시 |
+| --- | --- | --- |
+| `sigunguCd` | 시군구코드 5자리 (법정동코드 앞 5자리) | `11680` |
+| `bjdongCd` | 법정동코드 5자리 (법정동코드 뒤 5자리) | `10300` |
+| `platGbCd` | 대지구분 (`0` 대지 / `1` 산 / `2` 블록, 기본 `0`) | `0` |
+| `bun` | 본번 (4자리 zero-pad) | `0223` |
+| `ji` | 부번 (4자리 zero-pad, 없으면 `0000`) | `0000` |
+
+PNU 조회 방법:
+- [행정표준코드관리시스템 (code.go.kr)](https://www.code.go.kr) — 법정동코드
+- [V-World 공간정보 오픈플랫폼](https://www.vworld.kr) — 주소→PNU 변환 API
+- 건축물대장 원본 상단의 "고유번호" 19자리 = `[법정동코드 10][platGbCd 1][bun 4][ji 4]`
+
+## 오퍼레이션 카탈로그
+
+### `getBrTitleInfo` — 표제부 조회
+
+건축물대장 표제부(건물 본문) 조회. 연면적·용적률·지상층수·지하층수·주구조·주용도 등 **건물 개요**. 한 필지에 동이 여러 개이면 복수 레코드.
+
+**응답 주요 필드**: `totArea`, `vlRat`, `grndFlrCnt`, `ugrndFlrCnt`, `strctCdNm`, `mainPurpsCdNm`, `useAprDay`, `bldNm`, `dongNm`
+
+**주의**: 응답의 `items.item` 이 배열 또는 단일 객체로 올 수 있음. 숫자 필드는 문자열(`"114000.00"`)로 내려옴. 집합건축물은 `regstrKindCd=3`, 일반은 `2`.
+
+**예시**
+```
+operationRef: 1613000/BldRgstService_v2.getBrTitleInfo
+params: { sigunguCd: "11680", bjdongCd: "10300", bun: "823" }
+```
+
+→ PNU 5요소 파라미터 폼이 필요하면 [`data-go-kr-building-ledger`](../task/building-ledger.md) 전용 태스크를 이용.
+
+---
+
+### `getBrRecapTitleInfo` — 총괄표제부 조회
+
+집합건축물(아파트 단지 등) 의 총괄표제부. 단지 전체 연면적·대지면적·동 수·세대수 등.
+
+**주의**: 일반건축물대장(단동) 에는 레코드 없음. 집합건축물일 때만 유효.
+
+---
+
+### `getBrFlrOulnInfo` — 층별개요 조회
+
+층별로 주용도·구조·면적. 지하 N층부터 지상 M층까지 각 층의 상세 구성.
+
+**주의**: 한 필지에 동이 여러 개이면 각 동의 각 층이 모두 나옴 → 건수 多.
+
+---
+
+### `getBrExposPubuseAreaInfo` — 전유공용면적 조회
+
+집합건축물의 호(세대) 별 전유면적·공용면적. 아파트 세대별 실제 면적 산출.
+
+**주의**: 집합건축물일 때만 레코드 존재.
+
+---
+
+### `getBrAtchJibunInfo` — 부속지번 조회
+
+대장에 연결된 부속지번(인접 필지 등) 목록.
+
+---
+
+### `getBrHsprcInfo` — 주택가격 조회
+
+공동주택/단독주택 공시가격 이력. 연도별 개별주택가격·공동주택가격.
+
+---
+
+### `getBrBasisOulnInfo` — 기본개요 조회
+
+대장의 기본개요(대장 구분, 대장 종류, 변동일, 변동원인). 변동 이력 추적.
+
+---
+
+### `getBrExposInfo` — 전유부 조회
+
+집합건축물의 호(세대) 목록과 호별 개요. 전유공용면적보다 상위 요약 수준.
+
+---
+
+## 호출 방법
+
+모두 범용 태스크 [`data-go-kr-call`](../task/data-go-kr-call.md) 에 `operationRef` 로 지정해서 호출:
+
+```json
+{
+  "task": "data-go-kr-call",
+  "connection": "data-go-kr",
+  "params": {
+    "operationRef": "1613000/BldRgstService_v2.getBrTitleInfo",
+    "params": { "sigunguCd": "...", "bjdongCd": "...", "bun": "..." }
+  }
+}
+```
+
+표제부를 자주 호출한다면 PNU 5요소 폼이 명시된 전용 태스크 `data-go-kr-building-ledger` 사용.

package/helps/integration/task/building-ledger.md

@@ -0,0 +1,111 @@
+# data-go-kr-building-ledger
+
+국토교통부 건축물대장 **표제부**(`getBrTitleInfo`) 를 조회하는 전용 태스크.
+
+순수 **fetch** 만 수행합니다 — 집계·변환·요약 같은 도메인 가공은 소비자 스텝에서 처리하세요.
+
+## 입력 파라미터
+
+PNU(필지고유번호) 5요소로 조회:
+
+| 이름 | 필수 | 설명 | 예시 |
+| --- | --- | --- | --- |
+| `sigunguCd` | O | 시군구코드 5자리 (법정동코드 앞 5자리) | `11680` |
+| `bjdongCd` | O | 법정동코드 5자리 (법정동코드 뒤 5자리) | `10300` |
+| `platGbCd` | △ | 대지구분 (`0` 대지 / `1` 산 / `2` 블록, 기본 `0`) | `0` |
+| `bun` | O | 본번 (자동 4자리 zero-pad) | `223` |
+| `ji` | △ | 부번 (없으면 `0`, 자동 4자리 zero-pad) | `0` |
+
+시나리오 변수 치환 지원 — `{{data.project.sigunguCd}}` 바인딩 가능.
+
+## 출력
+
+```jsonc
+{
+  "items": [
+    {
+      "mgmBldrgstPk":  "...",
+      "platPlc":       "...",
+      "bldNm":         "...",
+      "dongNm":        "",
+      "totArea":       "114000.00",  // 연면적 (문자열)
+      "vlRat":         "250",        // 용적률 (문자열)
+      "grndFlrCnt":    "25",         // 지상층수 (문자열)
+      "ugrndFlrCnt":   "3",          // 지하층수 (문자열)
+      "strctCdNm":     "철근콘크리트구조",
+      "mainPurpsCdNm": "공동주택",
+      "useAprDay":     "20230801"
+      // ... 기타 20+ 필드
+    }
+    /* 다동 필지이면 여러 레코드 */
+  ]
+}
+```
+
+### 중요 — 모든 숫자는 문자열
+
+data.go.kr 공통 특성입니다. 숫자로 쓰려면 **후속 스텝** 에서 변환하세요.
+
+### 단동 vs 다동
+
+- **단동 필지**: `items.length === 1`. `items[0]` 이 대표값.
+- **다동 필지**: `items` 에 각 동이 한 레코드씩. `dongNm` 으로 식별.
+
+## 후속 스텝 예시 — 집계는 여기서
+
+### 단건 필드 바인딩 (data-mapper)
+
+```json
+{
+  "task": "data-mapper",
+  "params": {
+    "mapping": {
+      "totalFloorArea":    "items[0].totArea",
+      "floorAreaRatio":    "items[0].vlRat",
+      "aboveGroundFloors": "items[0].grndFlrCnt",
+      "belowGroundFloors": "items[0].ugrndFlrCnt"
+    }
+  }
+}
+```
+
+### 다동 필지 집계 (jsonata)
+
+```json
+{
+  "task": "jsonata",
+  "params": {
+    "expression": "{ 'totalFloorArea': $sum(items.totArea.$number()), 'aboveGroundFloors': $max(items.grndFlrCnt.$number()), 'belowGroundFloors': $max(items.ugrndFlrCnt.$number()), 'floorAreaRatio': items[0].vlRat.$number() }"
+  }
+}
+```
+
+### 도메인 전용 태스크
+
+소비자 도메인에서 반복 사용된다면 전용 태스크로 감싸세요. 예를 들어 dkpi 라면:
+
+```
+dkpi/server/scenario-task/summarize-building-ledger.ts
+  → input: { items: BrTitleItem[] }
+  → output: { totalFloorArea, floorAreaRatio, ... }  // KPI 4속성
+```
+
+이렇게 하면 "KPI" 어휘가 소비자 측에만 머물고 통합 모듈은 순수한 데이터 조회 레이어로 유지됩니다.
+
+## 트러블슈팅
+
+### "no 표제부 records" 에러
+
+- **신축 공사 중**: 사용승인 전에는 대장이 없음. 프로젝트 시작 시점 입력 후 사용승인 후 재조회.
+- **PNU 오타**: `sigunguCd`(앞 5자리) / `bjdongCd`(뒤 5자리) 가 뒤바뀌지 않았는지 확인.
+- **지번 구조**: "산 N-M" 지번이면 `platGbCd=1` 필요.
+
+### 집합건축물(아파트)
+
+`items[0].regstrKindCd === '3'` 이면 집합건축물. 더 정확한 단지 전체 연면적은 `getBrRecapTitleInfo`(총괄표제부) + `getBrExposPubuseAreaInfo`(전유공용면적) 조합이 필요합니다. 이 경우 범용 [`data-go-kr-call`](./data-go-kr-call.md) 로 호출하거나 ROADMAP Phase 4 의 집합건축물 전용 태스크를 기다리세요.
+
+## 관련
+
+- [`data-go-kr-connector`](../connector/data-go-kr-connector.md) — Connection 설정
+- [`data-go-kr-call`](./data-go-kr-call.md) — 범용 호출 (표제부 외 7개 오퍼레이션)
+- [서비스: 건축물대장 v2](../services/building-ledger.md) — 전체 오퍼레이션 카탈로그

package/helps/integration/task/data-go-kr-call.md

@@ -0,0 +1,87 @@
+# data-go-kr-call
+
+공공데이터포털 **모든 오퍼레이션** 을 호출하는 범용 태스크. 서비스·오퍼레이션별 전용 태스크를 만들지 않아도 되도록 단일 태스크 + 스펙 레지스트리 구조로 동작.
+
+## 입력 파라미터
+
+| 이름 | 필수 | 설명 | 예시 |
+| --- | --- | --- | --- |
+| `operationRef` | O | `<serviceId>.<operationId>` 형식 | `1613000/BldRgstService_v2.getBrTitleInfo` |
+| `params` | △ | 오퍼레이션 파라미터 객체 | `{ "sigunguCd": "11680", "bjdongCd": "10300", "bun": "223" }` |
+
+`operationRef` 가 **등록된 스펙** 을 가리키면:
+- 필수 파라미터 검증 / 기본값 주입 / zero-pad / 길이 검증 / enum 검증이 자동 적용
+- 실패 시 친절한 에러 메시지 (어떤 파라미터가 왜 실패했는지)
+
+스펙에 **없는 오퍼레이션** 도 호출 가능 (검증 스킵). 새 서비스가 추가되어 아직 스펙이 없어도 즉시 사용 가능.
+
+## 출력
+
+원 응답 봉투를 그대로 반환:
+
+```jsonc
+{
+  "response": {
+    "header": { "resultCode": "00", "resultMsg": "NORMAL SERVICE." },
+    "body": {
+      "items": { "item": [ /* ... */ ] },
+      "numOfRows": 100,
+      "pageNo": 1,
+      "totalCount": 1
+    }
+  }
+}
+```
+
+이후 스텝에서 `data.response.body.items.item` 에 접근하면 레코드. 단건/다건이 `item` 이 객체 혹은 배열로 갈리므로 후속 `data-mapper` 로 정규화 권장.
+
+## 사용 예시
+
+### 건축물대장 표제부 조회
+
+```json
+{
+  "task": "data-go-kr-call",
+  "connection": "data-go-kr",
+  "params": {
+    "operationRef": "1613000/BldRgstService_v2.getBrTitleInfo",
+    "params": {
+      "sigunguCd": "11680",
+      "bjdongCd": "10300",
+      "bun": "223"
+    }
+  }
+}
+```
+
+> `platGbCd` 는 기본 `0`, `ji` 는 기본 `0000` 으로 스펙이 채워줍니다.
+
+### 새 서비스 즉시 호출 (스펙 등록 전)
+
+예를 들어 부동산실거래가 API 가 아직 스펙 등록되지 않았어도:
+
+```json
+{
+  "task": "data-go-kr-call",
+  "params": {
+    "operationRef": "1613000/RTMSOBJSvc.getRTMSDataSvcAptTrade",
+    "params": {
+      "LAWD_CD": "11680",
+      "DEAL_YMD": "202504"
+    }
+  }
+}
+```
+
+검증은 없지만 호출은 정상 동작. 정식으로 쓰려면 `server/engine/spec/rtms-trade.ts` 로 스펙을 추가해주세요.
+
+## 자주 쓰는 경우는 전용 태스크
+
+자주 쓰이는 오퍼레이션은 파라미터 폼이 명시된 전용 태스크로 감싸면 운영 UX 가 좋습니다:
+
+- [`data-go-kr-building-ledger`](./building-ledger.md) — 건축물대장 표제부 조회 (PNU 폼 제공)
+
+## 관련
+
+- [`data-go-kr-connector`](../connector/data-go-kr-connector.md) — Connection 설정
+- [서비스: 건축물대장 v2](../services/building-ledger.md) — 8개 오퍼레이션 카탈로그

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@things-factory/integration-data-go-kr",
+  "version": "10.0.0-beta.62",
+  "main": "dist-server/index.js",
+  "things-factory": true,
+  "author": "heartyoh <heartyoh@hatiolab.com>",
+  "description": "Korean public data portal (data.go.kr) connector for Things-Factory integration engine. Includes generic invocation task and service-specific helpers (e.g., building ledger / 건축물대장).",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "@things-factory:registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hatiolab/things-factory.git",
+    "directory": "packages/integration-data-go-kr"
+  },
+  "scripts": {
+    "build": "tsc --p tsconfig.json",
+    "build:server": "npm run clean:server && tsc",
+    "clean:server": "rm -rf dist-server",
+    "clean": "npm run clean:server"
+  },
+  "dependencies": {
+    "@things-factory/integration-base": "^10.0.0-beta.57"
+  },
+  "gitHead": "5aaec8a7509b2c486e92fba2fd9d893fa5dc2d20"
+}

package/server/engine/connector/data-go-kr-client.ts

@@ -0,0 +1,133 @@
+import { DataGoKrResponse } from '../types'
+
+/**
+ * 공공데이터포털(data.go.kr) 공용 HTTP 클라이언트.
+ *
+ * 모든 data.go.kr Open API 는 아래 공통 규약을 따른다:
+ *  - URL: `https://apis.data.go.kr/<agency>/<service>/<operation>`
+ *  - 인증: `serviceKey` 쿼리 파라미터 (Encoding/Decoding 두 형태 모두 수용)
+ *  - 포맷: `_type=json` 없으면 XML
+ *  - 에러: `<OpenAPI_ServiceResponse>` XML 또는 `response.header.resultCode !== '00'`
+ *
+ * 본 클라이언트는 서비스·오퍼레이션에 독립적으로 동작하며, 경로를 파라미터로 받는다.
+ * 서비스별 도메인 로직(파라미터 검증, 응답 매핑) 은 task 레이어에서 처리.
+ */
+
+const DEFAULT_ORIGIN = 'https://apis.data.go.kr'
+
+export interface DataGoKrClientOptions {
+  serviceKey: string
+  /** 오리진 오버라이드 (모의 서버/사설 프록시 용도). 기본 `https://apis.data.go.kr`. */
+  origin?: string
+}
+
+export class DataGoKrClient {
+  private readonly serviceKey: string
+  private readonly origin: string
+
+  constructor(options: DataGoKrClientOptions) {
+    if (!options.serviceKey) {
+      throw new Error('DataGoKrClient requires serviceKey')
+    }
+    /* Encoding 키(%2B 포함)를 붙여넣어도 Decoding 키처럼 동작하도록 정규화.
+       base64 키는 `%` 를 포함하지 않으므로 raw Decoding 키는 영향 없음. */
+    this.serviceKey = normalizeServiceKey(options.serviceKey.trim())
+    this.origin = (options.origin || DEFAULT_ORIGIN).replace(/\/$/, '')
+  }
+
+  /**
+   * 범용 GET 호출.
+   *
+   * @param servicePath `<agency>/<service>/<operation>` (예: `1613000/BldRgstService_v2/getBrTitleInfo`)
+   * @param params 쿼리 파라미터 (serviceKey / _type 은 자동 추가)
+   */
+  async get<T>(servicePath: string, params: Record<string, any>): Promise<DataGoKrResponse<T>> {
+    const path = servicePath.startsWith('/') ? servicePath : `/${servicePath}`
+    const url = new URL(`${this.origin}${path}`)
+    url.searchParams.set('serviceKey', this.serviceKey)
+    url.searchParams.set('_type', 'json')
+    for (const [k, v] of Object.entries(params)) {
+      if (v === undefined || v === null || v === '') continue
+      url.searchParams.set(k, String(v))
+    }
+
+    const response = await fetch(url.toString(), {
+      method: 'GET',
+      headers: {
+        'User-Agent': '@things-factory/integration-data-go-kr',
+        Accept: 'application/json'
+      }
+    })
+    const raw = await response.text()
+
+    const nonSensitiveParams = Object.entries(params)
+      .filter(([, v]) => v !== undefined && v !== null && v !== '')
+      .map(([k, v]) => `${k}=${v}`)
+      .join(' ')
+
+    if (!response.ok) {
+      throw new Error(
+        `data.go.kr ${servicePath} failed (${response.status}): ${raw.slice(0, 300)} — params: ${nonSensitiveParams}`
+      )
+    }
+
+    let parsed: DataGoKrResponse<T>
+    try {
+      parsed = JSON.parse(raw) as DataGoKrResponse<T>
+    } catch (err) {
+      if (raw.includes('<OpenAPI_ServiceResponse') || raw.includes('<returnReasonCode>')) {
+        throw new Error(`data.go.kr ${servicePath}: ${parseOpenApiError(raw)} — params: ${nonSensitiveParams}`)
+      }
+      throw new Error(
+        `data.go.kr ${servicePath}: non-JSON response: ${raw.slice(0, 300)} — params: ${nonSensitiveParams}`
+      )
+    }
+
+    const header = parsed?.response?.header
+    if (!header) {
+      throw new Error(`data.go.kr ${servicePath}: response missing header — body: ${raw.slice(0, 300)}`)
+    }
+    if (header.resultCode !== '00') {
+      throw new Error(
+        `data.go.kr ${servicePath}: resultCode=${header.resultCode} msg=${header.resultMsg} — params: ${nonSensitiveParams}`
+      )
+    }
+
+    return parsed
+  }
+
+  /**
+   * 단건 또는 복수 items 를 배열로 정규화해서 반환한다.
+   *
+   * data.go.kr 공통 특성으로, body.items 가 아래 세 가지 형태로 올 수 있다:
+   *  - `""` (빈 문자열, 결과 없음)
+   *  - `{ item: { ... } }` (단건)
+   *  - `{ item: [ ... ] }` (복수)
+   */
+  async getItems<T>(servicePath: string, params: Record<string, any>): Promise<T[]> {
+    const response = await this.get<T>(servicePath, params)
+    const items = response.response?.body?.items
+    if (!items) return []
+    const arr = (items as any).item
+    if (!arr) return []
+    return Array.isArray(arr) ? arr : [arr]
+  }
+}
+
+/** Encoding 키(%2B) 를 붙여넣어도 Decoding 키로 정규화. */
+function normalizeServiceKey(key: string): string {
+  if (!key.includes('%')) return key
+  try {
+    return decodeURIComponent(key)
+  } catch {
+    return key
+  }
+}
+
+/** data.go.kr 공용 OpenAPI 에러 XML 에서 원인 추출. */
+function parseOpenApiError(xml: string): string {
+  const code = /<returnReasonCode>([^<]+)<\/returnReasonCode>/.exec(xml)?.[1]
+  const msg = /<errMsg>([^<]+)<\/errMsg>/.exec(xml)?.[1]
+  const auth = /<returnAuthMsg>([^<]+)<\/returnAuthMsg>/.exec(xml)?.[1]
+  return `code=${code} msg=${msg} auth=${auth}`
+}

package/server/engine/connector/data-go-kr-connector.ts

@@ -0,0 +1,75 @@
+import { ConnectionManager, Connector } from '@things-factory/integration-base'
+
+import { DataGoKrClient } from './data-go-kr-client'
+
+/**
+ * 공공데이터포털(data.go.kr) Open API 커넥터.
+ *
+ * 하나의 ServiceKey 로 data.go.kr 산하 **모든 오퍼레이션** 을 호출할 수 있으므로,
+ * 사용자는 Connection 을 보통 한 개만 만들고 (앱·법인별로 1개) 여러 태스크에서 재사용한다.
+ *
+ * Connection 의 `endpoint` 필드는 무시된다. 오리진 오버라이드가 필요하면 `origin`
+ * 파라미터 사용 (모의 서버/사설 프록시).
+ */
+export interface DataGoKrConnectionInstance {
+  client: DataGoKrClient
+}
+
+export class DataGoKrConnector implements Connector {
+  async ready(connectionConfigs) {
+    await Promise.all(connectionConfigs.map(this.connect.bind(this)))
+    ConnectionManager.logger.info('data-go-kr-connector connections are ready')
+  }
+
+  async connect(connection) {
+    const { params } = connection
+    try {
+      const client = new DataGoKrClient({
+        serviceKey: params.serviceKey,
+        origin: params.origin
+      })
+      const instance: DataGoKrConnectionInstance = { client }
+      ConnectionManager.addConnectionInstance(connection, instance)
+      ConnectionManager.logger.info(`data-go-kr-connector connection(${connection.name}) is connected`)
+    } catch (ex) {
+      ConnectionManager.logger.error(`data-go-kr-connector connection(${connection.name}) failed`, ex)
+      throw ex
+    }
+  }
+
+  async disconnect(connection) {
+    ConnectionManager.removeConnectionInstance(connection)
+    ConnectionManager.logger.info(`data-go-kr-connector connection(${connection.name}) is disconnected`)
+  }
+
+  get parameterSpec() {
+    return [
+      {
+        type: 'secret',
+        name: 'serviceKey',
+        label: 'label.service-key',
+        useDomainAttribute: true
+      },
+      {
+        type: 'string',
+        name: 'origin',
+        label: 'label.api-origin',
+        placeholder: 'https://apis.data.go.kr'
+      }
+    ]
+  }
+
+  get taskPrefixes() {
+    return ['data-go-kr']
+  }
+
+  get help() {
+    return 'integration/connector/data-go-kr-connector'
+  }
+
+  get description() {
+    return 'Korean Public Data Portal (data.go.kr) Connector'
+  }
+}
+
+ConnectionManager.registerConnector('data-go-kr-connector', new DataGoKrConnector())

package/server/engine/connector/index.ts

@@ -0,0 +1 @@
+import './data-go-kr-connector'

package/server/engine/index.ts

@@ -0,0 +1,2 @@
+import './connector'
+import './task'