Вход с **`[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 Package в GitHub Container Registry для
`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) для локального семантического поиска на основе ИИ

---

## Конфигурация (`.env`)

| Переменная | По умолчанию | Описание |
|---|---|---|
| `JWT_SECRET` | *(обязательно)* | Секрет для подписи JWT — используйте 32+ случайных символа |
| `PORT` | `3000` | Порт прослушивания HTTP/HTTPS |
| `STORAGE_BACKEND` | `json` | `json` (dev/demo) или `sqlite` (production) |
| `SSL_CERT_FILE` | — | Путь к TLS-сертификату → включает HTTPS |
| `SSL_KEY_FILE` | — | Путь к приватному ключу TLS |
| `DATA_DIR` | `./data` | Переопределение каталога данных (тома Docker) |
| `SMTP_HOST` | — | SMTP-сервер для email-оповещений |
| `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 |
| ✅ Готово | Email-оповещения журнала удаления 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) |
| ✅ Готово | Сканер → черновик риска (импорт XML и PDF Greenbone/OpenVAS, 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`) — тот же слой хранения Knex, что и MariaDB, проверен на реальном экземпляре PostgreSQL 17, включая полный путь `docker compose` (V 1.37.5) |
| ✅ Готово | Интеграция ownCloud / Nextcloud — утверждённые политики автоматически публикуются в PDF через WebDAV, опциональная видимость избранного/публичной ссылки, проверено вживую на реальном экземпляре NextcloudPi (#66, V 1.37.5.1) |
| ✅ Готово | Docker-образ публикуется в GitHub Container Registry после каждого релиза (`ghcr.io/coolstartnow/isms-builder`, `linux/amd64` + `linux/arm64`, подписанная provenance сборки) — вклад @bucherfa (#71, V 1.40.0). Пробная оценка затрат на сопровождение: будет удалён снова, если окажется, что требует больше усилий, чем ожидалось. |
| 🔜 Далее | AI-помощник по политикам — Ollama создаёт черновик политики на основе названия и фреймворка |
| 🔜 Далее | Плановые отчёты — еженедельный/ежемесячный отчёт о соответствии, доставляемый по email |
| 🔜 Далее | Обнаружение аномалий в журнале аудита (LLM-пакетная обработка) |
| 🚀 Позже | Количественная оценка рисков (значения в €, вдохновлено FAIR) |
| 🚀 Позже | Порталы сотрудничества с аудиторами — внешний доступ только для чтения для аудиторов |
| 🚀 Позже | Анализ пробелов в политиках (LLM) |
| 🏁 V 2.x | Настраиваемые категории руководств — администраторы определяют собственные категории (например, рабочие процессы, документы организации) |

---

## Об авторе

**Клод Хеккер** работает в IT более 35 лет. После примерно 15 лет на посту CIO
он перешёл на роли CISO и сотрудника по защите данных (DSO/DSB). За свою карьеру
он проектировал и внедрял корпоративную IT-инфраструктуру и широкополосные сетевые соединения
(VPN, MPLS) для крупной европейской корпорации — отвечая за надёжную, безопасную работу на
нескольких площадках и в нескольких юрисдикциях.

ISMS Builder вырос непосредственно из этого опыта: построение и поддержание соответствующей требованиям СУИБ в
реальном мире, в ходе реальных аудитов, под реальным регуляторным давлением. Инструмент отражает то, что
действительно нужно практикам — а не то, что, по мнению продакт-менеджера, им нужно.

**Почему open source?**
Малые и средние предприятия заслуживают доступа к полноценной платформе СУИБ без лицензионных сборов с пятью нулями. Усилия по внедрению
реальны независимо от того, какой инструмент вы выберете — но эти затраты не должны усугубляться
привязкой к вендору или утечкой данных за пределы вашей собственной инфраструктуры. Этот проект выступает за свободу программного обеспечения и
принцип, согласно которому ваши данные о соответствии принадлежат вам.

---

## Уведомление о ссылках на стандарты

Данное программное обеспечение ссылается на идентификаторы контролей и краткие названия из опубликованных
стандартов только в целях совместимости и управления соответствием.

- **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).

---

## Лицензия

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)
для полной информации об авторстве и текстах лицензий.