4. 文件命名与目录结构优化：统一命名规则、按项目/日期/工序分层的目录树设计

在数字工地管理许可工作流中，照片证据的检索效率直接取决于文件命名与目录结构的规范性。混乱的命名和扁平化存储会导致故障排查时“找不到、对不上、理不清”。本章从统一命名规则与分层目录树两个维度，建立可落地、可扩展的存储优化方案。

4.1 统一命名规则：从“无规则”到“可解析”

照片文件名应具备自描述性，即仅凭文件名即可还原拍摄时间、工序、位置与拍摄者。推荐采用以下三段式命名模板：

格式：{项目代码}_{拍摄日期}_{工序代码}-{序号}.{扩展名}
示例：XM2025-001_2025-03-21_A03-001.jpg
      XM2025-001_2025-03-21_A03-002.jpg
      XM2025-001_2025-03-21_B07-001.jpg

4.2 工序代码预定义表

工序代码是命名规则的核心索引。以下为数字工地许可工作流中常见的工序编码示例：

4.3 分层目录树设计：按项目/日期/工序三层组织

目录结构采用项目 → 日期 → 工序的三层嵌套模型。该设计兼顾了按时间回溯与按工序检索两种常见场景。

项目根目录/
├── XM2025-001/
│   ├── 2025-03-21/
│   │   ├── A01-基坑开挖/
│   │   │   ├── XM2025-001_2025-03-21_A01-001.jpg
│   │   │   ├── XM2025-001_2025-03-21_A01-002.jpg
│   │   │   └── XM2025-001_2025-03-21_A01-003.jpg
│   │   ├── A02-地基处理/
│   │   │   ├── XM2025-001_2025-03-21_A02-001.jpg
│   │   │   └── XM2025-001_2025-03-21_A02-002.jpg
│   │   └── B01-钢筋绑扎/
│   │       └── XM2025-001_2025-03-21_B01-001.jpg
│   ├── 2025-03-22/
│   │   ├── A03-地基验收/
│   │   │   └── XM2025-001_2025-03-22_A03-001.jpg
│   │   └── B02-模板安装/
│   │       └── XM2025-001_2025-03-22_B02-001.jpg
│   └── 2025-03-23/
│       └── C01-混凝土浇筑前检查/
│           └── XM2025-001_2025-03-23_C01-001.jpg
└── XM2025-002/
    └── ...

4.4 目录树结构示意图

以下 SVG 展示了三层目录树的逻辑关系与文件分布：

4.5 目录结构设计原则与对比

4.6 自动化批量重命名脚本

以下 Python 脚本可对指定目录下的照片按规则批量重命名，适用于现场快速整理：

import os
import re
from datetime import datetime

def batch_rename_photos(base_dir, project_code, date_str, process_code):
    """
    批量重命名照片文件
    :param base_dir: 照片所在目录
    :param project_code: 项目代码，如 XM2025-001
    :param date_str: 拍摄日期，如 2025-03-21
    :param process_code: 工序代码，如 A03
    """
    counter = 1
    for filename in os.listdir(base_dir):
        # 匹配常见图片扩展名
        if re.search(r'\.(jpg|jpeg|png|bmp|tiff)$', filename, re.I):
            ext = os.path.splitext(filename)[1].lower()
            new_name = f"{project_code}_{date_str}_{process_code}-{counter:03d}{ext}"
            src = os.path.join(base_dir, filename)
            dst = os.path.join(base_dir, new_name)
            os.rename(src, dst)
            print(f"重命名: {filename} → {new_name}")
            counter += 1

# 使用示例
batch_rename_photos(
    base_dir="D:\\工地照片\\2025-03-21\\A03-地基验收",
    project_code="XM2025-001",
    date_str="2025-03-21",
    process_code="A03"
)

4.7 目录结构自动化创建脚本

配合命名规则，以下脚本可一键生成项目级目录骨架：

import os
from datetime import datetime, timedelta

def create_project_dirs(root, project_code, start_date, end_date, process_codes):
    """
    创建项目目录树
    :param root: 存储根目录
    :param project_code: 项目代码
    :param start_date: 开始日期 (datetime)
    :param end_date: 结束日期 (datetime)
    :param process_codes: 工序代码列表，如 ['A01','A02','B01']
    """
    project_path = os.path.join(root, project_code)
    os.makedirs(project_path, exist_ok=True)

    current = start_date
    while current <= end_date:
        date_str = current.strftime("%Y-%m-%d")
        date_path = os.path.join(project_path, date_str)
        os.makedirs(date_path, exist_ok=True)

        for code in process_codes:
            # 工序目录名：代码 + 中文名称（可选）
            process_dir = f"{code}-{PROCESS_NAMES.get(code, '')}"
            os.makedirs(os.path.join(date_path, process_dir), exist_ok=True)

        current += timedelta(days=1)

# 工序名称映射表
PROCESS_NAMES = {
    "A01": "基坑开挖",
    "A02": "地基处理",
    "A03": "地基验收",
    "B01": "钢筋绑扎",
    "B02": "模板安装",
    "C01": "混凝土浇筑前检查",
}

# 使用示例
create_project_dirs(
    root="D:\\工地照片",
    project_code="XM2025-001",
    start_date=datetime(2025, 3, 21),
    end_date=datetime(2025, 3, 23),
    process_codes=["A01", "A02", "A03", "B01", "B02", "C01"]
)

4.8 命名与目录结构的故障排查价值

当许可工作流出现争议时，规范的命名与目录结构能显著缩短排查时间：

• 场景一：监理质疑某日地基验收未拍照。通过日期目录 2025-03-22/A03-地基验收/ 可立即确认是否存在该工序照片。
• 场景二：需要调取某工序的全部证据。在项目目录下全局搜索 A03- 即可跨日期聚合所有地基验收照片。
• 场景三：照片被误删或覆盖。文件名中的项目代码与日期可作为恢复时的关键索引。