@dssp/supervision 1.0.19 → 1.0.21

package/dist-client/pages/building-inspection/building-inspection-detail-ai-measurement.d.ts

@@ -77,6 +77,8 @@ export declare class BuildingInspectionAiMeasurement extends PageView {
         item_id: any;
         category: string;
         text: any;
+        criteria_kcs: string;
+        criteria_site: any;
     }[];
     get uploadedSets(): SetInfo[];
     render(): import("lit-html").TemplateResult<1>;
@@ -99,6 +101,8 @@ export declare class BuildingInspectionAiMeasurement extends PageView {
     private _callMeasure;
     private _fetchMeasureImage;
     private _loadShotGuide;
+    private _shotItemsMap;
+    private _itemsAwaitingShot;
     private _shotTag;
     private _shotTechnique;
     private _shotAppLink;
@@ -129,6 +133,7 @@ export declare class BuildingInspectionAiMeasurement extends PageView {
     private _runThicknessMeasure;
     private _applyMeasurement;
     private _dataUrlToFile;
+    private _saveJudgments;
     private _registerInspection;
 }
 export {};

package/dist-client/pages/building-inspection/building-inspection-detail-ai-measurement.js

@@ -37,6 +37,37 @@ const SET_FILES = ['video.mov', 'poses.jsonl', 'meta.json'];
 function appCaptureLink(tech) {
     return `gamri://${tech}?server=${encodeURIComponent(MEASURE_BASE_URL)}`;
 }
+/* 한 번의 /inspect 에 보낼 검사항목 수. 엔진이 8개까지만 병렬 처리하고, 그 앞단
+   Cloudflare 가 100초에서 끊기 때문에(524) 항목이 많으면 나눠 보내야 한다. */
+const INSPECT_BATCH = 8;
+/* 나눠 호출한 /inspect 결과 합치기 — 항목 배열만 이어 붙이고 요약은 다시 센다 */
+function _mergeInspectResults(a, b) {
+    const items = [...(a.items || []), ...(b.items || [])];
+    const itemsSorted = a.items_sorted || b.items_sorted ? [...(a.items_sorted || a.items || []), ...(b.items_sorted || b.items || [])] : undefined;
+    const summary = { pass: 0, fail: 0, hold: 0, pending: 0, error: 0, measure: 0 };
+    for (const it of items) {
+        summary[it.verdict] = (summary[it.verdict] || 0) + 1;
+        if (it.verdict === 'pending' && it.pending_reason === 'measure')
+            summary.measure += 1;
+    }
+    summary.total = items.length;
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, a), b), { items }), (itemsSorted ? { items_sorted: itemsSorted } : {})), { summary });
+}
+/* KCS 기준은 매칭 결과 JSON(kcs_matches[0])으로 저장돼 있다 → 엔진에 보낼 조문 텍스트로 편다.
+   문서/조항 라벨을 앞에 붙여야 모델이 어느 기준을 인용하는지 reason 에 쓸 수 있다. */
+function _kcsCriteriaText(raw) {
+    if (!raw)
+        return '';
+    try {
+        const kcs = JSON.parse(raw);
+        const label = [kcs.file_label, kcs.clause_no, kcs.clause_title].filter(Boolean).join(' ');
+        const body = (kcs.matched_item || kcs.text || '').trim();
+        return body ? `${label}\n${body}`.trim() : label;
+    }
+    catch (_a) {
+        return raw.trim(); // 구형 데이터(문자열 그대로 저장된 경우)
+    }
+}
 /* set_id(YYYYmmdd-HHMMSS_xxxxxx) → "9/11 14:30" 표기 */
 function _setTimeLabel(setId) {
     const m = /^(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})/.exec(setId || '');
@@ -158,7 +189,11 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             .map(item => ({
             item_id: item.id,
             category: [item.mainType, item.detailType].filter(Boolean).join(' · '),
-            text: item.name || ''
+            text: item.name || '',
+            // 검사 기준은 조문 '번호'가 아니라 본문을 보내야 판정 근거가 실제 기준에 붙는다.
+            // (조문 번호만 주면 모델이 그 내용을 모르는 상태로 판단한다 — 엔진 안내)
+            criteria_kcs: _kcsCriteriaText(item.kcsCriteria),
+            criteria_site: (item.siteSpecCriteria || '').trim()
         }));
     }
     get uploadedSets() {
@@ -747,6 +782,8 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
                 mainType
                 detailType
                 name
+                kcsCriteria
+                siteSpecCriteria
               }
             }
             buildingLevel {
@@ -833,7 +870,7 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
     }
     /* [1단계] 촬영 가이드 생성 (plan-shots) */
     async _loadShotGuide() {
-        var _a;
+        var _a, _b;
         const checklist = this.engineChecklist;
         if (!checklist.length) {
             notify({ message: '체크리스트 항목이 없습니다.', level: 'warn' });
@@ -844,6 +881,14 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             this.loadingText = 'AI 촬영 가이드 생성 중...';
             this.guide = await this._callEngine({ action: 'plan-shots', checklist });
             this.sets = new Array((((_a = this.guide) === null || _a === void 0 ? void 0 : _a.shots) || []).length).fill(null);
+            // 어느 촬영에도 배정되지 않은 항목이 있으면 그 항목은 판정 근거가 없다 → 재생성 권고
+            const unassigned = ((_b = this.guide) === null || _b === void 0 ? void 0 : _b.unassigned_items) || [];
+            if (unassigned.length) {
+                notify({
+                    message: `촬영에 배정되지 않은 검사항목이 ${unassigned.length}건 있습니다. 촬영 가이드를 다시 생성해보세요.`,
+                    level: 'warn'
+                });
+            }
             // 자동 등록 기준 시각 — 이 시점 이후 올라온 세트만 자동으로 붙인다.
             // (예전 테스트 세트가 태그만 같다고 채워지면 "찍지도 않았는데 완료"로 보인다)
             this.autoAttachSince = Date.now() / 1000;
@@ -856,6 +901,33 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             this.loading = false;
         }
     }
+    /* plan-shots가 준 촬영별 항목 배정 → {촬영번호: [항목ID]} (엔진 inspect 의 shot_items).
+       배정 정보가 없는 구버전 응답이면 null 을 돌려 종전대로(전 항목이 전 사진) 동작시킨다. */
+    _shotItemsMap() {
+        var _a, _b, _c;
+        const shots = ((_a = this.guide) === null || _a === void 0 ? void 0 : _a.shots) || [];
+        const map = {};
+        for (let i = 0; i < shots.length; i++) {
+            const items = (_b = shots[i]) === null || _b === void 0 ? void 0 : _b.items;
+            if (!Array.isArray(items) || !items.length)
+                continue;
+            map[String(((_c = shots[i]) === null || _c === void 0 ? void 0 : _c.shot_no) || i + 1)] = items;
+        }
+        return Object.keys(map).length ? map : null;
+    }
+    /* 세트가 아직 안 올라온 촬영에 배정된 항목 ID 집합 (그 항목은 판정할 사진이 없다) */
+    _itemsAwaitingShot() {
+        var _a, _b;
+        const pending = new Set();
+        const shots = ((_a = this.guide) === null || _a === void 0 ? void 0 : _a.shots) || [];
+        for (let i = 0; i < shots.length; i++) {
+            if (this.sets[i])
+                continue;
+            for (const id of ((_b = shots[i]) === null || _b === void 0 ? void 0 : _b.items) || [])
+                pending.add(id);
+        }
+        return pending;
+    }
     /* 촬영 칸마다 고유 태그 — 앱에 부재 ID로 넘겨 두면, 올라온 세트의 member_id로
        "어느 촬영 칸의 것인지" 되찾을 수 있다 (앱↔플랫폼 왕복에 식별자가 없어서 쓰는 방법) */
     _shotTag(shotNo) {
@@ -1044,11 +1116,13 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
      * - 최초 판정: 업로드된 모든 세트의 대표 3프레임 + 전체 체크리스트 (input_kind=video_frames)
      * - 재검사(재촬영 패널): 새 세트의 3프레임만 + 해당 항목만 재판정 후 결과 병합 */
     async _runInspection() {
+        var _a, _b, _c;
         const isRecapture = this.panel === 'recapture' && !!this.selectedItem;
         try {
             this.loading = true;
             this.loadingText = '동영상 프레임 추출 중...';
             let newPhotos = [];
+            const imageShots = []; // 사진마다 어느 촬영(shot_no)의 것인지
             if (isRecapture) {
                 if (!this.recaptureSet) {
                     notify({ message: '재촬영 세트를 먼저 업로드해주세요.', level: 'warn' });
@@ -1058,21 +1132,64 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
                 newPhotos = await this._fetchVlmFrames(this.recaptureSet, this.sets.length);
             }
             else {
-                const sets = this.uploadedSets;
-                if (!sets.length) {
+                if (!this.uploadedSets.length) {
                     notify({ message: '업로드된 촬영 세트가 없습니다.', level: 'warn' });
                     return;
                 }
-                for (let i = 0; i < sets.length; i++) {
-                    newPhotos = [...newPhotos, ...(await this._fetchVlmFrames(sets[i], i))];
+                // 촬영 칸 순서대로 — 비어 있는 칸은 건너뛰되 촬영번호는 가이드 것을 그대로 쓴다
+                for (let i = 0; i < this.sets.length; i++) {
+                    const set = this.sets[i];
+                    if (!set)
+                        continue;
+                    const frames = await this._fetchVlmFrames(set, i);
+                    const shotNo = ((_c = (_b = (_a = this.guide) === null || _a === void 0 ? void 0 : _a.shots) === null || _b === void 0 ? void 0 : _b[i]) === null || _c === void 0 ? void 0 : _c.shot_no) || i + 1;
+                    for (const _ of frames)
+                        imageShots.push(shotNo);
+                    newPhotos = [...newPhotos, ...frames];
                 }
             }
             const files = newPhotos.map(p => p.file);
-            const checklist = isRecapture
+            let checklist = isRecapture
                 ? this.engineChecklist.filter(c => c.item_id === this.selectedItem.item_id)
                 : this.engineChecklist;
-            this.loadingText = 'AI 자동 판정 중... (최대 1~2분 소요)';
-            const result = await this._callEngine({ action: 'inspect', checklist, input_kind: 'video_frames' }, files);
+            // 아직 안 올라온 촬영에 배정된 항목은 이번 판정에서 뺀다.
+            // 엔진은 그런 항목의 사진 범위를 비우는 대신 '전체 사진'을 주므로, 그냥 두면
+            // 타설 후 항목이 배근 사진으로 판정된다 (배근·타설은 며칠 간격으로 찍는다).
+            if (!isRecapture) {
+                const pending = this._itemsAwaitingShot();
+                if (pending.size) {
+                    checklist = checklist.filter(c => !pending.has(c.item_id));
+                    notify({
+                        message: `아직 촬영되지 않은 항목 ${pending.size}건은 이번 판정에서 제외했습니다. 해당 촬영을 올린 뒤 다시 실행하세요.`,
+                        level: 'warn'
+                    });
+                }
+            }
+            // 촬영 배정 되돌리기 — 이걸 안 보내면 모든 항목이 모든 사진을 보게 되어
+            // "타설 후 항목이 배근 사진으로 판정되는" 오판이 난다 (엔진 실증에서 실제 발생).
+            // 배정된 촬영이 안 올라온 항목은 엔진이 hold 로 둔다 — 남의 사진으로 판정하지 않게.
+            const shotItems = this._shotItemsMap();
+            const scoping = !isRecapture && shotItems && imageShots.length === files.length;
+            // 항목을 나눠 여러 번 호출한다. 엔진이 한 번에 8개까지만 병렬 처리하는데,
+            // 그 앞단 Cloudflare 가 100초에서 연결을 끊어 항목이 많으면 524 가 난다.
+            const batches = [];
+            for (let i = 0; i < checklist.length; i += INSPECT_BATCH) {
+                batches.push(checklist.slice(i, i + INSPECT_BATCH));
+            }
+            let result = null;
+            for (let b = 0; b < batches.length; b++) {
+                this.loadingText =
+                    batches.length > 1
+                        ? `AI 자동 판정 중... (${b + 1}/${batches.length} 묶음, 항목 ${batches[b].length}개)`
+                        : 'AI 자동 판정 중... (최대 1~2분 소요)';
+                const input = { action: 'inspect', checklist: batches[b], input_kind: 'video_frames' };
+                if (scoping) {
+                    input.image_shots = imageShots.join(',');
+                    input.shot_items = JSON.stringify(shotItems);
+                }
+                const part = await this._callEngine(input, files);
+                result = result ? _mergeInspectResults(result, part) : part;
+            }
             if (isRecapture) {
                 this.photos = [...this.photos, ...newPhotos];
                 this._mergeItems((result === null || result === void 0 ? void 0 : result.items_sorted) || (result === null || result === void 0 ? void 0 : result.items) || [], this.recaptureBase);
@@ -1354,6 +1471,9 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             });
             const judged = Object.assign(Object.assign({}, item), result.item);
             this._mergeItems([judged]);
+            // 확정 즉시 체크리스트에 기록한다. 「검사 등록」까지 미루면 그 사이에 화면을 벗어나거나
+            // 재판정이 일어났을 때 측정 판정만 유실된다 (VLM 항목은 inspect 결과에 남아 있어 티가 안 남).
+            await this._saveJudgments([judged]);
             this._resetMeasureState();
             this.panel = 'none';
             this.selectedItem = null;
@@ -1388,9 +1508,33 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             return null;
         }
     }
+    /* 적합/부적합으로 판정된 항목을 체크리스트의 감리자 확인란에 기록한다.
+       보류·미지원·오류는 미검사로 남긴다(자동으로 부적합 처리하지 않는다). */
+    async _saveJudgments(items) {
+        var _a;
+        const judged = items.filter(it => it.verdict === 'pass' || it.verdict === 'fail');
+        if (!judged.length)
+            return 0;
+        const response = await client.mutate({
+            mutation: gql `
+        mutation UpdateChecklistItemsAiJudgment($items: [ChecklistItemAiJudgment!]!) {
+          updateChecklistItemsAiJudgment(items: $items)
+        }
+      `,
+            variables: {
+                items: judged.map(it => ({
+                    id: it.item_id,
+                    supervisoryConfirmStatus: it.verdict === 'pass' ? 'T' : 'F'
+                }))
+            }
+        });
+        if (response.errors)
+            throw new Error(((_a = response.errors[0]) === null || _a === void 0 ? void 0 : _a.message) || '검사 결과 저장에 실패했습니다.');
+        return judged.length;
+    }
     /* ─── 검사 등록: 감리자 판정 자동 반영 + AI판단 근거 첨부 ─── */
     async _registerInspection() {
-        var _a, _b;
+        var _a;
         const items = this._sortedItems();
         if (!items.length) {
             notify({ message: '판정 결과가 없습니다.', level: 'warn' });
@@ -1402,23 +1546,7 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
             this.loading = true;
             this.loadingText = '검사 결과 등록 중...';
             // 1) 감리자 적합/부적합 자동 채움 (적합/부적합 판정된 항목만, 없으면 건너뜀)
-            if (judged.length) {
-                const response = await client.mutate({
-                    mutation: gql `
-            mutation UpdateChecklistItemsAiJudgment($items: [ChecklistItemAiJudgment!]!) {
-              updateChecklistItemsAiJudgment(items: $items)
-            }
-          `,
-                    variables: {
-                        items: judged.map(it => ({
-                            id: it.item_id,
-                            supervisoryConfirmStatus: it.verdict === 'pass' ? 'T' : 'F'
-                        }))
-                    }
-                });
-                if (response.errors)
-                    throw new Error(((_a = response.errors[0]) === null || _a === void 0 ? void 0 : _a.message) || '검사 등록에 실패했습니다.');
-            }
+            await this._saveJudgments(items);
             // 2) 항목별 첨부: 판단 근거(AI판단 텍스트) + 근거 프레임/측정 근거 이미지
             //    ai_report는 pending/error에서 빈 문자열로 오므로 그 항목은 첨부하지 않는다
             const attachments = [];
@@ -1457,7 +1585,7 @@ let BuildingInspectionAiMeasurement = class BuildingInspectionAiMeasurement exte
                     context: { hasUpload: true }
                 });
                 if (attachResponse.errors)
-                    throw new Error(((_b = attachResponse.errors[0]) === null || _b === void 0 ? void 0 : _b.message) || 'AI판단 자료 첨부에 실패했습니다.');
+                    throw new Error(((_a = attachResponse.errors[0]) === null || _a === void 0 ? void 0 : _a.message) || 'AI판단 자료 첨부에 실패했습니다.');
             }
             notify({ message: `검사 결과를 등록하였습니다. (자동 판정 ${judged.length}건 반영)` });
             // 등록 후 체크리스트 화면으로 이동