docs: 更新需求文档至v0.5并归档开发进度；修复大文件上传与二维码海报

- 需求文档升级到 v0.5：补充二维码海报保存文件名默认格式、大文件上传三层限制（IIS+ASP.NET+前端）部署约束、新增第11章开发进度状态归档（已上线功能/已修复缺陷/已知限制/后续优化） - 后端 FileController.Upload 增加 [RequestFormLimits(MultipartBodyLengthLimit=220_200_960)]，修复>128MB multipart 上传被拒 - 前端 UploadView 二维码海报：修正 drawImage 缩放错位、顶部logo/标题垂直居中、分区标题间距、大小与有效期分行显示；保存文件名改为文传易取件码-取件码(原文件名)-流水号.png - 新增部署脚本：apply_backend.ps1 / force_dll.ps1（app_offline 解锁DLL）/ ftp_fe.ps1 / ftp_diag.ps1 / ftp_apply.ps1 / _diag/check_dll.ps1 (部署手册 IIS部署与FTP发布.md 仅含编码/BOM 差异，未纳入本次提交)
2026-08-24 02:02:57 +08:00
parent 2e3f68472e
commit 5568548001
9 changed files with 389 additions and 28 deletions
@@ -0,0 +1,78 @@
+# Apply new backend build via app_offline.htm (unlock inprocess DLLs) + full sync
+$ErrorActionPreference = "Continue"
+$FtpHost="116.198.221.125"; $FtpPort=21; $FtpUser="wenchuanyi"; $FtpPass="r7P^f*v7rFts"
+$Root="D:\CodeBuddy\Pros\WenChuanyi"
+$PublishDir = "$Root\backend\WenChuanyi.Api\bin\Release\net8.0\publish"
+$DistDir = "$Root\frontend\dist"
+$Stage = Join-Path $env:TEMP "wcy_publish_staging"
+$RemoteRoot="/wwwroot"
+$Log = "$Root\deploy\apply.log"
+$fail=$false
+Set-Content -Path $Log -Value "=== apply start $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') ===" -Encoding UTF8
+function L([string]$m){ Add-Content -Path $Log -Value $m -Encoding UTF8 }
+function New-FtpReq([string]$path,[string]$method,[int]$timeoutMs=90000){
+    $uri="ftp://${FtpHost}:${FtpPort}/"+$path.TrimStart('/')
+    $r=[System.Net.FtpWebRequest]::Create($uri)
+    $r.Method=$method; $r.Credentials=New-Object System.Net.NetworkCredential($FtpUser,$FtpPass)
+    $r.UsePassive=$true; $r.UseBinary=$true; $r.KeepAlive=$false; $r.Timeout=$timeoutMs
+    return $r
+}
+function Get-FtpSize([string]$p){
+    for($i=0;$i -lt 3;$i++){
+        try{ $r=New-FtpReq $p ([System.Net.WebRequestMethods+Ftp]::GetFileSize) 30000
+             $resp=$r.GetResponse(); $s=$resp.ContentLength; $resp.Close(); return $s }catch{ Start-Sleep -Seconds 2 }
+    }
+    return -1
+}
+function UpFile([string]$lp,[string]$rp){
+    $localSize=(Get-Item $lp).Length
+    $remoteSize=Get-FtpSize $rp
+    if($remoteSize -eq $localSize){ L "SKIP $rp"; return }
+    L "UPLOAD $rp (remote=$remoteSize local=$localSize)"
+    for($i=1;$i -le 4;$i++){
+        try{
+            $r=New-FtpReq $rp ([System.Net.WebRequestMethods+Ftp]::UploadFile) 300000
+            $b=[IO.File]::ReadAllBytes($lp); $r.ContentLength=$b.Length
+            $s=$r.GetRequestStream(); try{ $s.Write($b,0,$b.Length) } finally { $s.Close() }
+            $resp=$r.GetResponse(); try{ $resp.Close() }catch{}
+            Start-Sleep -Seconds 1
+            $after=Get-FtpSize $rp
+            if($after -eq $localSize){ L "OK $rp"; return }
+            L "VERIFYFAIL $rp (got $after)"
+        }catch{ L "RETRY($i) $rp : $($_.Exception.Message)" }
+        Start-Sleep -Seconds 4
+    }
+    L "FAIL $rp"; $script:fail=$true
+}
+function DelF([string]$rp){
+    try{ $r=New-FtpReq $rp ([System.Net.WebRequestMethods+Ftp]::DeleteFile)
+         $resp=$r.GetResponse(); try{$resp.Close()}catch{}; L "DEL $rp" }catch{ L "DEL skip $rp" }
+    Start-Sleep -Milliseconds 800
+}
+function UpDir([string]$ld,[string]$rd){
+    foreach($d in Get-ChildItem $ld -Directory){
+        $c="$rd/$($d.Name)"
+        $mr=New-FtpReq $c ([System.Net.WebRequestMethods+Ftp]::MakeDirectory) 30000
+        try{ $null=$mr.GetResponse() }catch{}
+        UpDir $d.FullName $c
+    }
+    foreach($f in Get-ChildItem $ld -File){ UpFile $f.FullName "$rd/$($f.Name)" }
+}
+# 1. stage
+if(Test-Path $Stage){ Remove-Item $Stage -Recurse -Force }
+New-Item -ItemType Directory -Path $Stage | Out-Null
+Copy-Item "$DistDir\*" $Stage -Recurse -Force
+Copy-Item "$PublishDir\*" $Stage -Recurse -Force
+L "stage files: $((Get-ChildItem $Stage -File -Recurse).Count)"
+# 2. app_offline to stop app & unlock DLLs
+Set-Content -Path "$Stage\app_offline.htm" -Value "<html><body>maintenance</body></html>" -Encoding UTF8
+UpFile "$Stage\app_offline.htm" "$RemoteRoot/app_offline.htm"
+L "wait 6s for app shutdown..."
+Start-Sleep -Seconds 6
+# 3. full sync
+UpDir $Stage $RemoteRoot
+# 4. remove app_offline -> app auto-restart
+DelF "$RemoteRoot/app_offline.htm"
+Remove-Item $Stage -Recurse -Force
+if($fail){ L "RESULT=PARTIAL_FAIL" } else { L "RESULT=OK" }
+L "=== apply end $(Get-Date -Format 'HH:mm:ss') ==="