semantics

.env.enterprise-clean.example

@@ -1,31 +1,76 @@
-# Offline / air-gapped compose profile for enterprise clean release.
+# #region env.enterprise-clean [C:2] [TYPE Module] [SEMANTICS env,docker,enterprise]
+# @BRIEF Переменные окружения для docker-compose.enterprise-clean.yml.
+#   Сервисы собираются из исходников — не требуют pre-built images.
+#   Используется внешний PostgreSQL (корпоративный).
+# @LAYER Infrastructure
+# @RELATION DEPENDS_ON -> [docker-compose.enterprise-clean.yml]
+# #endregion env.enterprise-clean
 
-BACKEND_IMAGE=ss-tools-backend:v1.0.0-rc2-docker
-FRONTEND_IMAGE=ss-tools-frontend:v1.0.0-rc2-docker
-POSTGRES_IMAGE=postgres:16-alpine
+# ======================================================================
+#  PostgreSQL (внешний, корпоративный)
+# ======================================================================
+# Адрес и порт внешнего PostgreSQL (обязательно)
+POSTGRES_HOST=postgres.company.local
+POSTGRES_PORT=5432
 
+# Имя БД, пользователь, пароль
 POSTGRES_DB=ss_tools
 POSTGRES_USER=postgres
 POSTGRES_PASSWORD=change-me
 
+# ======================================================================
+#  Порты хоста
+# ======================================================================
 BACKEND_HOST_PORT=8001
 FRONTEND_HOST_PORT=8000
-POSTGRES_HOST_PORT=5432
+FRONTEND_SSL_PORT=443
 
+# ======================================================================
+#  Сертификаты (корпоративные)
+# ======================================================================
+# Путь к директории с сертификатами на хосте.
+# Содержимое монтируется в /opt/certs в обоих контейнерах.
+#
+# Для CA-сертификатов — положите .crt файлы:
+#   ./certs/my-company-ca.crt
+#   ./certs/other-ca.pem
+#
+# Для SSL терминации nginx — добавьте server.crt + server.key:
+#   ./certs/server.crt
+#   ./certs/server.key
+#
+# Если директория пуста или не существует — сертификаты не устанавливаются,
+# nginx работает в HTTP-only режиме.
+CERTS_PATH=./certs
+
+# ======================================================================
+#  Хранилище
+# ======================================================================
+STORAGE_ROOT=./storage
+
+# ======================================================================
+#  Логирование
+# ======================================================================
 ENABLE_BELIEF_STATE_LOGGING=true
 TASK_LOG_LEVEL=INFO
 
-STORAGE_ROOT=./storage
-
-# Initial admin bootstrap. Set to true only for the first startup in a new environment.
+# ======================================================================
+#  Admin (первый запуск)
+# ======================================================================
+# Установите true только для первого запуска в новой среде.
 INITIAL_ADMIN_CREATE=false
 INITIAL_ADMIN_USERNAME=admin
 INITIAL_ADMIN_PASSWORD=change-me
 INITIAL_ADMIN_EMAIL=
 
+# ======================================================================
+#  AI API ключи (опционально)
+# ======================================================================
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=
 
-# Features
-FEATURES__DATASET_REVIEW=${FEATURES__DATASET_REVIEW:-true}
-FEATURES__HEALTH_MONITOR=${FEATURES__HEALTH_MONITOR:-true}
+# ======================================================================
+#  Features
+# ======================================================================
+FEATURES__DATASET_REVIEW=true
+FEATURES__HEALTH_MONITOR=true