改了什么,
一条条记在这里。

平台导入弹窗点得到分类，不会点到背后那一排

• 打开平台导入后，点「啤酒」只会筛弹窗里的平台分类，不会点到背后商品管理的分类。
• 香槟、软饮这类重复名字只留一条。打开时默认进啤酒，不要一上来一百条威士忌。
• 手机上是全屏，不是一个盖不住背后的小窗。

菜单商品建置

供应商从平台库挑品，参考价不能冒充自己的报价

• 供应商门户 › 我的目录：点选平台商品后，平台参考进价只读，一直标着「参考，不是你的报价」。
• 你的报价在旁边另填。没有改过不能当已经报过价；报的和参考一样，要再确认一次。
• 手机上是先点卡片，再进定价页，参考价不会自动填进报价框。

供应商门户

从平台库上架菜单，填的是本店卖价，不是进货价

• 商品管理 › 平台导入：每一行分开写「建议零售」和「本店售价」。进货价不在这里填。
• 本店已经有同规格的，按钮改成「已在本店」，不会再导入成第二份。
• 批量导入会说明：先用建议零售价上架，到菜单页再改卖价。

菜单商品建置

调拨列表能看见发了什么、走了几天

• 跨店调拨列表写出品项摘要。成本没有就显示「—」，不会编成 0。
• 已经发出超过 7 天还没收的，会标红提醒。
• 手机卡片标题是「去哪家店、几项」，不是只给一个单号。

调拨

供应商打开门户，先登入；入驻分两步

• 打开供应商门户，默认是登入，不再一进来就是很长的入驻表。
• 入驻第一步只要手机、验证码和密码；执照、税号、品类在第二步。
• 小程序登录页会说明：入驻请到电脑上的门户做完。

供应商门户

采购建单先看到常用供应商和原料，测号沉到底

• 建采购单时，供应商按常用 / 其他 / 测号分组，测号默认藏着。
• 选商品默认只出原料、食材、原瓶。配方出品不会进这张单。
• 单位优先瓶、箱、件。出品用的杯会标明那是出品单位。

采购

付供应商的钱要对上订、收、票三张单

• 采购 › 应付：点开一笔能看到订单、收货、发票对照。
• 供应商还在对账异议里的，付款按钮不出现，会写「先核对异议」。
• 没有付款权限的员工进采购，根本看不到应付这一栏。

采购

今晨补货按瓶和箱下，没有金额的单不能收货

• 采购 › 今晨草稿：能确认的行才列出，并写出采购单位。出品记成「杯」的，会标明原记并提示用瓶或箱。
• 供应商还没报价的品，不会进可确认的那一张表。
• 待收货里总额是 0 的单，不再给出收货按钮，会写「这张单没有金额」。

采购

改记账规则只影响之后的新分录

• 会计 › 规则：每一条能看见版本和从哪天开始生效。
• 点「改」会先说明：已经过账的凭证不会重算，下一笔结账才用新科目。
• 没有改规则权限的人只看得到，不会出现乱放的保存按钮。

财务/日结/流水

会计点开一张凭证，能看到这一笔的借和贷

• 财务 › 会计 › 分录查询：点「看借贷行」，会列出这一张凭证的科目、方向和金额，不再变成「凭证不存在」。
• 金额按账上的数字原样显示。可以筛内账 / 外账，也可以只看储值、赠送或会员余额结账那几类事件。
• 网页已经能这样点开。小程序和 App 同一页也会带上店的账套，对得上网页那一张。

财务/日结/流水

資產負債表的「應交稅費」不再固定顯示 0.00——它現在讀下單當時的銷項税快照，快照沒有的單另外列出

• 原本那一列固定寫著 0.00，同頁還有一句說「系統未記錄增值稅銷項稅額」——而實際上資料庫裡存著每一筆下單當時的銷項税快照（近 30 天 571 筆裡有 563 筆有快照），未稅加稅額也剛好等於含稅小計、逐分不差。也就是說，報表不是在說「沒有稅」，是在說一件不成立的事。
• 現在它讀那份快照：實測某租戶 2026-09 算出應交稅費 77.40 元，而且來源標明是「下單快照」而不是估計。快照沒有的單不會被混進同一個數字，而是另外列出來（附單號），頁面上的說明也改成事實。
• 邊界講清楚：法人級的稅額拆分尚未支援，目前這個數字是租戶級；這一點寫在同一頁的說明裡，不假裝有。企業所得稅計提仍未記錄。

更新日誌的模組頁搜尋原本按了沒反應（畫面不會有任何紅字）——現在會回「找到 N 条…」

• 原本：在模組頁打關鍵字，畫面完全不動 ⇒ 看起來像「搜尋壞了」，而其實是頁面那段程式的識別鍵在那些頁面不存在、一按就拋錯。
• 現在：識別鍵搬到共用位置，模組頁／全部面／功能更新面三個面搜尋都有結果，且頁面錯誤數為 0。
• 怎麼查：在 `/changelog/m/finance/` 打「记賬」、在 `?view=all` 打「端點」，兩邊都應該出現「找到 N 条…」。

更新日誌頁原本自稱「目前共 232 条」，而同一頁已經畫到第 233 条——那個數字現在跟著實際條目走

• 原本：那個數字是**建置當時**的快照；頁面在瀏覽器裡補進新條目之後，數字不會動 ⇒ 讀者讀到的數字與他自己在同一頁上看到的清單對不上。
• 現在：開頁後用同一份端點資料把數字對齊（兩面都適用），並補上「未上線」徽章的逐條狀態。
• 怎麼查：`aimaidin.com/changelog/` 那行「目前共 N 条」與端點 `?kind=product` 的 `count` 必須相等。

官網的更新日誌多了第二個檢視：「全部（含工程日志）」——原本只列已經上線的功能更新，工程面的紀錄一條都看不到

• 原本：官網更新日誌只畫「已經上線」的功能更新（內部工程紀錄在 API 裡有、頁面上一條都看不到），所以「我們今天改了什麼」對外等於不存在。
• 現在：同一頁多了「全部（含工程日志）」的檢視，切過去就看得見全部條目；而**還沒上線**的條目會標上「尚未上线」，不會被誤讀成已經生效。
• 怎麼查：開 `aimaidin.com/changelog/?view=all`，對照 `aimaidin.com/changelog/`（預設仍是功能更新面）。

集团壳两页补上「看不到」与「还没有数据」两句不同的空态

• 集团的门店雷达与集团周报在无资料时原本只有壳、没有一句说明；现在两种空态分开：「你的账号在这个集团里看不到任何营业中门店（权限或范围问题·不是没有数据）」与「本周集团尚无指标（不适用）：有 N 家店，但这一周没有任何一家有数字——这是『还没有数据』，不是你『看不到』」。
• 判定布林改白名单（只认本周集团指标那 7 个栏位），并修掉把上周数字误当本周有指标的问题。
• 空态句与标记用同一个布林，两者不会不一致。

更新日志多了「全部（含工程日志）」这个视图,每条会标明上线状态

• 更新日志页现在有两个视图:默认的「功能更新」只列客户看得懂的功能变更,「全部（含工程日志）」把工程与治理类的记录也一起列出来。
• 每一条会带着它的上线状态显示;记录上还没有上线时间的那几条会挂一个「尚未上线」的标记,不会让人以为它已经生效。
• 页面写的「目前共 N 条」现在跟着实际资料走——开页时会重新对一次帐,不再停在页面生成的那一刻。
• 「全部」那个视图的网址是 https://aimaidin.com/changelog/?view=all ,可以直接分享或存书签。

会计页有一栏叫「帐套」，而它的值永远是「外帐」

• 凭证会同时写进外帐和内帐两套。这一页有一栏专门显示是哪一套,而**它永远显示外帐**——因为接口不带参数时默认只回外帐,而这一页从来没送过那个参数。
• 🔴 更糟的是同一页的说明里写着「本店这一期两套**逐笔完全相同**(各 38 笔、借方合计都是 6,926.42)」——**那是一句使用者在这一页上没办法查证的话**。他看不到内帐,只能相信。
• 对会计来说,内外帐是这一页存在的理由,而产品只给了其中一套。
• **能力早就有了,只是没有人接上去**:查询参数、序列化那一行都在代码里,缺的就是页面上传一个值。
• 现在加了帐套下拉(外帐默认 / 只看外帐 / 只看内帐)。真登入切换验证:凭证号从 `202609-**O**-0038` 变成 `202609-**I**-0038`,帐套栏整列跟着变。
• ⚠️ 下拉第一项写的是「帐套:外帐(默认)」不是「全部帐套」——不送参数拿到的**就是外帐**,写「全部」会是一句假话。
• ⚠️ 接口对不认识的值回的是「200 + 空列表」不是报错 ⇒ 万一送错值,使用者看到的是「这一期没有凭证」而**不是任何错误**。所以选项只能用后端认的那两个字面值。
• 顺带把说明里写死的「38 笔 / 6,926.42」拿掉:那是某一天某一期的读数,**它会过期,而过期的样子跟正确的样子一模一样**。改成让他自己切过去比。

财务/日结/流水

「预约订金」那一格从「读不到」换成了真数字

• 预收义务那张表的第三列,一直写着「读不到 · 后端没有订金合计端点,只能一单一单看」。后端那支端点昨晚上线了,今天接上。
• **为什么这一格非得有端点、前端自己算不了**:订金的三种归宿(客人来了抵掉 / 没来被没收 / 取消退还)**不记在订位的状态上**,记在会计那一侧。同事实测:19 笔「已确认」里 **18 笔的订金早就抵扣掉了**,而订位那一列从来没有前进过。按状态分桶会在两个方向同时错。
• 🔴 **「还欠客人的」用两格相加,不能用「总额 − 已处理」**:已处理那格记的是**全额**,另两格记的是**剩余**。今天三格相加刚好等于总额是巧合(现在活着的订金没有一笔被部分处理过);只要出现一笔「退一半」,减出来的数就开始偏大——**而偏大的方向读起来像「负债变多了」,没有人会觉得可疑**。
• 端点验证先跑负控:一个一定不存在的路径要回 404、一个一定存在的要回 200,**然后**那个 200 才算数。
• ⚠️ 只看得到「这家店还没有收过订金」那条分支——走查店 0 笔。有订金那条在别的租户,**没看到就是没看到**。
• 顺带修掉我自己第一版刚长出来的:零笔时两句话黏在一起(「还没消费掉 0 笔这家店还没有收过订金」)。**那正是我今天在挂账列表刚修过的同一个形状**,隔两小时在自己的新代码里又长了一次。

财务/日结/流水订位管理

手机上的客人端顶栏，EN／列表／大图／幻灯片被挤到屏幕外

• 扫码点单的手机页，顶栏原来是**一条不可压缩的长排**：390px 的手机上整页被撑到 600px 宽（横向溢出 210px），414px 溢出 188px，428px 溢出 174px。「中文」被压成 36.5×40、两个字竖着排成两行，「幻灯片」三行，而「EN／列表／大图／幻灯片」四颗整个落在画面之外——客人看不到，也就等于这几个功能没做。
• 根因两条：①顶栏那排自己不换行，它的最小宽度（584px）直接把整个页面撑宽，所以不是「栏内横向滚动」，是**整页左右晃**；②那几颗开关按钮没有禁止压缩、也没有最小宽度，被挤的时候先被压扁、文字直排，触摸高度也掉到 40px（这个仓库自己定的触摸门槛是 44px）。
• 现在手机上顶栏改成竖着堆：品牌一行、动作按钮一行、语言与浏览模式一起落在最后一行，放不下就折行，绝不撑宽页面。
• 代价照实说：390px 下顶栏由 147px 变成 190px（多 43px，其中一部分是把触摸目标补到 44px），换到的是「没有任何一颗跑到画面外」。绑了会员再多三颗（寄存／积分／优惠券）的情况也量过：11 颗仍然零溢出。

客人端切到 EN 没有任何反应——是依赖数组少列了一个变量

• 扫码点单页右上角的「中文／EN」以前点了没反应：文案一个字都不变，连按钮自己的选中态都不动。原因是语言这个状态改了值，但没有被列进 state 的依赖数组里，外面拿到的永远是旧值。现在点 EN，商品主标题会换成英文。
• 同一个对象里只有这一个变量漏了（浏览模式、分类、搜索都在依赖里），所以症状很怪：切视图、切分类、搜索都正常，只有语言不动——这也是它一直没被发现的原因。
• 切回「中文」，主标题回中文；价格与售罄状态逐字不变（只换语言，不换数据）。