验票系统管理后台

解绑人脸：解的是当前那张脸。若这张脸是照片建库来的（人脸列显示「已绑·照片」）， 解绑后不再自动重建，照片仍保留可查看，持票人须到闸机重新绑定；若是现场扫码/刷证绑的 （覆盖了票务方照片），解绑后会退回那张照片重新建库。挂失后立即禁止通行。 人脸列出现红色「缺 …」标记表示该票种要求的实名资料不齐，这类票不会下发到闸机， 人到现场刷不进——点【编辑】把缺的项补齐即可。 重新绑定（争议处理）：清空该票的人脸/照片/姓名/证件号/手机号全部登记信息，票码保持有效， 正确的持票人扫码即可重新登记；适用于绑错人、冒用等争议场景，操作计入对接记录留痕。

生成后票码来源固定标记为「纸质票」，与票务方 API 写入的票（来源「票务API」）分类管理、互不覆盖。 票面二维码印登记链接：观众手机扫码打开登记页填姓名+身份证；闸机扫同一个码自动解析出票码正常核验。

「导出二维码表格」把当前筛选的每张票直接生成 Excel：票码 / 票面链接 / 内嵌二维码图片 / 批次， 交印刷厂直接可用，无需再制码（数千张时生成约需十几秒，打开大文件请耐心等待）； 「打印二维码」适合小批量应急（本页最多 1000 张）；「导出 CSV」为纯文本清单（含链接列）。 观众绑定采集本人照片 + 姓名 + 手机号，无需身份证：观众扫票面二维码打开绑定页 （页面含信息采集用途提示）填写并自拍上传，照片建库后闸机人脸一致即放行；未提前绑定的 观众在闸机扫码时现场绑脸兜底（无姓名/手机号）。「清除绑定」清空姓名/手机号/照片/人脸 绑定，观众可重新扫码绑定；证件号仅在需要时由后台代登记。
票已印好（票码已存在）的存量纸质票：在【导入与设置】用 CSV 导入并加一列 source 填 paper，然后张贴海报二维码（内容为 https://本站域名/p.html?project=项目id），观众扫海报后手动输入票面票码即可绑定。

表里的数字可以点，点开就是「票证管理」里筛好的对应明细，能直接编辑、传照片、查通行记录。 绑脸率低说明这批票发出去了但持票人还没登记，展前要盯的就是这一列。

通行日（D0/D1/D2）、通道与人员类型随所选票种，无需单独设置；每张码同时生成 票码（二维码内容）和 credential_id（票务方 API 主键），来源标记「批量生成」， 与纸质票、票务方 API 写入的票分类管理、互不影响。大批量（数万张）生成约需数秒。

一键分类导出：不用逐个选票种，一次点击把所有已生成的票种各自导出为独立文件（文件名带票种名）， 直接分发给票务方对应负责人。 「导出 CSV」为纯文本清单，列：票种 / 票码 / credential_id / 二维码内容 / 批次 / 通行日 / 状态，票务方按 「二维码内容」列自行制码；「导出二维码表格」则把每张票的二维码图片直接内嵌在 Excel 行内 （列：票种 / 票码 / credential_id / 二维码图 / 二维码内容 / 批次），对方拿到即可导入打印、无需再制码， 超过 5000 张自动拆分成多个文件（每文件约 15MB，数万张生成需一两分钟，请留在本页等待）。 非观众二维码固定导出为实名登记链接，持有人须填写姓名、身份证号、手机号并拍摄本人照片后才可通行； 即使选择「纯票码」，工作人员/展商等非观众票也会自动改为登记链接。纯票码仅适用于由票务方导入信息的观众票。

观众票白名单玩法：发码给票务方前先「整票种停用」；票务方定期回传已售名单， 粘贴到上框「批量激活名单」——只有已售出的码能过闸，未售出的码扫码即拒（"该票已挂失或停用"）。 名单支持直接粘贴 Excel/CSV 整块内容，系统自动识别其中的票码与 credential_id，重复行自动去重。 每次操作计入对接记录留痕。

「删除未使用」只删除该批次中未绑脸且未入场的码（已发放使用的不受影响），用于误生成后清理。 单张码的查询、挂失、作废在【票证管理】里按票码/批次搜索维护。

删除后该 IC 卡/员工码变为未登记，下次在闸机刷卡会重新"卡+脸"绑定（即换脸）。停用则禁止通行且不可重绑。

"限进 N 次"票种用于会展/巡展等按次消耗场景，与"D0/D1/D2 按天放行"是两种互斥的规则，票种上二选一。 票证在【票证管理】编辑弹窗里选择所属票种（不选则按票证自身的 D0/D1/D2 走）。

命中姓名或证件号任一项即拒绝通行（reason: blacklisted），仅在当前所选项目内生效。

只操作当前项目内勾选的闸机；单机覆盖优先于设备组和全局阈值。保存后约 40 秒内生效，不会触发人脸库全量下载。

设备（闸机 / 手持机）在首次调用核验接口时自动登记，2 分钟内有请求视为在线。停用设备后其核验请求会被直接拒绝。

设备组用于给同一项目下不同入口配置不同的人脸比对阈值（例如化妆比例高的入口可以适当放宽阈值）。 阈值留空则该组设备使用全局默认值。在【设备管理】页把设备分配到某个组即可生效（约 40 秒内下发）。

对外接口的每一次调用逐笔留证：票务方 API（含鉴权失败）、观众纸质票自助登记、后台对票证的增改/挂失/解绑/导入， 均保存请求原文（照片等大字段脱敏）、处理结果、来源 IP、操作方与时间，可导出存档，用于对接纠纷时举证。

同一套后台可同时服务多个客户/多场活动，彼此票证、设备、通行记录、票务方 API Key 完全隔离。 每个活动项目分别填写对接票务方并发放独立 Key；同一票务方承接多个活动时也不能复用 Key。 如同一活动需要同时接入多家票务方，禁止共用项目 Key，须先建立独立的票务接入通道。 顶部"当前项目"选择器决定其余各页看到的是哪个项目的数据。设备可在【设备管理】页分配到某个项目。

场馆是可以跨项目复用的资产（例如同一体育馆一年办多场比赛），不属于任何单个项目。 项目可以在【项目管理】页选择关联某个场馆；不关联场馆的一次性活动可以继续用项目自己的场馆名称/地址文本字段。

表头需含 credential_code（或 qrcode）；可选列：display_name/name、real_name、id_card_no、credential_type、gate_category、 pass_d0、pass_d1、pass_d2、note。Excel 名单请先"另存为 CSV UTF-8"再粘贴，或用 python backend\import_xlsx.py 名单.xlsx 输出.csv 转换。

导入的票证归属于顶部当前所选项目，请先在【项目管理】选好项目再导入。

范围 0.60～0.95；数值越高越严格，越低越容易识别。保存后闸机下一次配置轮询自动生效，不触发人脸库全量下载；设备组设置会覆盖这里的全局值。

大屏挂在场馆里，链接会留在地址栏、访问日志和交接文档中，所以单独发一把只读令牌， 不要再用管理密钥打开大屏。该令牌只能读大屏需要的几个接口、只能 GET， 碰不到票证列表、设置、导出和任何写操作；返回的票码与身份证号已在服务端打码， 抓拍图也只给最近 6 小时的。令牌泄露或大屏换人看管时点【重置令牌】，旧链接立即失效， 不影响管理密钥和闸机设备。

当前场次（D0/D1/D2）已改为按项目设置，请到【项目管理】页每个项目自己的编辑框里改。

回传由服务器统一发出，闸机不直连对方接口 —— 现场闸机多且会离线，服务端做队列重试才不会漏推， 密钥也只需保管一份。放行时只入队不发送，对方接口超时不会拖慢开闸。
DES 参数必须与对方完全一致：分段长度、IV、编码任何一项不同，对方都会解出乱码并返回 appId or appToken is invalid。拿到对方给的测试向量后，改完参数点【试推一条】即可验证， 不用等真人过闸。
重试按 10s→30s→1m→5m→10m→30m→1h 退避，最多 8 次。对方返回业务错误码（非 500）或 HTTP 4xx 时 不再重试，避免无效请求反复刷对方接口，这类置为 dead 等人工处理。

阿里云：开通「实人认证-金融级人脸核身」，控制台创建网页 H5类型认证场景拿到 SceneId， 连同 AccessKey 填入即可（RAM 账号需授权 CloudAuth）。腾讯云则填 SecretId/SecretKey 与 H5 核身 RuleId。 密钥留空时，自助入场 H5 自动退化为"自拍上传"模式（不做公安库比对，仅凭姓名+证件号匹配票）。 未带身份证观众的自助入口：项目管理页每个项目的「自助入场码」按钮（打开可打印的张贴码）。