悦居集团数字化 · 统一后台
17 个系统一个门,按岗位看见该看的
把 17 个业务系统收进一个统一后台:一个账号进所有系统,按岗位与机构范围只看见该看的;大屏与后台同源取数,给高层看总览与异常。
核心亮点
- 一个文件演完全场:584 KB 单文件装下 57 页后台、三条业务链路、五张报表,双击即开、断网也跑
- 一个账号进 17 个系统:进去之后侧栏换成该系统的功能树,不是把 17 个系统塞进同一排菜单
- 权限两道拦截 + 金额三档可见:董事长看全量、站长看营收不见成本、护理员完全不见金额
- 单据到报表一条线:单据到终态自动出分录,五张表借贷自平,每个数字能倒查回单
- 6 处 L2 详情层:订单 / 凭证 / 出入库 / 请购 / 合同 / 事件,每个都有状态机 + 上下游单据链 + 字段级痕迹
- 派单调度做成约束满足:冲突→证书→余量→距离 四级排序,人员×时段行程板按真实预约画,负载与行程板同源
- 异常能演练:收货短收 / 客户退单 / 三单不匹配,改一张单,下游分录与毛利表跟着变
技术栈
开发成果 12/17
- 设计规范:四套皮肤 token 与组件基线
- 系统矩阵:17 业务 + 4 入口 + 7 内核,28 子域划分
- 交互原型:8 角色 × 17 系统 57 功能页可点
- 权限模型:四维权限收敛为 3 开关 + 机构范围
- 订单链路:旅行与保洁跨系统流转对照,定下插件切分线
- ERP 物料内核:方案 BOM → 净需求 → 请购
- 账簿闭环:三条链路 → 分录 → 五张报表,借贷平衡可验
- 源码入库:Gitee 私有仓库 + 分主题提交
- 统一演示台:57 页 + 三条链路 + 五张报表装进一个文件,一个入口
- 演示导览:23 步固定路径,每步一个跳转 + 一句讲解词
- 异常分支:收货短收 / 客户退单 / 三单不匹配,账跟着变
- L2 样板:凭证与出入库两处抽屉(状态机 + 上下游 + 字段级痕迹)
- P1 立骨:组织树闭包表 + 指标字典 + 统一登录 SSO 落地
- P1 权限下沉:把前端 inScope 挪到接口层(where org_path)
- P2 铺业务:客户 / 订单 / 工程 / 资产四域上线
- P2 业态插件:养老与文旅按插件接入,不动前后两端
- P3 通钱:财务结算与费控打通,大屏改实时取数
项目简介
集团数字化的统一后台设计。17 个业务系统 + 4 个入口(门户 / SSO / API / 移动)+ 7 个内核(身份 / 主数据 / 流程 / 消息 / 文件 / 审计 / 看板)= 28 个子域,用 Nginx server_name 在一台服务器上分发。
【权限】8 个岗位角色(董事长 / 区域 / 站长 / 护理员 / 财务 / 采购 / 项目经理 / 管理员),四维权限收敛为 3 个开关;数据范围按机构树取更深一层;金额分三档可见(见营收不见成本)。系统级不过则侧栏只显示未授权,页面级不过才出 403。
【三根柱子】组织树(闭包表)、业态开关(组织节点属性)、主数据。
【业态】智能家居工程走真 BOM(方案 → 点位 → 型号数量,安装费 = 物料 × 15%);养老服务走服务 BOM(工时 + 耗材);乡村文旅不拆物料,卖资源位 + 日期。三者前后两端共用,中间履约分叉,所以按插件接入。
【载体】单文件 HTML 交互原型,可点、可切角色、可切机构,不是静态截图。源码分块在 _src/,跑 build.py 合并重建。
开发历程 16 条
收付款流水补「三样缺一」与待认领,预算改占用口径
- 收付款流水(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-05 → 未定