@dssp/dkpi 1.0.27 → 1.0.29

package/dist-client/shared/sentiment-index.js

@@ -0,0 +1,119 @@
+import { gql } from '@apollo/client';
+import { client } from '@operato/graphql';
+import { tenantHeaders } from '@dssp/project/dist-client/shared/domain-context';
+/**
+ * 감리 종합의견서 AI 분석 결과 — "체감지수 결과" 표시 규칙.
+ *
+ * 지수값 하나(1.09)는 읽는 사람에게 아무것도 말해 주지 않는다. 2026-08-07 고려대·건산연·
+ * 하티오랩 회의에서 정해진 것은 그 지수를 5단계(매우 부정 ~ 매우 긍정)로 환산해 함께 보여
+ * 주는 것이고, 환산 구간은 안전과 품질이 서로 다르다:
+ *
+ *     안전  <0.7 / 0.7~1.0 / 1.0~1.1  / 1.1~1.2   / 1.2~
+ *     품질  <0.6 / 0.6~1.0 / 1.0~1.15 / 1.15~1.25 / 1.25~
+ *
+ * ── 그 경계를 여기 다시 적지 않는 이유 ──────────────────────────────────────
+ * 같은 숫자가 이미 X43/X34 의 grade table 에 있고(server/scripts/grade-data), KPI 점수는
+ * 그것으로 매겨진다. 화면이 제 사본을 들면 둘은 언젠가 갈라지고, 갈라지는 날 화면은 KPI 점수와
+ * 다른 등급을 아무 오류 없이 보여 준다. 그래서 등급도 같은 표에서 읽는다 — 표가 곧 정의다.
+ */
+/** grade table 의 score(1~5) 가 곧 5단계 결과. 순서가 의미다. */
+const SENTIMENT_RESULTS = ['매우 부정', '부정', '중립', '긍정', '매우 긍정'];
+/**
+ * 감정 분석이 값을 써 넣는 metric 과, 그 값을 채점하는 KPI.
+ *
+ * key 는 서버가 저장할 때 쓰는 metric 이름 그대로다
+ * (kpi-metric-value-mutation.ts 의 updateKpiMetricValuesSentiment).
+ * 화면 이름만 회의 결과대로 바꾼다 — metric 이름은 값을 찾는 열쇠라서, 바꾸면 이미 쌓인
+ * 값이 주인을 잃는다.
+ */
+export const SENTIMENT_METRICS = {
+    'SL-PA 안전 평가': { kpiCode: 'X43', label: '안전성과 체감지수 결과' },
+    'SL-PA 품질 평가': { kpiCode: 'X34', label: '품질성과 체감지수 결과' }
+};
+/** "X43. 안전 SL-PA 결과값" → "X43" — sv-project-detail 과 같은 규칙. */
+const codeOf = (name) => (name || '').trim().split(/[.\s]/)[0];
+/**
+ * 체감지수 metric 을 채점하는 KPI 들의 grade table 을 코드별로 가져온다.
+ *
+ * KPI 는 스무 개 남짓이라 전부 받아 코드로 고른다. 이름으로 필터를 걸면 "X43. 안전 SL-PA
+ * 결과값" 이라는 전체 문자열에 의존하게 되는데, 그 이름은 관리 화면에서 바뀔 수 있다.
+ */
+export async function fetchSentimentGrades(projectCode) {
+    var _a, _b;
+    const wanted = new Set(Object.values(SENTIMENT_METRICS).map(m => m.kpiCode));
+    const response = await client.query({
+        query: gql `
+      query SentimentKpiGrades {
+        kpis {
+          items {
+            id
+            name
+            grades
+          }
+        }
+      }
+    `,
+        context: { headers: tenantHeaders(projectCode) }
+    });
+    if (response.errors) {
+        return {};
+    }
+    const grades = {};
+    for (const kpi of ((_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.kpis) === null || _b === void 0 ? void 0 : _b.items) || []) {
+        const code = codeOf(kpi.name);
+        if (wanted.has(code) && Array.isArray(kpi.grades)) {
+            grades[code] = kpi.grades;
+        }
+    }
+    return grades;
+}
+/** 0.7 → "0.7", 1 → "1.0", 1.15 → "1.15". 회의 자료의 표기를 따른다. */
+function formatBoundary(value) {
+    return Number.isInteger(value) ? value.toFixed(1) : String(value);
+}
+/**
+ * 구간표를 화면에 그대로 보여 줄 수 있는 형태로 — 회의 자료의 "지수 범위 / 결과" 표다.
+ *
+ * 양 끝은 열린 구간으로 적는다. 첫 구간의 minValue(0)와 마지막 구간의 maxValue(99999)는
+ * 표를 채우기 위한 수치이지 사람에게 보여 줄 경계가 아니다 — "0~0.7" 이나 "1.2~99999" 로
+ * 적으면 읽는 사람이 없는 하한과 상한을 믿게 된다.
+ */
+export function sentimentBandsOf(grades) {
+    if (!Array.isArray(grades) || grades.length === 0) {
+        return [];
+    }
+    const sorted = [...grades].sort((a, b) => a.minValue - b.minValue);
+    return sorted.map((grade, index) => {
+        var _a;
+        return ({
+            score: grade.score,
+            range: index === 0
+                ? `<${formatBoundary(grade.maxValue)}`
+                : index === sorted.length - 1
+                    ? `${formatBoundary(grade.minValue)}~`
+                    : `${formatBoundary(grade.minValue)}~${formatBoundary(grade.maxValue)}`,
+            result: (_a = SENTIMENT_RESULTS[grade.score - 1]) !== null && _a !== void 0 ? _a : ''
+        });
+    });
+}
+/**
+ * 지수값이 떨어지는 구간을 찾는다.
+ *
+ * 판정 규칙은 kpi-step-lookup-chart 와 같다: 아래는 포함, 위는 미포함, 마지막 구간의
+ * maxValue(99999)는 열린 끝으로 본다. 두 곳이 다르게 판정하면 같은 값에 대해 차트와 글자가
+ * 엇갈린다.
+ *
+ * 표가 없거나 어느 구간에도 안 걸리면 null — 모르는 것을 "중립" 으로 메우지 않는다.
+ */
+export function matchSentimentBand(value, grades) {
+    var _a;
+    if (value == null || !Array.isArray(grades) || grades.length === 0) {
+        return null;
+    }
+    const matched = grades.find(grade => value >= grade.minValue && (grade.maxValue >= 9999 ? true : value < grade.maxValue));
+    if (!matched) {
+        return null;
+    }
+    return (_a = sentimentBandsOf(grades).find(band => band.score === matched.score)) !== null && _a !== void 0 ? _a : null;
+}
+//# sourceMappingURL=sentiment-index.js.map

package/dist-client/shared/sentiment-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentiment-index.js","sourceRoot":"","sources":["../../client/shared/sentiment-index.ts"],"names":[],"mappings":"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","sourcesContent":["import { gql } from '@apollo/client'\nimport { client } from '@operato/graphql'\n\nimport { tenantHeaders } from '@dssp/project/dist-client/shared/domain-context'\n\n/**\n * 감리 종합의견서 AI 분석 결과 — \"체감지수 결과\" 표시 규칙.\n *\n * 지수값 하나(1.09)는 읽는 사람에게 아무것도 말해 주지 않는다. 2026-08-07 고려대·건산연·\n * 하티오랩 회의에서 정해진 것은 그 지수를 5단계(매우 부정 ~ 매우 긍정)로 환산해 함께 보여\n * 주는 것이고, 환산 구간은 안전과 품질이 서로 다르다:\n *\n *     안전  <0.7 / 0.7~1.0 / 1.0~1.1  / 1.1~1.2   / 1.2~\n *     품질  <0.6 / 0.6~1.0 / 1.0~1.15 / 1.15~1.25 / 1.25~\n *\n * ── 그 경계를 여기 다시 적지 않는 이유 ──────────────────────────────────────\n * 같은 숫자가 이미 X43/X34 의 grade table 에 있고(server/scripts/grade-data), KPI 점수는\n * 그것으로 매겨진다. 화면이 제 사본을 들면 둘은 언젠가 갈라지고, 갈라지는 날 화면은 KPI 점수와\n * 다른 등급을 아무 오류 없이 보여 준다. 그래서 등급도 같은 표에서 읽는다 — 표가 곧 정의다.\n */\n\n/** grade table 의 score(1~5) 가 곧 5단계 결과. 순서가 의미다. */\nconst SENTIMENT_RESULTS = ['매우 부정', '부정', '중립', '긍정', '매우 긍정']\n\n/**\n * 감정 분석이 값을 써 넣는 metric 과, 그 값을 채점하는 KPI.\n *\n * key 는 서버가 저장할 때 쓰는 metric 이름 그대로다\n * (kpi-metric-value-mutation.ts 의 updateKpiMetricValuesSentiment).\n * 화면 이름만 회의 결과대로 바꾼다 — metric 이름은 값을 찾는 열쇠라서, 바꾸면 이미 쌓인\n * 값이 주인을 잃는다.\n */\nexport const SENTIMENT_METRICS: Record<string, { kpiCode: string; label: string }> = {\n  'SL-PA 안전 평가': { kpiCode: 'X43', label: '안전성과 체감지수 결과' },\n  'SL-PA 품질 평가': { kpiCode: 'X34', label: '품질성과 체감지수 결과' }\n}\n\nexport type SentimentGrade = { minValue: number; maxValue: number; score: number }\n\n/** \"X43. 안전 SL-PA 결과값\" → \"X43\" — sv-project-detail 과 같은 규칙. */\nconst codeOf = (name: string) => (name || '').trim().split(/[.\\s]/)[0]\n\n/**\n * 체감지수 metric 을 채점하는 KPI 들의 grade table 을 코드별로 가져온다.\n *\n * KPI 는 스무 개 남짓이라 전부 받아 코드로 고른다. 이름으로 필터를 걸면 \"X43. 안전 SL-PA\n * 결과값\" 이라는 전체 문자열에 의존하게 되는데, 그 이름은 관리 화면에서 바뀔 수 있다.\n */\nexport async function fetchSentimentGrades(projectCode?: string): Promise<Record<string, SentimentGrade[]>> {\n  const wanted = new Set(Object.values(SENTIMENT_METRICS).map(m => m.kpiCode))\n\n  const response = await client.query({\n    query: gql`\n      query SentimentKpiGrades {\n        kpis {\n          items {\n            id\n            name\n            grades\n          }\n        }\n      }\n    `,\n    context: { headers: tenantHeaders(projectCode) }\n  })\n\n  if (response.errors) {\n    return {}\n  }\n\n  const grades: Record<string, SentimentGrade[]> = {}\n\n  for (const kpi of response.data?.kpis?.items || []) {\n    const code = codeOf(kpi.name)\n    if (wanted.has(code) && Array.isArray(kpi.grades)) {\n      grades[code] = kpi.grades\n    }\n  }\n\n  return grades\n}\n\nexport type SentimentBand = { score: number; range: string; result: string }\n\n/** 0.7 → \"0.7\", 1 → \"1.0\", 1.15 → \"1.15\". 회의 자료의 표기를 따른다. */\nfunction formatBoundary(value: number): string {\n  return Number.isInteger(value) ? value.toFixed(1) : String(value)\n}\n\n/**\n * 구간표를 화면에 그대로 보여 줄 수 있는 형태로 — 회의 자료의 \"지수 범위 / 결과\" 표다.\n *\n * 양 끝은 열린 구간으로 적는다. 첫 구간의 minValue(0)와 마지막 구간의 maxValue(99999)는\n * 표를 채우기 위한 수치이지 사람에게 보여 줄 경계가 아니다 — \"0~0.7\" 이나 \"1.2~99999\" 로\n * 적으면 읽는 사람이 없는 하한과 상한을 믿게 된다.\n */\nexport function sentimentBandsOf(grades?: SentimentGrade[]): SentimentBand[] {\n  if (!Array.isArray(grades) || grades.length === 0) {\n    return []\n  }\n\n  const sorted = [...grades].sort((a, b) => a.minValue - b.minValue)\n\n  return sorted.map((grade, index) => ({\n    score: grade.score,\n    range:\n      index === 0\n        ? `<${formatBoundary(grade.maxValue)}`\n        : index === sorted.length - 1\n          ? `${formatBoundary(grade.minValue)}~`\n          : `${formatBoundary(grade.minValue)}~${formatBoundary(grade.maxValue)}`,\n    result: SENTIMENT_RESULTS[grade.score - 1] ?? ''\n  }))\n}\n\n/**\n * 지수값이 떨어지는 구간을 찾는다.\n *\n * 판정 규칙은 kpi-step-lookup-chart 와 같다: 아래는 포함, 위는 미포함, 마지막 구간의\n * maxValue(99999)는 열린 끝으로 본다. 두 곳이 다르게 판정하면 같은 값에 대해 차트와 글자가\n * 엇갈린다.\n *\n * 표가 없거나 어느 구간에도 안 걸리면 null — 모르는 것을 \"중립\" 으로 메우지 않는다.\n */\nexport function matchSentimentBand(\n  value: number | null | undefined,\n  grades?: SentimentGrade[]\n): SentimentBand | null {\n  if (value == null || !Array.isArray(grades) || grades.length === 0) {\n    return null\n  }\n\n  const matched = grades.find(\n    grade => value >= grade.minValue && (grade.maxValue >= 9999 ? true : value < grade.maxValue)\n  )\n\n  if (!matched) {\n    return null\n  }\n\n  return sentimentBandsOf(grades).find(band => band.score === matched.score) ?? null\n}\n"]}