开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 16 条记录。
2026-11-15
收付款流水补「三样缺一」与待认领,预算改占用口径
- 收付款流水(24→58 分):新增「三样缺一就说不清」,逐笔核 单据 / 账户 / 回单。回单不是「付了就有」:网银手工付的要自己传,现金的要先缴存才有缴款单,这两笔标红并写清缺什么。
- 新增六步付款状态机(申请→复核→授权→直连→回单→记账),样张停在第四步「钱已出、回单未回」,配一句「没有回单的支出,不算支出」。
- 新增「待认领 · 银行有、系统里没对上」三笔,每笔写清「可能是什么」和「不处理会怎样」—— 对账的第一件事不是做平,是找出说不清的那几笔。
- 预算与超标(17→43 分):占用 = 已用 + 在途,条形图浅色段就是在途;明细表给出可用与占用率,可用为负就是超支。
- 一并修了标题与数据不符:卡片叫「今日流水」却列了 6 条含昨日的,改成「近两日」。
- 厚度汇总:AVG 30.6 → 32.4,THIN(<40) 53 → 49。
决策:同一屏的数字必须同源,负载改成按当天行程算
- 现象:派单页左侧写「张桂芝 余 1 单」(来自
STAFF.orders静态字段),右侧行程板却只画了她两段时间,看上去像「系统自己都数不清」。 - 改法:负载一律用
blocksOf(name).length现算,和行程板、候选排序、可用人力 KPI 四处同源。现在张桂芝 2 单、余 2 单,三处一致。 - 同理处理过的还有:项目页
paid/cost/heads由数据算而不是写死、预算页占用 = 已用 + 在途、流水页流入流出由CASHFLOWS汇总。 - 这条以后当规矩:同一屏上两个数字如果能互相推出来,就不许一处写死一处现算。演示时被问到「为什么这里对不上」,一次就够尴尬了。
- 现象:派单页左侧写「张桂芝 余 1 单」(来自
坑:跨天单的「滞留时长」算出了负数
- 派单页 KPI「最长滞留」第一版算出来是 -1.0 小时:因为待派单池里有隔夜单(SO-20261106-088,昨天 16:10 受理),只比时分就会得负数。
- 正确算法是先把日期差折成分钟:
(new Date(TODAY) - new Date(单日)) / 60000 + NOWM - hm(at),昨天 16:10 到今天 10:00 应该是 17.8 小时。 - 修正后同时加了兜底:
Math.max(0, ...),即使池里只有未来单也不会出负数。 - 教训:任何「距今多久」的计算都不能只看时分,跨天、跨月全靠日期差。而且自检要盯边界值 —— 负数比错数字更容易看出问题,但也更容易被一句
Math.abs()掩盖过去。
派单调度:把「找最近的人」做成约束满足,加了人员×时段行程板
- 页头换成了「派单不是找最近的人」:候选护理员按 冲突 → 证书 → 余量 → 距离 四级排序,距离永远排最后,不然会把单塞给最忙的人。
- 张桂芝 09:10 那单助浴做到 11:10,新单 11:00 起,重叠 10 分钟 → 系统直接把她排到候选末尾并标「时段冲突」。这一步不是写死的文案,是算出来的:
bs.find(b => b.st < en && st < b.en)。 - 新增今日行程板:人员 × 08:00–18:00 时间轴,色块按预约时刻与标准时长画(左定位
(st-480)/600,宽度dur*60/600),红线是现在 10:00。用绝对定位而不是表格,是为了在一行里同时看清「有单的时段」和「空档」。 - 待派单池里两单走真实数据:往
data.js加了 SO-20261107-041(11:00 助浴)和 044(14:30 扶手加装),不再用静态卡片假装有活干。 - 厚度 19 → 54 分,自检
N=1422 ERR=0、DRAWERS=70 ERR=0。
23 步演示导览:老板看前 10 步,业务看后 13 步
23 步,每步
{tag, t, say, act}—— 一个动作 + 一句讲解词。左右键翻页,可左右挪位避开抽屉。路线分两段,对应两类听众:
- 第 1–10 步(给老板/董事长):一个账号进门 → 17 个系统 → 切角色看权限 → 切机构看数据范围 → 金额三档 → 大屏同源。要回答的是“为什么不能直接买现成的”。
- 第 11–23 步(给业务/财务):订单怎么变钱。立项 → BOM 展开 → 净需求 → 比价 → 定标 → 收货 → 领料 → 安装 → 开票 → 收款 → 分录 → 五张表。中间在第 20 步停在预算闸门,给听众选一次。
三个异常放最后:短收 / 退单 / 三单不匹配,改一张单,下游分录与毛利表跟着变。
导览面板初始
display:none,所以在renderApp()末尾幂等调一次tourRoot(),否则入口根本不存在。按钮bottom:64px避开右下角角色浮层。毛利口径改成「估价 − 定标价」:少装的货不能算成省下的钱
两个数字错了,不是算法错,是口径错。已改并加了回归断言。
一、比价省下的钱从 16 跳到 87
saved原来算quote - cost(估价 − 实际成本)。收货短收 4 台后成本变小,账上就显示「省了更多钱」—— 实际上那 71 块是少装的货,钱没进账,欠客户的。改为
saved = quote - po(估价 − 定标价),另单列gap = po - cost并标红:“这不是省下的钱,是少领的料。”二、毛利率 25.76% 虚高 71
同一个根因。短收后收入少了 389,成本少了 460,毛利反而被抬高。真实是净亏 71。修了之后异常票上直接写“毛利虚高 71,实为净亏”。
教训:异常分支不是改个数字就完事,口径不变就会让报表说假话。演示时被人问一句“短收了毛利怎么还高了”就穿了。
iframe.srcdoc 设了却加载空白 —— 包被 body.innerHTML 抹了
现象:
f.srcdoc = html执行成功,但contentDocument.body.innerHTML.length == 0,也不报错。两个真因,分两次才找全:
1. base64 包放在了 body 里。主原型每次
renderApp()都重写document.body.innerHTML,body 里的<script id="chainPkg">第一次渲染就被抹掉,getElementById('chainPkg').textContent读出空串 → 解码得空串 → srcdoc 为空。包必须放<head>。2. iframe 还没 append 就赋 srcdoc。游离节点赋值不触发加载,先
body.appendChild(f)再赋 srcdoc 才行。另两条坑:
blob:URL 在file://下被 CORS 挡死(SecurityError),srcdoc同源可读可调contentWindow,选 srcdoc。- 覆盖层(演示导览、应用框)要挂
document.documentElement,挂 body 同样被重写清掉,而且会让 iframe 重载、推演进度归零。
把 57 页后台、三条链路和五张报表装进一个 520 KB 的 HTML
目标是演示时只需双击一个文件,不用先开一个原型、再切另一个窗口。
做法:
- 把《业务链路推演器》整份 base64 编进演示台
<head>里的window.CHAIN_PKG - 点「业务链路」时 atob + TextDecoder 解码,塞进
iframe.srcdoc - 推演器和主后台的通信走
iframe.contentWindow.YJChain,只暴露goto/chains/state/run四个动作
现在的入口:7 个系统页头 + 订单抽屉 + 两张 L2 抽屉底部,共 5 类跨模块跳转,两边能互跳。
构建脚本
build_all.py:先跑build_chain.py出推演器,再把它打进演示台。改任何一边都跑这一个。- 把《业务链路推演器》整份 base64 编进演示台
2026-11-10
报表不许手填,但有三样东西自动不出来
- 原则:报表所有数字 = 期初余额 + 分录汇总,分录由单据终态自动生成。人只做两件事:推进单据、看报表
- 但必须承认三个边界,否则就是吹:
- 期初要人工搬:8 月售卡 4,776 不在链路里,没期初的话核销时预收会变成 −398。这就是「上系统先搬期初」的真实原因,省不掉
- 合同额在链路外:毛利表的 524 来自合同系统,链路只管成本那一半。合同额不对,毛利表全废
- 往来单位要靠主数据:分录能自动生,但「这笔应付是欠明觅还是万象汇」靠 party 字段。没维护就全进「未指定往来」,明细表立刻失效
- 否掉的方案:在报表页给人留「手工调平」入口。一旦允许手填,账和业务就脱钩了 —— 下次对不上时没人分得清是业务错了还是手调错了
- 一个实现细节:凭证单(VCH-*)标
post:false,只展示不重复计账,否则一笔业务会记两遍
链路里少一张领料单,毛利表的成本就永远是 0
- 现象:把三条链接到项目毛利表,成本永远是 0、毛利率永远 100%
- 查:手数 p2p 的 9 张单 —— 请购 → 比价 → 采购 → 收货 → 质检 → 发票 → 应付 → 付款 → 凭证。料进了仓库(借 库存商品 460),但没有任何一张单把它从仓库挪到工地
- 根因:收货只让料「从供应商搬到仓库」,资产还是资产。要领到工地才算项目成本。原链路把「入库」当成了终点,漏了「出库」
- 修:补一张领料出库单(借 合同履约成本 460 / 贷 库存商品 460),插在质检之后、收票之前。补完后库存清零、合同履约成本 460、毛利 64
- 教训:「账能不能自动出来」是检验链路完整性的最好尺子。页面画得再全,只要报表某一行永远出不来,就说明链路缺了一张单 —— 这个漏洞看单据流看不出来,一算账就暴露
三条链路接到账簿:7 张凭证、15 行分录、五张报表自己平
- 上一版只做到「单据流转」,57 页全是列表。这次往下接一段:单据到终态 → 分录自动入账 → 报表全是派生的,没有一处手填
- 三条链跑完(服务 6 / 采购 10 / 报销 6 单),产出 7 张凭证 15 行分录,本期借贷各 3,682.60、期末各 4,821.00,差额 0.00
- 三个能对上的验证:预收 4,378 ÷ 398 = 11 次(账上的负债 = 业务欠的活);库存商品与应付暂估双双归零(冲回做对了);项目毛利 64 = 报价口径 48 + 比价省 16
- 五张表:试算平衡 / 资产负债 / 利润 / 往来明细 / 项目毛利;每行可展开看来源凭证,数字能倒查回单据
- 自检:账务逻辑 27 项 + 浏览器 DOM 全矩阵(1460 / 1024 / 742 三宽度)0 错
2026-11-09
源码推入 Gitee 私有仓库 yueju-digital-design
- 5 个提交 / 29 文件 / 16,736 行,按主题拆:仓库骨架 → 设计规范与皮肤 → 交互原型 → 方案稿 → 样板与素材
- 私有仓库:17 个子域规划、组织机构、订单与成本口径都在里面,不能公开
.workbuddy/整体忽略:13M 是本机运行时截图与工作日志,不是交付物- 体检只命中一处:登录页的演示密码
yj@2026,假数据,保留 - 令牌没写进
.git/config,remote 保持干净 URL(用一次性 credential helper 推) - 已知:
assets/有一张重复图(同 md5),白占 1.8MB,未删
2026-11-08
移动端表格把中文压成一字一行,先别急着认定为横向溢出
现象:430px 宽下,订单表的客户名和「上门安装服务」被压成一字一行,右侧内容看着像被裁掉。
根因:
table没设最小宽度,浏览器按容器宽度硬分列;中文没有词边界不能断词,只能一个字一行。修法:760px 以下
table.tb设min-width: 820px、td.k设 132px,走横向滚动而不是压缩。820 不是拍的——先用探针量出max(各列最小可读宽)再加合。真正值得记的是怎么发现的:一开始靠截图目测,以为是横向溢出。用 DOM 探针实测才看清:无头 Chrome 的
--window-size=430实际innerWidth是 526,截图看着像被裁,探针报scrollWidth 485无溢出——问题根本不是溢出,是列宽不够。教训:窄屏判断一律用 DOM 探针(
clientWidth/scrollWidth/getComputedStyle),不要用截图目测。否则会去修一个不存在的 bug。旅行卖位置、保洁卖人时——业态插件的切分线定在「订单行怎么履约」
飞哥问:客户下一个旅行订单涉及几个系统?下单保洁呢?
答案:都是 7 个,但只有 4 个共用(CRM / OMS / CASH / BI),中间履约段完全不同。
- 旅行卖位置:资源位库存(按「资源 × 日期」扣可售量)→ SRM 供应商分账(民宿 / 餐饮 / 讲解各结各的)→ 电子协议 → 到店核销
- 保洁卖人时:HR 排班技能匹配 → 派单(距离 + 单日工时上限)→ PMS 现场签到拍照签字 → WMS 耗材领用
关键判断:资源位库存 ≠ WMS 物料库存,是两张表。前者按「资源 × 日期 × 可售量」扣,后者按 SKU 扣件数。混成一张,月底必然对不上账。
否掉的方案:把旅行和保洁拆成两个独立后台。理由——客户档案、订单主表、收款、报表会立刻分叉,两个后台各记一份客户,同一个客户在两边消费就对不上人了。
结论:业态插件的切分线定在「订单行怎么履约」。前后两端 (下单 → 客户 → 订单主表 / 收款 → 报表) 共用,中间分叉。插件只换中间那一段。
把 ERP 从「财务总账」改回「资源计划」—— BOM 才是内核
现象:上一版把
erp这个 id 给了「财务总账」(凭证 / 科目余额 / 报表)。飞哥直接问:ERP 不是企业资源计划、按产品拆物料型号和数量吗?根因:国内用友 / 金蝶把 ERP 泛化成「财务 + 进销存」,只有制造业客户才开 MRP 模块。我照着这个泛化建模,做出来的是 ERP 的 FI 尾巴,却当成了全身。
正解:MRP(BOM 展开算净需求)→ MRP II(加产能 / 车间 / 成本)→ ERP(1990 年 Gartner 提出,标志是业务单据自动生成凭证)。「资源」= 物料 + 产能 + 资金 + 人,物料是第一个也是最内核的那个。
落地:改名「资源计划 ERP」,3 页扩到 5 页 —— 计划组(方案物料计划 / 净需求与请购)+ 账务组(记账凭证 / 科目余额表)+ 报表组。
为什么悦居需要 BOM:报价单本质就是 BOM。安装费 = 物料 × 15% 就是「人工随物料走」,典型的工程 BOM 逻辑。三居室 A2:8 行物料、需求 12/6/4/22/1/1/1/8,减库存与在途后净需求只剩 12 件,齐套率 75%、物料成本 6,380 元。
口径坑(已写进页面):缺料货值 ¥524 按售价、建议采购 ¥476 按采购价,差的 48 元是毛利不是误差。对账时不能拿这两个数比。
三种业态物料强度不同:智能家居工程有真 BOM;养老服务是服务 BOM(工时 + 耗材);乡村文旅根本不拆物料,卖资源位 + 日期。
17 个系统全部展开为独立工作区,共 57 个功能页
- 上一版只有 8 个系统真展开了,wms / exp / cash / oa / clm / admin 六个挂着「共用骨架」标签 —— 拿共享骨架冒充独立系统,飞哥直接批了「有点偷懒」
- 改成
#/s/<系统>/<页面>路由:进系统后侧栏换成该系统的功能树,顶栏面包屑变「机构 / 系统 / 页面」,正文顶上加一条系统徽标(域名 + 职责 + 权限级) - 规模:17 系统 / 57 个功能页(其中 ERP 5 页、CLM 4 页、OMS 5 页、PMS 4 页)
- 权限两层:系统级不过侧栏只显「未授权」不列功能树;页面级不过才出 403 —— 护理员点 ERP 看到的是前者,不是「功能被藏起来」
- 自检:8 角色 × 5 机构 × 57 页 = 2280 次渲染,0 错(无 undefined / NaN / 抛错)