# ============================================================
# OpenDance Studio Web 服务端 -- Linux 原生部署环境变量
#
# 复制为 deploy/.env 后填写；.env 已被 .gitignore 忽略，禁止提交。
# 该文件由 systemd 通过 EnvironmentFile 注入 Node 进程。
# ============================================================

# ---- 服务 ----
NODE_ENV=production
# 软件 API 端口：Windows/Godot 客户端与 Android App 调用它
# （提供 /api、/health、/static、/contracts，**不提供管理页面**）
PORT=3000
# 管理端端口：浏览器访问管理界面（页面 + 上面全部接口）
# 不设置时默认 = PORT + 1（即 3001）；设为与 PORT 相同即为单端口兼容模式
ADMIN_PORT=3001
# 监听地址：
#   反代与后端同机 -> 127.0.0.1（后端不直接对外暴露，推荐）
#   反代在别的机器 -> 0.0.0.0，并用防火墙把该端口限制为仅反代来源可访问
HOST=0.0.0.0
# 管理端单独绑定地址（可选）。只想让管理端暴露在内网时，例如 127.0.0.1 或内网网卡地址
# ADMIN_HOST=127.0.0.1

# 管理端静态站点目录（本服务自带管理端页面，反代只需整体转发到管理端端口）
ADMIN_DIR=/opt/opendance/admin

# ---- 现有 MySQL / MariaDB 实例（本项目不安装、不管理数据库）----
DB_HOST='<existing-mysql-host>'
DB_PORT=3306
DB_USER=opendance_app
DB_PASS='<数据库口令>'
DB_NAME=opendance
# 生产环境必须为 false，表结构一律走 TypeORM migration
DB_SYNCHRONIZE=false
DB_LOGGING=false

# ---- 文件存储 ----
# 需与 install.sh 的 STORAGE_DIR 一致，且服务用户可写
STORAGE_DIR=/var/lib/opendance/storage
# 单文件上传上限（字节），默认 512 MiB。
# ★ 反向代理层的同名限制必须不小于此值（nginx client_max_body_size /
#   IIS requestLimits），否则大模型上传会在代理层被拒（413）。
UPLOAD_MAX_BYTES=536870912

# ---- 可选的 Assimp（FBX/glTF 动作预处理；也用于压缩包模型的转换）----
# 上传 .zip（内含 .pmx 的 MMD 模型包）时必须能调用到它，否则转换会失败
ASSIMP_BIN=assimp
# 模型交付格式：vrm（默认，v0.5.0 起所有上传模型一律转 VRM）| glb
#   vrm：在 GLB 之上补 VRMC_vrm 扩展（humanoid 骨骼 / 表情语义）
#   glb：仅作为转换中间产物；humanoid 不达标时会回退交付 GLB，
#        该模型 usable=false（可入库可审核，但不进入客户端目录）
MODEL_CONVERT_FORMAT=vrm
# 压缩包里优先选用的 PMX 文件名（大小写不敏感）；找不到时按"格式优先级 -> 目录最浅 -> 文件最大"挑
# 值里含空格或 shell 元字符时必须用引号包起来（install.sh 会用
# `set -a; . deploy/.env` 真的执行本文件；不加引号会把 "Miku.pmx" 当命令）
MODEL_CONVERT_PMX="Hatsune Miku.pmx"
# 单次转换超时（毫秒）
# 转换后模型的着色模式：pbr（默认，标准 PBR + 按 PMX 参数修正双面/粗糙度）
#   | unlit（给材质写 KHR_materials_unlit：颜色 = 贴图 x baseColorFactor，
#     与场景光照无关，最接近 MMD 的平涂观感；three.js 与 Godot 都支持）
MODEL_SHADING=pbr
MODEL_CONVERT_TIMEOUT_MS=180000

# ---- 默认模型（可选）----
# 显式指定默认模型 id；不设置时按源码 src/config/default-model.ts 里的种子匹配，
# 再回落到契约 data-models.md 4.1 的 VRM 优先规则
# DEFAULT_MODEL_ID=1

# ---- 契约目录 ----
# 指向安装目录下的 contracts/，使 /health 与 /api/catalog/version 反映实时契约版本
CONTRACTS_DIR=/opt/opendance/contracts