如何在NestJS+TypeORM中计算用户资料完成度百分比

核心思路 #

统计所有可填充的非必填字段（User表的email、full_name为必填项，不计入待填充范围；UserPersonalProfile和UserCareerProfile中的nullable字段为待填充项）的总数，再统计其中已填充（非null且非空字符串）的字段数量，最终通过公式 (已填充数 ÷ 总待填充数) × 100 计算完成度百分比。

具体实现步骤 #

1. 明确待统计字段清单 #

先梳理需要纳入统计的待填充字段：

• UserPersonalProfile：date_of_birth、address（以及你代码中省略的其他nullable字段）
• UserCareerProfile：job_role、work_location（以及你代码中省略的其他nullable字段）

2. 编写计算逻辑（TypeScript示例） #

在服务层实现计算方法，先关联查询用户的完整资料（包含关联的个人和职业档案），再逐个字段校验填充状态：

async calculateProfileCompletion(userId: string): Promise<number> {
    // 关联查询用户及关联的档案数据
    const user = await this.userRepository.findOne({
        where: { id: userId },
        relations: ['personal_details', 'career_profile']
    });

    if (!user) {
        throw new Error('用户不存在');
    }

    // 定义所有需要统计的嵌套字段路径
    const fieldsToCheck = [
        'personal_details.date_of_birth',
        'personal_details.address',
        // 补充UserPersonalProfile的其他nullable字段
        'career_profile.job_role',
        'career_profile.work_location'
        // 补充UserCareerProfile的其他nullable字段
    ];

    let filledCount = 0;
    const totalFields = fieldsToCheck.length;

    // 遍历检查每个字段是否已有效填充
    for (const fieldPath of fieldsToCheck) {
        const value = this.getNestedValue(user, fieldPath);
        if (value && value.trim() !== '') {
            filledCount++;
        }
    }

    // 计算百分比并保留两位小数，避免除以0的情况
    return totalFields > 0 ? Number(((filledCount / totalFields) * 100).toFixed(2)) : 0;
}

// 辅助函数：获取嵌套对象的属性值
private getNestedValue(obj: any, path: string): any {
    return path.split('.').reduce((current, key) => {
        return current && current[key] !== undefined ? current[key] : null;
    }, obj);
}

3. 关键注意事项 #

• 如果用户尚未创建personal_details或career_profile关联数据，则该实体下的所有字段均视为未填充。
• 可根据业务需求调整字段权重：例如将核心字段（如job_role）设置为双倍权重，计算加权完成度。
• 优先在应用层处理统计逻辑，比数据库层面的复杂查询更灵活、易维护。

内容的提问来源于stack exchange，提问作者RAHUL KUNDU