stephanev/risk-analysis-editor브라우저 기반 위험 분석 편집기로, 위험 매트릭스, 위험 등록부, 실행 계획을 구축할 수 있습니다. 오프라인 .rae.json 파일로 EBIOS RM, ISO 27005, CNIL DPIA를 지원합니다.
# <img src="https://raw.githubusercontent.com/stephanev/risk-analysis-editor/HEAD/docs/images/RAE-logo-mini.svg" alt="" height="38" align="top"> Risk Analysis Editor (RAE)
**한국어** · [Français](https://github.com/stephanev/risk-analysis-editor/blob/main/README.fr.md)
**위험 매트릭스 작성 및 시각화**를 위한 독립 실행형 도구 — 내재적(총) 위험과 잔여(순) 위험 — 으로, 공개되고 문서화된 파일 형식 `.rae.json`을 사용합니다.
### ▶️ [앱 열기](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) · 📖 [**사용자 가이드**](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md) · 🎬 [비디오 튜토리얼](https://www.youtube.com/@RiskAnalysisEditor) · ⬇️ [다운로드](https://github.com/StephaneV/Risk-Analysis-Editor/releases/latest/download/risk-analysis-editor.html)
*설치 불필요: 이 도구는 전적으로 브라우저에서 실행됩니다. 바로 열 수 있는 두 가지 데모: 📊 [**EBIOS RM에서 영감을 받은** 위험 분석](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html?file=../examples/demo-ebios-rm-information-system-enriched.rae.json) (위험 12개, 대책 11개)과 🛡️ [DPIA의 위험 분석 부분 예시](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html?file=../examples/demo-dpia-ohs-enriched.rae.json) — CNIL PIA 방법에서 영감을 받아 우려되는 사건, 통제 및 잔여 위험에 초점을 맞춘 예시 (위험 12개, 대책 12개) — 두 데모 모두 설명, 메모, 색상이 지정된 **태그**, **진행 표시줄**, 담당자 및 링크별 근거를 보여주며, **재사용 가능한 객체 모델**(비즈니스 가치, 지원 자산, 위험 원천, 이해관계자, 시나리오…)과 사전 구성된 보고서를 포함합니다. 다운로드 시 [최신 릴리스](https://github.com/StephaneV/Risk-Analysis-Editor/releases/latest)의 **단일 HTML 파일**이 제공됩니다: 더블클릭하면 **오프라인**으로 작업할 수 있습니다.*
> ***매트릭스 › 궤적** 보기: 각 화살표는 위험의 초기 위치(점선 윤곽)를 잔여 위치(실선 윤곽)에 연결합니다.*
> ***통계** 탭: 주요 카운터 및 분포 — 심각도별(초기 → 잔여), 범주별, 대책 유형 및 상태별, 사용자 정의 필드별, 적용 범위별 — 을 표 및/또는 차트(도넛 또는 파이)로 표시합니다. 그리드는 사용자 정의 및 드래그 앤 드롭으로 재배치할 수 있으며, 활성 필터를 따릅니다.*
> ***조치 계획** — 일정: 마감일순으로 정렬된 통제 항목으로, 담당자, 상태 및 포함된 위험을 표시합니다. **상태 보드(칸반)** 및 **담당자별** 보기로도 제공되며, 진행률과 기한 초과 추적 기능을 포함합니다.*
---
## 개요
**Risk Analysis Editor**는 **독립 실행형** 웹 앱입니다: 단일 HTML 파일로, 런타임에 네트워크나 외부 서비스 의존성이 없으며 **오프라인**으로 작동합니다(간단히 더블클릭하면 충분 — 설치나 서버 불필요).
일반적이고 구조화된 위험 분석을 수행할 수 있습니다: 점수 구성, 위험 및 대책 입력, 초기 및 잔여 평가, 조치 계획, 시각화 및 보고서.
이 도구는 일반적이고 구성 가능한 모델을 기반으로 하며, 내부 프레임워크에 맞게 조정할 수 있고 ISO 27005, EBIOS RM 또는 DPIA와 같은 접근 방식 내에서 수행된 분석을 구조화하고 제시하는 데 사용할 수 있습니다. 그리드는 광범위하게 구성 가능합니다: 차원, 축, 수준, 레이블, 임계값, 색상 및 점수 산정 방식; 이는 파일 내에 저장됩니다.
전체 분석은 자체 포함된 **`.rae.json`** 파일에 담깁니다: 그리드, 위험, 대책, 링크 및 초기/잔여 평가(3단계 모드에서는 현재 평가 포함). 형식은 **명세화**되어 있으며([기술 문서](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/SPEC-format-analyse-risque.md), 프랑스어), 검증을 위한 **JSON 스키마**([schema-analyse-risque.json](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/schema-analyse-risque.json))가 함께 제공됩니다. 속성 이름은 영어이며, 값(레이블, 설명)은 분석 자체의 언어로 유지됩니다.
**공식 웹사이트:** [www.risk-analysis-editor.com](https://www.risk-analysis-editor.com/) — 소개, 스크린샷 및 링크.
**YouTube 채널:** [@RiskAnalysisEditor](https://www.youtube.com/@RiskAnalysisEditor) — 비디오 튜토리얼.
**시작하기:** 그림이 포함된 **[사용자 가이드](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md)**(프랑스어)에서 모든 화면과 기능을 단계별로 안내합니다.
**진입점:** [온라인에서 앱 열기](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) — 또는 **오프라인**으로 사용하려면 저장소를 다운로드한 후 [`app/risk-analysis-editor.html`](https://github.com/stephanev/risk-analysis-editor/blob/main/app/risk-analysis-editor.html)을 간단히 더블클릭하여 여십시오.
### 방법론적 위치
RAE는 **위험 및 조치 등록부의 구조화, 평가 및 제시**에 초점을 맞춥니다: 점수 산정 그리드 정의, 초기 및 잔여 평가, 조치와 위험의 연결, 실행 계획 추적, 매트릭스 시각화 및 보고서 생성.
범용적이고 구성 가능한 모델 덕분에 ISO 27005, EBIOS RM, DPIA/PIA CNIL 또는 내부 프레임워크 등 다양한 접근 방식과 함께 작업할 수 있으며, 단일 방법론을 강요하지 않습니다. 제공되는 템플릿과 예시는 **이러한 접근 방식에서 영감을 받은** 것으로, 즉시 적용 가능한 출발점 역할을 합니다. 다만 RAE는 각 방법에 특유한 전체 단계, 객체 및 통제 항목을 재현하는 것을 목표로 하지 않습니다. 이들의 완전한 구현은 해당 프레임워크와 분석 맥락에 따라 안내됩니다.
따라서 RAE는 **스프레드시트 모음보다 더 구조화되고 일관된** 프레임워크를 제공하면서도, **GRC 플랫폼보다 더 가볍고 이식성이 뛰어나며 배포가 간단**합니다. 특히 독립적 분석, 워크숍, 컨설팅 프로젝트, 그리고 개방적이고 문서화된 형식으로 데이터에 대한 로컬 통제를 유지하고자 하는 조직에 적합합니다.
---
## 기능
### 시각화
- **나란히 배치된 두 개의 매트릭스**: *고유(총)* 위험과 *잔여(순)* 위험.
- **궤적 보기**: 화살표가 각 위험의 초기 위치와 잔여 위치를 연결하며, 감소되지 않은 위험이 강조됩니다.
- **궤적을 위한 레이아웃 알고리즘**으로 교차와 겹침을 줄이는 것을 목표로 합니다: 직선 화살표, 중앙 정렬 정사각형 그리드.
- 하나의 셀에 여러 위험이 있을 때의 **칩 레이아웃 전략**: 그리드, 행, 열, 클러스터/나선, "+N" 오버플로…
- 드래그 앤 드롭으로 칩을 **수동 배치**할 수 있으며, 구성 가능한 N×N 스냅 그리드와 파일에 저장되는 위치를 지원합니다.
- **대화형 칩**: 칩을 **클릭**하면 위험 레코드가 열려 편집할 수 있고, 다른 셀로 **드래그**하면 위험이 **재점수화**됩니다(키보드: `Enter`/`Space`로 편집, `Ctrl`+화살표로 재점수화).
- **통계 탭**: 수치 대시보드 — 주요 카운터, **심각도**별 분포(초기 → 잔여), 위험 **범주**별, 조치 **유형** 및 **상태**별, **사용자 정의 필드**별 분포, 그리고 **커버리지**(통제가 없는 위험, 고아 통제). 각 블록은 **표 및/또는 차트**(도넛 또는 파이)로 표시됩니다. 블록 토글, 크기, 모양을 **사용자 정의**할 수 있는 그리드로 **드래그 앤 드롭으로 재배치** 가능하며, 전파된 필터를 따르고 설정은 파일에 저장됩니다.
- **레이더**: **위험 프로필**을 레이더(거미줄) 차트로 보여주는 전용 탭 — **차원**(범주 또는 사용자 정의 필드)의 각 값마다 하나의 **축**, 여러 **지표**(평균, 최대, 누적 또는 가중 심각도, 위험 수) 및 **평가**(초기, 잔여, 나란히 또는 감소를 보여주기 위해 겹쳐서). 구성 가능한 렌더링(*설정 › 레이더*), 값 표, **PNG/SVG** 내보내기 및 보고서 포함, 전파된 필터를 따릅니다.
### 점수 산정 그리드
- **구성 가능한 축**(세로/가로): 자유로운 레벨 수, 레이블 및 툴팁 설명.
- **점수 계산 방식**: 곱(P × S), 합(P + S) 또는 **매트릭스**(셀 단위로 레벨을 정의하며, 전용 편집기 제공).
- **심각도 수준**: 색상 영역, 임계값, 색상, 수용 결정 및 설명과 함께 도달 가능한 점수에 대한 **커버리지 검사**.
- **2단계 또는 3단계 평가 수준** *(옵션, 분석별)*: 기존의 **초기 → 잔여** 모드와 함께 **내재적 → 현재 → 잔여** 모드(총 위험, 그다음 대책이 *적용된* 상태, 그다음 제안/계획/진행 중인 대책이 적용된 목표 상태). *설정 › 점수 산정 그리드*에서 전환하며, 데이터 입력, 등록부, **매트릭스**(나란히 보기 및 **3점 궤적**), **레이더**, **통계**, **보고서** 및 **Word/Excel/CSV** 내보내기에 적용됩니다. 기본값: 2단계(완전한 하위 호환성).
- **축 전환**(세로 ↔ 가로)을 클릭 한 번으로 수행하며, 평가 및 배치도 포함됩니다.
### 데이터 입력
- **개요**: 분석의 문서 메타데이터(제목, 상태, 작성자, 조직, 범위, 방법론 참조, 설명)와 분석 수준 사용자 정의 필드 값을 위한 전용 탭입니다.
- **위험 등록부**: 범주, 담당자, 설명, 초기 및 잔여 평가(3단계 모드에서는 **현재** 평가 포함), 변경 지표.
- **통제 / 조치**: 유형(기술적 / 조직적…), 상태(색상으로 구분), 책임자, 마감일, 비용.
- **위험 ↔ 조치 연결**, 두 개의 하위 탭으로 구성: *연결* (체크박스 교차 표, 다대다) 및 *세부 정보* (각 연결이 **메모**와 자체 **사용자 정의 필드**를 갖는 편집 가능한 등록부); 보강된 연결은 교차 표에서 표시됩니다.
- **실행 계획**: 세 가지 보기(타임라인, 상태별 칸반, 담당자별 그룹화)로 조치 추적, **기한 초과** 조치 강조 표시(마감일 경과 및 미완료), 그리고 **전체 진행률**(막대 + 상태별 카운터). 각 조치는 **더블 클릭**으로 — 또는 모든 행/카드의 **✎ 버튼**을 통해 — 편집용으로 열리며(마감일, 상태, 담당자, 메모, 사용자 정의 필드), 칸반에서는 상태 열 간에 **끌어서 놓기**가 가능합니다.
- **사용자 정의 필드**: *설정*에서 분석, 위험, 조치 또는 연결에 첨부되는 추가 필드를 정의합니다 — 다양한 유형(예/아니오, 정수, 소수, 날짜, 한 줄 텍스트, 긴 텍스트, URL, 이메일, 전화, 패턴 검사 텍스트, **색상**, **이미지**(임베디드, 클릭하여 확대하는 라이트박스가 있는 썸네일로 표시), 드롭다운, 체크리스트, 단일/다중 선택이 가능한 **색상 태그**, **척도**(계산에 사용 가능한 번호 매김 수준), % 단위의 **진행률 막대**, 그리고 **계산된 값**(다른 필드와 파생 수량에 대해 실시간으로 재계산되는 Excel 스타일 수식), 추가로 **참조** 유형 — 아래 참조), 다국어 레이블(레이블과 도움말은 활성 인터페이스 언어로 입력되며, 번역이 없으면 코드가 표시됨), 필수 플래그 및 범위(최소/최대, 길이, 항목 수), 그리고 목록(드롭다운, 체크리스트, 태그)의 경우 보고서의 **"필드 참조"** 섹션에 모아지는 **값별 설명**; 값은 레코드(위험, 조치)와 *개요* 탭(분석 필드)에서 검증과 함께 입력되며, **보고서**와 **CSV 가져오기/내보내기**에 포함됩니다.
- **객체 및 참조**: 단순한 사용자 정의 필드를 넘어, 자체 **객체 유형**(지원 자산, 비즈니스 가치, 이해관계자, 위험 원천, 데이터 수신자…)을 유형이 지정된 **속성**과 함께 정의한 다음, 전용 *객체* 탭(유형별 하위 탭, 정렬, CSV 가져오기/내보내기)에서 필요한 만큼 **인스턴스**를 생성합니다. 그런 다음 **참조** 필드가 위험, 조치, 연결, 분석 또는 다른 객체를 하나 이상의 인스턴스에 연결합니다 — 또는 분석 자체의 **위험/조치**에 연결하며, 클릭 가능한 **R*x*/M*x* 알약**(코드 + 레이블 툴팁)으로 표시됩니다. 참조는 필터, 통계 및 레이더에 반영되고, 보고서와 Word/Excel 내보내기에 나타나며, **연쇄 삭제** 덕분에 일관성을 유지합니다. **스키마 뷰어**([`tools/`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools/schema-viewer)에 있음)는 객체/참조 모델을 엔터티-관계 다이어그램으로 그립니다.
- 위험, 조치 및 연결의 **CSV 가져오기**: 형식의 **영어** 키 이름을 딴 열, 구분 기호 자동 감지; 식별자 기준 병합(위험/조치); 무결성 검사 및 중복 제거(연결).
- 위험, 조치 및 연결의 **CSV 내보내기**: 헤더 = **영어** 키 이름(인터페이스 언어와 무관하게 동일), `;` 구분 기호 및 UTF-8 BOM(Excel), 읽기 전용 파생 열 포함(위험의 경우 점수/심각도; 조치의 경우 커버된 위험; 연결의 경우 레이블); 재가져오기 가능.
- 위험, 조치 및 실행 계획 목록의 **정렬 및 필터링**: 텍스트 검색, 열 클릭으로 정렬(오름차순 → 내림차순 → 원래 순서), 드롭다운 필터(범주, 유형, 상태, 담당자, "기한 초과만"). 정렬이 활성화되지 않은 경우 행은 **끌어서 놓기**로 재정렬할 수 있습니다(행을 마우스로 가리키면 ⠿ 핸들 표시, 키보드로 Ctrl+↑/↓): 새 순서는 파일에 저장되며 기본 표시, 보고서 및 내보내기를 결정합니다.
- **전파 필터링**: 드롭다운 필터는 **카테고리**(위험), **유형** 및 **상태**(조치)와 *필터로 사용 가능*으로 선언된 모든 **사용자 정의 필드**(닫힌 값: 드롭다운, 체크리스트, 태그, 예/아니오)에 대해 제공되며, **링크를 따라 전파**됩니다 — 모든 탭, 매트릭스 및 보고서를 제한합니다: 위험에 대한 필터링은 해당 위험과 관련된 조치 및 링크만 유지하며, 조치 필터에 대해서도 대칭적으로 적용됩니다. 기준은 결합(AND)되며, 각 활성 전파 필터는 적용되는 모든 바에서 **표시되고 편집 가능**한 상태로 유지됩니다. 전파 필터(기본 + 사용자 정의 필드)는 **파일에 저장**되며 분석을 다시 열 때 복원됩니다. 텍스트 검색과 Action plan 전용 필터(*담당자*, *기한 초과*)는 해당 뷰에 국한됩니다.
- **입력 보조 및 안전 장치**: 위험 또는 조치의 원클릭 **복제**(⧉), 일괄 입력을 위한 **"저장 후 새로 만들기"**, 모든 삭제 후 **"실행 취소"** 토스트, 참조된 레코드를 여는 클릭 가능한 R*x*/M*x* 알약, 링크 확인에 대한 선택적 *"다시 묻지 않음"*, 이미 평가된 그리드를 편집할 때의 경고, 그리고 **도움말 및 단축키** 패널(파일 메뉴 또는 `?` 키).
- **레지스터 뷰 및 열**(위험, 조치, 링크 세부 정보, 객체): 각 레지스터는 **아이콘 선택기**에서 선택하는 세 가지 표시 방식을 제공합니다 — **테이블**, **마스터·디테일**(간결한 목록 + 행별 **세부 정보 서랍**) 및 **카드**(레코드당 하나의 카드) — 그리고 **밀도** 제어(편안함 / 간결함 / 조밀함)를 제공합니다. 3단계 **열 관리자**(모든 뷰에서 사용 가능한 툴바의 **⚙ 열** 버튼)는 각 열 — **사용자 정의 필드 열** 포함 — 을 **인라인**(테이블 및 마스터·디테일의 열이자 카드에 표시됨), **세부 정보에**(테이블에서 숨겨지고 마스터·디테일 서랍으로 이동되며 카드에는 계속 표시됨) 또는 **숨김**(모든 곳에서)으로 설정합니다. 기본적으로 앱은 각 열을 인라인 또는 세부 정보에로 자동 분류하며(긴 텍스트 및 보조 필드는 세부 정보에로 이동), 숨김으로는 절대 분류하지 않습니다. 열은 ▲/▼ 화살표 또는 헤더를 드래그하여 재정렬됩니다. ID와 작업은 고정된 상태로 유지됩니다. **전체 너비** 옵션과 **"정렬 기준 ▾"** 메뉴(헤더가 없는 곳, 예: 카드에서 정렬하기 위한)가 이를 완성합니다. 링크 **노트는 세 가지 뷰 모두에서 Markdown으로 렌더링**됩니다. **편집:** 한 번 클릭은 아무 동작도 하지 않으며(잘린 긴 텍스트는 확대되고, 이미지는 라이트박스로 열림), 필드를 **두 번 클릭**하면 모든 뷰에서 해당 필드에 위치한 레코드가 열립니다 — Action plan에는 명시적인 **✎ 버튼**이 있습니다. 전체 레이아웃 — 뷰, 밀도, 열 상태 및 순서 — 은 **파일에 저장**됩니다(`extensions.display`).
### 파일 및 내보내기
- `.rae.json` 형식의 **새로 만들기 / 불러오기 / 저장**.
- **URL로 불러오기**: `?file=<url>`(별칭 `?url=`)로 도구를 열면 시작 시 지정된 분석이 자동으로 로드됩니다 — 예: `risk-analysis-editor.html?file=../examples/demo-ebios-rm-information-system.rae.json`. 도구가 HTTP(S)를 통해 제공되어야 합니다(`file://` 프로토콜은 이 읽기를 차단합니다).
- **시작 URL 매개변수** (조합 가능): `?lang=fr|en|it`는 인터페이스 언어를 강제합니다(파일에 저장된 언어와 브라우저 언어를 재정의). `?tab=<tab>[.<sub-tab>]`는 지정된 탭과 선택적으로 그 하위 탭을 엽니다 — 예: `?tab=matrices.traj` (매트릭스 › 궤적), `?tab=settings.grid`, `?tab=plan`. `?filter=code:value;…`는 사용자 정의 필드 필터를 적용합니다(저장된 필터의 사용자 정의 필드 부분을 재정의한 후 주소 표시줄에서 제거됩니다). 알 수 없는 토큰은 무시됩니다.
- **매트릭스 내보내기**: **PNG**(×1 / ×2 / ×3) 및 **SVG** 형식으로, 제목, 부제목, 축 레이블, 범례를 포함합니다. 이 기능이 지원되고 브라우저와 런타임 컨텍스트에서 허용되는 경우 클립보드로 복사할 수 있습니다.
- 보고서의 **Word 내보내기(.docx)** 및 분석의 **Excel 내보내기(.xlsx)**: *파일* 메뉴(Word의 경우 *보고서* 탭의 버튼). Word 파일은 보고서에 구성된 섹션, 그 순서, 열, 범위를 재사용하며, **표지 페이지**, 필요 시 열 때 새로 고칠 수 있는 Word 기본 **목차**, **기본 페이지 머리글/바닥글**(페이지 번호 포함)을 추가합니다 — 메타데이터, 프레젠테이션, 요약, 그리드, **이미지로 삽입된 매트릭스**, 등록부 및 상세 시트 — 기업 템플릿에 통합하기 위한 기반으로 사용할 수 있습니다. Excel 통합 문서에는 스타일이 적용된 시트(요약 / 리스크 / 대책 / 링크, **더불어 객체 유형별 시트 하나씩**)가 있으며, 형식이 지정된 셀(실제 날짜와 숫자), 심각도 및 상태 색상, 고정된 머리글 행, 자동 필터가 포함됩니다. 두 파일 모두 **로컬에서 오프라인으로** 생성됩니다: 직접 작성한 OOXML과 ZIP 컨테이너용으로 내장된 MIT 라이선스 [fflate](https://github.com/101arrowz/fflate) 라이브러리 — 여전히 단일 HTML 파일로 배포되며 런타임에 외부 리소스가 필요하지 않습니다.
- **인쇄 가능한 보고서**: *보고서* 탭은 RAE에서 관리되는 정보(메타데이터, 분석 설명과 사용자 정의 필드가 포함된 **개요 블록**, 요약, 그리드 및 설명이 포함된 심각도 수준, **필드 참조 및 범례**(문서화된 드롭다운/태그 값), 벡터로 표현된 초기/잔여 및 궤적 매트릭스, 리스크 등록부, 설명 **및 사용자 정의 필드 값**이 포함된 상세 리스크 및 대책 목록, 링크)로부터 구성 가능한 보고서를 생성하며, 밝고 인쇄에 적합한 스타일로 렌더링됩니다(→ 브라우저를 통해 PDF로).
- **사용자 정의 가능한 보고서** (*설정 › 보고서*): **섹션**과 그 **순서**(드래그 앤 드롭), **표지 페이지**(로고, 제목, 부제목, 공지, 기밀 표시, 자유 텍스트), **목차**, 변수(`{title}`, `{date}`, `{page}/{pages}`…)가 포함된 3구역 **머리글/바닥글**, 각 표의 **열**, 메타데이터 행, 초기/잔여 매트릭스 레이아웃(나란히 또는 세로로 쌓기) 및 실행 계획 보기, 그리고 **범위**(전체 분석 또는 필터링된 하위 집합)를 선택할 수 있습니다. 동일한 구성이 **화면/PDF** 및 **Word** 렌더링(기본 목차와 머리글/바닥글 포함)의 섹션, 그 순서, 열, 범위를 결정하며, 파일에 저장됩니다(`extensions.display.report`).
- **Word 템플릿 보고서 생성기**: *파일 › Word 템플릿으로 내보내기…*는 **사용자 자신의 `.docx` 템플릿**을 채웁니다 — `{{ … }}` **태그**(값, 반복, 조건, `matrix` / `radar` / `stat` / `table` 블록, 로고…)가 분석 데이터로 대체되면서 문서는 전체 레이아웃을 그대로 유지합니다. **경고 보고서**는 인식되지 않은 태그를 표시합니다. **바로 사용할 수 있는 템플릿**(클래식, 카테고리별 분할, 참조 시트, 대시보드, 기본 보고서의 충실한 재현)이 [`word-templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates)에 제공되며, **[작성 가이드](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/guide-redaction-modeles.md)** 및 **[키워드 카탈로그](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/catalogue-mots-cles-rapport.md)**와 함께 제공됩니다.
### 사용자 지정
- **테마**: 다크, 라이트.
- **언어 선택기**: 프랑스어 / 영어 / 이탈리아어(인터페이스 및 새 분석의 기본 데이터), 다른 언어로 확장 가능한 아키텍처.
---
## 프로젝트 구조
| 폴더 | 내용 |
|---|---|
| [`app/`](https://github.com/stephanev/risk-analysis-editor/blob/main/app) | 애플리케이션(`risk-analysis-editor.html`). |
| [`docs/`](https://github.com/stephanev/risk-analysis-editor/blob/main/docs) | **사용자 문서**(프랑스어): 그림이 포함된 [사용자 가이드](https://github.com/stephanev/risk-analysis-editor/blob/main/docs/guide-utilisateur.md) 및 공용 이미지. |
| [`specs/`](https://github.com/stephanev/risk-analysis-editor/blob/main/specs) | **사양서**(프랑스어): 파일 형식 사양, JSON 스키마, 레이아웃 전략 및 **Word 보고서 생성기 사양**([`SPEC-rapport-modele-word.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/specs/SPEC-rapport-modele-word.md)). |
| [`examples/`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples) | `.rae.json` 형식의 샘플 분석(프랑스어 및 영어). 여기에는 **RAE의 기능을 대표하는 채워진 데모 두 개**가 포함됩니다: **EBIOS RM에서 영감을 받은** 위험 분석(`demo-ebios-rm-*.rae.json`)과 산업보건 서비스를 위한, CNIL PIA 방법에서 영감을 받은 DPIA의 위험 분석 부분 예시(`demo-aipd-sst.rae.json` / `demo-dpia-ohs.rae.json`) — 색상 태그, 진행 표시줄, 담당자 및 근거가 표시된 링크 포함. 각 데모는 비즈니스 가치/데이터, 지원 자산, 위험 원천, 이해관계자 및 시나리오를 모델링하고 사전 구성된 보고서를 갖춘 **강화된 "객체" 변형**(`…-objets-enrichi` / `…-enriched`)으로도 제공됩니다. [`examples/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples/README.md)를 참조하세요. |
| [`templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/templates) | 일반적인 방법론과 프레임워크에서 영감을 받은 분석을 위한 **시작 템플릿**(`xxx.template.<lang>.rae.json`, 언어별 파일 하나): 빈 골격 — 그리드, 심각도 수준 및 사용자 지정 필드가 사전 구성되어 있으며 위험이나 대책은 없음. **EBIOS RM**, **CNIL PIA / DPIA**, **ISO/IEC 27005** 및 **일반** 5×5 — 그리고 객체 유형과 사전 구성된 보고서를 갖춘 **강화된 EBIOS RM / CNIL PIA 변형** — 각각 **프랑스어, 영어, 이탈리아어**로 제공됩니다. 온보딩 블록의 *템플릿에서 시작* 아래에 나열됩니다(현재 인터페이스 언어와 일치하는 파일이 로드됨). 템플릿을 열면(해당 위치 또는 *불러오기…*를 통해) 새롭게 **연결되지 않은** 분석이 시작됩니다. **파일 › 템플릿으로 저장…**으로 현재 분석을 템플릿으로 전환하고, **파일 › 홈 화면**으로 온보딩 블록으로 돌아갈 수도 있습니다. |
| [`word-templates/`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates) | 템플릿 기반 보고서 생성기용 **Word 보고서 템플릿**(`.docx`): `{{ … }}` 태그가 분석의 값, 표, 매트릭스, 레이더 및 차트로 대체됩니다. *클래식*, *카테고리별 분할*, *참조 시트*, *대시보드* 템플릿과 기본 보고서의 충실한 재현(깔끔한 버전 및 **주석** 버전), 그리고 **작성 가이드**와 **키워드 카탈로그**. [`word-templates/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/word-templates/README.md)를 참조하세요. |
| [`tools/`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools) | **개발 도구**: 스크린샷(가이드 및 README) 생성 및 템플릿을 애플리케이션에 내장하는 스크립트. [`tools/README.md`](https://github.com/stephanev/risk-analysis-editor/blob/main/tools/README.md)를 참조하세요. |
---
## 시작하기
1. [온라인에서 앱 열기](https://stephanev.github.io/Risk-Analysis-Editor/app/risk-analysis-editor.html) — 또는 로컬 사본에서 최신 브라우저로 [`app/risk-analysis-editor.html`](https://github.com/stephanev/risk-analysis-editor/blob/main/app/risk-analysis-editor.html)을 엽니다.
2. 도구는 **빈 분석**으로 시작하며, **개요** 탭이 열립니다.
3. **불러오기…**를 사용하여 `.rae.json` 파일(예: [`examples/`](https://github.com/stephanev/risk-analysis-editor/blob/main/examples)의 파일)을 열고, **저장**으로 자신의 파일을 내보냅니다.
---
## 브라우저 지원
**필수 조건**: JavaScript가 활성화된 최신 데스크톱 브라우저(에버그린 버전) — 그 외에는 아무것도 필요하지 않습니다. 서버, 네트워크 액세스, 설치가 필요 없으며, 앱은 간단히 `file://`을 두 번 클릭하여 실행됩니다. **URL로 불러오기**(`?file=…`)만 도구가 HTTP(S)를 통해 제공되어야 합니다.
개발 및 테스트는 주로 **Microsoft Edge(Chromium)**로 수행됩니다. Chromium 기반의 최신 데스크톱 브라우저(Chrome, Edge, Opera, Brave…)가 주로 테스트되는 환경이며 가장 완전한 경험을 제공합니다. 다른 엔진과의 알려진 차이점:
- **Firefox / Safari** — File System Access API(`showSaveFilePicker`)를 사용할 수 없습니다. *저장*은 열린 파일에 직접 쓰는 대신 `.rae.json` 파일의 표준 **다운로드**로 대체되며(그리고 *불러오기*는 기존의 파일 선택기로 대체됩니다), Firefox와 Safari에서도 주요 기능은 그대로 사용할 수 있지만 클립보드, 파일 처리, 인쇄, 생성된 문서의 렌더링 등에서 차이가 있을 수 있습니다.
- **구버전 Firefox(< 127)** — 행렬을 **이미지로** 클립보드에 복사하는 것(`ClipboardItem`)은 지원되지 않습니다. PNG 및 SVG 다운로드 버튼은 계속 사용할 수 있습니다.
- **터치 기기** — 드래그 앤 드롭 상호작용(칩, 칸반, 열 머리글)은 마우스 사용을 전제로 합니다. 키보드 및 메뉴 대안이 존재하지만(칸반과 행렬에서 Ctrl+방향키, 열 메뉴에서 ▲/▼ 화살표), 이 도구는 데스크톱 사용을 위해 설계되었습니다.
---
## 서드파티 코드
RAE는 정확히 **하나의 서드파티 라이브러리**를 내장하고 있습니다: [**fflate** v0.8.2](https://github.com/101arrowz/fflate)(MIT 라이선스, © Arjun Barrett)로, 작고 빠른 ZIP/deflate 구현입니다. 이 라이브러리는 Word(`.docx`) 및 Excel(`.xlsx`) 내보내기에 필요한 ZIP 컨테이너를 제공합니다 — OOXML 파일은 XML 파트들의 ZIP 아카이브이기 때문입니다. 이 라이브러리는 라이선스 고지와 함께 HTML 파일에 **인라인으로 벤더링**되어 있어, 런타임에 외부 리소스가 필요 없이 앱이 완전히 오프라인으로 동작합니다. 그 외의 모든 것(Markdown 엔진, SVG/PNG 내보내기, OOXML 생성, UI 컴포넌트)은 이 프로젝트를 위해 처음부터 작성되었습니다.
---
## 개발
이 프로젝트는 **[Claude Code](https://claude.com/claude-code)**(Anthropic)와 **Claude Opus 4.8** 모델을 사용하여 작성자의 지휘 아래 개발되었습니다.
---
## 버그 및 아이디어 제보
버그를 발견했거나 제안할 사항이 있으신가요? [GitHub 이슈를 열어주세요](https://github.com/StephaneV/Risk-Analysis-Editor/issues). 버그의 경우 브라우저와 OS, 앱 버전(*About*에 표시됨), 예상한 동작, 실제로 발생한 동작, 그리고 가능하다면 문제를 재현하는 최소한의 `.rae.json`을 포함해 주세요(GitHub는 `.json` 첨부 파일을 직접 허용하지 않으므로 압축하거나 코드 블록에 붙여넣어 주세요).
---
## 라이선스
**MIT** 라이선스로 배포됩니다 — [`LICENSE`](https://github.com/stephanev/risk-analysis-editor/blob/main/LICENSE)를 참조하세요.
© 2026 Stéphane Vinter