--- template: policy-doc@1 doc_id: 01-analysis title: 분석 도메인 — 결과 축 · 조직 범위 · 대조 마스터 · 손해사정 접수 · 통계 분모 · 질병 검색 · 소유자 검증 미배포 config: ../_meta/template-config.yaml last_verified: 4d798f55 policies: - id: ANALYSIS_RESULT_AXES status: active-prod evidence: [S-route, S-constant] limitations: - 결과가 갈리는 축과 각 축의 조회 자리까지가 관측이다. 각 축이 담는 값의 산출 규칙은 이 문서가 판정하지 않는다 - 축 어휘가 담긴 자리는 열되 값의 뜻은 적지 않는다. 뜻의 정본은 운영 화면이며 이 저장소가 말하지 않는다 anchors: - insuniverse-server/apps/api/src/modules/analyze/analyze.dto.ts:35 - insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:74 - insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:247 - insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:422 - insuniverse-server/apps/api/src/modules/analyze/analyze.service.ts:214 - insuniverse-server/apps/api/src/modules/analyze/analyze.controller.ts:57 - id: ANALYSIS_CORP_SCOPE status: active-prod evidence: [S-guard, S-roles] limitations: - 조직 범위 판정이 조회 한 건으로 내려진다는 것까지가 관측이다. 그 조회가 소유의 정의를 옳게 옮겼는지는 이 문서가 증명하지 않는다 - 부분트리의 깊이 제한은 이 문서가 세지 않았다. 그 자리는 총론 권한 축이 진다 anchors: - insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:44 - insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:51 - insuniverse-server/apps/api/src/modules/analyze/analyze.service.ts:51 - id: COMPARE_MASTER_TABLE status: active-prod evidence: [S-roles, S-constant] limitations: - 마스터를 고치는 주체가 하나라는 것까지가 관측이다. 그 마스터가 결과 화면에서 어떻게 쓰이는지는 이 문서가 추적하지 않는다 - 분류 어휘가 선언된 자리는 열되 각 값의 뜻은 적지 않는다 anchors: - insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.controller.ts:38 - insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.controller.ts:39 - insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.entity.ts:16 - id: LOSS_CASE_INTAKE status: active-prod evidence: [S-route, S-guard] limitations: - 접수 건의 상태 어휘가 선언된 자리까지가 관측이다. 상태 사이의 허용 전이는 이 문서가 판정하지 않는다 - 미응답 목록이 별도 조회로 열린다는 것까지가 관측이고, 그 목록을 누가 소비하는지는 세지 않았다 anchors: - insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.controller.ts:39 - insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.controller.ts:56 - insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.entity.ts:6 - insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment-admin.controller.ts:17 - id: ANALYSIS_STATISTICS_SCOPE status: active-prod evidence: [S-roles, S-route] limitations: - 분모가 주체에 따라 갈린다는 것까지가 관측이다. 각 집계값의 산출식은 이 문서가 옮기지 않는다 - 좁혀진 분모의 식별자가 어디서 오는지는 총론 권한 축 소관이며 이 문서는 그 자리만 연다 anchors: - insuniverse-server/apps/api/src/modules/statistics/statistics.controller.ts:34 - insuniverse-server/apps/api/src/modules/statistics/statistics.service.ts:95 - insuniverse-server/apps/api/src/modules/statistics/statistics.service.ts:22 - id: DISEASE_SEARCH_MASTER status: active-prod evidence: [S-guard, S-schema] limitations: - 마스터 편집과 조회가 다른 입구로 갈린다는 것까지가 관측이다. 조회 결과의 정렬·가림 규칙은 이 문서가 판정하지 않는다 - 이 마스터를 분석 결과가 어떻게 참조하는지는 추적하지 않았다 anchors: - insuniverse-server/apps/api/src/modules/search/search-admin.controller.ts:39 - insuniverse-server/apps/api/src/modules/search/search.controller.ts:9 - insuniverse-server/apps/api/src/modules/search/search.entity.ts:5 - id: ANALYSIS_OWNER_GUARD status: staged-only evidence: [S-guard, A-release] limitations: - 미도달 판정의 근거는 이 앵커 행의 최종 변경 커밋 하나다. 그 행이 뒤에 다른 커밋으로 밀리면 같은 규칙이 도달로 뒤집힐 수 있다 - 도달성의 정본은 릴리스 인덱스이고 그 인덱스가 배포를 확증하지는 않는다. 승격 판정 자체는 이 문서 밖이다 anchors: - insuniverse-server/apps/api/src/modules/analyze/analyze.controller.ts:45 - id: ANALYSIS_CORP_VIEW_GATE status: staged-only evidence: [S-guard, A-release] limitations: - 미도달 판정의 근거는 이 앵커 행의 최종 변경 커밋 하나다. 그 행이 뒤에 다른 커밋으로 밀리면 같은 규칙이 도달로 뒤집힐 수 있다 - 등급 값의 비교 규칙은 총론 권한 축이 지며 이 문서는 그 층이 이 도메인 입구에 결선된 사실만 낸다 anchors: - insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:43 - id: LOSS_ANALYSIS_INVITE status: staged-only evidence: [S-route, A-release] limitations: - 이 워크플로 전체가 단일 커밋으로 들어왔고 그 커밋이 릴리스 인덱스의 미도달 집합에 있다. 부분 배포 여부는 이 저장소가 말하지 않는다 - 상태 어휘가 선언된 자리는 열되 각 상태의 체류 조건은 이 문서가 판정하지 않는다 - 초대 코드의 수명과 재발급 규칙은 세지 않았다 anchors: - insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.controller.ts:29 - insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.repository.ts:29 - insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.service.ts:115 --- # 분석 도메인 — 결과 축 · 조직 범위 · 대조 마스터 · 손해사정 접수 · 통계 분모 · 질병 검색 · 소유자 검증 미배포 분석 요청이 끝난 뒤 **무엇이 어떤 주체에게 열리는가**를 다룬다. 결과가 갈리는 축, 기업 측 주체의 조회가 좁혀지는 범위, 결과를 해석하는 대조 마스터, 손해사정 접수 건의 상태, 통계의 분모, 질병 검색 마스터가 여기 있다. **여기 없는 것** — 로그인과 계정 종류 판정, 권한 층의 우선순위, 입력 검증 규칙, 보관 기간은 총론 소관이며 이 문서는 그 층이 이 도메인 입구에 결선된 사실만 낸다. 진료 자료의 수집 자체는 `02-treat.md` 가, 분석 1건이 소비하는 잔여 한도는 `03-subscription-order.md` 가 진다. ## 정책 (기획) ### ANALYSIS_RESULT_AXES **분석 1건의 결과는 여러 축으로 갈려 따로 열린다.** 목록으로 여는 축, 한 건을 펼쳐 보는 축, 기간을 묶어 합산하는 축, 투약 내역을 따로 보는 축이 각각 다른 조회로 열리고 서로를 대신하지 않는다. 결과 목록의 분류 어휘는 코드값으로 고정돼 있어 화면이 임의로 늘리지 못한다. 원본 자료를 통째로 내려받는 자리가 따로 있고, 그 자리는 목록·상세와 다른 입구다. ### ANALYSIS_CORP_SCOPE **기업 측 주체가 여는 분석 목록은 자기 조직 범위로 좁혀진다.** 관리자·영업·기업담당자 세 종류가 같은 입구를 쓰지만, 기업 측 주체일 때는 요청한 건이 자기 조직 부분트리 안인지가 조회 한 건으로 먼저 판정되고, 밖이면 목록에서 빠지는 것이 아니라 요청 자체가 거부된다. 범위 판정은 목록과 상세 양쪽에 같은 형태로 걸린다. ### COMPARE_MASTER_TABLE **분석 결과를 해석하는 대조 기준표는 관리자 한 종류만 고친다.** 영업·기업 측 주체는 이 표를 읽는 화면에는 닿아도 편집 입구에는 닿지 않는다. 표의 분류 어휘는 코드값으로 선언돼 있고 항목마다 어떤 관점의 대조인지가 붙는다. 기준표는 파일로 올려 일괄 반영하는 자리와 한 건씩 고치는 자리를 함께 갖는다. ### LOSS_CASE_INTAKE **손해사정 접수 건은 상태를 갖고, 그 상태가 사용자 쪽 조회와 관리자 쪽 조회를 가른다.** 사용자는 자기 건만 열고 관리자는 전체를 열되, 관리자 쪽에는 **아직 답이 달리지 않은 건만 모으는 별도 조회**가 있다. 접수 건에는 분류와 댓글이 딸리며 각각 자기 입구를 갖는다. ### ANALYSIS_STATISTICS_SCOPE **통계의 분모는 보는 주체에 따라 갈린다.** 관리자가 보는 집계는 전체가 분모이고, 영업 주체가 보는 집계는 자기 채널로 좁혀진 분모다. 두 경로는 같은 입구를 쓰되 안에서 갈라지며, 좁혀진 쪽은 주체 식별자가 집계 조건에 함께 실린다. 가입·분석·매출 세 갈래가 각각 기간 단위로 열린다. ### DISEASE_SEARCH_MASTER **질병 검색 마스터는 편집 입구와 조회 입구가 다르다.** 편집은 관리자 한 종류만, 조회는 로그인한 사용자면 열린다. 조회는 코드 한 건을 주고 그 분류를 되받는 형태다. ## 강제 지점 (개발) ### ANALYSIS_RESULT_AXES 축 어휘는 `insuniverse-server/apps/api/src/modules/analyze/analyze.dto.ts:35` 의 열거형 상수로 고정된다. 목록·상세·집계·투약 네 조회는 각각 `insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:74` · `insuniverse-server/apps/api/src/modules/analyze/analyze.service.ts:214` · `insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:247` · `insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:422` 에서 서로 다른 질의로 조립된다. 사용자 쪽 입구는 `insuniverse-server/apps/api/src/modules/analyze/analyze.controller.ts:57` 이다. ### ANALYSIS_CORP_SCOPE 역할 목록은 `insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:44` 의 데코레이터가 선언하고, 기업 측 추가 판정은 `insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:51` 의 사설 처리기가 `insuniverse-server/apps/api/src/modules/analyze/analyze.service.ts:51` 을 불러 내린다. 층 자체의 정의와 우선순위는 `../02-access/03-authz-capabilities.md#ORG_WRITE_SCOPE` 와 `../02-access/03-authz-capabilities.md#LAYER_PRECEDENCE` 가 진다. ### COMPARE_MASTER_TABLE 편집 입구의 결선 층은 `insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.controller.ts:38`, 허용 역할은 `insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.controller.ts:39` 다. 분류 어휘는 `insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.entity.ts:16` 의 자료형 선언에 상수로 붙어 있다. ### LOSS_CASE_INTAKE 사용자 쪽 입구의 결선 층은 `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.controller.ts:39`, 한 건 조회는 `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.controller.ts:56` 이다. 상태 어휘는 `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.entity.ts:6` 의 열거형이고, 관리자 쪽 허용 역할은 `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment-admin.controller.ts:17` 이 선언한다. ### ANALYSIS_STATISTICS_SCOPE 허용 역할은 `insuniverse-server/apps/api/src/modules/statistics/statistics.controller.ts:34` 가 선언하고, 전체 분모와 좁혀진 분모는 `insuniverse-server/apps/api/src/modules/statistics/statistics.service.ts:22` 와 `insuniverse-server/apps/api/src/modules/statistics/statistics.service.ts:95` 두 처리기로 갈린다. 뒤쪽은 주체 식별자를 인자로 받는다. ### DISEASE_SEARCH_MASTER 편집 입구의 허용 역할은 `insuniverse-server/apps/api/src/modules/search/search-admin.controller.ts:39`, 조회 입구의 결선 층은 `insuniverse-server/apps/api/src/modules/search/search.controller.ts:9` 다. 마스터의 자료형은 `insuniverse-server/apps/api/src/modules/search/search.entity.ts:5` 가 선언한다. ### ANALYSIS_OWNER_GUARD 사용자 쪽 분석 조회 입구에 소유자 검증 층이 `insuniverse-server/apps/api/src/modules/analyze/analyze.controller.ts:45` 로 결선돼 있다. 그 행의 최종 변경 커밋이 릴리스 인덱스의 미도달 집합에 있다. ### ANALYSIS_CORP_VIEW_GATE 기업별 노출 등급 판정 층이 `insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:43` 의 결선 목록에 함께 실려 있다. 그 행의 최종 변경 커밋이 릴리스 인덱스의 미도달 집합에 있다. 등급 비교 규칙 자체는 `../02-access/03-authz-capabilities.md#CORP_ANALYSIS_VIEW_SCALE` 가 진다. ### LOSS_ANALYSIS_INVITE 초대 발급 입구는 `insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.controller.ts:29`, 상태 어휘는 `insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.repository.ts:29` 의 상수 맵, 수집 개시는 `insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.service.ts:115` 다. 세 자리 전부 같은 커밋에서 들어왔고 그 커밋이 미도달 집합에 있다. ## 적용 범위 (actor × 서비스) | 정책 id | server | site | admin | |---|---|---|---| | ANALYSIS_RESULT_AXES | 축 어휘 · 네 조회 조립 · 사용자 입구 | 결과 화면이 축별로 호출 | 관리자 목록·상세가 같은 축을 호출 | | ANALYSIS_CORP_SCOPE | 역할 선언 · 범위 판정 처리기 | — | 기업 측 콘솔이 이 입구를 쓴다 | | COMPARE_MASTER_TABLE | 편집 결선 층 · 역할 선언 · 분류 어휘 | — | 마스터 편집 화면 | | LOSS_CASE_INTAKE | 사용자 입구 · 상태 어휘 · 관리자 역할 선언 | 접수·조회 화면 | 접수 건 관리 화면 | | ANALYSIS_STATISTICS_SCOPE | 역할 선언 · 분모 두 처리기 | — | 대시보드 집계 | | DISEASE_SEARCH_MASTER | 편집 역할 선언 · 조회 결선 층 · 자료형 | 질병 검색 호출 | 마스터 편집 화면 | | ANALYSIS_OWNER_GUARD | 소유자 검증 층 결선 | 이 층 뒤에서 결과를 받는다 | — | | ANALYSIS_CORP_VIEW_GATE | 노출 등급 층 결선 | — | 기업 측 콘솔이 이 층 뒤에 있다 | | LOSS_ANALYSIS_INVITE | 초대 입구 · 상태 어휘 · 수집 개시 | 초대 수신 화면 | — | `—` = 그 서비스가 이 정책의 경로에 등장하지 않음. 이 표의 열은 서비스 3종이며 actor 는 열이 아니다. 이 문서의 축은 도메인 자원에 걸리는 판정이라 actor 를 열로 두면 서버 한 칸만 차는 표가 된다. 열 이름 집합과 순서는 `../_meta/template-config.yaml` 의 `services` 를 그대로 따른다. actor 축의 정본은 `../01-foundation/01-glossary.md#ACTOR_AXIS` 다. ## 예외·폴백 | 정책 id | 예외 조건 | 폴백 동작 | 확인 근거 | |---|---|---|---| | ANALYSIS_RESULT_AXES | 요청한 축이 어휘 밖일 때 | 입력 검증에서 거부된다. 빈 결과를 주지 않는다 | `insuniverse-server/apps/api/src/modules/analyze/analyze.dto.ts:35` | | ANALYSIS_RESULT_AXES | 원본 다운로드를 목록 입구로 요청할 때 | 그 입구가 아니라 별도 자리로만 열린다 | `insuniverse-server/apps/api/src/modules/analyze/analyze.repository.ts:422` | | ANALYSIS_CORP_SCOPE | 기업 측 주체가 자기 부분트리 밖 건을 요청할 때 | 목록에서 빠지는 것이 아니라 요청이 거부된다 | `insuniverse-server/apps/api/src/modules/analyze/analyze.service.ts:51` | | ANALYSIS_CORP_SCOPE | 주체가 관리자일 때 | 부분트리 판정이 걸리지 않는다 | `insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:51` | | COMPARE_MASTER_TABLE | 영업·기업 측 주체가 편집을 요청할 때 | 역할 판정에서 거부된다 | `insuniverse-server/apps/api/src/modules/compare/basic/compare-basic.controller.ts:39` | | LOSS_CASE_INTAKE | 사용자가 남의 접수 건을 열려 할 때 | 사용자 쪽 입구는 자기 건만 되돌린다 | `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment.controller.ts:56` | | LOSS_CASE_INTAKE | 답이 달리지 않은 건을 전체 목록에서 찾으려 할 때 | 전용 조회가 따로 있다. 전체 목록은 상태로 거르지 않는다 | `insuniverse-server/apps/api/src/modules/loss-adjustment/loss-adjustment/loss-adjustment-admin.controller.ts:17` | | ANALYSIS_STATISTICS_SCOPE | 영업 주체가 전체 분모를 요청할 때 | 좁혀진 처리기로 갈라져 자기 채널만 집계된다 | `insuniverse-server/apps/api/src/modules/statistics/statistics.service.ts:95` | | DISEASE_SEARCH_MASTER | 로그인하지 않고 조회할 때 | 결선 층에서 거부된다 | `insuniverse-server/apps/api/src/modules/search/search.controller.ts:9` | | ANALYSIS_OWNER_GUARD | 이 규칙이 배포에 도달하지 않은 환경일 때 | 소유자 검증 없이 앞 층의 판정만 남는다 | `insuniverse-server/apps/api/src/modules/analyze/analyze.controller.ts:45` | | ANALYSIS_CORP_VIEW_GATE | 이 규칙이 배포에 도달하지 않은 환경일 때 | 등급 판정 없이 역할·범위 층만 남는다 | `insuniverse-server/apps/api/src/modules/analyze/analyze-admin.controller.ts:43` | | LOSS_ANALYSIS_INVITE | 이 워크플로가 배포에 도달하지 않은 환경일 때 | 초대 입구 자체가 없다. 부분 배포 여부는 이 저장소가 말하지 않는다 | `insuniverse-server/apps/api/src/modules/loss-analysis/loss-analysis.controller.ts:29` | ## 부록 이 절의 정책은 **앵커 행의 최종 변경 커밋이 릴리스 인덱스의 미도달 집합에 있어 현행 배포를 판정하지 못한다.** 코드는 규칙을 말하지만 그 규칙이 지금 운영에 도달했는가를 이 저장소가 확증하지 않는다. 그 상태로 본문에 두면 독자가 차단이 기본이라고 읽는다. 배치의 정본은 `../_meta/template-config.yaml` 의 `statuses` 이며, 도달이 확인되면 상태가 바뀌고 배치도 함께 옮긴다. ### ANALYSIS_OWNER_GUARD **사용자 쪽 분석 조회에 소유자 검증 층이 붙어 있다.** 이 층이 도달한 환경에서는 남의 건을 식별자만 바꿔 열 수 없고, 도달하지 않은 환경에서는 그 앞 층의 판정만 남는다. ### ANALYSIS_CORP_VIEW_GATE **기업 측 분석 조회에 기업별 노출 등급 판정이 걸려 있다.** 이 층이 도달한 환경에서는 등급이 요구값에 못 미치는 기업이 목록 자체에 닿지 못하고, 도달하지 않은 환경에서는 역할과 조직 범위만으로 열린다. ### LOSS_ANALYSIS_INVITE **손해사정 분석은 초대로 시작해 자료를 모으는 별도 워크플로다.** 초대 코드를 발급하고, 그 코드로 열린 자리에서 제공기관을 골라 수집을 시작하며, 진행 상태가 상수 맵으로 고정돼 있다. 세 자리 전부 한 커밋에서 들어왔고 그 커밋이 미도달 집합에 있다. ## 연혁 릴리스 태그가 존재하지 않는다. 릴리스 열은 `—` 로 두고 커밋 SHA 로 추적한다. | 릴리스 | 날짜 | SHA | 변경 요약 | |---|---|---|---| | — | 2024-09-20 | `2b70336f` | 분석 결과 목록의 분류 축 어휘가 열거형으로 고정됨 | | — | 2024-09-27 | `05d6553c` | 사용자 쪽 분석 조회 입구의 요청 방식 변경 | | — | 2024-09-30 | `36f449e2` | 질병 검색 조회 입구에 인증 층 결선 | | — | 2024-10-30 | `72fdd873` | 분석 조회의 질의 조립이 별도 계층으로 분리됨 | | — | 2024-11-11 | `1b73c359` | 질병 검색 마스터의 관리자 편집 입구 신설 | | — | 2024-11-13 | `b3bb721e` | 대조 기준 마스터 자료형 신설 — 분류 어휘가 상수로 붙음 | | — | 2024-11-21 | `7150b52e` | 분석 상세 조회의 반환 형태 변경 | | — | 2025-01-03 | `29664ec4` | 원본 자료 일괄 다운로드 입구 신설 | | — | 2025-03-21 | `01ff277e` | 손해사정 접수 건의 상태 어휘 신설 | | — | 2025-03-21 | `b1f18aca` | 손해사정 접수 건의 사용자 쪽 한 건 조회 신설 | | — | 2025-03-27 | `1f1e2cfe` | 손해사정 사용자 입구에 결선 층 부착 | | — | 2025-06-24 | `780e6b64` | 대조 마스터·질병 검색·손해사정 관리자 입구에 역할 기반 판정 도입 | | — | 2025-06-25 | `b4027706` | 통계 입구의 허용 역할에 영업 주체 추가 | | — | 2025-06-30 | `47cbd8d7` | 영업 주체의 통계 분모가 자기 채널로 좁혀짐 | | — | 2026-07-01 | `f0ce46c8` | 기업 측 조회에 조직 부분트리 범위 판정 도입 | | — | 2026-07-24 | `54473012` | 기업별 분석 노출 등급 판정이 분석 입구에 결선됨 | | — | 2026-07-28 | `47d90c30` | 사용자 쪽 분석 조회에 소유자 검증 층 추가 | | — | 2026-08-05 | `4d798f55` | 손해사정 분석 초대·수집 워크플로 신설 |