Checkpoint production workflow updates

2026-06-30 15:25:29 +08:00
parent 19ae3ec37f
commit 9c80b95385
66 changed files with 7639 additions and 267 deletions
@@ -0,0 +1,189 @@
+# LT1AssetTool
+
+独立 EXE 工具，只做三件事：
+
+1. 扫描服务器资产路径，列出服务器现在有哪些资产，生成一个随身 JSON。
+2. 扫描一个或多个 UNC 路径，读取随身 JSON，服务器已有资产不参与复制，剩下的复制到一个或多个指定路径。
+3. 将一个或多个磁盘路径下的资产复制或剪切到服务器资产路径，并提示重新执行第 1 步。
+
+## 资产识别
+
+当前只识别平铺文件：
+
+- `LT1*.tar.gz`
+- `LT1*.tgz`
+- `LT1*.tar`
+- `LT1*.zip`
+- `LT1*.txt`
+
+判断是否已有资产使用：
+
+```text
+资产类型 + 文件名 + 文件大小
+```
+
+## 第 1 步：扫描服务器资产路径
+
+输入：
+
+```text
+服务器资产路径：
+D:\LuTan1_Image_Pool_Zip
+D:\LT1_data_lsarorbit
+
+服务器资产 JSON 保存为：
+E:\server_assets.json
+```
+
+输出 JSON 示例：
+
+```json
+{
+  "schema": "lt1_asset_inventory.v2",
+  "generated_at": "2026-06-22 16:00:00",
+  "roots": [
+    "D:\\LuTan1_Image_Pool_Zip",
+    "D:\\LT1_data_lsarorbit"
+  ],
+  "asset_count": 2,
+  "assets": [
+    {
+      "kind": "lt1_archive",
+      "name": "LT1A_xxx.tar.gz",
+      "path": "D:\\LuTan1_Image_Pool_Zip\\LT1A_xxx.tar.gz",
+      "size": 123456789,
+      "mtime": 1782100000.0
+    },
+    {
+      "kind": "lt1_orbit",
+      "name": "LT1A_GpsData_GAS_C_20240101.txt",
+      "path": "D:\\LT1_data_lsarorbit\\LT1A_GpsData_GAS_C_20240101.txt",
+      "size": 345678,
+      "mtime": 1782100100.0
+    }
+  ]
+}
+```
+
+以后就带着这个 JSON 去内网机器。
+
+## 第 2 步：从 UNC 补拷缺失资产
+
+输入：
+
+```text
+读取服务器资产 JSON：
+E:\server_assets.json
+
+UNC 源路径：
+\\server01\lt1_archives
+\\server02\lt1_orbits
+
+复制目标路径：
+E:\LT1_TRANSFER
+F:\LT1_TRANSFER
+```
+
+规则：
+
+- JSON 中已有且大小一致：跳过
+- JSON 中有同名资产但大小不同：报告冲突，不复制
+- JSON 中没有：复制到指定目标路径
+- 多个目标路径时，选择第一个空间足够的路径
+- 如果目标路径已有同名文件且大小一致：跳过
+- 复制过程先写 `.part`，完成并校验大小后再改名
+
+## 第 3 步：磁盘导入服务器
+
+输入：
+
+```text
+磁盘资产路径：
+E:\LT1_TRANSFER
+F:\LT1_TRANSFER
+
+服务器资产路径：
+D:\LuTan1_Image_Pool_Zip
+D:\LT1_data_lsarorbit
+```
+
+可选：
+
+```text
+剪切到服务器
+```
+
+规则：
+
+- 服务器已有且大小一致：跳过
+- 服务器有同名资产但大小不同：报告冲突，不覆盖
+- 服务器没有：复制或剪切到服务器路径
+- 多个服务器路径时，选择第一个空间足够的路径
+
+执行第 3 步之后，回到服务器重新执行第 1 步，生成新的随身 JSON。
+
+## 报告和日志
+
+需要指定 `报告/日志目录`，例如：
+
+```text
+E:\LT1AssetToolReports
+```
+
+工具会生成：
+
+```text
+E:\LT1AssetToolReports\
+  logs\
+    run_YYYYMMDD_HHMMSS.log
+  reports\
+    unc_copy_report_YYYYMMDD_HHMMSS.csv
+    disk_import_report_YYYYMMDD_HHMMSS.csv
+```
+
+CSV 可以用 Excel 打开。
+
+## 命令行
+
+扫描服务器：
+
+```powershell
+python lt1_data_sync_cli.py scan-server `
+  --report-dir "E:\LT1AssetToolReports" `
+  --server-roots "D:\LuTan1_Image_Pool_Zip;D:\LT1_data_lsarorbit" `
+  --output-json "E:\server_assets.json"
+```
+
+从 UNC 复制缺失资产：
+
+```powershell
+python lt1_data_sync_cli.py copy-unc `
+  --report-dir "E:\LT1AssetToolReports" `
+  --server-json "E:\server_assets.json" `
+  --unc-roots "\\server01\lt1_archives;\\server02\lt1_orbits" `
+  --targets "E:\LT1_TRANSFER;F:\LT1_TRANSFER" `
+  --execute
+```
+
+磁盘导入服务器：
+
+```powershell
+python lt1_data_sync_cli.py import-disk `
+  --report-dir "E:\LT1AssetToolReports" `
+  --disk-roots "E:\LT1_TRANSFER;F:\LT1_TRANSFER" `
+  --server-roots "D:\LuTan1_Image_Pool_Zip;D:\LT1_data_lsarorbit" `
+  --execute
+```
+
+## 打包 EXE
+
+```powershell
+cd D:\Code\Insar_management_system_v2\tools\lt1_data_sync
+.\build_exe.ps1 -Python "C:\ProgramData\anaconda3\envs\InSAR\python.exe"
+```
+
+输出：
+
+```text
+dist\LT1DataSync.exe
+```