@dssp/dkpi 1.0.0-alpha.79 → 1.0.0-alpha.80

package/dist-server/service/kpi-metric-value/kpi-metric-value-mutation.d.ts

@@ -1,5 +1,16 @@
 import { KpiMetricValue, KpiMetricValuePatch } from '@things-factory/kpi';
 import { Attachment, NewAttachment } from '@things-factory/attachment-base';
+/**
+ * 외부 시스템 데이터 수집 결과 — 시스템별 한 row.
+ * UI "자동 수집" 버튼이 시나리오 호출 후 시스템별 성공·오류 표시에 사용.
+ */
+declare class ExternalDataCollectionResult {
+    source: string;
+    label: string;
+    ok: boolean;
+    message: string;
+    data?: any;
+}
 export declare class KpiMetricValueMutation {
     updateKpiMetricValuesCumulative(patches: KpiMetricValuePatch[], context: ResolverContext): Promise<KpiMetricValue[]>;
     updateKpiMetricValuesAssessment(patches: KpiMetricValuePatch[], context: ResolverContext): Promise<KpiMetricValue[]>;
@@ -21,6 +32,63 @@ export declare class KpiMetricValueMutation {
      */
     private saveMetricValue;
     finalizeProjectWithKpiRecalculation(projectId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * UI "자동 수집" 버튼 전용 mutation. 외부 시스템 3종 시나리오를 순차 호출하고
+     * 시스템별 성공/실패 + 메시지를 반환. UI 는 결과를 보고 카드별 상태 (성공·오류) 를 표시.
+     *
+     * 시나리오는 도메인 EnvVar (주소·자격증명·서비스키 등) 만으로 동작하므로 파라미터 X.
+     * 한 시스템 실패가 다른 시스템 수집을 막지 않도록 try/catch 로 격리.
+     *
+     * 운영 현실: 키스콘·올바로는 시공사 ID/PW 가 자주 미확보 → 오류 흔함. 세움터는 공공
+     * 데이터 서비스키만으로 동작 가능. UI 는 시스템별로 명확한 오류 메시지 노출.
+     */
+    collectProjectExternalData(projectId: string, context: ResolverContext): Promise<ExternalDataCollectionResult[]>;
+    /**
+     * 프로젝트 정보 수정 화면의 "정보 연동" 버튼 전용 — 세움터 단일 시나리오만 호출.
+     * BuildingComplex 기본 속성 (area / floorAreaRatio / siteType / structureType /
+     * coverageRatio / householdCount 등) 자동 채움 목적.
+     *
+     * address 인자가 있으면 시나리오 실행 전에 EnvVar `Step::건축물관리대장조회::address::query`
+     * 를 그 값으로 upsert — 운영자가 폼에서 방금 입력한 주소를 시나리오가 곧바로 사용.
+     * (도메인의 기존 EnvVar 와 다를 수 있어 명시적 갱신.)
+     *
+     * **도메인 스위치**: mutation 호출은 system / 운영자 도메인에서 일어나지만 시나리오·
+     * EnvVar 는 **프로젝트가 속한 도메인** 에 있어야 자연. project.domain 으로 컨텍스트
+     * 스위치 후 그 도메인에서 EnvVar upsert + 시나리오 실행.
+     */
+    collectProjectBasicInfo(projectId: string, address: string, context: ResolverContext): Promise<ExternalDataCollectionResult>;
+    /**
+     * mutation 호출이 system / 운영자 도메인에서 일어나도 시나리오·EnvVar 는 **프로젝트
+     * 테넌트 도메인** 에서 동작해야 자연. project.code 로 자식 (테넌트) 도메인을 찾아
+     * 컨텍스트 사본 만들어 반환.
+     *
+     * 테넌트 도메인 매핑: Domain.subdomain = project.code AND Domain.extType = 'project'
+     * (promoteProjectToTenant mutation 이 그렇게 생성). project.domain 자체는 부모
+     * 도메인이라 외부 연동 EnvVar 가 거기 있을 일이 없어 사용 부적합.
+     *
+     * 테넌트 도메인이 없거나 (= 아직 승격 안 됨) project.code 가 비어있으면 원본
+     * 컨텍스트 그대로 반환 (방어). project 자체가 없으면 throw.
+     */
+    private switchToProjectDomain;
+    /**
+     * 컨텍스트의 도메인에 EnvVar 1개 upsert. 시나리오가 도메인 EnvVar 를 우선 참조하는
+     * 정책이라, 폼에서 입력한 주소를 시나리오 입력으로 흘리는 다리 역할.
+     */
+    private upsertEnvVar;
+    /**
+     * 단일 시나리오 호출 + result unwrap + 실패 판정 — collectProjectExternalData 의
+     * loop 본체와 같은 로직을 1건짜리로 분리.
+     */
+    private runSingleScenario;
+    /**
+     * 외부 시스템 3종 시나리오 순차 실행 + 시스템별 결과 수집.
+     */
+    private runExternalDataScenariosWithResults;
+    /**
+     * finalize 흐름용 시나리오 호출. 결과 형태 없이 진행만 — finalize 의 KPI 재계산이 곧
+     * 이어지므로 시스템별 결과를 클라이언트에 돌려줄 필요 없음. 실패는 warning 만.
+     */
+    private runExternalDataScenarios;
     /**
      * 프로젝트의 모든 KPI Value들을 계층적으로 재계산합니다.
      * 1. 기존 KPI Value 삭제 (중복 방지)
@@ -72,3 +140,4 @@ export declare class KpiMetricValueMutation {
      */
     private calculateWeightedAverage;
 }
+export {};

package/dist-server/service/kpi-metric-value/kpi-metric-value-mutation.js

@@ -4,6 +4,7 @@ exports.KpiMetricValueMutation = void 0;
 const tslib_1 = require("tslib");
 const type_graphql_1 = require("type-graphql");
 const shell_1 = require("@things-factory/shell");
+const integration_base_1 = require("@things-factory/integration-base");
 const typeorm_1 = require("typeorm");
 const kpi_1 = require("@things-factory/kpi");
 const attachment_base_1 = require("@things-factory/attachment-base");
@@ -13,6 +14,44 @@ const form_data_1 = tslib_1.__importDefault(require("form-data"));
 const node_fetch_1 = tslib_1.__importDefault(require("node-fetch"));
 const https_1 = tslib_1.__importDefault(require("https"));
 const http_1 = tslib_1.__importDefault(require("http"));
+/**
+ * 외부 시스템 데이터 수집 결과 — 시스템별 한 row.
+ * UI "자동 수집" 버튼이 시나리오 호출 후 시스템별 성공·오류 표시에 사용.
+ */
+let ExternalDataCollectionResult = class ExternalDataCollectionResult {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: '소스 키: saeumteo | allbaro | kiscon' }),
+    tslib_1.__metadata("design:type", String)
+], ExternalDataCollectionResult.prototype, "source", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: '표시 라벨 (세움터/올바로/키스콘)' }),
+    tslib_1.__metadata("design:type", String)
+], ExternalDataCollectionResult.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: '시나리오 실행 성공 여부' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ExternalDataCollectionResult.prototype, "ok", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: '성공 시 "완료", 실패 시 에러 메시지' }),
+    tslib_1.__metadata("design:type", String)
+], ExternalDataCollectionResult.prototype, "message", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, {
+        nullable: true,
+        description: '시나리오 result 객체 — projectKey: value 맵. ' +
+            '세움터={area, floorAreaRatio, upperFloorCount, lowerFloorCount, structureType, siteType}, ' +
+            '올바로={totalConstructionWasteAmount}, ' +
+            '키스콘={constructionPeriod, constructionCost}. ' +
+            'siteType (건축물 용도, 예 APARTMENT_COMPLEX) / structureType (구조형태) 는 ' +
+            'BuildingComplex 의 시설유형/구조유형 속성 후보. KISCON 의 "공사유형(신설/증축)" 은 ' +
+            'DSSP SiteType (용도분류) 와 다른 도메인이라 매핑 대상 아님.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], ExternalDataCollectionResult.prototype, "data", void 0);
+ExternalDataCollectionResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: '외부 시스템(세움터/올바로/키스콘) 데이터 수집 시나리오 호출 결과' })
+], ExternalDataCollectionResult);
 let KpiMetricValueMutation = class KpiMetricValueMutation {
     /* 프로젝트 수행과정 중에 (시간, 비용, 발생 건수 등) 누적된 값을 반영하여 KPI Metric Value 값을 수정 - 예를 들면, 총 설계 변경 건수, 총 건설 폐기물 발생량, 공사비, 공사기간, 재해 건수 등 */
     async updateKpiMetricValuesCumulative(patches, context) {
@@ -209,11 +248,169 @@ let KpiMetricValueMutation = class KpiMetricValueMutation {
         if (!project) {
             throw new Error(`Project not found: ${projectId}`);
         }
-        // 이지점에서 프로젝트 KPI Value 계산을 다시 할 것이다.
-        await this.recalculateProjectKpiValues(projectId, context);
+        // 시나리오·EnvVar·KPI value 모두 프로젝트(테넌트) 도메인 기준이라 컨텍스트 스위치
+        // 한 번 만든 뒤 이후 작업 모두 그 컨텍스트로 일관 진행.
+        const projectContext = await this.switchToProjectDomain(projectId, context);
+        // 외부 시스템 데이터 수집은 별도 mutation (collectProjectExternalData) 로 분리.
+        // 사용자가 UI "자동 수집" 으로 먼저 명시 수집 후 결과 검토하고 완공 처리하는 흐름.
+        // 안전 차원에서 finalize 시점에도 한 번 더 수집을 시도 — 실패는 warning 만.
+        await this.runExternalDataScenarios(projectContext);
+        // 프로젝트 KPI Value 계산을 다시 할 것이다 — 테넌트 도메인 컨텍스트에서.
+        await this.recalculateProjectKpiValues(projectId, projectContext);
         projectRepo.save(Object.assign(Object.assign({}, project), { state: project_1.ProjectState.COMPLETED }));
         return true;
     }
+    /**
+     * UI "자동 수집" 버튼 전용 mutation. 외부 시스템 3종 시나리오를 순차 호출하고
+     * 시스템별 성공/실패 + 메시지를 반환. UI 는 결과를 보고 카드별 상태 (성공·오류) 를 표시.
+     *
+     * 시나리오는 도메인 EnvVar (주소·자격증명·서비스키 등) 만으로 동작하므로 파라미터 X.
+     * 한 시스템 실패가 다른 시스템 수집을 막지 않도록 try/catch 로 격리.
+     *
+     * 운영 현실: 키스콘·올바로는 시공사 ID/PW 가 자주 미확보 → 오류 흔함. 세움터는 공공
+     * 데이터 서비스키만으로 동작 가능. UI 는 시스템별로 명확한 오류 메시지 노출.
+     */
+    async collectProjectExternalData(projectId, context) {
+        const projectContext = await this.switchToProjectDomain(projectId, context);
+        return await this.runExternalDataScenariosWithResults(projectContext);
+    }
+    /**
+     * 프로젝트 정보 수정 화면의 "정보 연동" 버튼 전용 — 세움터 단일 시나리오만 호출.
+     * BuildingComplex 기본 속성 (area / floorAreaRatio / siteType / structureType /
+     * coverageRatio / householdCount 등) 자동 채움 목적.
+     *
+     * address 인자가 있으면 시나리오 실행 전에 EnvVar `Step::건축물관리대장조회::address::query`
+     * 를 그 값으로 upsert — 운영자가 폼에서 방금 입력한 주소를 시나리오가 곧바로 사용.
+     * (도메인의 기존 EnvVar 와 다를 수 있어 명시적 갱신.)
+     *
+     * **도메인 스위치**: mutation 호출은 system / 운영자 도메인에서 일어나지만 시나리오·
+     * EnvVar 는 **프로젝트가 속한 도메인** 에 있어야 자연. project.domain 으로 컨텍스트
+     * 스위치 후 그 도메인에서 EnvVar upsert + 시나리오 실행.
+     */
+    async collectProjectBasicInfo(projectId, address, context) {
+        const projectContext = await this.switchToProjectDomain(projectId, context);
+        if (address && address.trim()) {
+            await this.upsertEnvVar('Step::건축물관리대장조회::address::query', address.trim(), projectContext);
+        }
+        return await this.runSingleScenario({ source: 'saeumteo', label: '세움터', name: '건축물관리대장조회' }, projectContext);
+    }
+    /**
+     * mutation 호출이 system / 운영자 도메인에서 일어나도 시나리오·EnvVar 는 **프로젝트
+     * 테넌트 도메인** 에서 동작해야 자연. project.code 로 자식 (테넌트) 도메인을 찾아
+     * 컨텍스트 사본 만들어 반환.
+     *
+     * 테넌트 도메인 매핑: Domain.subdomain = project.code AND Domain.extType = 'project'
+     * (promoteProjectToTenant mutation 이 그렇게 생성). project.domain 자체는 부모
+     * 도메인이라 외부 연동 EnvVar 가 거기 있을 일이 없어 사용 부적합.
+     *
+     * 테넌트 도메인이 없거나 (= 아직 승격 안 됨) project.code 가 비어있으면 원본
+     * 컨텍스트 그대로 반환 (방어). project 자체가 없으면 throw.
+     */
+    async switchToProjectDomain(projectId, context) {
+        const { tx } = context.state;
+        const project = await (0, shell_1.getRepository)(project_1.Project, tx).findOne({ where: { id: projectId } });
+        if (!project) {
+            throw new Error(`Project not found: ${projectId}`);
+        }
+        if (!project.code) {
+            console.warn(`[collect] project ${projectId} 는 아직 테넌트 승격되지 않음 (no code) — caller domain 그대로 사용`);
+            return context;
+        }
+        const tenantDomain = await (0, shell_1.getRepository)(shell_1.Domain, tx).findOne({
+            where: { subdomain: project.code, extType: 'project' }
+        });
+        if (!tenantDomain) {
+            console.warn(`[collect] project ${projectId} (code=${project.code}) 의 테넌트 도메인을 찾지 못함 — caller domain 그대로 사용`);
+            return context;
+        }
+        return Object.assign(Object.assign({}, context), { state: Object.assign(Object.assign({}, context.state), { domain: tenantDomain }) });
+    }
+    /**
+     * 컨텍스트의 도메인에 EnvVar 1개 upsert. 시나리오가 도메인 EnvVar 를 우선 참조하는
+     * 정책이라, 폼에서 입력한 주소를 시나리오 입력으로 흘리는 다리 역할.
+     */
+    async upsertEnvVar(name, value, context) {
+        const { domain, user, tx } = context.state;
+        const repo = (0, shell_1.getRepository)(shell_1.EnvVar, tx);
+        const existing = await repo.findOne({ where: { domain: { id: domain.id }, name } });
+        if (existing) {
+            existing.value = value;
+            existing.active = true;
+            existing.updater = user;
+            await repo.save(existing);
+        }
+        else {
+            await repo.save(repo.create({
+                name,
+                value,
+                active: true,
+                domain,
+                description: 'Project basic info 자동 연동용 (project-update 정보연동 버튼)',
+                creator: user,
+                updater: user
+            }));
+        }
+    }
+    /**
+     * 단일 시나리오 호출 + result unwrap + 실패 판정 — collectProjectExternalData 의
+     * loop 본체와 같은 로직을 1건짜리로 분리.
+     */
+    async runSingleScenario(s, context) {
+        var _a, _b;
+        const { domain } = context.state;
+        const instanceName = `collect-${s.name}-${Date.now()}`;
+        try {
+            const runResult = await (0, integration_base_1.runScenario)(instanceName, s.name, {}, context);
+            if (!runResult) {
+                console.warn(`[collect] '${s.name}' no result on domain '${domain.subdomain}'`);
+                throw new Error('업데이트할 정보가 없습니다');
+            }
+            if (runResult.state === 'HALTED') {
+                console.warn(`[collect] '${s.name}' HALTED on domain '${domain.subdomain}': ${runResult.message || '(no message)'}`);
+                throw new Error('업데이트할 정보가 없습니다');
+            }
+            let data = (_b = (_a = runResult.result) !== null && _a !== void 0 ? _a : runResult.data) !== null && _b !== void 0 ? _b : {};
+            if (data && typeof data === 'object' && !Array.isArray(data)) {
+                const wrapKeys = Object.keys(data);
+                if (wrapKeys.length === 1 &&
+                    data[wrapKeys[0]] &&
+                    typeof data[wrapKeys[0]] === 'object' &&
+                    !Array.isArray(data[wrapKeys[0]])) {
+                    data = data[wrapKeys[0]];
+                }
+            }
+            console.log(`[collect] '${s.name}' OK on '${domain.subdomain}' keys=${Object.keys(data || {}).join(',')}`);
+            return { source: s.source, label: s.label, ok: true, message: '완료', data };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[collect] '${s.name}' failed on '${domain.subdomain}': ${msg}`);
+            return { source: s.source, label: s.label, ok: false, message: msg };
+        }
+    }
+    /**
+     * 외부 시스템 3종 시나리오 순차 실행 + 시스템별 결과 수집.
+     */
+    async runExternalDataScenariosWithResults(context) {
+        const { domain } = context.state;
+        const SCENARIOS = [
+            { source: 'saeumteo', label: '세움터', name: '건축물관리대장조회' },
+            { source: 'allbaro', label: '올바로', name: '건설폐기물정보조회' },
+            { source: 'kiscon', label: '키스콘', name: '건설공사정보조회' }
+        ];
+        const results = [];
+        for (const s of SCENARIOS) {
+            results.push(await this.runSingleScenario(s, context));
+        }
+        return results;
+    }
+    /**
+     * finalize 흐름용 시나리오 호출. 결과 형태 없이 진행만 — finalize 의 KPI 재계산이 곧
+     * 이어지므로 시스템별 결과를 클라이언트에 돌려줄 필요 없음. 실패는 warning 만.
+     */
+    async runExternalDataScenarios(context) {
+        await this.runExternalDataScenariosWithResults(context);
+    }
     /**
      * 프로젝트의 모든 KPI Value들을 계층적으로 재계산합니다.
      * 1. 기존 KPI Value 삭제 (중복 방지)
@@ -680,6 +877,30 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [String, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], KpiMetricValueMutation.prototype, "finalizeProjectWithKpiRecalculation", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => [ExternalDataCollectionResult], {
+        description: 'Run external data collection scenarios per system, returning per-system result.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('projectId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], KpiMetricValueMutation.prototype, "collectProjectExternalData", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => ExternalDataCollectionResult, {
+        description: 'Run only 건축물관리대장조회 scenario for project basic info collection.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('projectId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('address', { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], KpiMetricValueMutation.prototype, "collectProjectBasicInfo", null);
 exports.KpiMetricValueMutation = KpiMetricValueMutation = tslib_1.__decorate([
     (0, type_graphql_1.Resolver)(kpi_1.KpiMetricValue)
 ], KpiMetricValueMutation);