?demo=1 再打开即回到真实数据。
file:// 开头)。数据照样能读写,但这个地址不能收藏、换台电脑打不开,导出与复制也可能被浏览器拦。要长期用,建议把 admin-web 传到静态托管,用固定网址打开并收藏(见「帮助与部署」第十节)。
总览
小程序全局状态与待办入口
小程序功能地图
当前实现状态一眼看清进入各操作模块
每个模块都有独立链接检测点资料
检测点资料与小程序 utils/sites.js 一致;改地址、电话、时段请改模板表后重新导入小程序,本页会自动同步展示口径。休假只按「检测点」设置,不影响其它点。
某检测点某天的时段占用
每段 1 个名额 · 服务端互斥开放时段与预约跨度配置
按检测点 · 负责人可改自己负责的点未配置过的检测点继续使用小程序内置默认时段,不影响现有预约。负责人只能改「可管检测点」范围内的点;改完立即生效,小程序下次打开自动同步。
未来 7 天预约占用
只显示检测点、日期、时段与状态,不显示姓名、手机号、openid;名额占用由云端 booking_slots 唯一键保证跨设备互斥。
休假设置(现场检测预约)
按检测点 · 分账号授权每个工作人员用自己的「员工口令」登录,只能设置自己负责的那一个检测点(如 A 管中大五院、B 管岭南社区);总管理可设「全部检测点」整体停约。权限在「账号与权限」页给每个账号勾选(模块管能进哪些页面、检测点管能管哪几个点),保存立即生效,网页与小程序都不用改。设置后小程序该点当天日期条标「休」、整日不可预约;自检服务包申领不受影响。
设好之后会自动给当天已经约上的人发一条微信停诊提醒(用户在提交预约时点过「允许通知」才收得到,一次授权只能发一条)。发不出去不会影响休假生效,结果会显示在下面,失败的人请按手机号电话联系。
按检测点的提醒路由
预约成功 / 取消都会推送客服名片(分地区接入)
按检测点配置接待人,小程序自动展示本页管理员和员工都能保存:管理员用管理密钥登录即可直接保存,不需要额外口令;员工需要先验证员工口令(下面那一栏,与休假设置页同一串),且该账号要在「账号与权限」里勾选「客服配置」模块、检测点范围包含要配的这个点。
「微信 / 企微」一栏:企业微信成员没有微信号,微信里搜不到企微账号名。要让微信用户加到他,填 ① 他的手机号(他在企微「设置 → 隐私」开启「可通过手机号搜索」后,微信里能搜到),或 ② 企微「客户联系 → 联系我」生成的添加链接(形如 work.weixin.qq.com/ct/...)。
名片上的电话可一键拨打;上面两种值小程序会自动识别,复制后给出对应的加好友引导。
按查询码查找申请
支持粘贴带空格或横线的码服务确认
未选中申请「标记完成服务」只登记状态,不会立即退款、也不会自动退;请再到左侧「押金退款」的「待退款列表」逐笔核对查询码后点该行「执行退款」,由云端原路退还。没有支付流水的联调单只登记、不退款。
申请列表
待退款列表
逐笔核对 · 不会自动退款只列出「工作人员已确认完成服务」的订单。需要进一步沟通的,先在下面填原因、再点该行的「标记待沟通」——暂缓期间从任何路径都不会退这笔;沟通清楚后点「取消暂缓」,再单独点「执行退款」。没有定时器,也没有一键批量统一退款。确认人、暂缓人、退款发起人都写入云端审计日志。
自检包设置
纪念品类别 · 各点剩余份数 · 尿液自检开放城市改完点「保存设置」即写入云端,小程序下次进入自检页自动生效,不用重新发版。云端尚未配置或云函数未部署时,小程序自动使用 utils/selftest-options.js 的默认值。保存需要管理密钥。
快递到家 · 随包纪念品类别
一行一个,最多 12 项第一项建议保留「不需要纪念品」。用户选快递到家时可从中选一项,所选类别会写入申领单与云端订单,工作人员在查询台可见。
尿液自检开放城市
只在这个城市提供发货与转账设置
后台隐藏字段的默认值超过原路退款期限的押金,改由「商家转账到零钱」退还;补贴结算只按云端账本,网页不能指定收款人或金额。
就近自取 · 各检测点剩余份数
一行一个:编号=数量,0 表示暂已领完这是对外展示的剩余份数,由运营按实际手动维护,不是实时扣减的库存;小程序每个点位显示「距离 + 剩余 N 份」,份数为 0 时标「暂已领完」。
结果判读与退款
判读 · 补绑 · 退款善后这一块只做两件事:看结果是否有效、把押金退回去。判读为有效不会当场发钱——单子会进入另一边的「补贴审核与发放」,由审核员确认是否本年度首次之后再发邀请补贴。所以这里判错,只是多一条待审核记录,钱不会直接出去。
本页不保存也不显示任何检测结果内容、阴阳性或照片,只记「有效 / 无效 / 待判读」这个结论。
结果判读
按 12 位查询码 · 判读不发钱判为有效之后:如果这一单还没绑邀请人,会提示「待审核 · 未绑邀请人」,先在下面补绑;绑好了就会自动进入对方的审核队列。
补绑邀请人
客服补救 · 不发钱朋友下单时漏填邀请码,可按邀请人本人的邀请码把关系补到这一单。补绑本身不发钱:如果这单已经判读有效,补绑后它会进入「待审核发放」,由审核员确认后再发 ¥20。已结算的订单不允许改绑;每次补绑/改绑都会记录操作人与原邀请人尾号。
邀请码以对方小程序「补贴」页当前显示的 6 位码为准。若和之前发出去的码不一样,说明旧码只是那台手机的本地临时码、从没成功写进云端(所以按旧码补绑会提示「找不到这个邀请码」);按现在显示的码补,成功后请让对方重新分享新码。
超期押金改由零钱退还
原路退款超期专用支付超过「原路退款期限」后无法原路退,按查询码单笔创建 ¥50 转账单。后台创建 ≠ 到账:新版商家转账要求用户本人在小程序「待领取款项」里确认收款,请同步通知用户。金额只取数据库订单,网页不能指定。
商家转账开通自检
只读探测 · 不产生资金动作微信支付只对「发起转账」这个出资接口校验接口 IP,查单不校验。白名单限制的是云函数服务器的出口 IP,不是你现在电脑/酒店的网络;在酒店用浏览器也能配置和检测。
「验证白名单是否放行」只发一笔注定失败的请求撞 IP 校验(伪造 openid、0.1 元),不会创建转账单、不会动资金:提示「IP 已放行」说明白名单生效;提示「IP 未放行」就再等几分钟或核对 IP。当前固定出口 IP:124.221.134.89(2026-11-13 已开标准版固定出口)。
补贴审核与发放
年度首次审核 · 通过才发钱判读员判为有效之后,单子会排到下面这张表。你要判断的只有一件事:这是不是这个人本自然年第一次检测。是 → 点「通过并发放」,¥20 进邀请人余额;不是 → 点「不通过」,写一句原因,钱不发、结论留在单子上。
表里的「本年已有效 N 单」和「邀请人今年已领」是系统给的线索,不是判决:一个人用不同手机号/微信号重复申领时,这两个数字会露馅,但最终由你拍板。金额与收款人不由网页指定,全部按订单里已绑定的邀请人结算。
补贴账户与流水
账本 · 提现 · 撤销补贴流水
最近 80 条 · 邀请补贴可撤销「邀请补贴」那一行右边的撤销用于纠正不该发的钱:解绑该单的邀请人、锁定这一单不再结算;已结算的会写一条负数流水并从邀请人余额扣回(余额不足的差额会标注「未追回」)。撤销记录本身也会出现在下面的流水里,不会静默改账。
补贴账户
最近 100 个 · 按尾号/邀请码找人点不参与补贴等于把这个人加进下面的豁免名单,只影响今后的结算。余额是还没提现的部分;撤销已结算补贴时先从这里扣,不够的差额会记在流水上。
补贴豁免名单
工作人员推广不计补贴推广补贴面向的是朋友推荐给朋友。工作人员、站点同事、内部账号自己推出去的单子不应计入补贴:加进本名单后,以他为邀请人的单一律不结算(不影响他本人的押金退还,也不影响他作为被邀请人的那部分规则)。
已经发出去的补贴不会自动回滚,请到上面「补贴流水」找到那一行点撤销:已结算的会冲正(写一条负数流水并从余额扣回),未结算的直接解绑并锁定这一单。同一单只可能撤销一次。
按邀请码添加,是因为尾号 6 位会撞、拿尾号当资金口径等于给错人免单。对方没注册过邀请码就找不到?让对方在「补贴」页停留几秒再试,或直接在上表「补贴账户」里找一个。
转账账单
提现 + 超期押金退还自检包发货
发货员 · 快递公司 · 快递单号这三个字段只由工作人员在后台维护,小程序申领页看不到。单号首次提交时会发一次性订阅消息,并把运单号录入微信「发货信息录入」,用户随后可在微信里看到物流动态。一个支付单只能录入一次,单号务必一次填对;填错请到 mp 后台「发货信息管理」改。
仓库发货常用「先导清单 → 打包 → 回填单号」:导出发货清单里含完整收件人、手机号与地址(列表里是脱敏的),所以导出要求管理密钥 + 当前操作员,每次导出都会写一条审计日志(谁、几条、是否只含未发货);单号可以整批粘贴回来一次登记。
录入发货信息
按 12 位查询码批量登记快递单号
一次最多 50 行 · 写审计日志从 Excel 直接复制粘贴,一行一单,用逗号、制表符或空格分隔:查询码,快递公司,快递单号。快递公司留空就用上面的默认快递;只填两列时按「查询码,快递单号」解析。每笔都会走与单笔完全相同的流程(订阅消息 + 微信物流录入),已填过相同单号的单不会重复发通知。
快递到家的申领单
最近 60 条发货的人看合并的(一列直接抄到快递单);做统计的人看拆分的(能按市、区县透视)。拆分格式比合并格式多「省 / 市 / 区县 / 详细地址」四列,并把完整地址原样保留在最右边,方便核对有没有拆错。早期订单只剩拼好的整串,会按空格自动反推;反推不出来的(例如手打成「中山市海伦印象」)省市区留空、整串放在详细地址,不硬猜。
CSV 用 Excel / WPS 直接打开(已带 BOM,中文不乱码);查询码与手机号按文本写入,不会被 Excel 变成科学计数法。清单里不做脱敏,只用于发货,不要转发到群里或存到公共盘。
文件会存到浏览器的默认下载目录(Chrome / Edge 一般是「下载」文件夹,即 C:\Users\你的用户名\Downloads),文件名形如 发货清单_合并_待发货_20261114-2135.csv;点导出后没看到文件,看地址栏右侧的下载图标——可能是被拦了,允许一次即可。
月度申领额度
每号每月 2 份 · 按手机号额度在建单那一刻就预占 1 份,防的是同一号码并发下单超领。未付款的单 30 分钟后会把额度自动还回去(付过款的单永远算一份),用户取消支付后重新申领不会白掉一份名额。
如果用户反馈「一份都没收到,却显示本月已满」——多见于旧版本反复取消支付——在这里按手机号重算一次即可:已收款的单照旧算一份,超时未付款的不算。重算会写审计日志。
自取领取(含流动自取点)
最近 80 条 · 给志愿者备货看固定自取点和流动自取点都在这里。流动点没有固定地址,靠「省 / 市 / 区县」+「具体位置」找人:地区由申领人用选择器选(和收货地址同一套标准行政区划),具体位置必须手写,两项都由后端强制非空。看到空值说明是旧版本客户端提交的,按「流动自取点」联系本人确认即可。
现场检测码(优惠码)
一张码 = 一次 1 分钱现场检测志愿者在现场帮人检测时,让对方输入这张码,押金就从 50 元变 1 分。规则只有三条:只在「流动自取点」能用(这张码买的是志愿者当场做的那次检测;快递到家、固定自取点都不能用,后端强制校验)、一张只能用一次、被占用 30 分钟没付款会自动放回(和名额预占同一个时长)。
建议提前生成、提前导出:现场信号差,志愿者手里得先有纸。一批给一个人 / 一场活动,备注写清给谁,生成后点「导出这批」拿到 CSV,打印或发微信都行。每张码不绑定具体某个人,要追责就靠备注与批次。
码只在流动自取点出现:申领人选了「快递到家」或「固定自取点」,小程序根本不会展示输入框。所以发码前先确认这场是流动点——在服务站等人来拿的那种固定点,用码会被后端直接拒掉。
当前登录与模块权限
按模块授权 · 云端强制工作人员账号管理
需管理密钥 · 改完立即生效口令只发给对应负责人,不要写进网页、不要发到群里。员工离职时在列表里点「停用」或「删除」即可,立即生效。员工用同一个后台网址登录,输入各自口令后只会看到自己被授权的模块,无需分发不同链接。
模块深链(发给对应工作人员)
配合其口令使用连接设置
默认仅保存在当前标签页;勾选「本机记住」后才会留在这台电脑https://xutong-d5gil4dmd518eb73a.service.tcloudbase.com/deposit-admin
两个岗位各用一个口令:「判读员」只能做结果判读、补绑邀请人与退款;「审核员」只能做年度首次审核、发放补贴与维护豁免名单。登录后左侧只显示你这个岗位的模块;越权动作云端会直接拒绝,改网址也没用。总管理仍用上面的管理密钥,看到全部模块。
日常登录不用进这一页:打开网址后在登录框输入你的口令(员工口令或管理密钥)即可,接口地址已自动带出。本页仅供排障:连不上时点「网络自检」看结论。手工 health 自检的方法见「帮助与部署」第二节。
口令去哪找(两种口令别填错):① 管理密钥管自检包设置、自检包发货、押金申请 / 押金退款 / 本页连接,查看 cloudfunctions/depositAdminHttp/admin-key.js 的 value;② 员工口令由管理员在「账号与权限」页生成并分配(休假、判读、审核等按勾选的模块区分),在那页的账号列表里可查看/复制。两者互不通用、都不会写进网页文件。本项目没配环境变量(体验版 64MB 限制),不用去云开发控制台找。
默认就是真实数据,看不到演示模式开关是正常的。只有内部培训 / 验收时才需要演示模式:在网址后加 ?demo=1(例如 https://admin.xutong.online/?demo=1)重新打开,会用本机示例数据、不连云端,开关与提示条届时自动出现。日常使用去掉这个参数即可回到真实数据。勾上「本机记住凭据」后,下次打开本页会自动带回口令,不用再抄一遍。
本次操作记录
使用与部署说明
按顺序看即可日常使用:一个网址、一个口令
所有人打开同一个网址 https://admin.xutong.online/,在登录框输入自己的口令即可:员工用管理员分配的员工口令、管理员用管理密钥,系统自动识别身份。API 地址已自动带出,无需填写;登录后只显示你有权限的模块,点右上角「退出登录」可切换账号。勾「本机记住凭据」后下次免输入(公用电脑勿勾)。
内部培训 / 验收才用演示模式:网址后加 ?demo=1,用本机示例数据、跳过登录;去掉参数即回到真实数据。
一、云端准备(只需一次)
- 先确认云函数都已部署:
cloudPing、initDatabase、depositOrder、depositAdmin、depositAdminHttp、bookingRules。最容易漏的是depositAdminHttp和bookingRules——在微信开发者工具资源管理器里右键该目录 →「上传并部署:云端安装依赖」。 - 管理密钥已随代码部署,不需要在控制台配环境变量。口令写在云函数目录的
admin-key.js里,右键重新部署depositAdminHttp即生效。体验版环境云函数内存上限 64MB,控制台保存环境变量会触发LimitExceeded.Memory,这个报错跟密钥内容无关。将来升级为付费环境后,可改用环境变量DEPOSIT_ADMIN_KEY(优先级更高)。 - 建 HTTP 访问路径
/deposit-admin→ 指向云函数depositAdminHttp。 - 接口地址已在
config.js里配好并自动带出,日常使用不用填。只有换环境 / 换域名时才需要改config.js的defaultApiUrl;若网页和接口部署在同一域名下,可填相对路径/deposit-admin。
「管理密钥」到底是什么?它只是控制台的管理口令,不是微信 AppSecret,也不是商户支付密钥。本项目已经定好一串,写在 cloudfunctions/depositAdminHttp/admin-key.js 的 value 里,打开该文件复制即可,云端和网页填的是同一串。忘记口令不用重新配置,去这个文件看一眼就行。只发给需要使用押金模块的工作人员,不要写进网页文件、不要上传到公开仓库;在「连接设置」勾选「本机记住凭据」可免得每次重填(公用电脑勿勾,点「清除本机凭据」可随时删掉)。
| 位置 | 填什么 |
|---|---|
depositAdminHttp/admin-key.js | value = 那串口令,已写好,重新部署即生效 |
depositAdmin/admin-key.js | 同一串(小程序内查询台用) |
| 网页「管理密钥」输入框 | 同一串口令 |
| 网页「API 地址」输入框 | 接口完整地址,不含 ?action=health |
二、「HTTP 网关 / HTTP 访问服务」在哪
三个名称是同一件事:新版控制台叫「HTTP 网关」(路由管理 → 新建),腾讯云文档叫「HTTP 访问服务」,老版叫「云接入 / HTTP 触发」。另外「集成响应」不需要手动开启——CloudBase 按返回值里的 statusCode 自动识别。
| 入口 | 怎么点 |
|---|---|
| ① 微信侧完整网页控制台(首选) | 浏览器打开 tcb.cloud.tencent.com/dev,用小程序管理员微信扫码登录 → 选环境 xutong-d5gil4dmd518eb73a → 左侧「HTTP 网关」→「路由管理」→「新建」:触发路径 /deposit-admin、云函数选 depositAdminHttp、版本 $DEFAULT → 确定,等 3~5 分钟生效。 |
| ② 老版控制台 | 「云函数」→ 点开 depositAdminHttp →「HTTP 触发 / 云接入」标签 → 开启并填触发路径 /deposit-admin。 |
| ③ 命令行 | npm i -g @cloudbase/cli → tcb login → tcb service create -p /deposit-admin -f depositAdminHttp -e xutong-d5gil4dmd518eb73a。 |
本项目已实测可用的接口地址(2026-11-08):https://xutong-d5gil4dmd518eb73a.service.tcloudbase.com/deposit-admin。已验证 ?action=health 返回 ok:true / adminKeyConfigured:true。忘记地址时点「一键填入」即可。
手工自检(可选):浏览器打开 API地址?action=health,正常应返回含 ok:true、"version":"2.3.0"、adminKeyConfigured:true 的 JSON。带 statusCode:200 外壳但 body 里有 ok:true 也算通。adminKeyConfigured:false 说明密钥没配好,重新部署一次。
最简单:跳过手工自检。填好地址与密钥、取消演示模式,点「验证连接」,出现绿色「连接正常,云端已就绪」即全通。
三、网页放哪
本目录是纯静态文件,双击 index.html 就能用;正式使用建议整个 admin-web 目录上传到云开发静态网站托管或你自己的服务器,工作人员收藏网址即可。无需构建、无需安装依赖。
四、连不上时按顺序查
- 先点「验证连接」,它会自动做云端自检并给出中文结果。
- 返回
FORBIDDEN:最常见是depositAdminHttp还没重新部署;右键重新「上传并部署」一次。 - 提示网络失败 / CORS:把网页放到静态托管改成同源、填相对路径,这是最稳的解法。
- 提示不是合法 JSON:多半是地址填错,命中了网关错误页。
五、数据安全
控制台只返回脱敏手机号、地址摘要和订单状态,不返回 openid,也不接触任何检测结果、阴阳性或照片。结果回传在外部页面完成,这里只做「是否完成服务」的状态登记。所有标记动作都会写入云端审计日志。预约名额页只显示检测点/日期/时段,不显示个人信息。
六、结果回传表单怎么配(免密钥)
- 建表单时一定要有一个「查询码」字段:单行文本或数字,12 位纯数字、首位不为 0。
- 复制该表单的公开填写链接,必须是
https://开头,且不带?或#。 - 同一个链接填两处:本网页
config.js的jinshujuUrl;小程序utils/deposit.js的CONFIG.jinshuju.formUrl。 - 改完后:网页刷新即可生效;小程序需要重新上传代码。
- 用户复制查询码 → 在回传表单提交结果 → 工作人员在「押金申请」按码找到申请 → 核对后点「标记完成服务」。
七、两个凭据、按模块授权(谁管什么,2026-11-16 改为网页勾选)
页面顶部只认两种凭据,彼此完全独立、互不通用:
| 凭据 | 能做什么 | 填在哪 |
|---|---|---|
管理密钥adminKey | 全部模块 + 管理账号。适合老板或唯一管理员。 | 连接设置 · 管理密钥 |
员工口令staffKey | 按模块只开勾选项(见下)。押金、发货、设置等未勾的模块一律进不去。 | 连接设置 · 员工口令 |
账号在网页上建,不再改代码文件。用管理密钥登录 → 左侧「账号与权限」→ 填姓名、点「生成口令」、勾选模块(和检测点范围)→ 保存。立即生效,不用改代码、不用重新部署云函数。改口令、停用、删除也都在这里点一下即可。
| 可勾选模块 | 勾选后能做什么 | 建议 |
|---|---|---|
| 结果判读与退款 | 按码判读、补绑邀请人、押金退款、超期零钱退还 | 给 A 员工 |
| 补贴审核与发放 | 审核本年度首次、通过后发放 ¥20、豁免名单 | 给 B 员工 |
| 自检包发货 | 发货清单、单号批量登记、发货通知 | 按需 |
| 自检包设置 | 纪念品、库存、补贴金额、模板 ID | 谨慎 |
| 休假设置 / 预约与名额 / 检测点 / 企业微信提醒 | 现场检测预约相关,受「检测点范围」限制 | 按点负责人 |
| 总管理(全部) | 等价于管理密钥,拥有所有权限 | 谨慎,别随手勾 |
权限是云端核对的,不是只把按钮藏起来。改网址、手输 #/rewards、拿浏览器开发者工具改页面都不行——云函数会按账号勾选的模块先核一遍,没授权的动作直接返回「没有该操作权限」。钱和结果都在云端,只靠界面隐藏等于没锁。
- 给 A 员工(判读 + 退款):账号与权限页新建账号 → 名字填「判读员A」→ 生成口令 → 只勾「结果判读与退款」→ 保存。把网址
https://admin.xutong.online/#/readback和口令发给他。 - 给 B 员工(审核 + 发放):同样新建 → 只勾「补贴审核与发放」→ 保存。发
#/rewards深链和口令。两人不要共用口令,也别互相勾对方的模块——判读和发放必须分开才有人复核。 - A 的活:
#/readback按查询码找到回传结果 → 判「有效 / 无效」→ 补绑、超期零钱退还。判读有效不会当场发钱,只是把这笔放进 B 的待审核队列。押金退款在#/refunds。 - B 的活:
#/rewards上方「待审核」队列 → 每行三条线索(本人本年已判读有效几单、邀请人本年已实付几单、是否疑似本年首次)→ 核对后点「通过」结算 ¥20;不是首次点「驳回」,必须写原因。 - 驳回不等于拉黑:只这一笔不发,不锁邀请关系;判错了可人工复核改判。
- 口令安全:用「生成口令」按钮(随机强口令),别用生日、手机号;离职在列表点「停用」或「删除」,立即失效。
八、检测点授权口径(休假设置)
权限粒度是「检测点」,不是城市——A 账号只管中大五院(zh-01),B 账号只管岭南社区(zh-02),以此类推。
- 总管理账号(已建好):
scope: ['all'],可设置「全部检测点」整体停约或任一个检测点。 - 加检测点负责人:还是在「账号与权限」页建账号,勾选「休假设置 / 预约与名额」,并在「可管检测点」里勾对应点:
zh-01只管中大五院,可多选。模块只管「能进哪些页面」,检测点只管「能管哪几个点」,两栏互不影响——所以判读岗、审核岗不必勾检测点。 - 使用:把
https://admin.xutong.online/#/holidays这个深链发给工作人员 → 填自己的口令点「验证账号」→ 下拉框只会出现自己有权限的检测点 → 选日期(连休可填结束日期,一次最多 62 天)→「设置休假」。清单里每条可单独「撤销」;无权限的记录只读。 - 生效范围:只停该检测点的「现场检测预约」;其它检测点、自检服务包申领、押金、查询台都不受影响。小程序里该点日期条会标「休」,云端也会在提交时强制拦截。
- 老账号兼容:早期写在
holiday-admins.js里的账号仍然可用,系统会按原来的岗位自动换算成等价模块,既不会突然提权也不会失效。新账号一律在网页建。
九、电脑端控制台的模块与深链
左侧导航即全部操作模块,每个模块都是独立页面、有独立链接,可单独收藏或发给对应工作人员:
| 模块 | 链接 | 用途 | 谁能进 |
|---|---|---|---|
| 总览 | #/overview | 全局状态、功能地图、各模块入口 | 任何人 |
| 检测点 | #/sites | 11 个点资料与可管范围 | 检测点运营 |
| 预约与名额 | #/bookings | 时段占用与未来预约 | 检测点运营 |
| 休假设置 | #/holidays | 按检测点设休假 | 检测点运营 |
| 企业微信提醒 | #/notify | 按点负责人与推送群(只读) | 任何人 |
| 结果判读与退款 | #/readback | 辨判回传结果、补绑邀请人、超期零钱退还、转账自检 | 判读岗 A |
| 押金申请 | #/deposits | 按查询码核对与确认完成服务 | 判读岗 A |
| 押金退款 | #/refunds | 待退款列表、逐笔退款、待沟通暂缓 | 判读岗 A |
| 补贴审核与发放 | #/rewards | 年度首次审核队列、通过后发放、提现账本 | 审核岗 B |
| 自检包设置 | #/selftest | 价格、押金、名额上限 | 管理密钥 |
| 自检包发货 | #/shipping | 待发货清单、导出与批量标记 | 管理密钥 |
| 账号与权限 | #/accounts | 当前账号、岗位、权限矩阵、复制深链 | 任何人 |
| 连接设置 | #/settings | API 地址、管理密钥、员工口令、操作记录 | 任何人 |
| 帮助与部署 | #/help | 本说明 | 任何人 |
只填员工口令时,没权限的模块在左侧导航里是灰的、点开会提示「需管理密钥」或「需判读岗 / 审核岗」;总管理(管理密钥或 roles: ['all'])两个凭据都填上即可使用全部模块。默认进入真实数据;仅内部培训时网址带 ?demo=1 才会切到本机示例数据(不连云端),那时全部模块可放心点开体验。
「当前操作员」现在可以自动署名了:页面顶部不再放姓名输入框。押金申请的「服务确认」、押金退款页、结果判读页、补贴审核页和连接设置各有一处「当前操作员」,几处自动同步;在「连接设置」用员工口令验证后,会自动带出账号名、输入框变为只读,云端按口令解析账号并写入审计日志——带口令时网页传来的姓名一律不采信,所以 A 判读的单子上写的一定是 A 的名字。还没分配口令时可手填姓名,它只是署名、不是口令。
押金退款改为「待退款列表」:不再有一键批量统一退款。列表按确认时间排序列出所有待退款订单,可逐笔核对查询码、金额、确认人、支付流水尾号后单独点「执行退款」。需要进一步沟通的,先在上方填「待沟通原因」再点该行「标记待沟通」,理由与操作人写入审计日志,暂缓期间单笔与批量退款都会跳过这笔;沟通清楚后点「取消暂缓」即可正常退款。已发起退款的单会显示「退款处理中」,不会重复发起。
十、部署到固定网址(admin.xutong.online)
为什么值得做:本地双击打开虽然能用,但地址跟着项目文件夹走——挪个目录、换台电脑就失效,也没法收藏。传到云开发静态托管后得到一个固定网址,任何电脑、手机都能打开,还能按模块把深链发给不同的人。
⓪ 先重传云函数,再传网页。顺序反了会出现「网页是新的、内核还是旧的」:判读点了照样当场发钱。必须重传三个:bookingRules(加了 roles 岗位解析)、depositAdmin 与 depositAdminHttp(内核 2.18.0,判读与发放拆开)。三个都「上传并部署」完再传网页六文件。
① 上传 6 个文件,全部放在同一层(根目录)。index.html、styles.css、config.js、core.js、app.js、console.js。必须一起传——只传一部分会出现「页面能开、点按钮没反应」,因为页面里的版本号和脚本对不上。
控制台路径:云开发控制台 → 静态网站托管 → 上传文件(可直接拖文件夹)。装了 Node 也可以用命令行:npx @cloudbase/cli hosting deploy ./admin-web -e xutong-d5gil4dmd518eb73a,按提示扫码登录。没绑域名时,托管给的默认域名(形如 xxx.tcloudbaseapp.com)也能先用。
② 绑定域名:静态托管 →「设置」→「添加自定义域名」→ 填 admin.xutong.online,把给出的 CNAME 目标填到阿里云云解析(主机记录 admin)。不要改动 www 的现有记录。
③ 不需要配 ADMIN_WEB_ORIGIN。HTTP 网关已经对所有来源返回 Access-Control-Allow-Origin: *;而且体验版环境保存云函数环境变量会触发 LimitExceeded.Memory(本项目踩过)。将来若换付费环境真要收紧来源,务必保留本地打开——file:// 的 Origin 是 null,代码已明确放行;否则工作人员在自己电脑上会突然连不上,而浏览器只丢一句看不懂的 CORS 报错。
④ 上线后自检 5 条:
- 打开网址,顶部没有蓝色「本地文件」提示条——还有的话说明看的仍是本机文件。
- 连接设置里填接口地址,点「验证连接」→ 绿色「连接正常」;右上角「内核」应显示
2.18.0。若仍显示旧号,说明depositAdmin/depositAdminHttp还没重传,页面会提示「内核版本过旧」并拒绝发送判读与审核动作——这是故意的,旧内核里判读会当场发钱。 - 地址栏手动加
#/shipping回车,页面应直接停在「自检包发货」——说明深链可用,可以按模块发给别人。用员工口令登录后再试#/readback与#/rewards:判读岗只能进前者、审核岗只能进后者,进错会看到「当前账号没有该模块权限」。 - 导出一份发货清单,再点「复制为表格」粘进 Excel:两条路至少一条通。
- 用手机浏览器打开同一网址,布局应变成单列、按钮点得到。
⑤ 两个容易忽略的点:页面是公开可访问的,但代码里没有任何密钥(密钥在云端,没密钥只能看界面),已加 noindex 不让搜索引擎收录;index.html 建议在静态托管里把缓存设成「不缓存」,其余文件靠 ?v= 强制更新,否则改完页面容易看到旧版。
十一、电脑端快捷键与长期使用
| 按键 | 作用 |
|---|---|
| / | 跳到当前页第一个输入框(查询码、手机号、快递单号等) |
| R | 刷新当前页的数据(不重新加载整个网页) |
| P | 打印当前页(发货清单、待退款列表可直接出纸) |
| Ctrl / ⌘ + Enter | 触发当前页的主按钮(查询、保存、批量登记等) |
| Esc | 关闭确认弹窗,等于点「取消」 |
| Alt + 1…9 | 按左侧导航顺序跳到第 1~9 个模块 |
在输入框里打字时,R / P / / 不会触发快捷键,不会把单号打丢。页面切到别的标签再切回来,若距上次取数超过 3 分钟会自动刷新一次;顶栏「已同步」的时间就是这个页面最后一次成功取数的时间。
长期使用的三条建议:① 把控制台地址收藏到浏览器书签栏固定位置,不要每次从开发工具里找;② 用 Chrome / Edge 的「创建快捷方式」建一个桌面图标,打开就是独立窗口,不会和一堆标签页混在一起;③ 公用电脑勾了「本机记住凭据」的,离开前点「清除本机凭据」。