document-management/build/build.ps1

# DMS 一体化构建脚本
# 用法：在项目根目录执行 .\build\build.ps1
[CmdletBinding()]
param(
    [switch]$SkipFrontend,
    [switch]$SkipPyInstallerInstall
)

$ErrorActionPreference = "Stop"
$ProjectRoot = Split-Path $PSScriptRoot -Parent
$Backend = Join-Path $ProjectRoot "backend"
$Frontend = Join-Path $ProjectRoot "frontend"
$Dist = Join-Path $ProjectRoot "dist-package"
$BuildCache = Join-Path $PSScriptRoot "__pycache_build"

Write-Host "========== DMS 一体化构建 ==========" -ForegroundColor Cyan
Write-Host "项目根目录: $ProjectRoot"
# Python 后端已废弃（2026-09-16）：不再更新、不再运行测试，详见 backend\DEPRECATED.md
Write-Warning "Python 版后端已废弃（DEPRECATED）：backend\ 不再更新，也不运行测试。现役版本请使用 .\build\build-java.ps1 构建 Java 版发行包。"

# ---------- 1. 前端构建 ----------
if (-not $SkipFrontend) {
    Write-Host "`n[1/5] 构建前端..." -ForegroundColor Yellow
    Push-Location $Frontend
    try {
        if (-not (Test-Path "node_modules")) {
            Write-Host "  npm install..." -ForegroundColor DarkGray
            npm install
            if ($LASTEXITCODE -ne 0) { throw "npm install 失败" }
        }
        npm run build
        if ($LASTEXITCODE -ne 0) { throw "前端构建失败" }
    } finally { Pop-Location }
} else {
    Write-Host "`n[1/5] 跳过前端构建 (-SkipFrontend)" -ForegroundColor DarkGray
}

$indexHtml = Join-Path $Frontend "dist\index.html"
if (-not (Test-Path $indexHtml)) {
    throw "前端产物不存在: $indexHtml - 请先执行 npm run build"
}

# ---------- 2. 检查 PyInstaller ----------
Write-Host "`n[2/5] 检查 PyInstaller..." -ForegroundColor Yellow
Push-Location $Backend
try {
    $pyinstallerVersion = & python -m PyInstaller --version 2>$null
    if ($LASTEXITCODE -ne 0 -or -not $pyinstallerVersion) {
        if ($SkipPyInstallerInstall) {
            throw "PyInstaller 未安装且 -SkipPyInstallerInstall 已指定"
        }
        Write-Host "  安装 PyInstaller..." -ForegroundColor DarkGray
        python -m pip install pyinstaller
        if ($LASTEXITCODE -ne 0) { throw "PyInstaller 安装失败" }
    } else {
        Write-Host "  PyInstaller 版本: $pyinstallerVersion" -ForegroundColor DarkGray
    }
} finally { Pop-Location }

# ---------- 3. PyInstaller 打包 ----------
Write-Host "`n[3/5] PyInstaller 打包..." -ForegroundColor Yellow
$ReleaseDir = Join-Path $Dist "dms-server"
# 暂存现有 .env 与 dms-storage：删除发行目录前移出，重打包后自动还原，
# 避免用户配置与运行数据每次丢失（dms-storage 用移动而非复制，同卷瞬时完成）
$KeepEnv = Join-Path $Dist ".env.keep"
$KeepStorage = Join-Path $Dist "dms-storage.keep"
if (Test-Path (Join-Path $ReleaseDir ".env")) {
    Copy-Item (Join-Path $ReleaseDir ".env") $KeepEnv -Force
}
# 备份管理配置（界面保存的 rsync 地址等）同样暂存，避免重打包丢失
$KeepBackupCfg = Join-Path $Dist "dms-backup-config.keep"
if (Test-Path (Join-Path $ReleaseDir "dms-backup-config.json")) {
    Copy-Item (Join-Path $ReleaseDir "dms-backup-config.json") $KeepBackupCfg -Force
}
if (Test-Path (Join-Path $ReleaseDir "dms-storage")) {
    if (Test-Path $KeepStorage) { Remove-Item $KeepStorage -Recurse -Force }
    try {
        Move-Item (Join-Path $ReleaseDir "dms-storage") $KeepStorage -ErrorAction Stop
    } catch {
        # dms-storage 被运行中的服务占用（文件句柄未释放）：中止打包而非删数据
        throw "dms-storage 暂存失败（可能被运行中的服务占用）：$_ - 请先停止 dms-server 再打包"
    }
}
if (Test-Path $BuildCache) { Remove-Item $BuildCache -Recurse -Force }
if (Test-Path $ReleaseDir) {
    try {
        Remove-Item $ReleaseDir -Recurse -Force -ErrorAction Stop
    } catch {
        # 目录被其他进程占用（如命令行窗口停留在该目录内）：保留目录节点，清空内容
        Write-Warning "发行目录被其他进程占用，改为清空目录内容后继续"
        Get-ChildItem $ReleaseDir -Force | Remove-Item -Recurse -Force
    }
}

Push-Location $Backend
try {
    python -m PyInstaller `
        --noconfirm `
        --clean `
        --distpath $Dist `
        --workpath $BuildCache `
        (Join-Path $PSScriptRoot "dms-server.spec")
    if ($LASTEXITCODE -ne 0) { throw "PyInstaller 打包失败" }
} finally { Pop-Location }

# ---------- 4. 整理发行包 ----------
Write-Host "`n[4/5] 整理发行包..." -ForegroundColor Yellow
if (-not (Test-Path $ReleaseDir)) { throw "发行目录未找到: $ReleaseDir" }

# 复制配置模板（不含真实 .env，保护凭据）
Copy-Item (Join-Path $Backend ".env.example") $ReleaseDir -Force
# 尝试调用项目自带的导出工具，把示例数据库导出为 SQL 文件
# 工具三参数均必填：--env-file 提供库连接、--storage 提供文件根、--output 为输出目录
# （产物含 full_demo_data.sql 与 storage 文件副本），仅取 SQL 进发行包，临时目录用完即删
$ExportTool = Join-Path $ProjectRoot "tools\export_full_demo_data.py"
$ExportedSql = Join-Path $ReleaseDir "database-init.sql"
if (Test-Path $ExportTool) {
    # 运行时 .env 不在 backend 目录：按优先级取最新的现有配置（暂存 > 备份 > backend）
    $ExportEnv = @(
        $KeepEnv,
        (Join-Path $ProjectRoot "dist-package-bak\dms-server\.env"),
        (Join-Path $Backend ".env")
    ) | Where-Object { Test-Path $_ } | Select-Object -First 1
    $ExportStorage = Join-Path $Backend "dms-storage"
    if (-not $ExportEnv) {
        Write-Warning "未找到可用的 .env（暂存 .env.keep / 备份目录 / backend\.env），跳过自动导出"
    } elseif (-not (Test-Path $ExportStorage)) {
        Write-Warning "未找到存储目录 $ExportStorage，跳过自动导出"
    } else {
        Write-Host "  导出示例数据库 SQL..." -ForegroundColor DarkGray
        $ExportTmp = Join-Path ([System.IO.Path]::GetTempPath()) "dms-demo-export"
        if (Test-Path $ExportTmp) { Remove-Item $ExportTmp -Recurse -Force }
        try {
            # 通过当前 Python 环境运行导出工具
            python $ExportTool --env-file $ExportEnv --storage $ExportStorage --output $ExportTmp 2>&1 | Out-Host
            $ExportedSource = Join-Path $ExportTmp "full_demo_data.sql"
            if (Test-Path $ExportedSource) {
                Copy-Item $ExportedSource $ExportedSql -Force
                Write-Host "  已生成 database-init.sql" -ForegroundColor DarkGray
            } else {
                Write-Warning "导出工具未生成 full_demo_data.sql，请手动准备 SQL 文件"
            }
        } catch {
            Write-Warning "导出工具执行失败：$_"
        } finally {
            if (Test-Path $ExportTmp) { Remove-Item $ExportTmp -Recurse -Force }
        }
    }
} else {
    Write-Warning "未找到 tools\export_full_demo_data.py，跳过自动导出"
}
# 复制说明文档
Copy-Item (Join-Path $PSScriptRoot "README.txt") $ReleaseDir -Force
# DB upgrade script for existing deployments (dms-server.exe upgrade-db)
Copy-Item (Join-Path $PSScriptRoot "upgrade-db.bat") $ReleaseDir -Force

# rsync 备份工具：Windows 发行包随包携带 cwRsync（rsync.exe + cygwin dll），
# RSYNC 备份模式开箱即用；Linux 用系统 rsync 无需二进制（探测顺序见
# backup_service.locate_executable：DMS_RSYNC_EXECUTABLE → PATH → tools/rsync）
$RsyncTools = Join-Path $PSScriptRoot "tools\rsync"
if (Test-Path $RsyncTools) {
    Copy-Item $RsyncTools (Join-Path $ReleaseDir "tools\rsync") -Recurse -Force
    Write-Host "  已内置 rsync 备份工具（tools\rsync）" -ForegroundColor DarkGray
} else {
    Write-Warning "未找到 $RsyncTools，发行包不含内置 rsync（RSYNC 备份模式需目标机自装或配置 DMS_RSYNC_EXECUTABLE）"
}

# ---------- 5. 恢复 .env 和 dms-storage ----------
# 优先级：打包前暂存（原地数据，Move 回） > 备份目录；发行目录已有的 dms-storage 绝不覆盖
Write-Host "`n[5/5] 恢复 .env 和 dms-storage..." -ForegroundColor Yellow
$BackupDir = Join-Path $ProjectRoot "dist-package-bak\dms-server"
if (-not (Test-Path $BackupDir)) {
    Write-Host "  备份目录不存在: $BackupDir - 跳过备份恢复" -ForegroundColor DarkGray
} else {
    $BackupEnv = Join-Path $BackupDir ".env"
    if (Test-Path $BackupEnv) {
        Copy-Item $BackupEnv $ReleaseDir -Force
        Write-Host "  已恢复 .env（备份）" -ForegroundColor DarkGray
    } else {
        Write-Warning "备份中没有 .env，跳过"
    }
}
if (Test-Path $KeepStorage) {
    Move-Item $KeepStorage (Join-Path $ReleaseDir "dms-storage") -Force
    Write-Host "  已保留重打包前的 dms-storage" -ForegroundColor DarkGray
} elseif ((Test-Path $BackupDir) -and (Test-Path (Join-Path $BackupDir "dms-storage"))) {
    Copy-Item (Join-Path $BackupDir "dms-storage") (Join-Path $ReleaseDir "dms-storage") -Recurse -Force
    Write-Host "  已恢复 dms-storage（备份）" -ForegroundColor DarkGray
} else {
    Write-Host "  无 dms-storage 可恢复（暂存与备份均无），跳过" -ForegroundColor DarkGray
}

# 还原打包前暂存的 .env（优先级高于备份目录，始终保留用户最新配置）
if (Test-Path $KeepEnv) {
    Copy-Item $KeepEnv (Join-Path $ReleaseDir ".env") -Force
    Remove-Item $KeepEnv -Force
    Write-Host "  已保留重打包前的 .env" -ForegroundColor DarkGray
}
# 还原打包前暂存的备份管理配置
if (Test-Path $KeepBackupCfg) {
    Copy-Item $KeepBackupCfg (Join-Path $ReleaseDir "dms-backup-config.json") -Force
    Remove-Item $KeepBackupCfg -Force
    Write-Host "  已保留重打包前的 dms-backup-config.json" -ForegroundColor DarkGray
}

Write-Host "`n========== 构建完成 ==========" -ForegroundColor Green
Write-Host "发行包目录: $ReleaseDir" -ForegroundColor Green
$sizeMB = [math]::Round((Get-ChildItem $ReleaseDir -Recurse | Measure-Object -Property Length -Sum).Sum / 1MB, 1)
Write-Host "包大小: ${sizeMB} MB" -ForegroundColor Green
Write-Host "将该目录整体压缩即可分发给最终用户" -ForegroundColor Green