Module account_locator 

Stable API — 账户定位纯规则（acc_id / card_num / uni_card_num）。 Surface 只能调用这些规则，不应各自手写 4 位卡号、16 位卡号、白名单和可见 卡号匹配语义。 账户定位纯规则。

这层只处理 acc_id / card_num / uni_card_num 的字符串语义，不发网络、 不读 cache、也不做 surface 文案。CLI / REST / MCP / daemon cache 都应复用 这里的规则，避免一个用户可见卡号在不同入口解析出不同账户。

Structs

CardNumFormatError

card_num 查询格式错误。

Enums

CardNumResolution

card_num 定位后的账户匹配状态。

Traits

AccountCardRecord

可参与 card-num 定位的账户记录。

AccountVisibilityRecord

可参与默认账户发现投影的账户记录。

Functions

acc_id_visible_to_caller

判断单个 acc_id 是否对 caller 可见。

account_matches_card_num

一个账户是否命中 card_num 查询。

app_visible_accounts

对账户全集应用默认用户可见投影。

card_num_allowed_by_whitelist

用户输入的 card_num 是否落在 API key 的 allowed_card_nums 白名单内。

card_num_matches

单个候选卡号是否命中查询。

is_app_visible_account

判断一条账户记录是否应出现在默认用户可见账户发现结果中。

is_app_visible_account_parts

通过原始字段判断默认账户发现是否应展示。

is_app_visible_business_label

backend 明确给出的用户可见业务账户标签。

is_futures_market

是否属于 App 不单独展示的期货-only 市场。

match_card_num_in_records

在账户集合中按 card_num 查询匹配的 acc_id。

redact_card_num

用户可见错误里脱敏 card_num。

resolve_card_num_in_records

在账户集合中按 card_num 查询，并返回统一的 0/1/N 分类。

validate_card_num_query

验证用户输入的 card_num 查询。

visible_card_num

用户可见的统一卡号。