unis-oa/docs/mobile-approval-layout.md

84 KiB
Raw Permalink Blame History

手机端审批版式:只换版式,不换逻辑

对应场景:领导从企业微信里的卡片点开 → hub 免登 → OA 待办详情。原来的页面是照着 1440 宽的 桌面排的,同一套东西塞进 390 的屏上就成了一片挤在一起的小字加一条够不着的操作栏。 这一版只做一件事:在手机上把单子读清楚、把「同意」按下去。

落脚:views/oa/{TaskDetailView,TodoListView}.vue 的分叉、components/oa/mobile/*、 composables/useMobileShell.ts、路由上的 meta.chromeless、components/layout/AppLayout.vue。 后端一行没动,接口、字段、权限码、出口口径全部照原样。设计稿在 design/mobile-approval.html。

0. 为什么没有第二套逻辑

判据只有屏幕宽度,而且只允许出现在版式这一层:权限、出口怎么合并、必填闸、这一环哪几格改得动, 一律不看宽度。同一张单子在手机上能批,在电脑上就得同样能批,反过来也是。

所以手机版式自己不判断任何事。TaskDetailView.vue 仍是审批逻辑唯一的归属地,它把已经算好的那一份 (routeButtons / requiredMissing / fieldPerms / goBackOptions / 写回卡没卡 / OA 锁没锁……) 用 provide(TASK_VIEW_KEY, …) 交出去,MobileTaskView.vue 接过来只管两件事:把它摆成竖屏的样子、 决定「办完之后去哪儿」。接口写在 components/oa/mobile/taskContext.ts,缺一个属性 vue-tsc 就报错。

这一点是被教训逼出来的:早先那一版把桌面 TaskDetailView 里三百来行逻辑抄进了手机版, 抄过去的那一刻就落后了——表单里的附件没跟着提交、标题预告不显示、批注进不去、退回只有「逐级」、 加签只有「并行」、抄送没有「需处理」、写回卡住不提示,九处行为在手机上都和电脑上不一样。 现在的结构下,桌面每补一条判据,这一页自动跟着。

代价只有一处,写在桌面上:submit / confirmGoBack / confirmPeople / confirmDecision 多收一个可选的 done 回调。桌面不传,办完仍按老路子跳「已办」;手机版传的是「关掉这一张,回待办列表」 (加签例外:单子还在自己手里,那一档就地 reload 一次,不把人送走)。

1. 三档判定,各管各的

判据 线 管什么
useViewport 的 NARROW <1024 侧边栏收进抽屉、底部标签栏接手(平板也适用)
PHONE_QUERY <768 要不要换成竖屏那套审批版式(phoneShell)
meta.chromeless + phoneShell 两者都真 这一页把顶部栏和底部标签栏都让掉

两条线不能合成一条:拿 1024 去判版式,10 寸平板会被塞进只有单列的手机页,白瞎半屏。 chromeless 也要两条都真——桌面版式那条吸底操作栏是按「底下有条标签栏,我抬 3.5rem」摆的, 标签栏一没,它就凭空悬在半空。

还有一条退路:更多操作里那颗「看电脑版」把 pinDesktop 记进 localStorage。领导偶尔要看流程图、 要改别人填错的格子,钉上之后别再每次进来都赶他回手机版。

钉上得有法子下来。这一条原本是个单行道——全仓库只有「看电脑版」那一个写入点,没有解除的入口, oa.mobile.desktop 一旦落下,phoneShell 从此恒假,只能去清缓存。现在底部标签栏在 isPhone && desktopPinned 时头顶多一颗「看手机版」(MobileTabBar.vue),点一下就回来。 底部那条只看屏幕宽度、不看这个开关,所以钉着的时候它照旧在场,正好把这句话摆在人看得见的地方。

2. 首页:四张小卡片,一张对一个列表(2026-11 起;原先五张,「待阅」并进取件箱后退役)

手机上打开 OA 落地的那一屏就是这一屏:utils/returnPath.ts 里的 landingPath() 先按设备挑表、 再按权限挑那一条真进得去的——手机上 工作台 → 待办 → 我的 → 门户,桌面上门户照旧排第一。 为什么要按权限挑:生产上 139 个人挂在「普通员工」那一档,有 work:todo 却没有 work:workbench, 写死落 /workbench 只会被路由守卫打回门户,而门户那一屏是桌面版面,看着就像手机版式没做。 这类人现在直接落进待办那张卡片流。门户没丢:抽屉侧栏里 /home 那一条还在。 <768 时 /workbench 换成 components/oa/mobile/MobileHome.vue:待办、已办、已阅、我发起的,四张卡片, 一张对一个列表,最后一张横着占满整行(2 列网格摆五张会留一个洞)。原来那张「待阅」卡删了—— 2026-11 抄送并进取件箱之后,待阅就是待办本身,再摆一张等于同一批东西给两个入口, 人反而要分清哪边才是真的。桌面上那四张统计卡 + 快捷发起 + 概览走 v-else,两版各摆各的,取数一处没动,后端零改动。

卡片按 authStore.can 过滤(work:todo / work:done / work:read / work:created), 判据与侧边栏、底部标签栏同一套:没那条权限的人不会看见一张点不进去的卡片。 「发起流程」也在这屏(work:start 才有),因为底部栏不再常驻那一格了。

卡片上的数字与点进去那张列表同口径,这在这个仓库里算 bug 级要求:

卡片 数字出处 为什么是它
待办 appStore.todoCount 侧边栏与底部栏角标用的就是这一份(/task/processing/count?inbox=true,统一待办口径:我自己的待办 + 抄送需处理 + 只需阅)
已办 statistics/workbench 的 completed 后端那条按 DISTINCT work 数,注释写明与已办列表同口径
已阅 /read/completed 的 total 没有现成计数,只取一页一条拿那个数;/read 这一屏从 2026-11 起只剩已阅一档
我发起的 statistics/workbench 的 created_total /work/created 默认合并在办与已办结两张表,与它同口径

「待阅」那一档的数从前是 appStore.readCount(/read/processing/count),并进取件箱之后这个 store 字段与那次请求一起删了——refreshBadgeCounts() 现在就是重数待办那一个数,角标只有一个来源。 两个坑在这里记一下:工作台统计里的 unread 是站内信未读、不是待阅; month_completed 是全平台当月办结、不是「我的已办」。都别拿去当卡片数字。 取数任一路挂了不弹红条,数字归零(跟角标那一套一个脾气:留旧数比没数更误事)。

底部标签栏从此只有三格:首页 / 待办 / 我的。

3. 列表:一屏四条,扫的是「哪条要先批」

TodoListView.vue 在手机上换成 MobileCardList.vue,数据还是 useOAList 那一份,它自己不取数。 首页那四张卡片点进去的另外三张列表(已办、已阅、我发起的)用的是同一个版式组件与同一个 useMobileFeed(把一页一页攒成下滑加载的那一段),差别只在「只看超时」那颗钮只有待办摆。 已阅从前是待阅那张列表的 ?tab=done 档位,现在 /read 本身就是已阅,没有档位可切。

待办那一屏在手机上跟着变成一张取件箱(口径、PC 版式与逐条取舍见 todo-inbox-unified-design.md,这里只写手机上换在哪):

  • 顶部一排圆角胶囊档位(MobileCardList 新增的 segments,与桌面那一排 tab 吃同一份数据): 全部 / 待我办 / 抄送需处理 / 只需阅,每档带条数。
  • 卡片左上角一枚红点(m-card-unread-{key})说"还没看过";看过红点灭,卡片照旧在列表里。
  • 只需阅那张卡在右边直接给一颗「标记已阅」(m-card-secondary-{key}),不用先进选择模式; 点了只冒 secondary 这一个事件,不顺手把人带进单据页。
  • 「批量处理」与抄送那句「处理意见」用的是从下沿推上来的那一层(MobileSheet)而不是桌面的 BaseDialog:那套尺寸在 375px 上会把「确定」顶到屏幕外;出口也不做下拉而做一排按钮 (下拉浮在弹层里会被截掉半截);引擎逐条回的原因在桌面上是悬浮提示,手机上直接摊在那一层里。 整批都是抄送时那一层不摆「流转路由」那一格,也不说「没有共同出口」——它不走流转。

一条卡片三行:标题、发起人 · 部门 · 时间、状态标签。左边一道色条表紧急(超时红、临期黄), 催办次数和出口数量挂在标签上。整条都是点击区,右边只留一个「去批」。 往下滑是攒页(IntersectionObserver 哨兵),不给分页器——手机上没人愿意去点「下一页」。 桌面上那排筛选控件(流程、日期区间、导出)没进来:手机上一次就批几条,那几个控件加起来比单子 还占地方;搜索收了但留着——顶栏那枚放大镜点开一行输入框。批量审批后来补上了,见 §3.1。

3.1 批量处理:先换一档,再勾几条

原话是**「手机端也需要有批量处理的功能」。桌面那一套(表头复选框 + 工具栏那一颗按钮)搬不过来: 390 的屏上复选框那一列会把标题挤成两行,何况一次只批三五条,用不着「全选这 20 条」。 手机上把它做成一档**,不是一排控件:

  • 顶栏一颗「批量处理」,按下去整张列表进选择档——卡片左边那颗勾替掉右边的「去批」和箭头, 点卡片是勾上 / 取消,不再进详情(一次批三条不该点六下);再按一次「取消」退档,退档顺手把勾收掉, 留着看不见的那几个勾会跟着下一次提交走;
  • 操作位在屏幕下沿那一横条:全选 / 清空 + 已选 N 条 + 「批量处理 N」,全在拇指底下, 不用滑回顶栏去找。计数只数屏幕上摆得出来的那几条,翻页翻走的、被人抢先办掉的不算;
  • 那一层用 MobileSheet(§5 那条规矩),出口不做下拉而做一排按钮——下拉浮在 bottom sheet 里 会被截掉半截;意见还是那个 TextArea,引擎逐条回的那几句失败原因摊在层里,改完可以只重试这几条。

判据与桌面同一条,不另起一套:能勾的是 !row.oa_locked(这一环的表态已交给外部系统), 全选不硬塞它,手动勾上照样能提交——引擎回的那句原因写清了去哪儿办,比界面挡着不吭声好。 oa_locked 那条卡片照摆、只是点不动,理由挂在勾上。

交上去的 id 从攒下的那一沓(useMobileFeed 的 feed)里取,不是从当前页取:手机上往下滑过三页、 勾了 25 条,只按当前页找会莫名少掉一截。一批全办完就自动退出选择档,剩下的单子摆回普通列表。 桌面那一版(DataTable 勾选 + BaseDialog)一个字没动,两条分支共用 openBatch / confirmBatch 与 batchRoutes(可用出口 = 每条被选待办路由名的交集)那一套。

3.2 就地删除:卡片标题行右侧那颗垃圾桶

桌面上「我的待办」与「我发起的」各有一列操作,里面 v-if 摆着一颗删除(TodoListView.vue 的 #cell-actions、CreatedListView.vue 的同一处):自己创建、还停在开始环节、没进过任何人办理的那张单, 删掉是把它扔回纸篓——不必先进详情,也不必退回草稿箱重填一遍。手机端走的是 MobileCardList 那套卡片 版式,而这张卡从前只有标题 / meta / 标签 / 箭头,没有任何行内操作位,于是同一种单在手机上删不掉。

补法只在版式组件上开一个口子:MobileCardRow 多一个可选的 deletable,组件据此在标题行右侧、箭头之前 摆一颗垃圾桶,点下去只往外冒一个 delete(key);组件照旧不打接口、也不知道 deletable 从哪来。

判据各页沿用各自桌面上那一条,不另起一套,也不强行统一:

列表 判据 为什么算在这一头
我的待办 row.deletable 后端 engine.deletable_task_ids() 一页一次问完,里面还含「别人手上也压着这条单」「有人欠着一条要处理的抄送」「单被管理员挂起」三道挡条,界面自己算不出
我发起的 status === "running" && activity_type === "begin" 这一页的单据事实本来就在行上,桌面那一条也是这么判

两边点下去都只把 key 冒回列表页的 deleteById(id),从 useMobileFeed 攒下的那一沓里找回整行(与 openById 同一个理由:往下滑过三页,只按当前页找会莫名少掉一截),再交给既有的 askDelete——确认框用的 还是页面上那一只 ConfirmDialog,落地还是 workAPI.deleteJob(job),文案、成功提示、删完重载全走同一条路, 不会出现手机与桌面各删各的。

两个细节:选择档里不摆垃圾桶,那一点是勾选,不给它第二种点击语义(跟右边那道「去批」箭头同一个处理); 卡片外层本身是一颗 <button>,而 HTML 不许 button 套 button,所以这颗用 <span role="button" tabindex="0"> 顶上去,@click.stop 保证不顺手把卡片点进详情,Enter 与 Space 各自也删得掉。

4. 详情:一屏之内先答完四问

这一单是什么、谁提的、多少钱、卡在哪一步几号到期——抬头四问答完,才轮到内容。

抬头就一行:左边是那几枚徽章(处理中 总经理审批 11/04 18:00 催办 2), 右端挂发起人(李 李明,部门只在宽一点屏上跟出来),再往下是关键数字那一档。 流程名在顶栏上,不再在抬头里重复一遍;单号 · 提交时间 那一行、标题待更新 那一行、 独立的发起人段落都并掉了——同一条信息在 390 的屏上出现两次,就是把下面真正要看的东西 推出第一屏。单号没丢,它落在审批记录那一条的末尾(见 §4.1),要查还能查到; 谁提的、什么时候提的,本来就是那条时间线的第一行。

只有两个页签:表单内容、审批记录。桌面上那张流程图画布在 390 的屏上缩成一团, 而「走到哪了、在等谁」时间线本来就说清楚了,手机上不再留画布。

本环节要填的那几格提到最前面。桌面上它们住在右栏处理面板里,手机上没有右栏, 读单子的路上顺手就填了。意见不在这里——那是按下「同意」之后的事。

四十几格的表单不照抄网格,按「判断这件事需要看什么」归置(useFormPlan.ts):

字段 手机上怎么摆
空值 不渲染,也不给占一行
money / number 最多两条金额上浮到抬头,先让人看到钱;写法全按格子上配的格式走(formatNumber),金额没配单位也补一个「元」
auto(系统取数) 合并成一行折叠起来——发起人是谁、哪个部门,抬头已经有了
dept(部门) 只念部门名,也就是组织路径的末段(紫光汇智\软件开发事业部 → 软件开发事业部),与桌面只读态同一个口径
week / months / location 星期几念「周一、周三」、多月念「2026年10-11月」、定位念「地址(经度, 纬度)」,读的都是桌面只读态那三份(utils/formRuntime),手机上不再看到 1-7、['2026-10'] 这类库里的码
url(链接) 那一串字本身就是点得开的链接(common/LinkText):认得出的包成 <a>,认不出的一句话原样摆,裸域名补上 https://
relation / 来源=流程单据(关联的流程) 那一格存的是别人家那张单的 job,摊成一串码没人读得懂:问一次 /work/summaries 把标题念回来,名字还点得开那张单(mobile/MobileRelationValue.vue,摘要两版与「完整单据」三处共用;明细里那一列同一条路)
table(明细) 收成一行「明细 12 条 · 合计 7,181.00」,点一下就在这一行底下逐条摊开,再点收回
attachment / image 缩略图横滑,不占字段行
tabs(标签页) 那一页的名字就是分节标题;外部页面那一页整节换成一张「打开」卡片
divider 页里的第二段:段名跟在页签名后面(费用报销基本信息 · 第二段)
group(分组标题) 同样当分节依据:那一格是配表的人给字段起的段名,别只活在电脑上。段名跟在页签名后面(基本信息 / 费用报销基本信息 · 票据),没起名时用桌面那句「分组标题」,不摆 key。三屏(摘要两版 + 「完整单据」)切的是同样的段
signature 只在「完整单据」里看

明细摊开是逐条:一条一段,段头「第 N 条」,底下按列把这一条填了什么一行一行念出来 (useFormPlan.mobileRowCells,与「完整单据」同一份读法——勾了「隐藏此列」的那一列不摆,空着的列不占行)。 摊开的位置就在摘要里那一行底下,不推弹层:从前那一层是照「完整单据」用的 full 弹层, 盖住整屏、没有上下文,划两下就忘了自己在看哪张单的哪一节;要读完整的一单,末尾那颗 「完整单据」那条路一个字没动。

两版共用同一段明细模板:没配手机端版式时那张漂在节外的明细卡,现在被当成「没有节名的一节」 排进逐格那条链子里,于是「配成逐条展开」与「点了才展开」在屏幕上不可能长出两副面孔(用例逐字比过 两档摊出来的那一段)。自动归置那一版行照旧是那张子表的全部行,列照旧一条不少;换一张单子, 上一张摊到第几条不带过来。

**部门那一格念的是部门名,不是整条组织路径。**库里存的是路径(紫光汇智\软件开发事业部), 桌面上这一格取的是部门下拉候选项的 label,那本来就是末段那个名字(utils/deptOptions); 手机上从前把这一格和选人格子共用一套读法,于是部门路径被当人员引用报给 /org/persons/label, 后端对认不出的字符串照字面给个名字(app/service/org.py:_ref_missing),前端再拼成 姓名(账号)——手机上念出来是「紫光汇智\软件开发事业部(紫光汇智\软件开发事业部)」, 同一条路径摊三行,还把要看的那 7 个字挤到第二行。现在 fieldText 里 dept 单独一条口径 (deptText:取路径末段,物件取名字,尾部那个反斜杠不算一层),摘要与「完整单据」两屏一起修好。

顺带把同一家族的另外几类补齐了,原则只有一条:手机上念一句人话的那份口径,与桌面只读态是同一份。

那一格 从前在手机上 现在
week(星期几,库里 1-7) 落到最后的兜底那句 → 念出来是空的 「周一、周三」(formRuntime.weekText,已从桌面控件提到这一层,两边共用)
months(多选月份) 同上,空的 「2026年10-11月」(monthsText)
location(定位) 同上,空的 「地址(经度, 纬度)」(locationText)
money / number 自己按两位小数写,单位只在配了才写:电脑「12.00 元」、手机「12.00」 读 formatNumber(千分位 / 小数位 / 货币全按格子上的配置),单位口径照桌面那句——金额没配单位也补「元」
明细里的金额列 库里那个 1129 原样摊出来 按那一列配的格式写「1,129.00」,合计同理
daterange / timerange 自己拼 ~(碰巧一样) 直接读 rangeText,不再各拼一遍

链接那一格在手机上点得开。url 格子在桌面只读态一直是 <a>,手机上两屏(摘要与「完整单据」) 都只把值当一句文本摆出来,于是同一张单子在电脑上点得开、在手机上是一段读得出、抄得下来的字—— 390 的屏里既没有地址栏可以补协议,也没法划词,等于点不动。现在两屏的值都过一层 components/common/LinkText.vue:判据在 utils/linkText(toHref / linkSegments), 认得出的网址包成 <a target="_blank" rel="noopener noreferrer">,认不出的照普通文字摆, 一个字都不改。三条分寸:

  • 链接格子整串当一个地址看(wholeUrl):oa.example.com/policy/2026 这种不写协议的也认, 缺的 https:// 由这一层补——桌面那只 <a :href="值"> 碰上裸域名会当本站相对路径,点开是 404;
  • 一句话里夹的网址也认(只认带协议的与 www. 起的):细则见 https://a.com/rule/3。 切成三段摆,句尾那个句号留给句子,不吸进地址里;
  • 认不出就不摆链接:有人往链接格写「见内网制度页」,退回普通文字,别给一条点不通的蓝线。 3.5、v1.2 这类看着像域名的也不算地址。

同一层还管手机上另外三处读得见链接的地方:摘要与「完整单据」里明细的链接列 (mobileRowCells 每格多带一个 wholeUrl,摆法跟着格子走)、流转时间线里那条意见 (MobileFlow,「详见 https://…」不再要人手抄),以及填写块里那一格链接 (FormFieldControl 编辑态在输入框底下给一条「打开链接」,值一改就跟着改—— 输入框里那串字本身是点不动的)。

关联的那几张单在手机上点得开(2026-11-18)。「来源 = 流程单据」那一格(关联审批单, 生产上就是费用报销单上的「关联已审批流程」与明细里那一列「备用金流程编号」)存的是 别人家那张单的 job,按文本摆就是 32 个字符的一串码:读不出是哪张单,更点不动。 桌面早就把这一格交给只读态的挑选器(components/oa/OptionPicker.vue,见 option-source-design.md §10),手机上「完整单据」那一屏跟着学了, 摘要那一屏与两屏里的明细列却一直漏着——useFormPlan 那两版明写了「不渲染控件」, 值全靠 fieldText 算,而它手上没有取摘要的那条路。

现在补上,而且只补这一格:components/oa/mobile/MobileRelationValue.vue 就是桌面那只挑选器的 只读态摆法,判据 useFormPlan.opensWork(field, data)(这一格此刻是不是流程单据, optionRoutes 命中哪一条按那一份表单值算,与桌面 FormRenderer.routedField 同一分寸)。 三处用它——摘要两版的主表格子、摘要里摊开的明细行、「完整单据」的同一张明细—— 标题与落点因此不可能在两屏长出两副样子。链接落在 /work/:job(PC 与手机共用的那一条路由, WorkDetailView 自己按设备换版式),开在新标签页:从填单那一屏跳走会把手上还没提交的这张单弄丢。

两条分寸:摘要里这一格一律整段摆(标签在上),标签牌要宽度,塞进「左问右答」那一行两行就溢出; 空着的那一格不走这一条路,照旧留一行破折号,摆一排空的标签牌不如什么都不摆。 钉在这儿的行为:MobileFormSummary.spec.ts「关联的流程点得开」(念回标题不给 job、 明细那一列同一条路、空着不抢这一条行、挂在候选路由上命中那条才翻标题)、 MobileFormReader.spec.ts「明细里那一列关联的流程也点得开」、 useFormPlan.spec.ts(mobileRowCells 每格多带 relation 与那一列的定义本身)。

当时还留着一件:「存为」一改成单据编号(或限定流程之后对方表单里那一格),这一格就念不出标题、 也就点不开。回显那一趟问的是 GET /work/summaries,它从前只按 job 查,拿存着的那个值去问 只能空手回来——桌面同一件事撞的是同一堵墙。同日一起补上:界面把「存的到底是哪一列 + 限的哪条流程」 一起报过去(by / process),后端按同一列认回单据,跳转从此与「存为」选哪一列无关; 归档表的 serial 跟着补了索引(已经挂上的关联单据九成套在归档表里)。三种认法的取舍与 「库里存码、界面念名」那一类为什么仍认不到,见 option-source-design.md §13。

分节先认页签,段名认「离得最近的那一枚」——分隔条或「分组标题」(判据 utils/mobileLayout.ts:mobileSectionMarkers,按表单上的次序算,与手机端那份清单的排序无关)。 原先这一层只认 divider,而生产上那张费用报销单是靠一张 「标签页」分两页的(tabsMode: collapse),于是三十几格全挤进一节「表单内容」, 段名一个字都不见——配表的人分好的两页,手机上等于没分。现在读的是同一份 utils/tabPages(tabsFieldOf / tabsOf / tabKeyOf / isEmbedTab),与桌面、与后端一字不差, 只是把「哪一页」搬到段名上:页签在前、分隔条在后,两者都没有才回落 表单内容。回落出来的那三个字标在 PlanGroup.generic / ReaderSection.generic 上,整屏只有这一节的时候连标题行一起不摆: 上面那排页签已经写着「表单内容」,同一句话不该在 390 的屏上占两行,还搭上「N 项」和一颗没用的 折叠箭头。起了名字的节(页签名、分隔条、手机端配置里的节名)照旧摆;好几节的时候兜底那节也照摆, 那时候节名是把正文分开的记号,撤了反而读不出哪段是哪段。 压在「外部页面」那一页上的格子也不在摘要里出现——桌面上它们本来就不显示, 手机上跟着摆只会让人以为那一格丢了。

4.3 「完整单据」那一屏:手机上自己读,不借桌面的渲染

点开「完整单据」原先是把桌面的 FormRenderer(readonly)整个塞进下推层,两处跟不上:

  • FormRenderer 的段头位置是按桌面 12 列网格的行号算的(pagePlan → bandStyle(row))。 390 宽每格独占一行,行号全错配,几段的段头一起堆到最顶上——这就是 「手机端表单里的页签怎么全在最顶上」那一句的来处。页签本身在窄屏会塌成一排挤不下的按钮, 在弹窗里更没法用。
  • 桌面的渲染空值不占行,可这一屏要答的偏偏是「这张单还少填了什么」。

现在换成 components/oa/mobile/MobileFormReader.vue:一格一行、左问右答、空着也留一行(—)、 按页签和分隔条分节且默认全开;附件摆缩略图、明细逐条只摆填了的那几列、签名直接把图画出来, 外部页面那一节给一张「打开」卡片而不是在 390 里嵌一整张 ERP 表。口径出自 useFormPlan.readerSections(),与摘要共用同一套分节判据。待办详情与单据详情两屏都读它。

哪些格子上这一屏,现在能在设计器里逐格定:属性面板「默认隐藏」旁边多了 「手机上不展示」(field.mobileHidden)。只影响手机版式——电脑、打印、导出、必填校验 一概照旧;「标签页」那一格不给这一档,因为段名就是照它认的。画布上会挂一枚 手机不展示 的角标,完整单据那一屏顶部也说清「有 N 格设了手机上不展示」。 框选一片还能一次收掉:多选面板上「手机上不展示 / 手机上都展示」两颗(排版件与「标签页」跳过)—— 那张报销单是 32 格,逐格点三十二下等于没做。

这个键是新增的,后端 design.py:clean_formats 只按类型收掉它认识的几栏,原样存回, 没动一行后端。

这一档后来被整表配置盖过一层:逐格只能做减法(藏与不藏),摆成什么样、先摆哪一格、 明细摊不摊开仍然定不了。表单设计器工具栏上那颗「手机端」是把整张单在手机上摆成 一节的开关——节名、格子的顺序、每格的摆法一起配,存在 content.layout.mobile。 勾了「手机上不展示」的格子在那一版里照样不摆(同一个键,两处共用)。口径与取舍见 mobile-form-layout-config.md。

再往后补的是**「显示条件」那一档**。这一屏原先只读裸的 field.hidden,visibleWhen 一个字都不评, 于是电脑上一拨条件就露出来的格子上不了手机,条件早已翻走的格子却在手机上留着一行谁也改不动的值。 现在四道闸在 utils/mobileLayout.ts:mobileVisibilityOf 一句排到底(手机上不展示 → 本环节隐藏 → 显示条件不成立 → 整单默认隐藏),并且按手上是哪一份值分两屏:待办那一屏那份值是活的, 格子跟着电脑上同一时刻露、同一时刻藏;已办、抄送、归档那一屏那份值是死的,条件在那一屏 只放行不收——拿存过的值把「默认隐藏 + 显示条件」那一组摆回来,其余照旧把存过的摊开 (判据 utils/formRuntime.readbackHidden,桌面只读渲染读的是同一句)。见 mobile-form-layout-config.md §4.2。

4.5 摆法跟「此刻」那份配置,判据跟发起那一刻那一版

单据发起那一刻整份设计被冻进 oa_process_snapshot(oa_work.design_snapshot 认着它), 表单内容也在里面——这是「改图改表单不影响在途单」那条规矩的落点,check_design_pin.py 钉的就是它。 表单那一份跟着一起冻住,于是露出一个只在手机上别扭的后果:配表的人改了「哪几格展示、什么顺序、 每格怎么摆、显示条件」,手机上那一屏看不着,得等这张单走完、下一张单发起才见效。 原话:「手机端的审批表单我希望根据表单配置的展示规则而变化,而不是一发起就冻结。 手机端需要跟随调整而变化。」

现在这一屏读此刻那份配置,其余照旧读冻住的那一张:

读哪一份 谁
forms_live[表单 id] + activity_perms_live[环节 id](此刻) 手机端:摘要那一节、「完整单据」那一屏(待办详情与在途单的单据详情两处)
forms[0..] + activity_nodes[环节].form_perms(发起那一刻) 桌面只读渲染、打印、明细导出、必填校验、填写块、引擎落库认的那些格

单据是凭证。「这一屏给这个人看哪几格」是可以跟着配置动的,「这张单当时该填什么、 他改了哪几格」不能因为别人改了表单就当场换掉——所以分叉只开在摆法这一寸。

后端只多一份报文(api/runtime.py::_job_response / _forms_live):

  • 键是 form_id -> 此刻的 content,只装与冻住的那一张真改了的那几张;没人改过就是 {},报文与这一改动之前逐字节一致,前端也就不会为同一份内容摆两遍。
  • 冻过结的单都算,在途与办结一起(2026-11-16 改的正是这一寸)。没冻过的老单,forms 本来就是现读的。从前这一份只给在途单,于是同一张单跨办结那道坎就换一副面孔:审批那一屏 跟的是「此刻」那份配置,单子一办结当场掉回「发起那一刻」那份快照——配表的人在手机端面板 配的「哪几格展示 / 什么顺序 / 每格怎么摆 / 显示条件」在办结回看里全不认。原话: 「这样不行啊,办结后手机端展示应该和手机端审批界面一致才对。」 凭证那一寸照旧不动: forms(桌面详情 / 打印 / 导出 / 引擎认值)仍是冻结那一版,多的这一份只给手机端当摆法用。
  • 内容走 autofill.form_content 那层进程内快照(app/presence.py),没人改表单时一条 SQL 都不排;真没命中也只排在这一个并发位里,不给详情页添串行的往返。设计器保存表单时那层 快照当场作废,所以是「保存即见效」。
  • 认的是同一张表:设计器里就地改表单是更新那一行,id 不变,这正是"改配置马上影响在途单" 那条路。把环节换成另一张表单(id 变了)不算调整——在途单照旧看自己冻住的那一张, 不会因为换表而在半路上换一张脸。

上线后第一句回话是**「现在为什么手机端在途的表单为什么还是展示的不一样呢?不是跟我配置的展示呢」**。 拿着生产上那十张在途报销单逐个对,卡住的不是部署(镜像里两份报文都在),是两处真没跟:

  • 环节压根没绑表单。 生产上「费用报销流程」的财务总监 / 执行董事 / 部门主管那三环, activity_nodes[环节].form 是空串:页面照旧回落到 forms[0],而刚写的那一版是拿这个空串去 forms_live 里查——永远查不到,于是手机上静默退回冻住的那一张(35 格,此刻那张表配的是 38 格)。 认 id 这件事从前散在三处(环节、待办、兜底),漏一处就悄悄不跟。现在收成 utils/mobileLayout.ts:mobileFormRead(detail, …preferredIds) 一处:先按 「环节 form → 待办 form → forms[0]」把 id 解析出来,再一次性交出 { frozen, mobile } 两份; TaskDetailView 与 WorkDetailView 都读它,桌面拿 .frozen、手机拿 .mobile。
  • 还有半份配置冻在另一张表上。 审批人在手机上露哪几格,一半写在表单那几栏展示配置里, 一半写在流程设计器「环节 → 字段权限」那一格(隐藏 / 只读 / 可编辑 / 必填),而它冻在 activity_nodes[环节].form_perms 里。管理员把 checkTotal 那几个审定格从「隐藏」改成「只读」, 手机上照旧不露——那张单冻的还是「隐藏」。现在后端多回一份 activity_perms_live (api/runtime.py::_perms_live,只回与冻结那一版不一样的环节,没人动过就是 {}), 前端 mobileFieldPerms 读它,取不到就逐环节回落到冻结那份 form_perms。

生产上真数据的对照(同一张单,手机版式按两份各算一遍):

那张单停在 跟之前上屏 跟之后上屏 差在哪
执行董事 19e5b023… 11 格 22 格 多出 applyTime、project_code、feiyong_type、checkTraffic、sumEntertain、checkEntertain、checkTravel、checkTelecom、sumOther、checkOther、expenseTotal、checkTotal;少 relatedWork(此刻显示条件不成立)
部门主管 6a39a9f7… 9 格 17 格 多出 applyTime、processNo、project_code、sumTraffic、sumTravel、sumTelecom、expenseTotal、reimburseType
财务总监 40bd8d73… 25 格 20 格 字段权限那一份本来就没改,只跟着表单内容与显示条件走:加 project_code,去掉 sumTraffic、sumEntertain、sumTravel、sumOther、relatedWork、financiaNotes

唯一还压着手机端这一屏的是「显示条件」(visibleWhen,读这张单此刻存着的值):面板上给某一格点了 「展示」,而它当下条件不成立,手机上还是不摆——那本来就是这份配置的一部分(口径见 §4.3)。要是希望 手机端那一屏以面板为绝对优先、只让「本环节隐藏」拦人,改的是 mobileVisibilityOf 那四道闸的次序, 一处改完。

前端落点:TaskDetailView 多交一份 mobileFormSchema 与 mobileFieldPerms (components/oa/mobile/taskContext.ts),MobileTaskView 拿它们算摘要与「完整单据」;填写块、 requiredMissing、needKeys、提交校验的输入仍是 formSchema 与 fieldPerms。WorkDetailView 给 MobileWorkView 递的也是 .mobile 那一份,桌面那一版没换。页签那一档的「藏整片 / 藏某一页」要 跟着摆法走,所以 expandPerms 在手机上按当下那份字段清单与当下那份环节权限再展开一遍 (displayPerms),两屏不许一套跟一套不跟。

办结回看的字段权限认「本人办过的那一环」:归档行压根没有 activity 这一列 (serializers.work 拿 getattr 兜空串),于是这一屏从前拿不到环节,字段权限那一份压根不往下递 ——审批时被自己那一环「隐藏」按住的格子(生产上那 25 处 formPerms.hidden 就在这条路上) 一办结就在手机上凭空冒出来。现在 WorkDetailView.handledActivity 认本人在这张单上最后办完的 那一环,回看时摆的就是当初他自己看到的那一副;递下去的那一份与待办详情同一个函数 (utils/mobileLayout.ts:mobilePermsRead——activity_perms_live 优先、取不到逐环节回落到冻结那份 form_perms),摘要与「完整单据」两屏都按 expandPerms 展开之后再判。

「认哪一环的字段权限」从前在两页各写一遍,跟「认哪一张表」一样是漏一处就悄悄不跟。现在它与 mobileFormRead 配成一对,只此一处:办单那一屏传脚下那一环,回看那一屏传本人办过的那一环, 认不到环节(空串)就回一份空的——回看那一屏讲的是"存过的都摊开",宁可多摊一行,也不拿一个 认不准的环节去收格子。

只认本人办过的那一环,不认"最后那一环":这一屏对没在这张单上办过一步的人(尤其发起人) 讲的是"存过的都摊开",拿别人那一环的「隐藏」去收他的格子,会把 checkTotal 那几格核准审定 凭空抹掉——那是退回给他改单时最该看见的东西。

认环节有两把尺,不许并成一把:

认哪一环 谁 为什么
credentialActivity(这张单最后停过的那一环,与谁在看无关) 桌面只读渲染、打印、明细导出认的那张表 凭证不能因为"谁在打开"换一张表
activityForLayout(本人办过的那一环) 手机端摆内容:字段权限 + 认哪张表的此刻那份 回看时与他当初批的那一屏对上

从前这一屏两把尺都没有——归档行没有 activity 那一列,页面拿 activity_nodes[''] 去查, 查不到就悄悄回落到表单清单第一条。多表单流程上"清单里谁排第一"不等于这张单走过的那一张。 表单内容那一份(forms_live)本身不认环节,所有人都跟。

代价是详情页归档那一支多问一条语句(实测同一张归档单热缓存下 10 → 11 条,排在既有的并发位里, 不给这一页加串行的往返;在途那一支一条不多问)。

最硬的一条是 WorkDetailView.mobileParity.spec.ts 里那组逐格对照:同一套环节配置,把审批 那一屏(MobileTaskView)与办结回看那一屏(MobileWorkView)都真挂起来,各开「完整单据」那一层, 把屏幕上真看得见的行逐字比一次,两屏必须一模一样。变异过两次(回看屏拿不到字段权限、回看屏不认环节), 都精确多出「内部编号」那一行——正是用户看到的那一副"办结之后凭空冒出来"。

守卫:check_design_pin.py 第 3b 组(两份表单各是什么、没改动不多带、表删了回落)和 第 3c 组(此刻的环节字段权限回得对、冻结简报一个字没动、没改时是空的、冻结简报里没有的环节不进报文)、 第 9 组那两条盯的就是这一寸(归档单也带这两份当下配置,同时 forms / 简报里那份仍是冻结那一版)、 WorkDetailView.mobileParity.spec.ts(办过单的人回看认自己那一环、被按住的格子不冒出来; 没办过单的人照旧看全,不许拿别人那一环的「隐藏」收他的格子;此刻那份表单跟得到、 桌面凭证那一份不许跟;在途单仍认脚下那一环;凭证认哪一张表与谁在看无关、摆法才跟着人走 ——多表单流程上两个人看同一张归档单,桌面 / 打印 / 导出必须是同一张表)、 e2e_mobile_parity.py(打真接口、真流程走完一遍:发一张单 → 用设计接口改表单与环节字段权限 → 一路办到落定,比对办结前后那两份报文,顺带验「保存即见效」在归档件上照样成立; 收尾逐字还原设计与表单并按主键删掉这张校验单,不在共享开发库上留痕)、 mobileLayout.spec.ts(mobileFormRead 那三份优先级,含生产上那个空 form id 回落;mobilePermsRead 那三份:改过认此刻、没改逐环节回落、认不到环节给空的)、 MobileTaskView.liveForm.spec.ts(跟的那一份要跟到:「隐藏」改成「只读」的格子手机上要露出来; 不跟的那一份不许跟:填写块仍是冻住那一份算出来的)、WorkDetailView.spec.ts(复现生产上 form: '' 那个形状)。设计器版本号那颗 tooltip(process.versionPinTipMobile)也把这条例外 写在了落款里。

4.6 一格两只控件:格子装不下就先竖排,不许顶出卡片

原话:「手机端的发起流程,与退回流程后再次填写必填字段的时候日期组件太宽了显示在外部去了。」 两处说的是同一只格子——daterange(日期区间)在手机上整个顶到卡片外头。

量出来的根因不在样式表写错,在浏览器的固有尺寸:input[type=date] 有个缩不下去的固有最小宽—— 手机上 165px/只(style.css:998 那条 iOS 防缩放把 .input 字号抬到 16px;桌面 14px 时是 159.7px), input[type=time] 是 115.8px。flex 子项的 min-width 默认是 auto,缩不到这个数以下;两只控件中间 还夹一只 ~ 加 6px 间距,于是那一行的下限约 350px。而手机端这一格的内容宽只有视口 − 58~66px (AppLayout 的 main.p-4 → 页面 .px-4 → section.card.p-4 → FormRenderer 的 grid-cols-1)。 真页面逐档实测(HEAD 版):daterange 在 320 屏溢出 88px(卡片本身被顶出 74px)、360 屏 48px(卡片 34px)、 390 屏 18px(卡片 4px),到 414 屏才不溢出;同一批宽度上单只 date / datetime 与两只 time 全是 0——顶出卡片的只有「一行两只日期框」这一种。 用户点名的那一屏另有一组数:真流程「财务及资质材料使用申请」的申请有效期(daterange)在发起页 320 屏把整页顶出 63px(右边那只框出卡片 78.56px、出视口 62.56px)、360 屏整页 23px、390 屏框出卡片 8.56px;改后三档都竖排,每只框 254 / 294 / 324px,整页横向溢出归 0(数据与截图见 §4.7 末「真流程对照」同一批产物)。

为什么不能只缩不排(同一页就地改样式让布局引擎重排,实测):只加 min-width: 0 溢出确实归零,但两只框 掉到 137 / 152px;再加 flex: 1 1 0 而父行仍是横排,三只(框 + ~ + 框)挤到每只 34px,手指点不准。 竖排之后 360 / 390 / 414 屏每只拿到 294 / 324 / 348px、溢出 0,每段可点宽 79 / 89 / 97px,sm 起自动回横排 (277 / 363px)——所以「窄档竖排」不是审美选择,是让可点宽度回到能用的那一档。

现在 FormFieldControl.vue 里那一行是窄档竖排、sm 起横排:容器 flex min-w-0 flex-col items-stretch gap-1.5 sm:flex-row sm:items-center,两只控件走 rangeInputClass(原 inputClass 上多 min-w-0 flex-1),单只 date / datetime-local 也补 min-w-0;行容器带 data-test="daterange-row" / "timerange-row" 供复测。取值一个字没动: rangePart / setRangePart 两条路原样,仍是一格两个值、两头都空才是 []。

三个只有真量才踩得到的坑,注释与用例里各钉一条:

  • 窄档那一下必须把 items-center 收进 sm:。换成竖排之后交叉轴变成横向,挂着不带前缀的 items-center 会把两只控件又收回 159px 固有宽,等于白改。
  • 只加 flex-1 不够,必须配 min-w-0。flex-basis 归零之后可缩的下限仍由 min-width: auto 兜在固有宽上,横排那一档照样溢出。
  • 不许拿 overflow: hidden 把溢出藏起来——藏了等于没修,用例专门钉这条类不许出现。

同一处顺带修掉两个没人报上来的现场:明细表紧凑档(.cell-control)改动前列被撑到比声明还宽—— TABLE_COLUMN_MIN_WIDTHS 给 daterange 250px、timerange 210px,实测要 326.6px / 227.7px(桌面 250 → 300.6 同样超),因为 table-layout: auto 外面套的是 overflow-x-auto,表现成整表横向拖(容器 300px、内容 1048px)而不是顶出卡片;电脑端把日期区间摆进 3~4 列宽的窄列也顶格子。改完手机窄档全部归零:390 屏 填写块里每只框 332px、发起页每只 324px(两处内距不同,分别是视口 −58 与 −66)。

下一轮(本轮不扩面):① 明细表里那两只区间格跟着竖排,别去抬 TABLE_COLUMN_MIN_WIDTHS——6 列已经 1048px / 容器 300px, 抬宽只是把横滑拉长,列内两只框从约 105px 变 160px 仍然难点准;② 把 min-w-0 + 窄档竖排收成一个「成对控件」的共用档位。 ② 的理由按实测改一下:五类原生控件的固有最小宽是 datetime-local 258 / month 199 / date 172 / week 187 / time 143px, 而声明底宽(utils/formRuntime.ts:887)是 date 150 / datetime 200 / time 110 / month 130 / week 260 / daterange 250 / timerange 210——month 现在就比自己的声明宽还宽(实测固有最小宽 167~199px > 声明 130px),属于当下就在「列被撑到比声明宽」那一档,不是将来才复发;week 反倒不缺(实测 187~198px < 声明 260px)。两次量法给的数各有出入(date 165 与 172、month 167 与 199),差在量的那一档字号是手机 16px 还是桌面 14px——下一轮动手前先把量法统一成一条。 另外 min-w-0 + flex-1 落地之后,「列比声明宽」已不再是溢出,只是声明值失去意义,急迫度低。 ③ 兜底分节那一版的只读值格(MobileFormSummary.vue:158)少一个 whitespace-pre-wrap,填的人手敲的换行在那一版会被并成一行 (另两版有)。是行为差异不是撑破卡片,改它等于改显示效果,本轮没动,用例按各版实际有的钉。

验收:FormFieldControl.dateRangeLayout.spec.ts(17 条)钉版式(窄屏竖排、sm 起横排、两只控件都带 min-w-0 flex-1、一行里只有两只原生控件)与取值口径(两端仍是 [起, 止]、已有值仍拆回两只框、只读 念法不变)。对改动前的组件跑这份用例红 11 条,对改动后全绿。量测办法是真 headless Chrome 跑布局 (jsdom 量不出固有宽):CSS 用 npx tailwindcss 现编,合成台按 160 / 222 / 262 / 277 / 292 / 313 / 316 / 340 逐档扫 × 窄屏与横排 × 紧凑与非紧凑;改前(HEAD 只读副本 :5610)与改后(工作区 :3000)再在 320 / 360 / 390 / 414 真页面各量一遍,两边数据都对得上才算修完。

4.7 「本环节要填」那一块:判据换成引擎那把尺

原话:「在手机端当流程被驳回后我希望可以填写所有字段而不是只能填写必填字段。」 查下来卡住人的 不是"只让填必填",是环节没点名的格子在手机上压根没有输入框——退回重填那一屏尤其明显。

同一张单,三条链路曾经用两把尺:

谁 认的是哪一句 环节没点名的普通格子
引擎收值 editable_keys(backend/app/service/formruntime.py)→ effective_perm,带这份数据 字段自身兜底成 editable,收值
桌面渲染 FormRenderer 的 effectivePerm(utils/formRuntime.ts 那面镜像) 同上,给输入框
手机端填写块(旧) expandedPerms[key] 恰为 editable / required expandPerms(utils/tabPages.ts)只把页签层的"藏整页"合进环节权限,不含字段兜底 → 取到空串 → 掉出填写块

begin 环节最吃这一亏:设计器里开始环节常常一格 formPerms 都没配(dev 库 9 条启用的业务流里有 6 条如此,费用报销那条 34 格点了名、要人填的只有 3 格)。按空单口径逐条数过:9 条流程全都存在「改前手机上没框、却被必填闸点名」的格子(1~7 格)。于是退回到发起人重填那一屏 needFields 是空的,填写块整块 不渲染,而底栏那句「先填这几项」读的是 requiredMissing(走 requiredFields,本来就带兜底)照旧催 人——手机上既没有框、也按不下提交,只能回电脑。桌面从来不受影响,所以只有手机端被报上来。

现在填写块读的就是引擎那一句:effectivePerm(field, expandedPerms.value, ctx.formData.value) 落在 editable / required 的那几格。几条边界写死在这里,少一条就会漏成另一种bug:

  • 必须带上手上这份 data。不带的那一挡压根不评「显示条件」,条件早已翻走的格子会既进填写块、 又不进必填闸,反倒多开一道缝;带 data 才与必填闸同源。
  • 只收真有人填得动的格子(isRuntimeFillable):公式、系统取数、分隔条、说明条不进块——它们权限 算下来可能是 required(公式格自己勾了必填就这样),放进来「共 N 项必填」数的就是假数,而摘要本来就在 摆它的值。embed 没有框,但环节点名它时确实要在这一环表态,跟着老行为留在块里。
  • 引擎 hidden_keys 那条通道(环节点名"隐藏"仍然收值)不进填写块;self_gated_keys 那一档界面 不跟(有值才露、有值就锁,敲完这一格就消失但值还在)——桌面同样如此,是有意的,别当 bug 修。
  • 读的仍是发起那一刻冻住的那 formSchema / fieldPerms,§4.5 那条分叉一个字没动;后端判据与 formRuntime.ts / tabPages.ts 本体也没动,换的只有填写块这一句。全仓裸写 ['editable','required'].includes 的就这一处,发起页(useStartForm.ts)不受影响。

放宽之后这一块会明显变长——用例里那张 18 格的报销单,环节只点名 2 格,如今填写块摆出 10 格(1 格必填 + 9 格可改),于是两件事是必需项不是装饰:

  • 块头两句各数各的:「共 N 项必填」只数必填那几格,「另有 M 格可改」说的就是下面实际摆出来的可选行数 ——块头、中间那条分隔、行数三处同一个数,写 2 摆 3 就是计数说谎;哪一堆是空的就不写那一句。
  • 「已填 X/Y」只数人填得动的那几格必填,红字「先填这几项」仍对整张表单算(里面还有公式、单据编号 那种自己勾了必填、权限算下来却只读的静默格)。于是可能"已填 2/2"而红字还点着另一格——故意不同径: 计数说的是人还能做的那部分功课,红字说的是这一刀到底提不提得交。用例钉着红字不许被计数吞掉。 还有一档要认:公式来源格被清空的那一刻,红字也不会提前点那格的名——判据读的是手上这份值,那一格 还是重算前的旧值,要到提交时才被服务端那句「表单校验未通过」拦下。改前改后都这样,不是这次放宽造成的;用 例把「服务端算得出空 → 红字点名」与「客户端还是旧值 → 红字不点名」两档分开钉住。
  • 一处已知不同径(本轮没动,别当成新 bug):引擎那侧「环节显式点名 editable 就等于允许留空」 (formruntime.py:849),而前端必填闸只挡 readonly / hidden、不认这一条——于是「字段自己勾了必填 + 环节点名 editable + 此刻是空」那一格,桌面右栏画着星号、手机红字点它的名并拦住提交,引擎其实允许留空。 改前改后都这样,发起页与桌面同样中招;要统一得连桌面那半一起动,另开一轮。用例把现状钉住。

一格只有一个家:进了填写块的格子由 needKeys 交给 planForm,摘要与「完整单据」不再重复摆一遍 (报销金额那一格从前是摘要里一行只读文本,如今是填写块里一只改得动的框)。

验收:MobileTaskView.needFields.spec.ts(14 条)——环节没点名的必填格与可改格都进了可编辑区、没勾 录入框的类型不许混进来、判据带 data(显示条件不成立的不进块)、必填在前可改在后且中间插分隔、两句计数 各自与屏上的行数对齐、两种"一堆是空的"不写 0、静默必填格不进计数但红字照样点名、进块的格子不在摘要 重复、页签层明写隐藏的仍然不露、整块为空时连「要填」那句都不摆,最后一条用真渲染器钉住搬进去的格子 上屏仍带着 label 与值(替身会替你把回归藏起来)。

审计对账(2026-11-13:改前跑 HEAD 只读副本 :5610,改后跑工作区 :3000,两边都是 dev 真页面 + 真后端函数):同一条退回后发起人待办上三处各取一次值——(a) 接口原样 activity_nodes[开始].form_perms、(b) 真页面 DOM 上的 [data-field-key]、(c) 直接调 formruntime.editable_keys(冻结字段, perm_map(那份权限), work.data)——改前 (b) 只有 1 格而 (c) 有 7 格,改后两向差集都是空;f_node_hidden 走 hidden_keys 通道值不丢;页签层明写隐藏的那格没被放宽放出来(label 节点 0 个)。不只是多画了框:在 390 真页面上改未点名的 f_opt 与 f_daterange 两端,提交后回读 work.data 真带上改后的值,其余各格原值一字未动;给环节点名只读的 f_node_ro 填新值,提交后仍是 null。 另一张对照是开始环节一格都没点名的 12 格单(3 格字段自己勾必填 + 9 格可改):改前那一屏整块不渲染、一个输入框都没有,只能回电脑;改后块头「共 3 项必填 另有 9 格可改」,同意屏那句是「本环节要填 3/3」而不是 12——可改的格子不算欠账。清空其中一格必填:N/M 两个数纹丝不动,红字与吸底栏点它的名、m-agree 让位给闸门句,但那一格的输入框还在、还写得进去,补上之后提交就过——拦路的是闸门不是没框。块头 testid(m-fill-required-count / m-fill-optional-count)与分隔条 [data-field-key="_mobileFillSplit"] 三处念出来的数字一致;仓里没有 fill-split 这个属性,别拿它当定位手段。

真流程对照(不是夹具):财务及资质材料使用申请流程 13 格、开始环节一格没点名、其中 validRange(申请有效期)是 daterange。发起一单再退回到发起人,320 / 360 / 390 三档真页面各量一次:改前那一屏填写块整块不存在(0 格、一个输入框都没有),改后 12 格全出,块头「共 4 项必填 另有 8 格可改」与分隔条同一个 8;validRange 那一行在 320 屏竖排拿到 262px、相对卡片溢出 −15px(在卡内),三档整页横向溢出都是 0。数据 /tmp/goal-mobile-1113/realfix_realflow.json,截图 realfix_before_HEAD_390.png / realfix_after_fix_390.png / ..._320.png。

窄屏复核(320 × 860 真页面,改前 :5610 与改后 :3000 各扫一遍,判据只看几何不认类名):「无滚动祖先且顶出卡片」的元素两版都是 0 个,整页横向溢出 0。 摘要里那条长只读值本来就会折行——值那一格是 p.break-words whitespace-pre-wrap 加 min-w-0 flex-1 (MobileFormSummary.vue:93-95、MobileFormReader.vue:107-109),往真页面那一格灌到 120 字符也只是从 1 行变 8 行, 宽度与右边界一动不动;明细表展开行的值那一格同理(MobileFormSummary.vue:46)。明细表里表格本体在 320 屏比卡片宽 733px,但它带 overflow-x-auto 祖先,属横向滑、 不属顶出卡片。中途一度报过「只读日期区间在 320 屏顶出 100~136px」,那是从合成台(抠 DOM 自拼 markup、类名也是自己起的) 读出来的,真页面上复现不出来,已作废——量布局一律用真页面,合成台只能用来隔离单只控件的固有最小宽。

4.4 没配闸门就不摆「外部核验」

ExternalCheckPanel 原先的判据是「接口通不通」,于是没配外部核验的流程也在单据上挂一块 「外部核验 / 未提交 / 提交」,点提交还被闸门当没这一回事。后端一直把 configured: bool(cfg) 发回来了(api/runtime.py 里那段),是这一层没认。

现在 configured === false 且没有历史结论时整块不渲染(桌面与手机一起修); 真送过一次审的单照样摆——闸门后来被撤了,那句结论也还得留在单据上给人看。

4.1 流转记录另画一条,不搬桌面那条

桌面那份 ApprovalRecord(408 行)带着内层滚动、编号、部门和一整个批注表单, 摊在 390 上比单子本身还长。手机上换成 components/oa/mobile/MobileFlow.vue: 竖着一条时间线,一步两行——谁在哪一步、什么时候,意见默认两行读完, 超过一句长话才给「展开」;改单折成「改了表单 · 2 项」,附件折成「附件 2」,点开才是原值新值与缩略图。

  • 整条时间线从头摊到底,不折叠。从前只摆最近三步(RECENT = 3),更早的收成一颗 「展开更早 N 条」——批了七八环的单子打开只看得见两环加一颗钮,人以为这张单少走了几环, 其实是被折起来了。这一屏要答的就是"这张单走过哪些环节",省下那两三屏不值这个误会, 于是那颗钮连同 RECENT 一起删了。要省地方可以往上翻页签,本来「表单内容 / 审批记录」就是两屏;
  • 发起那一行永远留着,收掉开头就说不清这张单从哪儿来;
  • 末尾那一行高亮说「此刻卡在谁手上」(停在「总经理审批」,等待 黄雪秋 处理), 这一句才是审批人真正要的答案,桌面上它混在几十行记录里;
  • 批注还挂在这条线上(MobileSheet + 桌面那份 OpinionComposer + PeoplePicker),不另开页签;
  • 数据口径与桌面是同一份:都出自 utils/approvalRecord.buildApprovalRecord, 两处不会各算一套记录。桌面那条一个字没动,仍给 TaskDetailView 用。
  • 抄送与转发也在这一屏摆开,不折叠:挂着环节的每一步下面带「抄送 谁谁 +N · 未阅 / 未处理」那一行,以及收到抄送的每个人一行处理结果 (已阅于几点 / 未阅 / 已处理于几点 / 已阅 · 待处理 加他那句话)。「这一环配置的抄送」 逐条从前也摊在这一屏,按「审批记录里不展示这一环配置的抄送」撤掉了,与桌面同一口径: 这一屏答的是「抄没抄、谁看没看」,本来配了哪几条属流程配置。 他处理时上传的附件也跟着这一行:文件名常驻(一眼知道有没有回执),缩略图收在 「附件 N」那颗折叠里,点开才拉图——手机上不把一条时间线撑成相册;转发那几行同样带。 没有审批记录的环节(办结 / 作废 / 发起 / 还停着人的那一环)自己成一条抄送行, 办结之后转发的那张单在末尾多出一条「办结之后」并逐条列转给了谁、他看没看。 手机上不给悬浮提示,那本账只能写在明面上;说法与桌面共用 utils/flowCc.ts,不在这屏另拼一句;
  • 引擎事件默认全排进来(showAll 默认 true,与桌面同一口径),那颗「全部事件」 钮留着但用途反过来:点一下只留审批步骤。

吸底操作位只三颗:主按钮(永远在同一个位置,拇指不用找)、退回、···。主按钮那一句由 桌面那份算好交下来(TaskView.primaryText):审批那一档是这一环的出口名,发起人自己的那一环 (开始环节 / 起草环节)是「提交 / 重新提交」——见 docs/starter-submit-action-design.md。 必填没填时主按钮换成一句「先填这几项:出差天数」,不给一颗点了报错的死按钮。 这一档是 chromeless 的:不挂顶部栏、不挂底部标签栏,main 也不留内边距, 两道常驻栏省下来的近 120px 全给单子本身,返回交给页面自己那颗返回键。

4.2 单据详情(/work/:job):只读那一屏也换成竖版

上面讲的待办详情(/todo/:id)是手上有活儿的人走的那条路。手机上还有另一批落点—— 已办 / 我发起的 / 已阅 / 首页通知弹层 / 流程监控,以及发起之后那一跳(取件箱里抄送那两档 也算一处,地址带 from=inbox,useReturnTo 认得回待办这条路),全都指向同一张单据 /work/:job(WorkDetailView.vue)。这一页原先只有桌面那一版,于是从「我发起的」点进来还是桌面那套: 抬头四排说明 + 打印审批单 / 刷新 / 催办 / 终止流程 摊成两排 + 「表单内容 / 流转流程图」+ 整屏表单 + 「费用报销基本信息 30 个格子」全摊开,划三屏还没看到进度。领导点开自己提的那张单, 看到的正是这一屏——这也是「手机版式不是没生效吗」这句质问真正的来处。

现在这一页也分两档(components/oa/mobile/MobileWorkView.vue,只读):

  • 抬头就一行:处理中 当前环节 已挂起 当前处理人:黄雪秋 几枚徽章,发起人压成 同一行右端的一枚人标,再往下是关键数字那一档。桌面上红框那一整块——按第 13 版设计在走、 费用报销流程 · FYBX202611030012 · 发起人:×(部门)、发起时间:…——在手机上一个字都不摆: 那是「这张单是怎么来的」,列表里刚读过;这一屏要答的是「现在怎么样了」。单号仍在审批记录末尾, 谁提的、什么时候提的就是那条时间线的第一行。
  • 两个页签:表单内容、审批记录(带条数)。桌面上那张流程图画布不搬,换成 §4.1 那条竖时间线, can-comment 不往下传,所以这一屏只有看、没有批注框。
  • 吸底那一行只在真的办得动时才出现,而且就那一颗:can_start → 提交发起(这张单是被 退回到开始环节的,改口 重新提交,判据同 utils/taskAction),否则 canPress → 催办;两条都不成立整条不挂。原先兜底那颗 刷新 撤了——没得办的单子刷不出新东西, 而那条栏会一直压着正文最后两行。
  • 低频那几件搬到顶栏的 ···:流程干预(要 monitor:work)、终止流程(要 can_terminate 且还在途)、看电脑版、三档字号。屏幕下沿只留给「此刻要按的那一颗」。
  • 终止与提交要写的那一句话也在手机上做成下推层,不弹桌面那个居中框。
  • 这一屏没有的:打印审批单、意见框与那套提交/退回出口(没有待办要办)、桌面那三排抬头说明。
  • 挂起、被第三方锁住、停在开始环节等提交,这三种「办不动」各在抬头下面说一句,别让按钮哑着。

判据仍旧由 WorkDetailView 一处算完递下去(canPress / canIntervene / startLocked / beginDecisions),手机那一版自己一条都不算,不会出现「电脑上能终止、手机上说不行」。桌面那一版 是同一个文件里的 <div v-else>,一个字没动,包括打印、流程图画布和右栏那三张卡片; 两个要写意见的确认框从桌面块里挪到了两条版式外面共用,BaseDialog 本来就被送到 body, 挪位置不动样式,只是确认那颗改成显式传词(confirmTerminate(terminateOpinion)), 免得手机上抛上来的那句意见被当成点击事件。

/work/:job 也标了 meta.chromeless:手机上这一屏自己管顶部那一行和吸底那一行, 不再叠一条 MobileTopBar,也不会被底部标签栏压住最后两行。桌面不受这条影响—— useChromeless() 要 meta.chromeless 与 phoneShell 同时成立才算数。

5. 动作一律 bottom sheet,不用居中弹窗

BaseDialog 居中、宽度按内容撑,那套尺寸在 375 的屏上会把「确定」顶到屏幕外。 审批动作的弹层都只需要「填一点东西 + 一颗主按钮」,从屏幕下沿推上来之后主按钮位置固定, 而且躲开了企业微信自带的顶部标题栏。

  • 多出口先选一条再写意见,每条出口上写着它去哪儿(同意 → 财务复核),不用点了才知道; 适用条件不成立的那几条当场标黄说为什么走不了(手机上没有悬停,等人次点完再吃一句提示是白费一次拇指), 点了也带不走——挡回来的是桌面那份 pickRoute,手机版式没有第二条闸;
  • 同意那一屏只有「说一句 + 提交」:五句常用意见点一下就填进框,主按钮是「提交,回待办」—— 批完这张就把它关掉,落回待办列表;退回、转办同一口径。这一档原先是「自动去下一条」, 省一次拇指,代价是批完的人看不见「这条真走了、还剩几条」,而且两个 id 之间 TaskDetailView 不重新挂载,抬头那一屏还是上一张单子的内容;列表本来就自己取数, 剩下几条摆在眼前,下一条点不点由人决定(TaskDetailView 也补了 watch(taskId, load), 直达链接、前进后退换单子时不会再拿旧数据糊在新的 URL 上);
  • 退回带目标环节 + 逐级/直退 + 意见,加签带前后/并行串行,抄送带要不要对方处理, 与桌面那几个弹窗的选项一一对上,一样不少;
  • 更多操作:加签、转办、抄送、分享、完整单据、看电脑版,末尾三档字号;已办结的那一张还多一项「转发」(只在后端详情报文里 can_forward 为真时出现,也就是「已归档 + 本人是发起人或管理员」,判据不在手机上另算一套)。那一层收三样:要不要对方处理(默认不要)、转给谁(必填)、一句转发的话;交出去的是 emit 出去的一个 payload,请求由父页那一份 sendForward 发——手机上不自己碰接口,否则长成「电脑上转完会刷新、手机上转完没反应」。来源仍是「抄送」那一类,不另立名目;转出去的每一条也回到流转记录里摆一行(末尾那条「办结之后」,逐条列转给了谁、看没看、要不要处理),转完在这一屏就查得到,不用回列表翻。手机上不给「打印审批单」 这一档——手边没有打印机,真要出纸是回电脑上的详情页做的事,/print/work/:job 那条路由留着不动; (字号靠 html 的 font-size 整体缩放,Tailwind 的字号间距都是 rem,一处改完全屏跟着走)。

「完整单据」是那条兜底的路:折叠了多少格、哪些是空值、签名长什么样,进去一个字段都不会少, 用的是桌面那套只读渲染,只把行距收一档。摘要负责好读,这一份负责不漏。

5.1 刷新不是按钮:下拉这一把,加上回到前台补一次

两个详情页原先都在顶栏右侧摆一颗刷新图标。那是全场离拇指最远的一次点击——它在屏幕最上沿, 而拇指天然落在下半屏;手机上有一把手势专门干这件事,就是往下拉。于是按钮撤了, 换成 composables/useMobileRefresh.ts 两条道:

  • usePullToRefresh:只在页面已经滚到顶、手指又继续往下拖过 12px 才接管,拖过阈值才算数, 阻尼 0.5、上限 92px;往上滑、在弹层里滚、页面还没到顶,一律当场把手势还给正常滚动(不抢 preventDefault)。触发时顶栏正中浮出「继续下拉 / 松开刷新 / 正在刷新…」那枚胶囊,松手即散。 待办详情只有人主动下拉才取——那一屏有正在填的填写块,不能拿人家写了一半的字去换一次「也许更新了」。
  • useRefreshOnReturn:企微里点开单子、切回去聊两句、再切回来,这中间单子早被人批掉一环了。 只读那一屏(/work/:job)没有输入框,回到前台就自己取一次,不会吃掉谁写的东西。

列表页与首页仍留着那颗刷新按钮:那是几十条数据的入口,下拉之外还得给个显式的口子; 详情页不一样,它进门就取过一遍,之后只有「别人动了这张单」这一种变化。

6. 常驻栏:手机上只留一条细栏和一条标签栏

截图里那条顶栏(汉堡 + 站点名 + 通知 + 语言 + 深色 + 头像)在 390 上比正文还高,整条不要了 (AppLayout.vue:<AppHeader v-if="!chromeless && !phoneShell" />)。桌面上一个字没变。

那几件事各有各的去处,没有一件是丢掉的:

原来在顶栏 手机上在
页名 子页面上那条 44px 细栏(MobileTopBar.vue,只有返回 + 页名)
通知(铃铛 + 未读) 首页抬头那颗铃铛 与 「我的」那一行,都开同一张底部弹层
语言 / 深色 / 字号 「我的」→ 外观
头像菜单(退出、说明、看电脑版) 「我的」
抽屉菜单(其余入口) 「我的」→ 按权限过滤的那几组入口
「有新版本」那颗钮 首页下面一条横贯的细条(data-test="m-update")

细栏也不挂在底部三格常驻的那几页(/workbench /todo /profile)——它们本来就在导航上, 再顶一行标题只把正文往下推。详情页连细栏也不要,自己管那一行(meta.chromeless)。

左侧那个抽屉在手机上整块不挂(<AppSidebar v-if="!phoneShell" />)。它的拉手本来就是顶栏那颗 汉堡,顶栏没了,抽屉就成了一堆进不去的 DOM;入口改由「我的」那一屏按权限分组给出。 768~1023 那一档(平板、企微 PC 端缩小窗口)照旧:汉堡在,抽屉也在,桌面上一个字没动。

「我的」这一格是这次新加的一屏(ProfileView.vue 手机档):身份一行、通知一行、收款账户 (点开还是那张表,字段与桌面同一份)、按权限过滤的入口若干组、外观(深色开关 + 三档字号 + 语言)、 添加到主屏幕、退出登录,末尾钉着构建号。桌面上那一版(资料卡 + 收款账户两张卡)照原样。

提示也收干净:Toast 在手机上贴底居中一条(inset-x-3 bottom-20,抬过标签栏,也不压 详情页那张吸底操作栏),不摆关闭叉,只走 translate-y 进出;登录成功那一句在手机上不发—— 紧接着就是整屏换页,那条绿横幅只会盖在刚出来的列表上。桌面上两处都照旧。

7. 怎么看效果、怎么验

7.1 线上:手机上那一串数字就是镜像 tag

版式改动最难自查的一点是「发上去了没有」。首屏问候语下面钉了一串 12 位数字 (utils/appBuild.ts 的 APP_BUILD,MobileHome.vue 里 data-test="m-build"),它是打包那一刻 由 vite 注入的构建号,构建时把镜像 tag 递给它,两边就是同一个值:

TAG=$(date +%Y%m%d%H%M)
docker buildx build --platform linux/amd64 --load --build-arg OA_APP_BUILD=$TAG \
  -t docker.oa.unissense.tech/public/unis_oa:$TAG .
kubectl -n unis-oa set image deploy/unis-oa unis-oa=docker.oa.unissense.tech/public/unis_oa:$TAG

手机上看到 202611031703,集群里那个 Pod 跑的也是 :202611031703,两句话就把「生效」说完了。 数字对不上只有三种可能,按概率排:

  1. Pod 还是旧镜像。imagePullPolicy: IfNotPresent,latest 不会重拉,所以只能用时间戳 tag 换。 kubectl -n unis-oa get pods -o jsonpath='{.items[*].status.containerStatuses[*].imageID}' 当场验。
  2. 这台手机被钉在电脑版。清掉 oa.mobile.desktop,或者用新加的「看手机版」那颗钮。
  3. 屏幕宽度不够窄。闸门是 <768,企微 PC 端和 10 寸平板拿到的仍是桌面版式,这是设计如此。

数字对得上、可这一屏还是桌面摆法,那就不是发没发上去的问题,是这一屏本来就没做过手机档—— /work/:job 就是这么漏过一次的(构建号是新的,顶部细栏也是新的,正文却还是桌面那套四排抬头, 见 §4.2)。所以别只盯构建号:那一屏归哪个组件管,先去 router/index.ts 对一眼。

index.html 后端发的是 Cache-Control: no-cache,/assets/* 带哈希又标 immutable, 换版本等于换 URL;离线外壳对导航请求走网络优先。所以缓存基本不是嫌疑人,别拿清缓存当第一招。

7.2 本地:预览台

版式这东西看代码看不出来,得真摆到 390 的屏上。frontend/preview-mobile.html 是预览台: 挂真的手机版式组件、吃真的 Tailwind、走真的词条,数据用 mobileFixtures.ts 里那张照真实报销单 抄的假单子(两分隔条三节、四十七格里一多半是空的、明细十二行、发票两张、这一环还要补两点)。 没有后端、没有登录也能把每一屏截下来对一遍,所以它只在 dev 下存在,不进产物。

cd frontend && pnpm dev
# http://localhost:3000/preview-mobile.html?screen=home
# http://localhost:3000/preview-mobile.html?screen=list
# 批量那一档(前两条已勾上):把上面这条换成 ?screen=list&select=on ;再把那层推上来用 &select=sheet
# http://localhost:3000/preview-mobile.html?screen=detail&open=approve
# http://localhost:3000/preview-mobile.html?screen=work&open=progress
# http://localhost:3000/preview-mobile.html?screen=profile
# http://localhost:3000/preview-mobile.html?screen=work&form=tabs&open=reader

screen 可选 home list detail work profile(work 就是 §4.2 那一屏);open 可选 routes approve menu people goback rows reader progress missing frozen readonly notice bank dark, scroll=520 直接滚到指定位置(弹层里那一屏自己滚,window 滚不动它),blocked=1 把「退回修改」那条出口的适用条件设成不成立, 看走不通的出口怎么交代。

select 只有 screen=list 认:on 直接停在批量选择档,sheet 再把批量那一层推上来。

form=tabs 把那张假单子换成生产上费用报销单的形状——一张「标签页」分两页、第二页整页是外部系统、 其中一格勾了「手机上不展示」。分节、外部页面那一节、逐格开关这三件事,只有在这种表上才看得出对不对, 默认的 mobileFixtures 那张只有分隔条,替不了它。

截屏注意:headless Chrome 把窗口宽度钳在 500,量不到真机的 390,要么套一层定宽 iframe, 要么用 CDP 的 Emulation.setDeviceMetricsOverride。另外 --virtual-time-budget 不推合成器, 弹层那 260ms 的位移会被拍成「划到一半」,看着像版式错了,其实是快门按早了——真等一秒再截。

自动化那一头:MobileTaskView.spec.ts(16 条)盯的是「什么摆在哪儿」,包括必填没填时不给点同意、 两条出口要先挑一条、走不通的出口当场说为什么且点不走、意见 chips 真能填进框、 提交整个交给桌面那份逻辑、不归他办时操作位不说谎,还有一条盯「点摘要里那一行明细就在本页摊开、再点收回,且 m-reader 那一层压根不出现」;useFormPlan.spec.ts(57 条)盯归置口径,含页签分节、「分组标题」切段(归属认表单上的次序、清单里挪格子不换段、三屏切同样的段、singleSection 退回一节)、外部页面那一页的格子不摆、mobileHidden 单独计一笔, 以及 readerSections 那套「空值也留一行」的读法;MobileFormReader.spec.ts(7 条)盯 §4.3 那一屏: 按页签分节、外部页面给卡片并带上 标签页key#页签key 那个回写分区键、手机上不展示的那格哪儿都不出现还要报数、 空值留一行破折号、环节权限藏起来的不出现。ExternalCheckPanel.spec.ts(3 条)盯 §4.4 那三条: 没配闸门不摆、配了就摆、闸门撤了但有结论仍然摆。设计器那一档由 FieldInspector.newTypes.spec.ts(18 条)里那四条盯:普通格子有「手机上不展示」且勾得进字段、 「标签页」那一格不给这一档而「默认隐藏」还在、排版件两档都没有、框选一次收一片而排版件不参与。 MobileFormSummary.spec.ts(26 条)盯「一节最多六行、剩下收成一颗『展开更早 N 条』、换一张单子不把上一张摊开的状态带过来、节名是兜底来的那一节不摆标题行、表单上的分组切成几段时每段自己折自己(收一段不把别段一起带走)、明细那一行点了就地逐条摊开(一条一段、列按 mobileRowCells),以及「点了摊开」与「配成逐条展开」两档摊出来逐字同一份」;MobileFlow.spec.ts(14 条)盯这条时间线:整条线一步不落(十二环的单子摆十三行,且没有「展开更早」那颗钮)、发起那一行在最前、「等谁处理」和单号还在、只有写了长意见的那一条才给「展开」、挂着环节的那一步下面带「抄送 谁谁 +N · 未阅 / 未处理」那一行(不折叠,手机上也不藏),而「这一环配置的抄送」逐条不在这一屏摆、逐人那一行旁边的「附件 N」只在有附件时出现、点了才摆缩略图而文件名一直写着、办结之后被转发的那张单在末尾多出一条「办结之后」并逐条列出转给了谁随附了什么;MobileTopBar.spec.ts(3 条)盯那条细栏只写页名与返回;AppLayout.spec.ts(6 条)里四条盯的就是「手机上整条顶栏不挂、抽屉不挂、细栏只挂在子页面、桌面照旧」;MobileHome.spec.ts(8 条)盯四张卡片的顺序、地址、权限过滤(并钉住「待阅」那张已经不在——留着它就是两个入口摆同一批东西),以及上面那张口径表——数字来源写死在断言里,谁换成自己另算一份就红,另有一条盯抬头那颗铃铛与它那张弹层;MobileTabBar.spec.ts(5 条)盯底部栏只有三格、以及钉在电脑版时那口回去的井;useMobileFeed.spec.ts(5 条)盯攒页不重不漏、回第 1 页清干净;ReadListView.spec.ts(6 条)盯的是 2026-11 之后那一版:这一屏只剩已阅一档,标题与页名都是「已阅件」,没有档位页签、没有勾选、没有批量、没有行内动作,只有五列与「看单据」,手机上换成卡片流,点开单据带上 from=read。原来那份 ReadListView.batch.spec.ts(12 条)跟着退役——批量已阅的入口整体搬进取件箱,这一路现在由 TodoListView.inbox.spec.ts(16 条:红点逐行在、看过只灭点不推行、四档筛选各归各、只需阅点完报「已归入已阅」、抄送需处理不写意见不放行、整批都是抄送时不摆出口那一格)与 backend/scripts/check_inbox_read.py(33 项)盯。 MobileWorkView.spec.ts(16 条)盯 §4.2 那一屏:抬头不重复流程名与发起时间、整页没有「刷新」也没有 打印审批单、没有画布、切页签才出时间线且单号在末尾、办得动才挂吸底那一行、终止走下推层并把意见抛出去、 没权限时 ··· 里不摆那两颗、挂起与被锁各自说一句,还有一条盯下拉这一把真的把 refresh 抛出去、给了取数那条路就走它且胶囊等到取完,另两条盯明细:点了在本页摊开(摊的是那张子表的全部十二行)而 m-work-reader 不出现,以及摊开之后「完整单据」那一层照旧开得起来、点遮罩照旧收得回去; useMobileRefresh.spec.ts(5 条)盯手势本身——越过阈值才刷、没到顶或往上滑就让位、禁用时不抢 preventDefault、卸载后不再监听、回到前台补取一次;WorkDetailView.spec.ts(4 条)盯那个岔口本身—— 手机上整页换掉且判据原样递下去、电脑宽度一格都没少。 MobileCardList.spec.ts(12 条)盯批量那一档在版式组件这一头的手感:不传 selectable 就不摆那颗钮、 选择档里点卡片是勾上而不是进详情、卡片尾巴上那句「去批」跟着收掉、办不动的那条点不动且理由挂在勾上、 全选只带上屏又办得动的两条、计数不把不在屏幕上的那条算进去、「批量处理」只把事件喊上去; §3.2 那颗垃圾桶也钉在这一份里,五条:只有给了 deletable 的行画得出、点它只喊 delete 不顺手喊 open、 进了选择档就不画、Enter 与 Space 各删一次,外加一条守门的「卡片那棵子树里 button 必须为零」—— 不传这个字段的行一条都不画,所以已办、已阅那两张列表照旧是原来的样子(已阅那一屏本来就是只读); TodoListView.batch.spec.ts(14 条)盯接口那一只脚:交上去的就是勾的那几条、走的是共同出口、 全选不带 oa_locked 那条、没有共同出口时不硬凑、部分失败那层不关且失败的几条留在勾选里、 退档把勾收掉,还有一条盯桌面档位仍走 BaseDialog 而不是从下沿推上来那层。另七条是这两轮补的: 两条盯「发起人」那一格只画 creator_unit_name、绝不肯回退到本环节处理人的 unit_name(手机上那张卡同样), 五条盯手机端删除——只有后端给了 deletable 的那条画得出垃圾桶、点它只开确认框而那一刀还没落、 确认之后按那一条的 job 调一次 deleteJob 并重载、进了选择档垃圾桶收掉、按钮嵌按钮那条在视图这一头 再守一遍。CreatedListView.mobileDelete.spec.ts(4 条)是「我发起的」那一侧的同四件事, 判据换成桌面上那一条,并钉住已办结的那张不给删。 卡片上那一段「时间」由 format.time.spec.ts(7 条)钉:它断的是念出来的整句(「40 分钟前」 而不是「 分钟前」),中英文各断一遍——这几条 t() 的插值参数名一度与词条对不上(代码传 {n}、 词条写 {count}),而 vue-i18n 对认不上的名字不报错、只把占位符换成空串,于是手机与桌面的列表 一起把数字吞了,界面上看着却像「刚刚」「永不」那类正常兜底,一直没人报上来。 returnPath.spec.ts(6 条)盯手机上落地那一屏:有工作台落那五张卡片、没有工作台落待办、桌面落门户、 站外地址不被带出去——它原先写死落 /home,而且没有 work:workbench 的人会被守卫打回门户新闻页。 全量 npx vitest run 2149 条绿(「分组标题」在手机上分段那一档另加 20 条:mobileLayout.spec.ts 那枚标记怎么认 5 条、useFormPlan.spec.ts 三屏切同样的段 9 条、MobileFormSummary.spec.ts 屏幕上真切成几段 4 条、MobileLayoutPanel.spec.ts 那一格不进清单与那颗开关 2 条;§4.5 那两档另加 12 条:mobileLayout.spec.ts 31 条、 MobileTaskView.liveForm.spec.ts 7 条、WorkDetailView.spec.ts 8 条,含生产上那个空 form 回落那条; §4.6 / §4.7 这一轮再加三份:FormFieldControl.dateRangeLayout.spec.ts 17 条(对 HEAD 那一版红 11 条)、 MobileTaskView.needFields.spec.ts 14 条、MobileReadonlyLongValue.spec.ts 4 条 —— 最后这份钉的是只读长值 那一格靠折行撑住而不是截断(break-words + min-w-0 flex-1,不许 whitespace-nowrap / truncate), 四挡变异(换 nowrap+truncate、删 break-words、摘 min-w-0、摘 pre-wrap)都挡得住,不是空断言) 后端 check_design_pin.py 57 条全过(第 3b / 3c 组),npx vue-tsc --noEmit 与 eslint 干净,vite build 通过 (预览台两个 html 不在产物里:rollup 只有一个入口 index.html)。真机那几件(企微内置浏览器、iOS 安全区、软键盘顶页面)还得在手机上过一遍。