Kris
b88c0ae29e
新增完整的 channels 限界上下文模块，包含契约层、领域核心层、应用服务、管道编排、插件体系、基础设施组合根等全层级代码，新增飞书与微信 iLink 渠道插件基础结构，补充各类 DTO、端口协议与领域服务实现。
120 lines
3.5 KiB
Python
120 lines
3.5 KiB
Python
"""身份 DTO。
|
||
|
||
定义身份解析相关的不可变值对象，包括统一身份 ID、身份置信度枚举、
|
||
身份解析结果、身份提供者配置与身份解析命令。所有 DTO 均为
|
||
``dataclass(frozen=True)``，仅依赖标准库与契约层内部类型，用于
|
||
身份解析、统一身份关联与置信度评估（FR-05）。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from dataclasses import dataclass
|
||
from enum import StrEnum
|
||
from typing import Any
|
||
|
||
from yuxi.channels.contract.dtos.channel import ChannelType
|
||
from yuxi.channels.contract.errors import ValidationError
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class UnifiedIdentityId:
|
||
"""统一身份 ID。
|
||
|
||
标识用户统一身份的唯一 ID，用于跨渠道身份关联与路由匹配。
|
||
|
||
字段：
|
||
value: 统一身份 ID 字符串。
|
||
"""
|
||
|
||
value: str
|
||
|
||
|
||
class IdentityConfidence(StrEnum):
|
||
"""身份置信度。
|
||
|
||
标识身份解析结果的置信度等级，用于路由决策与审计。继承
|
||
``str, Enum`` 以支持 JSON 序列化与字符串比较。
|
||
|
||
取值：
|
||
HIGH: 高置信度。
|
||
MEDIUM: 中置信度。
|
||
LOW: 低置信度。
|
||
"""
|
||
|
||
HIGH = "high"
|
||
MEDIUM = "medium"
|
||
LOW = "low"
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class IdentityResolveResult:
|
||
"""身份解析结果。
|
||
|
||
描述身份解析的产出，包括统一身份 ID、身份类型、置信度与可选的
|
||
关联用户 ID 及元数据，用于 FR-05 身份解析与统一身份关联。
|
||
|
||
字段：
|
||
unified_identity_id: 统一身份 ID。
|
||
identity_type: 身份类型（邮箱 / 手机 / 组织员工 ID）。
|
||
confidence: 置信度（数值型，0.0-1.0）。
|
||
metadata: 渠道侧元数据（可选）。
|
||
resolved_user_id: 关联用户 ID（可选）。
|
||
"""
|
||
|
||
unified_identity_id: UnifiedIdentityId
|
||
identity_type: str
|
||
confidence: float
|
||
metadata: dict[str, Any] | None = None
|
||
resolved_user_id: str | None = None
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class IdentityProviderConfig:
|
||
"""身份提供者配置。
|
||
|
||
描述身份解析器的配置，包括名称、启用状态、优先级与配置字典，用于
|
||
FR-05 身份解析器注册与执行顺序控制。
|
||
|
||
字段：
|
||
name: 解析器名称。
|
||
enabled: 是否启用（默认 True）。
|
||
priority: 优先级（默认 100）。
|
||
config: 配置字典（可选）。
|
||
"""
|
||
|
||
name: str
|
||
enabled: bool = True
|
||
priority: int = 100
|
||
config: dict[str, Any] | None = None
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class IdentityResolveCmd:
|
||
"""身份解析命令。
|
||
|
||
由身份解析端口方法引用，描述一次身份解析请求，携带渠道类型、对端
|
||
ID、账户 ID 与可选元数据，用于驱动身份解析流程。
|
||
|
||
字段：
|
||
channel_type: 渠道类型。
|
||
peer_id: 对端 ID。
|
||
account_id: 渠道账户 ID。
|
||
metadata: 入站消息元数据（可选，供手机号解析器等读取）。
|
||
"""
|
||
|
||
channel_type: ChannelType
|
||
peer_id: str
|
||
account_id: str
|
||
metadata: dict[str, Any] | None = None
|
||
|
||
def __post_init__(self) -> None:
|
||
"""校验必填字段非空（FR-05）。
|
||
|
||
``peer_id`` 与 ``account_id`` 必须非空，在构造时即抛出
|
||
``ValidationError``，adapter 不再做该校验（INV-8）。
|
||
"""
|
||
if not self.peer_id:
|
||
raise ValidationError("peer_id", "must not be empty")
|
||
if not self.account_id:
|
||
raise ValidationError("account_id", "must not be empty")
|