📘 商户商机员工抢单系统
使 用 说 明 书

本系统用于银行商户商机的发布 → 抢单 → 跟进补录 → 核对归档全流程闭环管理。三级角色数据严格隔离，未抢单商机自动脱敏，抢单成功后解锁完整数据，72 小时未完成自动释放重新开放抢单。

1.1 当前访问地址

3.1 首次身份绑定

1. 手机浏览器打开 /m（或将链接分享至网点经理微信群，点击打开）；
2. 录入网点机构号（联系管理员获取）、本人姓名、联系电话，点击「绑定身份，进入抢单」；
3. 绑定后身份信息自动留存，后续抢单无需重复填写；机构号错误的无法绑定，外部人员无访问权限。

3.2 抢单流程

1. 商机大厅：首页只展示「未抢单」有效商机（已抢/已完成自动隐藏），每条仅显示 商户名称、商户地址、用户类型，手机号、商户编号、费率、账号、授权码、证书号等敏感字段全部隐藏（系统强制脱敏，无开关）；支持按用户类型、发布时间筛选；
2. 立即抢单：点击「⚡立即抢单」确认后一键抢占。同一商机仅允许 1 名经理抢到：服务器以请求到达时间为准毫秒级判定，手慢者提示「抢单失败，该订单已被抢占」；
3. 查看订单：抢单成功后自动解锁该订单全部数据（商户信息、费率、限额、分润、服务商联系方式等），订单卡显示 72 小时倒计时；
4. 补录提交：商户申请审核通过、商户生成后，在「查看/补录」中填写 商户编号（必填）、建行机构号、建行商户号、终端号、柜台号、微信/支付宝二级商户号、分行号（默认 360000000）、商户授权码、经度、纬度、建行证书号（非必填）、落地备注，点击「提交服务商核对」，订单进入「待完善」状态；
5. 消息提醒：底部「消息」页查看抢单成功提醒、第 2 天时效提醒、到期前 6 小时预警、超时释放提醒、订单完成提醒；
6. 个人台账：「我的已抢」查看处理中/待完善订单（含倒计时），「已完成」查看历史归档订单。

3.3 时效规则（重要）

• 抢单成功瞬间开始计时，72 小时（3 个自然日）为有效处理周期；
• 超时未提交商户申请的，系统自动取消抢单资格，订单重置为「待抢单」重新开放给所有经理（同一经理可重新抢该订单）；
• 同一未完成订单同一经理不可重复抢占；已超时释放的订单任何人（含原经理）可重新抢。

4.1 登录

使用银行分配的服务商编号 + 账号 + 密码登录。每个服务商仅能查看、管理自己发布的商机与订单，完全无法看到其他服务商数据。

4.2 发布商户商机

1. 进入「发布商户商机」面板，填写发布必填字段：商户名称（营业执照全称）、商户手机号、商户地址、用户类型（企业/个体）；
2. 选填：商户联系人、商户费率、是否收单轻应用、分润百分比、单笔/日/月交易限额、是否已设回调地址（这些参数抢单前对经理隐藏，抢单成功后自动解锁）；
3. 发布机构、业务员姓名、业务员手机号由系统自动带出；
4. 点击「🚀发布商机」，订单自动生成商机编号并进入抢单池，实时同步至客户经理抢单端。

4.3 订单跟进与核对补录

• 「自有订单台账」实时显示订单状态：待抢单 → 已抢单（处理中）→ 待完善 → 已完成，以及超时释放次数；
• 订单被抢后可见抢单经理的姓名、机构号、联系方式；
• 点击「核对/补录」可修改订单全部业务参数（含经理提交的商户编号、终端号等），所有修改自动留存修改人、修改时间、修改前后值；
• 「取消抢单资格」：可将已抢/待完善订单重置为待抢单重新开放（如经理长期不跟进）；
• 「归档完成」：经理提交（待完善）且参数核对无误后，点击归档，订单闭环、停止计时与推送，归档后仅可查看、不可修改；
• 「导出台账 CSV」：一键导出本服务商全部商机/抢单/完成记录（Excel 可直接打开）。

5.1 服务商账号管理

• 创建服务商：填写服务商编号、登录账号、初始密码、机构名称、联系人，一键创建；
• 支持账号启用/禁用（禁用后立即无法登录）、密码重置；所有登录、操作全程留痕。

5.2 全量数据监管

• 「全量订单监管」：查看系统内所有服务商的商机、所有网点经理抢单记录，可按关键词、状态、服务商、网点机构号、发布日期区间筛选；每笔订单的完整数据、时效记录、人员信息、超时释放次数一目了然；
• 「导出全量报表」：全量订单明细一键导出 Excel(CSV)，满足存档与合规要求。

5.3 多维度统计

• KPI 总览：商机总量、已抢订单数、订单抢单率、有效完成数、有效完成率、超时释放次数；
• 图表：各服务商发单量/完成/超时释放对比、各网点抢单量 TOP20、每日发单趋势；
• 所有明细可按时间（日/周/月/自定义区间）、服务商、网点、订单状态筛选后导出。

5.4 系统日志

全量记录商机发布、抢单、补录、修改、状态变更、归档、登录、报表导出等操作（含操作时间、角色、操作人、详情、关联订单），支持关键词检索与导出，满足审计合规。

5.5 网点机构

内置 98 个网点机构号（010001～010098），客户经理绑定时的机构号即在此范围内核验。

8.1 启动与停止（本机服务器 + 公网隧道）

• 启动：双击 启动抢单系统.bat —— 自动同时启动「主服务」（三端后台+数据库+每日03:00自动备份）和「公网隧道」（cloudflared，免注册），约 1~2 分钟后生成公网地址，写入 公网地址.txt，门户页/说明书页同步实时显示；
• 公网隧道断线自动重连（tunnel_manager.py 守护进程）；重连后地址可能变化，以 公网地址.txt / 门户页显示为准；
• 服务端口默认 8080，修改端口：设置环境变量 QD_PORT（隧道脚本需同步修改）；
• 修改超时时长（默认72小时）：环境变量 QD_TIMEOUT_HOURS；
• 数据文件：安装目录下 data/qiangdan.db（SQLite）；每日 03:00 自动备份到 data/backup/（保留最近 30 份），也可随时运行 db_backup.py 手动备份；
• 局域网使用：手机与服务器同一网络时，用 http://服务器IP:8080/m 访问（当前服务器内网 IP：192.168.3.27）；
• 停止：关闭「抢单系统-主服务」与「抢单系统-公网隧道」两个最小化的窗口。

8.2 常见问题

• Q：公网地址打不开？ A：① 确认「抢单系统-主服务」「抢单系统-公网隧道」两个窗口在运行；② 打开门户页看实时地址是否已更新；③ 免费隧道偶发抖动，守护进程会自动重连。
• Q：绑定提示机构号不存在？ A：核对银行监管端「网点机构」页的机构号（010001～010098）。
• Q：抢单提示已被抢占？ A：正常现象——同一商机仅 1 人成功，其余请求毫秒级判定失败，请抢其他商机。
• Q：倒计时归零订单去哪了？ A：72 小时超时已自动释放回抢单池（我的已抢中消失，可在大厅重新抢）。
• Q：补录提交提示必须填商户编号？ A：商户编号是商户生成后的核心标识，为提交必填项。
• Q：订单已归档还能改吗？ A：不能。归档后全端只读，如确需修正请联系银行监管端核查日志处理。
• Q：CSV 打开乱码？ A：导出文件已带 BOM，直接双击用 Excel 打开即可；若用 WPS 请选择 UTF-8 编码。