50 lines
4.1 KiB
Markdown
50 lines
4.1 KiB
Markdown
# 领域术语表
|
||
|
||
## 资产（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 中“资产类型 + 标准化资产标识 + 套餐编码”相同的行。首次出现的行正常处理，后续重复行失败并指向首次出现的行号；同一资产的不同套餐不算重复，重复行也不表达购买多份。
|