一、业务背景与核心问题
保姆、月嫂等家政服务人员具有高信任门槛、长服务周期、强个性化匹配的特点。用户在预约时不仅关注服务人员的基本信息,更看重其资质证书、从业经验、技能特长、历史评价等维度的综合画像。
传统家政公司依赖纸质档案或Excel表格管理服务人员信息,存在以下痛点:
- 信息碎片化:身份证、健康证、培训证书、客户评价等分散在不同渠道,无法形成统一画像。
- 匹配效率低:用户提出"需要会做月子餐、有催乳师证、带过3个以上宝宝"等复合条件时,人工筛选耗时且不准确。
- 档案更新滞后:服务人员考取新证书、完成新订单后,档案信息未能及时同步,影响推荐质量。
- 信任传递困难:用户无法直观了解服务人员的真实能力和服务记录,决策成本高。
本文围绕家政预约平台的人员档案管理系统,介绍其数据模型设计、档案生命周期管理以及基于多维标签的智能匹配方案。
二、系统架构设计
档案数据模型
人员档案采用"基础信息 + 资质证照 + 技能标签 + 服务履历 + 评价画像"五层结构:
- 基础信息层:姓名、性别、年龄、籍贯、联系方式、照片、自我介绍等。
- 资质证照层:身份证、健康证、母婴护理师证、催乳师证、育婴师证、家政服务证等,每个证照记录编号、发证机构、有效期、扫描件地址。
- 技能标签层:以标签体系描述服务能力,如
["月子餐制作", "新生儿护理", "产后康复", "早教启蒙"],标签支持多级分类和自定义扩展。 - 服务履历层:历史服务订单记录,包括服务类型、服务时长、客户满意度评分、服务区域等。
- 评价画像层:由历史订单的客户评价聚合而成,包括综合评分、各维度评分(专业能力、态度、守时等)、标签云(如"细心""经验丰富""做饭好吃")。
档案生命周期管理
档案从创建到归档经历以下阶段:
- 注册提交:服务人员提交基础信息和证照材料。
- 审核认证:运营人员核验身份信息、证照真伪,审核通过后档案状态变为"已认证"。
- 上架服务:认证通过的档案进入可预约池,用户端可搜索和浏览。
- 持续更新:每次完成订单后自动更新服务履历和评价画像;证照到期前自动提醒续期。
- 冻结/下架:证照过期、投诉过多或主动退出时,档案状态变为"冻结"或"已下架",不再接受新预约。
智能匹配引擎
用户预约时输入需求条件(服务类型、技能要求、预算范围、服务区域等),匹配引擎从档案库中筛选符合条件的服务人员,并按综合得分排序推荐。匹配维度包括技能标签匹配度、评分、从业年限、区域距离、档期可用性等。
三、核心代码实现
人员档案模型与生命周期管理
以下代码实现了家政服务人员档案的数据模型定义和生命周期状态管理。
from dataclasses import dataclass, field from typing import Optional from enum import Enum from datetime import datetime class ArchiveStatus(Enum): PENDING_REVIEW = "pending_review" # 待审核 CERTIFIED = "certified" # 已认证 ACTIVE = "active" # 上架服务中 FROZEN = "frozen" # 冻结 OFFLINE = "offline" # 已下架 class Certificate: """资质证照""" cert_id: str cert_name: str # 如"母婴护理师证" cert_number: str issuing_authority: str issue_date: str expiry_date: str scan_url: Optional[str] = None def is_valid(self): return datetime.strptime(self.expiry_date, "%Y-%m-%d") > datetime.now() class ServiceRecord: """服务履历记录""" order_id: str service_type: str # 如"月嫂""住家保姆" start_date: str end_date: str client_rating: float = 0.0 service_area: str = "" class WorkerArchive: """家政服务人员完整档案""" worker_id: str name: str gender: str age: int phone: str self_intro: str = "" photo_url: Optional[str] = None status: ArchiveStatus = ArchiveStatus.PENDING_REVIEW certificates: list = field(default_factory=list) skill_tags: list = field(default_factory=list) service_records: list = field(default_factory=list) composite_rating: float = 0.0 total_orders: int = 0 years_of_experience: float = 0.0 created_at: str = "" updated_at: str = "" class ArchiveManager: """档案生命周期管理器""" def __init__(self): self.archives = {} # worker_id -> WorkerArchive def create_archive(self, archive: WorkerArchive) -> WorkerArchive: """创建新档案,初始状态为待审核""" archive.status = ArchiveStatus.PENDING_REVIEW archive.created_at = datetime.now().strftime("%Y-%m-%d %H:%M:%S") self.archives[archive.worker_id] = archive return archive def approve_archive(self, worker_id: str) -> WorkerArchive: """审核通过,档案进入已认证状态""" archive = self.archives.get(worker_id) if not archive: raise ValueError(f"档案 {worker_id} 不存在") if archive.status != ArchiveStatus.PENDING_REVIEW: raise ValueError(f"档案 {worker_id} 当前状态不允许审核操作") archive.status = ArchiveStatus.CERTIFIED archive.updated_at = datetime.now().strftime("%Y-%m-%d %H:%M:%S") return archive def publish_archive(self, worker_id: str) -> WorkerArchive: """上架服务,档案进入可预约状态""" archive = self.archives.get(worker_id) if not archive: raise ValueError(f"档案 {worker_id} 不存在") if archive.status != ArchiveStatus.CERTIFIED: raise ValueError(f"档案 {worker_id} 未认证,无法上架") # 校验所有证照是否仍在有效期内 invalid_certs = [c for c in archive.certificates if not c.is_valid] if invalid_certs: raise ValueError( f"档案 {worker_id} 存在 {len(invalid_certs)} 个过期证照," f"请先更新后再上架" ) archive.status = ArchiveStatus.ACTIVE archive.updated_at = datetime.now().strftime("%Y-%m-%d %H:%M:%S") return archive def add_service_record(self, worker_id: str, record: ServiceRecord): """添加服务履历并更新评价画像""" archive = self.archives.get(worker_id) if not archive: raise ValueError(f"档案 {worker_id} 不存在") archive.service_records.append(record) archive.total_orders = len(archive.service_records) # 重新计算综合评分 rated_records = [r for r in archive.service_records if r.client_rating > 0] if rated_records: archive.composite_rating = round( sum(r.client_rating for r in rated_records) / len(rated_records), 2 ) archive.updated_at = datetime.now().strftime("%Y-%m-%d %H:%M:%S") def get_expiring_certificates(self, days_ahead: int = 30) -> list: """查询即将到期的证照,用于提前提醒续期""" from datetime import timedelta threshold = datetime.now() + timedelta(days=days_ahead) result = [] for archive in self.archives.values(): if archive.status != ArchiveStatus.ACTIVE: continue for cert in archive.certificates: expiry = datetime.strptime(cert.expiry_date, "%Y-%m-%d") if datetime.now() < expiry <= threshold: result.append({ "worker_id": archive.worker_id, "worker_name": archive.name, "cert_name": cert.cert_name, "expiry_date": cert.expiry_date, "days_remaining": (expiry - datetime.now()).days }) return result
多维标签智能匹配引擎
以下代码实现了基于技能标签、评分、经验、区域等多维度的服务人员智能匹配与排序逻辑。
from dataclasses import dataclass, field from typing import Optional class MatchRequest: """用户预约匹配请求""" service_type: str # 服务类型:月嫂/保姆/育儿嫂 required_skills: list = field(default_factory=list) min_rating: float = 0.0 min_experience_years: float = 0.0 max_budget: float = 0.0 # 预算上限(元/月) service_area: str = "" # 服务区域 preferred_tags: list = field(default_factory=list) # 偏好标签 class MatchResult: """匹配结果""" worker_id: str name: str composite_rating: float years_of_experience: float skill_match_score: float overall_score: float matched_tags: list = field(default_factory=list) class WorkerMatchEngine: """服务人员智能匹配引擎""" def __init__(self): self.archives = {} # worker_id -> WorkerArchive def load_archives(self, archives: list): """加载已上架的服务人员档案""" for archive in archives: self.archives[archive.worker_id] = archive def hard_filter(self, request: MatchRequest) -> list: """ 硬性条件过滤:技能必须全覆盖、评分达标、经验达标、区域匹配 """ candidates = [] for archive in self.archives.values(): if archive.status != "active": continue # 技能全覆盖校验 if not set(request.required_skills).issubset(set(archive.skill_tags)): continue # 评分门槛 if archive.composite_rating < request.min_rating: continue # 经验门槛 if archive.years_of_experience < request.min_experience_years: continue # 区域匹配 if request.service_area and archive.service_records: areas = {r.service_area for r in archive.service_records} if request.service_area not in areas: continue candidates.append(archive) return candidates def soft_score(self, archive, request: MatchRequest) -> MatchResult: """ 软性打分:对通过硬性过滤的候选人进行综合评分 打分维度:技能匹配(30%) + 评分(25%) + 经验(20%) + 偏好标签(15%) + 订单量(10%) """ # 技能匹配度:在满足硬性条件基础上,额外技能越多分越高 extra_skills = set(archive.skill_tags) - set(request.required_skills) skill_score = min(1.0, 0.6 + len(extra_skills) * 0.1) # 评分归一化(满分5分) rating_score = archive.composite_rating / 5.0 # 经验归一化(假设10年为满分) experience_score = min(1.0, archive.years_of_experience / 10.0) # 偏好标签匹配 if request.preferred_tags: matched = set(request.preferred_tags) & set(archive.skill_tags) tag_score = len(matched) / len(request.preferred_tags) else: tag_score = 0.5 # 无偏好时给中间分 # 订单量(反映市场认可度) order_score = min(1.0, archive.total_orders / 50.0) overall = ( skill_score * 0.30 + rating_score * 0.25 + experience_score * 0.20 + tag_score * 0.15 + order_score * 0.10 ) matched_tags = list(set(request.preferred_tags) & set(archive.skill_tags)) return MatchResult( worker_id=archive.worker_id, name=archive.name, composite_rating=archive.composite_rating, years_of_experience=archive.years_of_experience, skill_match_score=round(skill_score, 3), overall_score=round(overall, 4), matched_tags=matched_tags ) def match(self, request: MatchRequest, top_n: int = 10) -> list: """ 执行匹配:硬性过滤 → 软性打分 → 排序取TopN """ candidates = self.hard_filter(request) if not candidates: return [] scored = [self.soft_score(c, request) for c in candidates] scored.sort(key=lambda x: x.overall_score, reverse=True) return scored[:top_n]
四、关键设计要点
关于证照有效期管理:月嫂、保姆等岗位对健康证等证照的时效性要求很高。系统应设置定时任务,在证照到期前30天、7天分别推送提醒消息给服务人员和运营人员。证照过期后自动将档案状态切换为"冻结",避免过期人员被预约。
关于评价画像的防刷机制:评价画像直接影响匹配排序,必须防止刷分。建议从以下角度设计:同一用户30天内对同一服务人员的评价只计一次;评价需关联真实完成的订单;异常评分(如连续多条5分或1分)触发风控审核。
关于技能标签体系的维护:标签体系应由运营团队统一维护,避免服务人员随意填写导致标签泛滥。建议建立标准标签库,服务人员注册时从标签库中选择,运营审核时确认。随着业务发展,可定期扩充标签库。
关于档期管理:月嫂等岗位的服务周期较长(通常26天或42天为一期),档案中应维护服务人员的档期日历。匹配时需排除档期冲突的人员,避免推荐已被预定的月嫂。
关于隐私保护:服务人员档案中包含身份证、手机号等敏感信息,存储时应加密处理,用户端仅展示脱敏后的信息(如姓名显示"张阿姨"、手机号显示"1385678"),完整信息仅在订单确认后对授权人员可见。
以上是家政预约平台人员档案管理系统的整体设计与核心代码实现。核心思路是"五层档案模型 + 生命周期状态机 + 硬过滤与软打分两级匹配",通过结构化的档案管理和多维度的智能匹配,帮助用户快速找到符合需求的优质服务人员,同时为平台运营提供高效的档案管理能力。