使用 **`[email protected]` / `adminpass`** 登录。首次登录时，系统会提示您选择**演示数据语言**（🇩🇪 德语 / 🇬🇧 英语 / 🇫🇷 法语 / 🇳🇱 荷兰语），或从空系统开始。请立即更改管理员密码。

如需在生产环境中使用 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 包发布到 GitHub 容器注册表中，支持 `linux/amd64` 和 `linux/arm64`——标记为 `:latest` 和 `:<version>`（例如 `:1.37.5.2`）：```bash
docker compose up -d
# App runs at http://localhost:3000

这是默认配置，将数据以纯 JSON 文件形式存储在 `./data` 中——完全不需要数据库容器。这是小型团队的推荐设置，上述两条命令使用的正是这种方式。

**使用 PostgreSQL（或 MariaDB）替代 JSON。** 该镜像开箱即用地支持这一点，但与上述 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
- （可选）[Ollama](https://ollama.ai)，用于本地 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 分钟即可完成首次测试运行）
- 代码风格与约定
- 如何提交高质量的 issue 或 PR

**发现安全问题？** 请勿公开提交 issue——请使用
[私有漏洞报告](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） |
| ✅ 已完成 | 每次发布后将 Docker 镜像发布至 GitHub Container Registry（`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** 从事 IT 工作已超过 35 年。在担任 CIO 约 15 年后，
他转型担任 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** 是欧盟立法法案，
  可通过 [eur-lex.europa.eu](https://eur-lex.europa.eu) 公开获取。

---

## 许可证

版权所有（C）2026 Claude Hecker

本程序为自由软件，依据
[GNU Affero 通用公共许可证 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)。