**`[email protected]`** / **`adminpass`**로 로그인하세요. 첫 로그인 시 **데모 데이터 언어**(🇩🇪 DE / 🇬🇧 EN / 🇫🇷 FR / 🇳🇱 NL)를 선택하거나 빈 시스템으로 시작하라는 메시지가 표시됩니다. 로그인 직후 관리자 비밀번호를 변경하세요.

HTTPS를 사용한 프로덕션 환경의 경우:```bash
# .env
JWT_SECRET=your-very-long-random-secret
STORAGE_BACKEND=json
SSL_CERT_FILE=/etc/ssl/certs/your.crt
SSL_KEY_FILE=/etc/ssl/private/your.key

항상 변경 전에 백업(`data.bak.<timestamp>/`, `data/` 디렉터리 옆에 생성)을 만들며, `STORAGE_BACKEND`는 절대 건드리지 않습니다. 이는 데모 인스턴스용으로 설계된 앱 내 "데모 리셋" 관리자 작업과 달리, 해당 작업은 역사적 이유로 여전히 `sqlite`로 전환됩니다([Issue #42](https://github.com/coolstartnow/isms-builder/issues/42) 참조).

---

## Docker

모든 릴리스는 GitHub Container Registry의 GitHub Package로 게시되며, `linux/amd64` 및 `linux/arm64`용으로 제공됩니다. 태그는 `:latest` 및 `:<version>`(예: `:1.37.5.2`)입니다:```bash
docker compose up -d
# App runs at http://localhost:3000

이것이 기본 설정으로, 데이터를 `./data`에 일반 JSON 파일로 저장합니다 — 데이터베이스 컨테이너가 전혀 필요 없습니다.
소규모 팀에 권장되는 설정이며, 위의 두 명령어가 사용하는 방식이기도 합니다.

**JSON 대신 PostgreSQL(또는 MariaDB) 사용하기.** 이미지는 이 기능을 기본 지원하지만 —
위의 JSON 설정과 달리 — 두 번째 컨테이너(실제 데이터베이스)와 앱이 데이터베이스에 연결하는 방법을 알려주는
몇 가지 환경 변수가 필요합니다. 이미지만 가져왔다면(`docker pull ghcr.io/coolstartnow/isms-builder`)
이 저장소를 클론한 적이 없을 경우, 해당 변수 이름은 기본적으로 어디에도 표시되지 않습니다 — 해당 변수들이 문서화된
`docker-compose.yml`과 `.env.example`은 이 Git 저장소의 파일이지 이미지의 일부가 아니기 때문입니다.
이 섹션은 그 정보가 저장소 전용 비밀로 남지 않도록 하기 위해 존재합니다.

`isms-builder` 이미지 자체에는 데이터베이스 서버가 절대 포함되지 않습니다 — `postgres:17`(또는 `mariadb:11`)은
Docker Hub에서 가져온 완전히 범용적인 빈 데이터베이스 엔진으로, 이 프로젝트의 테이블에 대해 전혀 알지 못합니다.
그 테이블들(위험, 자산, SoA 통제 항목 등)은 애플리케이션이 시작되어 빈 데이터베이스를 발견하는 순간
자동으로 생성됩니다 — 수동 SQL 가져오기나 별도로 실행해야 하는 마이그레이션 단계가 없습니다.
전체 메커니즘을 알고 싶다면 아래의 "데이터베이스 스키마는 어떻게 생성되나요?"를 참조하세요.

두 개의 컨테이너, 하나의 공유 Docker 네트워크, 그리고 앱에 데이터베이스 위치를 알려주면 됩니다:```bash
# 1) An isolated network so the two containers can reach each other by name
docker network create isms-net

# 2) The database — empty until the app first connects and creates its tables
docker run -d --name isms-postgres --network isms-net \
  -e POSTGRES_DB=isms_builder \
  -e POSTGRES_USER=isms \
  -e POSTGRES_PASSWORD="$(openssl rand -hex 16)" \
  -v isms-postgres-data:/var/lib/postgresql/data \
  postgres:17-alpine

# 3) The app, pointed at that database by container name (isms-postgres) via
#    Docker's built-in DNS on the shared network — no host/port juggling needed
docker run -d --name isms-builder --network isms-net -p 3000:3000 \
  -e JWT_SECRET="$(openssl rand -hex 32)" \
  -e STORAGE_BACKEND=postgres \
  -e DB_HOST=isms-postgres \
  -e DB_PORT=5432 \
  -e DB_USER=isms \
  -e DB_PASS="<same password as POSTGRES_PASSWORD above>" \
  -e DB_NAME=isms_builder \
  ghcr.io/coolstartnow/isms-builder:latest

---

## 요구 사항

- **Node.js 18+** (테스트 완료: 18, 20, 22)
- npm 9+
- (선택 사항) Docker + Docker Compose
- (선택 사항) 로컬 AI 의미 검색용 [Ollama](https://ollama.ai)

---

## 구성 (`.env`)

| 변수 | 기본값 | 설명 |
|---|---|---|
| `JWT_SECRET` | *(필수)* | JWT 서명용 비밀 키 — 32자 이상의 임의 문자 사용 |
| `PORT` | `3000` | HTTP/HTTPS 수신 포트 |
| `STORAGE_BACKEND` | `json` | `json`(개발/데모) 또는 `sqlite`(프로덕션) |
| `SSL_CERT_FILE` | — | TLS 인증서 경로 → HTTPS 활성화 |
| `SSL_KEY_FILE` | — | TLS 개인 키 경로 |
| `DATA_DIR` | `./data` | 데이터 디렉터리 재정의(Docker 볼륨) |
| `SMTP_HOST` | — | 이메일 알림용 SMTP 서버 |
| `SMTP_PORT` | `587` | SMTP 포트 |
| `SMTP_USER` | — | SMTP 사용자 이름 |
| `SMTP_PASS` | — | SMTP 비밀번호 |
| `SMTP_FROM` | — | 알림 발신자 주소 |

---

## 아키텍처```
server/
  index.js          — Express app setup, router mounts
  auth.js           — JWT auth, RBAC ranks, session
  routes/           — 17 Express route modules (one per domain)
  db/               — Data stores (jsonStore / sqliteStore / orgSettingsStore / …)
  ai/               — Semantic search (embedder, embeddingStore, lexicalSearch)
  reports.js        — Report generation logic
ui/
  index.html        — SPA shell (Atlassian Dark Theme)
  app.js            — All render functions, ~6000 lines vanilla JS
  style.css         — CSS variables, dark theme
data/               — JSON files / SQLite DB (gitignored)
docs/
  ISMS-build-documentation.md  — Full architecture reference
  architecture/                — C4 diagrams, data model, OpenAPI 3.0.3 spec
tests/              — Jest + Supertest (176 tests, --runInBand)

테스트는 격리된 임시 디렉터리를 사용합니다 — 운영 데이터는 건드리지 않습니다.

---

## 기여

기여는 언제나 환영합니다! [CONTRIBUTING.md](https://github.com/coolstartnow/isms-builder/blob/main/CONTRIBUTING.md)에서 다음 내용을 확인하세요:

- 개발 환경 설정 (첫 테스트 실행까지 5분)
- 코드 스타일 및 규칙
- 좋은 이슈 또는 PR을 여는 방법

**보안 문제를 발견하셨나요?** 공개 이슈를 열지 말고
[비공개 취약점 보고](https://github.com/coolstartnow/isms-builder/security/advisories/new)를 이용해 주세요.
[SECURITY.md](https://github.com/coolstartnow/isms-builder/blob/main/SECURITY.md)에는 범위, 안전한 기여 범위, 현실적인 기대치가 설명되어 있습니다.

**첫 기여에 좋은 이슈**는 이슈 트래커에서 [`good first issue`](https://github.com/coolstartnow/isms-builder/issues?q=label%3A%22good+first+issue%22) 라벨로 표시되어 있습니다.

---

## 로드맵

| 상태 | 기능 |
|---|---|
| ✅ 완료 | 의미 기반 검색 (Ollama / nomic-embed-text) |
| ✅ 완료 | SQLite 백엔드, Docker, CI/CD |
| ✅ 완료 | GDPR 삭제 로그 이메일 알림 |
| ✅ 완료 | 다국어 데모 번들 (DE / EN / FR / NL) |
| ✅ 완료 | 감사 발견 사항 모듈 및 실행 계획 (V 1.37.2.0) |
| ✅ 완료 | FR/NL 가이드 번역 + 관리자 언어 설정 (V 1.37.2.0) |
| ✅ 완료 | MariaDB/MySQL 백엔드 (`STORAGE_BACKEND=mariadb`, V 1.37.2.1) |
| ✅ 완료 | 스캐너 → 위험 초안 (Greenbone/OpenVAS XML + PDF 가져오기, V 1.37.2.0) |
| ✅ 완료 | 정책 승인 — 직원이 감사 추적과 함께 정책을 디지털로 확인 (V 1.37.2.0) |
| ✅ 완료 | 가이드 CRUD — 자체 문서 생성, 편집 및 업로드 (V 1.37.2.0) |
| ✅ 완료 | 가이드 검색 — 발췌문 포함 카테고리 간 전체 텍스트 검색 (V 1.37.2.0) |
| ✅ 완료 | 자산 보호 목표 — CIA + 무결성(진위성) (1–4), 종속성 및 BSI 최대 원칙 상속 (V 1.37.2.0) |
| ✅ 완료 | NIS2 제21조 거버넌스 체크리스트 (30개 항목) 및 제23조 보고 기한 자동 알림 (V 1.37.2.0) |
| ✅ 완료 | PostgreSQL 백엔드 (`STORAGE_BACKEND=pg`) — MariaDB와 동일한 Knex 저장소 계층, 실제 PostgreSQL 17 인스턴스 및 전체 `docker compose` 경로로 검증됨 (V 1.37.5) |
| ✅ 완료 | ownCloud / Nextcloud 통합 — 승인된 정책이 WebDAV를 통해 PDF로 자동 게시, 선택적 즐겨찾기/공개 링크 표시, 실제 NextcloudPi 인스턴스에서 실시간 검증됨 (#66, V 1.37.5.1) |
| ✅ 완료 | 릴리스마다 GitHub Container Registry에 Docker 이미지 게시 (`ghcr.io/coolstartnow/isms-builder`, `linux/amd64` + `linux/arm64`, 서명된 빌드 출처) — @bucherfa 기여 (#71, V 1.40.0). 유지보수 비용 시험: 예상보다 관리 부담이 크면 다시 제거할 수 있음. |
| 🔜 다음 | AI 정책 어시스턴트 — Ollama가 제목 + 프레임워크에서 정책 내용 초안 작성 |
| 🔜 다음 | 예약 보고서 — 주간/월간 규정 준수 보고서 이메일 전송 |
| 🔜 다음 | 감사 로그 이상 탐지 (LLM 배치) |
| 🚀 이후 | 정량적 위험 점수 산정 (€ 가치, FAIR 기반) |
| 🚀 이후 | 감사자 협업 포털 — 감사자를 위한 외부 읽기 전용 액세스 |
| 🚀 이후 | 정책 격차 분석 (LLM) |
| 🏁 V 2.x | 구성 가능한 가이드 카테고리 — 관리자가 사용자 정의 카테고리 정의 (예: 워크플로, 조직 문서) |

---

## 저자 소개

**Claude Hecker**는 35년 이상 IT 분야에서 일해 왔습니다. 약 15년간 CIO로 근무한 후
CISO 및 데이터 보호 책임자(DSO/DSB) 역할로 전환했습니다. 경력 동안
유럽의 주요 기업을 위해 전사적 IT 인프라와 광역 네트워크 연결
(VPN, MPLS)을 설계하고 구현했습니다 — 여러 사이트와 관할 구역에 걸친 안정적이고 안전한 운영을 책임졌습니다.

ISMS Builder는 바로 그 경험에서 탄생했습니다: 실제 감사와 실제 규제 압력 속에서
규정을 준수하는 ISMS를 구축하고 유지하는 일. 이 도구는 실무자가 실제로
필요로 하는 것을 반영합니다 — 제품 관리자가 필요하다고 생각하는 것이 아니라요.

**왜 오픈 소스인가?**
중소기업은 다섯 자릿수 라이선스 비용 없이 제대로 된 ISMS 플랫폼에 접근할 자격이 있습니다.
어떤 도구를 선택하든 온보딩 노력은 실제로 필요합니다 — 하지만 그 비용에 벤더
종속이나 데이터가 자체 인프라를 벗어나는 것이 더해져서는 안 됩니다. 이 프로젝트는 소프트웨어 자유와
규정 준수 데이터가 사용자 자신의 것이라는 원칙을 지지합니다.

---

## 표준 참조 고지

이 소프트웨어는 상호 운용성 및 규정 준수 관리 목적으로만
게시된 표준의 통제 식별자와 짧은 제목을 참조합니다.

- **ISO/IEC 27001, ISO 9000, ISO 9001**은 국제표준화기구(ISO)가 발행한
  표준입니다. 이러한 표준의 통제 정의는 **이 소프트웨어 배포판에 포함되어 있지 않습니다** —
  ISO 저작권은 통제 텍스트의 재배포를 허용하지 않습니다. 사용자는
  자체 JSON 파일을 제공해야 합니다 (위 섹션 및 `scripts/import-iso-controls.sh` 참조).
  표준은 [ISO](https://www.iso.org/) 또는 공인된 국가 배포 기관에서
  구해야 합니다.
- **BSI IT-Grundschutz** 자료는 독일 연방 정보보안청(BSI)이 발행하며
  [bsi.bund.de](https://www.bsi.bund.de)에서 무료로 이용할 수 있습니다.
- **NIS2, CRA, EUCS, EU AI Act**는 EU 법률이며
  [eur-lex.europa.eu](https://eur-lex.europa.eu)를 통해 공개적으로 이용할 수 있습니다.

---

## 라이선스

Copyright (C) 2026 Claude Hecker

이 프로그램은 [GNU Affero General Public License v3.0](https://github.com/coolstartnow/isms-builder/blob/main/LICENSE)에 따라
라이선스된 자유 소프트웨어입니다.

수정된 버전을 네트워크 서비스로 실행하는 경우 해당 서비스의 사용자에게
전체 소스 코드를 제공해야 합니다 (AGPL §13).

이 프로젝트에는 MIT, BSD-2-Clause 및 Apache-2.0 라이선스의 타사 구성 요소가 포함되어 있습니다.
전체 저작자 표시 및 라이선스 텍스트는 [THIRD-PARTY-LICENSES.md](https://github.com/coolstartnow/isms-builder/blob/main/THIRD-PARTY-LICENSES.md)를 참조하세요.