4.1 KiB
领域术语表
资产（Asset）
IoT 卡 / IotCard：物联网流量卡，以 ICCID 为唯一标识。分为独立卡（is_standalone=true，未绑定设备）和设备卡（绑定在设备上）。
设备 / Device：硬件设备，以虚拟号（VirtualNo）为业务标识，可插卡使用。
资产世代 / Generation：generation 字段记录卡/设备经历"换货+旧资产转新"操作的次数。初始值为 1；每完成一次换货且旧资产执行"转新"后加 1。generation > 1 说明该资产曾作为旧资产经历过换货并被重新投入使用。
资产业务状态 / AssetStatus：asset_status 字段表示资产在 CMP 内部的业务生命周期（1=在库, 2=已销售, 3=已换货, 4=已停用）。换货完成时旧资产置为 3；执行"旧资产转新"后重置为 1，同时 generation+1。
企业授权（Enterprise Authorization）
卡企业授权：将独立卡授权给企业使用的操作。业务约束：一张卡在同一时间只能授权给一个企业（与设备授权保持一致，数据库通过部分唯一索引强制约束）。
有效授权：revoked_at IS NULL AND deleted_at IS NULL 的授权记录。撤回授权后（revoked_at 有值）视为历史记录，不计入当前授权关系。
设备企业授权：将设备（含其绑定卡）授权给企业使用的操作。同一台设备同一时间只能授权给一个企业（uq_active_device_auth 唯一约束）。
代理资金（Agent Funds）
代理主钱包 / Agent Main Wallet：代理店铺承担订单结算和债务的唯一钱包；信用额度只属于该钱包，不属于角色、平台员工、佣金钱包或资产钱包。
信用额度 / Credit Limit：平台授予某个代理主钱包、允许其现金不足时继续使用的最高资金边界。额度本身不是余额，也不是一笔充值。
角色默认信用模板 / Role Default Credit Template：客户角色为未来新建代理提供的信用开关和额度默认值；创建主钱包时复制一次，之后与该钱包实际信用额度相互独立。
现金可用金额 / Cash Available Amount：代理主钱包的账面余额减冻结金额，不包含信用额度。
总可用金额 / Total Available Amount：现金可用金额加当前启用的信用额度，是主钱包扣款和冻结可否执行的资金边界。
欠款 / Debt：代理主钱包账面余额低于零的部分；冻结信用不直接形成欠款。
企业微信审批（WeCom Approval）
业务提交人 / Business Submitter：在本系统实际创建退款或线下充值申请的登录账号，是审批单展示、通知、数据权限和审计中的真实发起人。
企微发起身份 / WeCom Creator Identity：调用企微 applyevent 时使用的成员 userid。平台/超级管理员使用当前系统账号扫码绑定的本人 userid；代理使用部署配置中的固定企微账号代提交。无论身份来源如何，审批实例和表单都必须独立保存真实业务提交人。
单次退款申请 / Single Refund Application：一张退款单只对应一条企微审批申请。企微拒绝后，审批和该退款单同时终结，原退款单不可修改、不可重提；业务人员纠正问题后若仍需退款，必须重新创建退款单，生成新的退款 ID、退款单号、业务快照和企微审批申请。
批量订购（Bulk Purchase）
批量订购批次 / Bulk Purchase Batch：内部员工以一种统一支付方式提交的一份 CSV 订购任务。批次不绑定单一代理，同一批次可以包含不同代理名下的资产。
结算代理 / Settlement Agent：批量订购每一行根据资产处理时的当前归属解析出的代理。该行的套餐授权、成本价和代理主钱包均以结算代理为准；结算代理不是前端提交的批次参数。
批量订购重复行 / Duplicate Bulk Purchase Row：同一 CSV 中“资产类型 + 标准化资产标识 + 套餐编码”相同的行。首次出现的行正常处理，后续重复行失败并指向首次出现的行号；同一资产的不同套餐不算重复，重复行也不表达购买多份。