document-management/backend/.env.example

# DMS MySQL 8连接（示例值，不包含真实凭据）
DMS_DATABASE_URL=mysql+pymysql://dms_app:change-me@127.0.0.1:3306/dms?charset=utf8mb4

# 存储根目录：留空（推荐）由启动器自动选择默认位置。
#   - 开发模式：backend/dms-storage/
#   - 打包模式：dms-server.exe 同级 dms-storage/
# 如需自定义，请填写绝对路径，并取消下面一行注释。
# DMS_STORAGE_ROOT=

# 留空时使用内置中文UI字典；部署时可指向外部UTF-8 JSON，修改后需重启
DMS_UI_DICTIONARY_CONFIG_PATH=

# 单文件、请求总大小与批量文件数
DMS_MAX_FILE_SIZE=52428800
DMS_MAX_UPLOAD_SIZE=104857600
DMS_BATCH_MAX_FILES=50

# LibreOffice 离线转换配置（DOC/DOCX 转 PDF 预览）
DMS_OFFICE_PREVIEW_ENABLED=true
DMS_LIBREOFFICE_EXECUTABLE=C:\\Program Files\\LibreOffice\\program\\soffice.exe
DMS_LIBREOFFICE_TIMEOUT_SECONDS=60
DMS_LIBREOFFICE_MAX_CONCURRENCY=2

# PDF 预览渲染引擎：iframe=浏览器内置预览（默认，适应宽度）；pdfjs=自托管 pdfjs-dist
DMS_PDF_VIEWER_ENGINE=iframe

# B2配置真实随机密钥；禁止提交真实密钥
DMS_JWT_SECRET=replace-with-a-random-secret

# 仅供显式执行 python -m dms.seed_dev；密码值不得提交
DMS_SEED_ADMIN_PASSWORD=
DMS_SEED_USER_PASSWORD=
# true会覆盖admin和user两名同名用户的密码并使其旧Token失效，默认必须保持false
DMS_SEED_OVERWRITE_PASSWORDS=false

# 既有AI配置仍独立使用 INFO_EXTRACTOR_* 环境变量

# ─────────────────────────────────────────────────────────────
# 门户跳转按需登录（对接其他系统门户；留空/不配置=功能整体关闭，
# 用户名密码登录不受影响）。详见 docs/门户对接指南.md
# ─────────────────────────────────────────────────────────────
# provider类型：留空=关闭 / mock=本地联调 / http=标准REST配置驱动 / custom=手写适配
DMS_PORTAL_PROVIDER=
# 跳转URL中携带token的参数名（默认token）
DMS_PORTAL_TOKEN_PARAM=token

# ---- 以下仅 provider=http 时需要 ----
# 对端验签接口地址（token怎么传由下面三项决定）
DMS_PORTAL_VERIFY_URL=
# GET 或 POST
DMS_PORTAL_VERIFY_METHOD=POST
# token放置位置：header / body / query
DMS_PORTAL_VERIFY_TOKEN_IN=header
# header方式时的头名与值模板（{token}为占位符）
DMS_PORTAL_VERIFY_HEADER=Authorization
DMS_PORTAL_VERIFY_HEADER_TEMPLATE=Bearer {token}
# 验签成功判定：响应JSON中该字段的值等于该值才算通过（支持a.b点路径）
DMS_PORTAL_VERIFY_SUCCESS_FIELD=code
DMS_PORTAL_VERIFY_SUCCESS_VALUE=0
# 验签响应中用户信息对象所在字段路径（如 data）
DMS_PORTAL_VERIFY_USER_FIELD=data
# 验签响应不含完整用户信息时，额外的用户信息接口（留空=验签已含）
DMS_PORTAL_USERINFO_URL=
DMS_PORTAL_USERINFO_UID_PARAM=userId
# 用户信息字段映射 local:remote（local固定为externalId/username/realName/orgName）
DMS_PORTAL_FIELD_MAP=externalId:userId,username:loginName,realName:realName,orgName:orgName

# ---- 新用户落库 ----
# 组织名称匹配不到时的默认组织ID（留空=不挂组织）
DMS_PORTAL_DEFAULT_ORG_ID=
# 对端HTTP请求超时秒数
DMS_PORTAL_HTTP_TIMEOUT_SECONDS=10