授权与网关

本页由 docs:sync 从数据库结构生成，请勿手工编辑。

license_grants

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
customer	varchar(150)	否	—	客户名称（公司全称，与授权文件 payload 一致）
domains	json	否	—	可拉取此授权的域名清单（子域自动匹配，与授权 domains 语义一致）
license	text	否	—	已签发的 .lexlic 原文（构建机产物；客户机侧照常本地验签）
status	varchar(20)	否	active	active/disabled
last_fetched_at	timestamp	是	—	最近一次被拉取时间
notes	varchar(500)	是	—	备注
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
tenant_id	bigint unsigned	是	—	归属客户账号（拉取须持该租户的登录凭证；null=旧登记，不可拉取）
maintenance_until	date	是	—	维护期至（展示副本；真源在签名 payload 内，续期必须重签发换文本并同步本列）
license_id	varchar(40)	是	—	授权编号（payload.license_id，追溯签发批次）
issued_at	timestamp	是	—	本文本的签发时间（续期重签发时更新）
fetch_instance	varchar(16)	是	—	在线拉取 TOFU 指纹：首拉记录，此后不符即拒；管理端可重置
fetch_count	int unsigned	否	0	在线拉取累计次数（审计）
product_version	varchar(20)	是	—	签发时交付的产品版本（记录用，不参与签名）
expected_instance	varchar(64)	是	—	预登记的实例指纹：非空时首拉也必须匹配（关闭 TOFU 抢绑窗口）；空=首拉即绑定

gateway_clients

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
customer	varchar(150)	否	—	客户名称
status	varchar(20)	否	active	active / disabled
token_balance	bigint	否	0	预充值 token 余额（用尽硬拦 AI）
monthly_token_limit	bigint unsigned	是	—	月度用量上限（null=只看余额）
monthly_free_tokens	bigint unsigned	是	—	月度赠送 tokens（自然月循环，null=无赠送）
notes	varchar(500)	是	—	—
allowed_models	json	是	—	客户可自选的驱动白名单（null=不开放自选）
last_used_at	timestamp	是	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
month_key	char(7)	是	—	月度预占口径的自然月（YYYY-MM）；跨月首次准入时重置 month_reserved
month_reserved	bigint unsigned	否	0	本月已预占 tokens（含在飞预占，settle 时校正为实际用量）——月度上限的准入口径
month_free_used	bigint unsigned	否	0	本月已占用的赠送份额（随 month_key 翻页归零）
tenant_id	bigint unsigned	是	—	归属租户（账号化计费主体；null=旧版纯授权码客户）

gateway_keys

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	归属租户（平台级表不挂全局作用域，查询显式过滤）
client_id	bigint unsigned	否	—	计费钱包（gateway_clients）
label	varchar(100)	否	—	用途备注（哪个站/哪套系统）
domain	varchar(190)	是	—	软绑定域名（仅观测展示，OpenAI 协议无域名概念，不做硬拦截）
token_hash	varchar(64)	否	—	明文 sha256（鉴权查行；明文只在签发响应出现一次）
token_encrypted	text	否	—	明文的 Crypt 密文（客户侧显式取值回显；模型 $hidden，整体序列化不带出）
token_prefix	varchar(20)	否	—	展示前缀（sk-lexi-xxxx…，列表识别用）
status	varchar(20)	否	active	active/disabled
monthly_token_limit	bigint unsigned	是	—	密钥级月度上限（tokens，空=不限，只受钱包约束）
month_key	varchar(7)	是	—	月度预占口径的自然月（YYYY-MM）
month_reserved	bigint unsigned	否	0	本月已预占 tokens（含在飞；结算多退少补校正）
model_map	json	是	—	模型路由：请求 model 名 → "驱动[:模型],驱动[:模型]" 主备链；空=仅 default 走平台默认路由
moderate	tinyint(1)	否	1	输入侧内容审核开关（输出为流式透传，仅事后审计）
instance	varchar(64)	是	—	最近上报的 CMS 实例指纹（X-LexiSite-Instance，软观测）
site_url	varchar(300)	是	—	最近上报的站点地址（软观测展示）
bound_at	timestamp	是	—	首次真实调用时间（台账「已接入」判定）
last_used_at	timestamp	是	—	—
created_by	bigint unsigned	是	—	创建者 user id（平台代建=运营侧，客户自建=客户管理员）
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

gateway_usage

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
client_id	bigint unsigned	否	—	—
key_id	bigint unsigned	是	—	计费密钥（0.12 起；null=历史账号 token 时代的流水，台账列为「未归属密钥」）
feature	varchar(30)	否	chat	builder / widget / translate…（客户端上报）
model	varchar(60)	是	—	实际命中的模型
input_tokens	int unsigned	否	0	—
output_tokens	int unsigned	否	0	—
created_at	timestamp	是	—	—
instance	varchar(64)	是	—	客户机实例指纹（APP_KEY 派生哈希前 16 位）；同一授权码多实例=疑似一码多装，后台预警