数据迁移报告模板

这是一个 Handlebars 模板文件（.hbs 后缀），用于生成数据导入/迁移的报告。让我详细解释每个部分：

文件结构分析

1. 记录汇总部分

Record Summary:
    record total count: {{recordCount}}
    record pending: {{Pending}}
    record success: {{Success}}
    record failed: {{Failed}}

作用：显示总体处理统计

• recordCount: 总记录数
• Pending: 待处理记录数
• Success: 成功记录数
• Failed: 失败记录数

2. 成功记录详情

Record Success Details:
    record created: {{Created}}
    record updated: {{Updated}}
    record skipped: {{SkipDuplicated}}

作用：细分成功操作的类型

• Created: 新建的记录数
• Updated: 更新的记录数
• SkipDuplicated: 跳过的重复记录数

3. 失败记录详情

Record Failed Details:
    uniqueKey empty: {{UniqueKeyEmpty}}
    invalid path: {{PathInvalid}}
    invalid datetime: {{InvalidDatetime}}
    // ... 更多错误类型

作用：分类显示各种失败原因

• 数据验证错误：唯一键为空、路径无效、时间格式错误等
• 系统错误：数据库连接失败（MariaDB、MongoDB、Elasticsearch）
• 业务逻辑错误：用户不存在、文件被检出、版本受保护等

4. 文档详情

Document Details:
    projects created: {{projectsCreated}}, updated: {{projectsUpdated}}, failed: {{projectsFailed}}
    folders created: {{foldersCreated}}, updated: {{foldersUpdated}}, failed: {{foldersFailed}}
    files created: {{filesCreated}}, updated: {{filesUpdated}}, failed: {{filesFailed}}

作用：按文档类型统计处理结果

• 分别统计项目、文件夹、文件的创建、更新、失败数量

5. 特殊处理部分

distinct files not found: {{sizeof filesNotFound}}

{{#if profilesNotFound}}profiles not found: {{sizeof profilesNotFound}}
    {{#each profilesNotFound}}  - {{{@key}}}: {{@value}}
    {{/each}}{{else}}profiles not found: 0{{/if}}

作用：显示特定问题的详细信息

• filesNotFound: 未找到的文件列表（只显示数量）
• profilesNotFound: 未找到的用户档案（有条件显示详细信息）

6. 时间统计

Time Usage:
    startup time: {{humanize startupInMilliSeconds}}
    parse time: {{humanize parseInMilliSeconds}}
    // ... 各阶段时间

作用：性能分析，显示各处理阶段耗时

• 使用 humanize 助手函数将毫秒转换为易读格式

实际应用示例

假设数据导入完成后，模板会生成类似这样的报告：

Report
Record Summary:
    record total count: 1000
    record pending: 0
    record success: 850
    record failed: 150
    
Record Success Details:
    record created: 600
    record updated: 200
    record skipped: 50
    
Record Failed Details:
    uniqueKey empty: 10
    invalid path: 5
    invalid datetime: 3
    user not found: 132
    // ... 其他错误类型

Document Details:
    projects created: 5, updated: 2, failed: 1
    folders created: 50, updated: 30, failed: 5
    files created: 545, updated: 168, failed: 144

Time Usage:
    startup time: 2.3s
    parse time: 1.1s
    concurrent import files time: 45.2s
    // ... 其他阶段时间

这个模板提供了完整的导入过程可视化，便于运维人员快速定位问题和优化性能。