Add UPP STL asset indexing workflow

UPP_数据库构建/README.md

@@ -0,0 +1,45 @@
+# UPP STL资产索引
+
+本目录用于把 `UPP_STL处理/待处理STL数据` 和 `UPP列表处理` 的合并 list 建成 CT 号唯一索引。
+
+处理规则：
+
+- STL 候选目录必须能从路径中提取 `CT号`，格式为 `CT...` 或 `DCT...`。
+- 同一 CT 号有多个 STL 目录时，优先选择 STL 文件数更多的目录。
+- 文件数相同，则选择病例名或 `*-STL` 目录中序号更大的目录。
+- 规范化输出到 `UPP_STL处理/已处理STL数据/<CT号>/`。
+- 数据库中 `upp_exam_assets.ct_number` 是主键，可用 list 的检查号查询对应 STL 路径；未来 CT 数据也可以继续挂在同一行。
+
+运行：
+
+```bash
+cd /home/wkmgc/Desktop/PACS数据处理
+PGHOST='<host>' PGPORT='<port>' PGDATABASE='<database>' PGUSER='<user>' PGPASSWORD='<password>' \
+  python3 UPP_数据库构建/02_同步UPP_STL资产.py
+```
+
+主要表：
+
+- `upp_exam_assets`：CT 号唯一资产索引，含 list 元数据、最终选中 STL 目录、候选目录、STL 文件清单。
+- `upp_stl_files`：最终选中 STL 的 CT 级聚合表，每个 CT 号唯一一行，文件名、分割名、family、分类、路径和完整文件清单用 JSONB 存储。
+
+STL 名称统计：
+
+```bash
+python3 UPP_数据库构建/03_统计STL名称.py
+```
+
+输出：
+
+- `UPP_数据库构建/UPP_STL名称统计.json`
+- `UPP_数据库构建/UPP_STL名称统计.csv`
+- `UPP_数据库构建/UPP_STL_family统计.csv`
+- `UPP_数据库构建/UPP_STL文件family顺序明细.csv`，含逐 CT 文件路径，默认不提交
+
+常用查询：
+
+```sql
+SELECT ct_number, patient_name, processed_stl_dir, stl_file_count
+FROM upp_exam_assets
+WHERE ct_number = '<CT号>';
+```