清单营业日写入核对后端
- 清单勾选及撤销接口支持核对客户端已显示的营业日。
- 在取得事项锁后计算日期，跨日请求拒绝写入，不自动转到新一天。
- 兼容未发送日期的旧客户端；后端已备份部署，无资料迁移，跨日实际场景仍待验收。
开班交班
更新日志
改了什么,
一条条记在这里。
已经上线的直接写；还没上线的会标明「尚未上线」。 目前共 907 条
同一条更新可能同时属于多个模块,因此各模块条数相加会大于总数。
按模块查:
交班日结
开票申请、挂账、员工账号、班次：每行一行，批量只有一个按钮且先确认
- 开票申请：顶部写「待开 N 笔 · 合计 ¥…」，唯一的金色按钮是「全部标记已开」，点了先出确认（笔数、合计、「标记已开后不可撤回」）；一笔一笔提交，失败的逐条写原因，成功的不回滚；每行点开才有单笔「标记已开」；默认显示 20 条，其余点「看更多」；已开的收进折叠行。
- 挂账应收：顶部写欠款合计、几位客人、最久几天；按欠款从大到小，默认 20 条加「看更多」；核销和催收话术点开一行后在侧边详情里做；账龄分布、已核销/已退款收成折叠行。
- 员工账号：搜索加「全部/启用/停用」，每行姓名加状态；点开看手机号、岗位、最近登录；重设密码是次要按钮；「停用这个账号」放在最底部「危险操作」里，点了必须先确认（写清「立刻生效，已登录的设备下次请求会被拒，班次订单记录保留，之后可以恢复」）。
- 班次纪录：本班在上，下面历史；交班留言、现金差异、趋势、班次对比收成折叠行，行上写具体数字；代为交班、平账等操作原样保留。
- 小程序的开票申请、挂账、待我批核、员工账号也是同一个形态；小程序员工账号停用同样先确认。
财务/日结/流水员工账号与权限开班交班
交班多一条路：数不到现金时按应有现金平账，别人的班要写原因
- 交班和代为交班都多一个「无法清点，按应有现金平账」：原因必填，点了会先写一句确认（「不记短款，标成系统平账。原因：…」），确认后差额记为 0，原因前面标「系统平账」。
- 自己的班按钮写「去交班」，别人的班写「代为交班」；原因一填上，红字「请先写原因」就消失，不用再按一次。
- 今日账隔夜那句改成：「还有 N 班隔夜未交。别人的班，请本人交；本人不在才由有权限的人『代为交班』，并写明原因。」
- 数现金、盲点、必填原因、短款分录都没改。
开班交班
本班现金：点完抽屉弹层里看差异，面额加减自动合计
- 小程序「本班现金」点完抽屉，弹层留着，标题「这一次的差异」，写应有现金、实点，以及「多出 ¥…」「短少 ¥…」或「刚好对平」，点「知道了」才关。
- 本班收款明细里 cash_refund 写「现金退款」，member_balance 写「会员余额付款」；只改班次收款明细，收银台和小票仍写「会员储值」。
- 金色「应有现金」下面写小字算式：开班 + 收入 − 进出 − 现金退款；格子改成金底深字，对比够了。
- 面额每一格「−」旁边加「＋」，点面额、点加减、改硬币都会重新合计写回实点金额。
开班交班
「对不上」里标记已跟进补上了门店，门槛那句改成「达到」
- 手机上「今日账 → 对不上」点「标记已跟进」，以前请求里没带当前门店，后端回「缺少门店ID」，页面只在名单最底下写一行红字，看起来像没反应。现在请求带上当前门店；没选到门店时不发请求，直接写「缺少门店ID」。
- 失败时的红字挪到「达到 ¥…」那句下面、名单上面，不再藏在 11 张卡的最底下。
- 名单的门槛原来写「超过 ¥20」，实际差额正好 ¥20（或 −¥20）也会进名单。三端改成同一句：「达到 ¥20 才会出现在这里」，空名单写「达到门槛」。
- 后端没有改，筛选规则没变。网页和电脑上的手机应用本来就带门店，这次只改了它们的那句话。
开班交班运营异常中心
今天现金没记下差额就不再写都对得上，待审批退款写在单上
- 今天已经交过的班，只要有一班现金差额没有记下，就不再写「现金都对得上」。多和少用中文逗号分开，金额用服务端字符串。
- 收款退款在退款按钮旁边写出待审批的金额，几笔不加成一笔。名单没读完之前，不说今天没有退款。
- 有退款权限的人，在订单详情看到「这张单有一笔待审批」。有审批入口才给去审批。
- 申请退款时，回补库存单独占一行。数量是 0 也留着，只是不能点。网页、小程序、App 一样。
- 审批里的退款写出单号，以及回不回补库存。申请人名字没读到就写「读不到申请人」，不写员工号。
- 订单上这一笔的金额字符串和本单已付相同，就写全额，否则写部分。审批标题改由服务端判断：退款金额等于本单已付就是整单退，不等就是部分退，并带回本单已付。三端照读，读不到写「退款范围没读到」。
开班交班财务/日结/流水审批收件箱结账收款
旧班没交时，结账和退款会停下来先交班，点单会显示还剩多少
- 收银有一个更早日期开的班还没交时，结账、有人先走和现金退款停在原来的窗口，写出哪一天的班，并给出「先交掉这一班」。交完再开今天的班，不会自动把这笔款收掉或退掉。
- 那一天已经日结时，只说明要由有日结权限的人处理，不给交班按钮。
- 点单上的「剩 N」用服务端给的 remaining。剩 0 显示「已卖完」，确认后才把同一请求带上继续点的标记重送。不追踪、配方和服务型不显示剩，也不确认。
结账收款开班交班点单送厨
原来那个月已经结账，交班仍能交成，这笔账记进当前期间
- 班是上个月开的，这个月才交，而上个月的账已经结了：班仍然交得成。
- 现金对不平的那一笔，改记到今天还开着的期间，不再去改已经结掉的那一期。摘要里会写明原期间已结账、记入当期。
- 现金对平了，仍然不记这一笔。
开班交班财务/日结/流水
今天现金多和少分开写，不再把 +20 和 -20 加成 0
- 今天交过的班，多出来的现金和少掉的现金分开写，不再加在一起。两班一班多 20、一班少 20，会写成「今天已交 2 班，2 班对不上：多 ¥20.00,少 ¥20.00」。
- 只有多或只有少时，只写那一边。都对得上，仍写「今天已交 N 班，现金都对得上」。
- 差额没记下来的已交班，不算进这个 N，另写「有 X 班的现金差额没有记录」。网页、小程序、App 读的是同一句。
开班交班
交班对出来的长款和短款，会记进账
- 交班时，抽屉里的现金比应有的多（长款）或少（短款），会记进账，两边金额相等。
- 现金对平了，就不记这一笔，也不会留下一笔零元的账。
- 店里如果还没备好这笔账的规则，或当年的会计期间还没建，交班不会因此停住。能补上的会当场补上再记账；期间实在建不起来，班仍然交成，并留一条给财务的提醒。
开班交班财务/日结/流水
没开班时，顶栏可以直接开班
- 有开班权限、当前没有班次时，收银顶栏和班次页都显示「未开班 · 开班」。
- 用的是原来的备用金对话框，不是另外一张。
- 没有开班权限的人看不到这颗按钮。
开班交班
收银班次、库存预警、补货下单、客人菜单等多处读取失败时,不再误判成「没有」或「找不到」
- 客人扫码点单的菜单页读取失败时会提示重试,不再显示成「没有菜品」
- 后台库存预警中心的缺货、临期批次、滞销三张卡片读取失败时明确提示读不到,不再显示成「没有xx」
- 采购、调拨、进价历史、损耗记录、班次详情等多个后台页面统一了读取失败的判断,弱网或断线重试期间不再误判成「没有」
- 班次详情读不到时不再笼统显示「找不到这个班次」,并说清楚三种可能原因(没有查看权限/班次不属于这家店/这个班次本身不存在)
- 补货下单不再要求员工额外的「商品查看」权限才能看到计量单位名称——单位名称改由后端直接给出
- App(iOS/安卓/Mac/Windows)收银点单菜单读取失败时给出重试按钮,不再显示成「没有菜品」
- App 的库存台账、入库、出库、临期批次、跨店调拨、进价历史、记损耗、在途采购等页面读取失败时不再误判成空
- App 有 4 个页面原本把「读到了」的标记写反,已改对
- App 入库时如果读不到仓库列表,不会再悄悄把商品入到默认仓库,而是提示读取失败
- 建采购单时,商品计量单位的名称改由后端按 unit_id 查表解出,不再采信客户端传的字符串;已停用的单位仍能正确解出原名;查不到对应单位时会提示具体是哪个商品的单位有问题,不会显示成一串数字
开班交班进销存采购调拨客人扫码点单
今天订单特别多时,收款、销售、AI助手、毛利、总览、交班六处会提示「只显示了一部分」
- 今天订单数超过系统一次抓取的上限(200 笔)时,「收款与退款」「销售」「AI 助手」「毛利」「总览」五个后台页面和收银台的「交班」弹窗,现在都会显示提示,说明目前看到的数字不是今天全部订单,避免把「只看到一部分」误当成「今天就这么多」。
- 旧的、这次上线之前就已经在内存里的历史事件因为没有订单号,不受影响,仍照常显示。
财务/日结/流水运营委员会经营看板成本与毛利运营异常中心开班交班
交班窗口的退款说明改成：现金退款计入应有现金，但归班规则与本班统计不同
- 原提示「本班退款……不影响应有现金计算」会在后端 T-2718b 上线后变成假话，改为同时说明「现金退款已计入应有现金」和「归属班次的规则与这里的统计规则不同，不一定对应同一批」。
开班交班
今日班次:没交的班标出哪天开的、开了几天,并可代为交班
- 排班 › 今日班次上,不是今天开的班会写「开班 8/26 13:16 · 已 29 天 · 没交班 · 现金没点过」;以前只印时分,看起来像今天下午开的。
- 有代理交班权限的人,在这里就能代为交班;没有权限的人会看到说明,不是一个按了会失败的按钮。
开班交班排班打卡
小程序可以代为交班:有权限的人替没交班的同事收尾,留下原因和数到的现金
- 同事忘了交班、或已经离职,有「代理交班」权限的人(交班权限 + 用户管理或关账权限)现在可以在小程序上替他交。
- 入口两处:老板首页「这班开了 N 小时还没交班」那一行,以及「今日账」被挡住时的逐班列表。
- 必须填原因、必须填你数到的现金;现金留空会直接挡下,不会被当成 0。系统会记下是谁代交的、原主是谁、原因。
- 没有权限的人看到的是「只有本人、或有「代理交班」权限的人交得了」,不是一个按了会失败的按钮。
开班交班财务/日结/流水
小程序今日账:日结被没交的班挡住时,逐班列出是谁的班、从哪天开始
- 「今日账」按「确认日结」被挡住时,下方会逐班列出还没交的班:班号、收银员、从几月几号开始。
- 以前只要那些班不是今天开的(隔夜没交),列表就一行都不出来,只剩一个「去交班」,点进去只看得到自己的班,是死路。
- 隔夜的班用提醒色标出来;自己的班仍然可以直接去交班。
财务/日结/流水开班交班
现金流水里差异为 0 的班次显示「无差异」，开着太久的班按后端判断标出
- 现金差异分三态：读不到不印，0 印「✓ 无差异」，非 0 按原样标色。
- 「开着的班」改用后端算好的是否超时未交，区分「开着」和「开太久忘了交」。
- 班次记录页同步补 7 天分级显示（重放提交一并补回）。
开班交班财务/日结/流水
股权分红确认前提示「本月没有营业数据」，有权限的人可以在班次记录页代为交班
- 股权分红页：当月营收、成本、提成、其他支出全为 0 时，在确认按钮上方提示「这个月没有任何营业数据」，并提醒先确认月份。
- 后端股权分红整条动线的错误提示由繁体改为简体，对应的基线条目一并拿掉。
- 网页「班次记录」页给有代为交班权限的人加「代为交班」：要填数到的现金和原因，会以代理交班留痕；后端这条路早就有。
股东与分红开班交班
177 个班开着没人交得掉，而「代别人交班」这条路后端早就做好了、三端一个都没接
- 全平台现在有 **177 个班次开着没交**,涉及 86 家门店、24 个租户;其中 176 个开超过一天、169 个开超过 30 天,**最久的一班从 6 月 11 日开到现在,102 天**。走查店自己就挂着三个(8/26 · 629 小时、8/31 · 502 小时、9/19 · 52 小时)。
- 班交不掉,那几天的日结就确认不了;日结确认不了,那个月就关不掉。
- **后端其实早就能代交班**:填原因、有权限的人可以替别人交,而且会留痕(记下代关的人是谁、班次原主是谁、原因是什么)。只是网页、小程序、Flutter **三端一个调用点都没有**——能力盖好了、权限定好了、留痕齐了,没人接得到。
- 🔴 **我上一轮的结论是反的**:我说「没有任何代交班路径,建议做」。我搜的词是「强制交班」那一类,而它真实的名字是「代**理**交班」——**两个都只差一点点,而搜索是全有或全无**。零命中在字面上完全正确,结论却是反的。这一次我上正式机把那段代码逐行读过才写。
- 现在:班次页每一班,不是自己的、而且你有这把权限 → 「代为交班」;没有权限 → 明写「只有本人、或有『代理交班』权限的人交得了」,不是整颗按钮消失。
- 原因必填、现金必填,两个都在前端先挡。文案写的是「**你数到的现金**」不是「应有现金」——填错的症状是静默的:代关照样成功,差异被记成你填的那个数,那一天的现金从此对不回来。
- ⚠️ 號碼說明:提交 9205f96b 的訊息寫的是 T-2601,那是 rico11 先領的號(股权分红)——我當時沒先 claim 就用了。這條改掛 T-2671;追 9205f96b 的人請看這裡,不要去 T-2601 的討論串找代交班的理由。
开班交班财务/日结/流水
「隔夜未交」的班次现在直接告诉你抽屉里应该有多少钱
- 原本那一行只有:收银员姓名、班次编号、开班时间、营业日——三个识别码、零个金额。
- 现在会显示「抽屉应有 ¥X」;这一班根本没经手现金的时候说「这班没经手现金」,而不是显示 ¥0;算出来是负数的时候标红并说明现金进出记错了。
- 这个金额精确到分:点钞要跟手上的钞票对,四舍五入到元会让收银员对不上号。
开班交班
网络不稳时,后台不再把「读不到」说成「你没有」
- 「还没有交过班」「还没有预约」「你今天还没开班」「这个区间内还没有任何一笔钱动过」「没有符合条件的挂账纪录」——这些话现在只在真的读到数据、而数据确实是空的时候才出现。
- 「我的班次纪录(0)」标题里那个 0 也一起修了:读不到的时候不显示数字,而不是显示 0。
- 总览页「还差一项没设置:时薪」不会再在读不到人力数据时冒出来。
审批收件箱财务/日结/流水订位管理开班交班
班次记录里开了很多天没交的班会显眼显示并写明天数
- 以前三条未交班记录用脚注小字样式，只写「隔夜未交」，开了 25 天和 1 天写得一样；现在改成显眼样式并写「已开 N 天未交班」。
- 重放提交补回 7 天分级的显示。
开班交班
现金流水页如实说明只列自己的班
- 现金流水页的说明改成直接说出：这一页只列你自己的班。
- 文案不点名角色，也不承诺尚未做的全店视图能力，不再把读者导向只给班次本身的「班次纪录」页当作全店版。
开班交班
有权限的人代为关班不再每次报错，网页的说明也不再说「还没做」
- 后端 close_shift 补上 force、force_reason 参数并留痕；以前接口层传了这两个参数而函数不收，代为关班每次都是 500。
- 代为关班的权限门槛放行范围数过了并写进注释，防止下一个人把门槛放宽。
- 网页班次记录页关于代为关班的说明文案两次订正：不再说「这条路我们还没做」，也不再说「修好了还没上线」。
开班交班
在另一台机器开过的班，这台按结帐不再被挡「尚未开班」（小修）
- 同一班在 A 台开过之后，B 台打开结帐窗会立刻重新确认一次班次，不会再显示「尚未开班,结账前需先开班」。
- 万一真的按到「开班」而后端回「已有进行中的班次」，画面会说「这个班已经开过了（可能是在另一台装置开的）——正在重新确认班次状态…」并自动重查，不再只丢一句交班提示。
开班交班结账收款
空着的地方不再说谎
- 有开台的那天,周报不再说「大盘走弱」
- 今日班次读不到的时候说读不到,不假装「今天没有班」
- 出品站全部没指派时,档头直接说明白,不是留一片空白
- 老板首页那句话不再在有单的日子说「停业」
经营周报开班交班厨房出品运营委员会经营看板
这是交班日结的全部更新。 回按时间看全部。