feat: 支持合同模板上传与地区隔离

fastapi_common/fastapi_common_storage/oss_path_utils.py

@@ -54,6 +54,7 @@ class OssPathUtils:
 
     @staticmethod
     def BuildContractTemplateKey(
+        Region: str,
         CategoryName: str,
         TemplateCode: str,
         FileRole: str,
@@ -61,12 +62,13 @@ class OssPathUtils:
     ) -> str:
         """生成合同模板 object key。"""
         ext = Path(FileName).suffix or ""
+        safe_region = OssPathUtils.BuildSafeFileStem(Region or "shared")
         safe_category = OssPathUtils.BuildSafeFileStem(CategoryName or "uncategorized")
         safe_template_code = OssPathUtils.BuildSafeFileStem(TemplateCode or "template")
         safe_stem = OssPathUtils.BuildSafeFileStem(FileName)
         safe_role = OssPathUtils.BuildSafeFileStem(FileRole or "file")
         return (
-            f"contract-templates/{safe_category}/{safe_template_code}/"
+            f"contract-templates/{safe_region}/{safe_category}/{safe_template_code}/"
             f"{safe_role}__{safe_stem}{ext}"
         )