瀏覽代碼

fix:970 仓储管理看板首先新需求 最近作业动态改为滚动

mlchen 1 周之前
父節點
當前提交
e5f97529bd

+ 3 - 2
docs/仓储首页看板口径.md

@@ -169,13 +169,14 @@ F1 断言块覆盖:statusLabel/color 优先级与三色兜底(normal 不
 
 - 去重:同一单据(`orderId`,缺失回落 `id`,两者都没有用行下标兜底)只留事件时间最新一条(`buildActivityFeed`,`dashboard-utils.js:853-867`);同刻不覆盖(`:865-866`)。后端已做 `GROUP BY orderId`(`WmsHomeMapper.xml:238`),但前端不能假设这个口径永远不变。
 - 排序:事件时间倒序;同刻按行 key 倒序(`dashboard-utils.js:868-879`),因此顺序确定、可复现——稳定排序才能让刷新后行不跳位。解析不出时间的行排最后(`:872`)。
-- 条数:默认 5 条(`ACTIVITY_LIMIT = 5`,`dashboard-utils.js:601`;前端截断 `:880`;后端 `LIMIT #{q.limit}` 取同一值,`WmsHomeMapper.xml:247` 与 `WmsIndexServiceImpl.java:1546`)。**双保险的理由**:前端还要按 `orderId` 再去重一次,去重后条数可能变少;后端口径若调整也可能变多,只靠后端 LIMIT 保不住「卡片正好 5 条」这个视觉契约(`:598-600`)。多出来的条数进 `overflow`(`:881`),不静默丢弃。
+- 条数:最多 50 条(`ACTIVITY_LIMIT = 50`;前端截断在 `buildActivityFeed`;后端同一上限 `ACTIVITY_FEED_LIMIT = 50` 经 `query.setLimit(...)` 下传,`WmsHomeMapper.xml` 的 `LIMIT #{q.limit}`)。2026-11-10 起由「固定 5 条」改为「最多 50 条 + 卡片内自动滚动」:5 条填不满一屏,没有可滚内容,「最近动态」就只是静态列表。50 与统计接口 `STATISTICS_ACTIVITY_MAX_LIMIT` 同值。**双保险的理由不变**:前端还要按 `orderId` 再去重一次,只靠后端 LIMIT 保不住前端展示条数。多出来的条数进 `overflow`,不静默丢弃。
+- 自动滚动(2026-11-10):`.feed` 容器每 3 秒上移一行(`ACTIVITY_SCROLL_INTERVAL_MS = 3000`),滚到底先停在底部、下一拍回到第一行形成循环;位置由纯函数 `nextActivityScrollTop` 计算,是否可滚由 `isActivityFeedOverflow` 判定(不足一屏不起定时器,1px 容差)。鼠标悬停、键盘聚焦暂停;系统 `prefers-reduced-motion: reduce` 时完全不起定时器。**只许动本容器的 `scrollTop`/`scrollTo`**:禁止 `scrollIntoView`、`scrollBy`、`window`/`document` 级滚动,否则会把整页顶走;单行可读的节奏优先于「看起来更炫」。
 - 「全部动态 ›」下钻 V4 出入库动态:`HomeOverview.vue:128` 发 `open('io')`,`dashboard.vue:84-101` 落到 io 屏(`dashboard-screens.js:8`)。整行与单号点击走 `openActivity`(`HomeOverview.vue:701-705`)→ `dashboard.vue:214-216` 按 `activityType` 分流:盘点→盘点工单详情、调拨→V4 带单号、io→入/出库单据详情;缺 `orderId` 时提示核实,不许硬跳到列表首页。
 
 ### 刷新与高亮
 
 - 30 秒轮询:`dashboard.vue:170` 的 `setInterval(() => this.refreshPart('activities'), 30*1000)`,只刷 `activities` 这一片,不整页重算(`:164-172`)。
-- 新事件只加 `is-new` 类做 3 秒渐隐(`HomeOverview.vue:135` + `dashboard-theme.scss:162-163`),JS 只负责到点摘类(`HomeOverview.vue:679-682`)。**不移动 DOM、不调用任何滚动 API**:30 秒轮询里主动 `scrollIntoView`/`scrollTop` 会把用户正在看的位置顶走(`HomeOverview.vue:668-669`、`dashboard-theme.scss:160-161`)。
+- 新事件只加 `is-new` 类做 3 秒渐隐,JS 只负责到点摘类。**轮询不移动 DOM 顺序、不复位滚动位置**:卡片自己的自动滚动是独立定时器,30 秒轮询只重算「还超不超出可视区」,绝不把 `scrollTop` 归零(归零等于每次刷新都把用户正在看的那几行顶走)。
 - 首屏不整屏高亮:`diffActivityIds` 在 prev 为空(首次加载)时返回空数组(`dashboard-utils.js:919`),`HomeOverview.vue:670-673` 因此天然不触发——整屏闪一下等于什么都没强调。
 - 差分只按行 key 比较,绝不按数组引用(`dashboard-utils.js:920-924`):`activities` 是计算属性,每次求值都返回新数组,引用比较会让 30 秒轮询把同一批行全判成新增、整屏反复闪。
 - 连续两批新增重置定时器:`HomeOverview.vue:675` 先 `clearTimeout` 再起新的 3 秒,只保留最后一轮,避免先到的一批提前被摘掉;组件销毁时同一处清理(`:685-688`)。

+ 41 - 12
scripts/check-warehouse-dashboard.cjs

@@ -1092,8 +1092,10 @@ const {
   formatActivityTime, activityStatusOf, buildActivityFeed, diffActivityIds
 } = utilsLogged;
 // const 常量落在 vm 词法作用域、不会成为上下文属性,必须用 utilConst 取(同 STAGNANT_DEFAULT_DAYS / ALERT_TOP_LIMIT)。
-// 卡片固定 5 条是视觉契约:改成 6 会让卡片多出一行,与设计稿的 5 行节奏错位。
-assert.equal(utilConst('ACTIVITY_LIMIT'), 5, '最近作业动态卡片必须固定展示 5 条');
+// 2026-11-10 起卡片改「最多 50 条 + 容器内自动滚动」:5 条填不满一屏,没有可滚内容,
+// 「最近动态」就只剩静态列表。50 与后端 ACTIVITY_FEED_LIMIT、统计接口 STATISTICS_ACTIVITY_MAX_LIMIT 同值。
+assert.equal(utilConst('ACTIVITY_LIMIT'), 50, '最近作业动态最多 50 条(容器内自动滚动,不再固定 5 条)');
+assert.equal(utilConst('ACTIVITY_SCROLL_INTERVAL_MS'), 3000, '自动滚动周期必须 3 秒一行:慢到能读,又不至于半天不动');
 // 超时口径必须与待办条(overdueInbound/overdueOutbound/overdueApproval)同源 24 小时,
 // 否则同一屏上「待入库单超时」与「入库流水超时」会用两个阈值各说一套。
 assert.equal(utilConst('ACTIVITY_OVERDUE_HOURS'), 24, '待* 超时阈值必须与待办条同口径 24 小时');
@@ -1146,8 +1148,8 @@ assert.equal(activityStatus({}), '状态待核实/neutral', '完全没有类型
 assert.equal(activityStatus({ activityType: 'inventory', status: 9 }), '状态待核实/neutral', '未识别盘点 status 必须回落 neutral,绝不猜成某个已知状态');
 assert.equal(activityStatus({ activityType: 'inventory', status: null }), '状态待核实/neutral', '盘点缺 status 时回落 neutral,不得默认成「待执行」');
 
-// —— (4) buildActivityFeed:去重(同单号留最新)→ operateTime 倒序 → 截断 5 条 ——
-// fixture:8 条入参、含 1 条重复(O6 两条),期望 total=8 / deduped=1 / shown=5 / overflow=2。
+// —— (4) buildActivityFeed:去重(同单号留最新)→ operateTime 倒序 → 最多 50 条 ——
+// fixture:8 条入参、含 1 条重复(O6 两条),期望 total=8 / deduped=1 / shown=7 / overflow=0(未到上限不丢行)。
 // 重复的两条刻意把「旧的一条排在前面」,用来证明去重认的是 operateTime 而不是先到者。
 const activityFeedRows = [
   { id: 'A1', orderId: 'O1', orderNo: 'RK-001', activityType: 'io', direction: 1, status: null, operateTime: '2026-10-20 14:00:00', itemCount: 3, warehouseName: '一号库' },
@@ -1163,9 +1165,9 @@ const activityFeed = buildActivityFeed(activityFeedRows, activityNow);
 const activityById = (feed, id) => feed.items.filter((item) => item.id === id)[0] || {};
 assert.equal(activityFeed.total, 8, 'total 必须是入参条数 8(含重复),用于核对后端到底回了几行');
 assert.equal(activityFeed.deduped, 1, 'deduped 必须记 1 条被去掉的重复单据');
-assert.equal(activityFeed.items.length, 5, '卡片只展示 5 条,多一条就会顶掉设计稿的 5 行节奏');
-assert.equal(activityFeed.overflow, 2, 'overflow=去重后 7 条 − 展示 5 条 = 2,供「全部动态 ›」提示余量');
-assert.equal(activityFeed.items.map((item) => item.id).join('|'), 'A1|A2|A3|A7|A4', '必须按 operateTime 倒序截断 5 条:A6 是同单号的旧记录,去重后只留较新的 A7');
+assert.equal(activityFeed.items.length, 7, '上限 50 条:fixture 去重后 7 条必须全部保留,不得再截断到 5 条');
+assert.equal(activityFeed.overflow, 0, 'overflow=去重后 7 条 − 展示 7 条 = 0:没超上限就不许丢行');
+assert.equal(activityFeed.items.map((item) => item.id).join('|'), 'A1|A2|A3|A7|A4|A5|A8', '必须按 operateTime 倒序全量返回:A6 是同单号的旧记录(去重后只留较新的 A7),A8 是最早的一条,超过 5 条后也必须保留');
 assert.equal(activityFeed.items.filter((item) => item.orderId === 'O6').length, 1, '同一 orderId 在卡片上只能出现 1 次,否则同一张单会被看两遍');
 // 盘点动作文案:以「盘点」开头 + 带库区 + **绝不出现「项」**。
 // 后端盘点行的 itemCount 是占位常量 1(WmsHomeMapper.xml 盘点分支 CAST 成 1),拼成「盘点 1 项」就是伪造明细数。
@@ -1212,6 +1214,23 @@ const activityFeedAgain = buildActivityFeed(activityFeedRows, activityNow);
 assert.equal(activityFeedAgain.items.map((item) => item.overdue).join('|'), activityFeed.items.map((item) => item.overdue).join('|'), '重复求值的 overdue 必须完全一致(幂等,轮询不得让角标闪来闪去)');
 assert.equal(activityFeedAgain.items.map((item) => item.tone).join('|'), activityFeed.items.map((item) => item.tone).join('|'), '重复求值的 tone 必须完全一致');
 
+// —— (5b) 自动滚动纯函数:不超出不滚、一次一行、先到底再回顶 ——
+// 滚动位置只由这两个纯函数算,组件只负责把结果写进容器;边界若写在组件里就没法在这里验。
+const { isActivityFeedOverflow, nextActivityScrollTop } = utilsLogged;
+assert.equal(isActivityFeedOverflow(300, 264), true, '内容高于可视区必须判为可滚动');
+assert.equal(isActivityFeedOverflow(264, 264), false, '正好一屏不许滚(否则定时器空转、容器自己抖)');
+assert.equal(isActivityFeedOverflow(265, 264), false, '1px 容差内的亚像素差不算可滚动');
+assert.equal(isActivityFeedOverflow(NaN, 264), false, '测量值非法(容器还没渲染)时不得起滚');
+assert.equal(isActivityFeedOverflow(undefined, 264), false, '测量值缺失时同样不得起滚');
+assert.equal(nextActivityScrollTop(0, 34, 100), 34, '第一拍必须正好上移一行');
+assert.equal(nextActivityScrollTop(34, 34, 100), 68, '之后一拍一行,节奏与行高一致');
+assert.equal(nextActivityScrollTop(68, 34, 100), 100, '越过末尾先停在底部:直接归零会把最后一行吞掉');
+assert.equal(nextActivityScrollTop(100, 34, 100), 0, '已在底部时下一拍回到第一行,形成循环');
+assert.equal(nextActivityScrollTop(0, 0, 100), 0, '行高取不到时必须停在 0,不许乱跳');
+assert.equal(nextActivityScrollTop(0, 34, 0), 0, '不超出可视区时永远返回 0');
+assert.equal(nextActivityScrollTop(-20, 34, 100), 34, '负数 scrollTop 按 0 归一,不得滚到负坐标');
+assert.equal(nextActivityScrollTop(0, 34, NaN), 0, 'maxScroll 非法时不得算出位置');
+
 // —— (6) diffActivityIds:首屏不整屏高亮、只标新增、同批二次为空 ——
 // prev 为空=首次加载:返回空数组,否则首屏 5 行全部高亮,等于什么都没强调,只是让卡片闪一下。
 assert.equal(diffActivityIds([], [{ id: 'n1', orderId: 'N1' }]).length, 0, '首次加载(prev 为空)必须返回空数组,首屏不得整屏高亮');
@@ -1258,7 +1277,7 @@ assert.match(activityAllLink, /\$emit\('open', 'io'\)/, '「全部动态 ›」
 const activityScript = activitySfc.script.content;
 assert.match(activityScript, /setTimeout\(\(\) => \{[\s\S]{0,200}?\}, 3000\)/, '新增事件高亮必须是 3000ms 定时器(与 scss 的 3s 渐隐动画同长)');
 assert.match(activityScript, /beforeDestroy\(\)\s*\{[\s\S]{0,260}?clearTimeout\(this\.highlightTimer\)/, 'beforeDestroy 必须清理高亮定时器(否则 3 秒后往已销毁实例写响应式数据)');
-// 滚动守卫前先剥注释:实现里为了说明「禁止 scrollIntoView/scrollTop」本身就写了这两个词,
+// 滚动守卫前先剥注释:实现里为了说明「只许滚卡片自己」本身就写了这些词,
 // 拿原文匹配会把这条说明当成违规;剥掉注释后剩下的才是真正的代码,守卫挡的就是它。
 const stripCodeComments = (source) => source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/[^\n]*/g, '$1');
 const activityOverviewCode = stripCodeComments(overviewSource);
@@ -1266,9 +1285,19 @@ const activityThemeCode = stripCodeComments(fs.readFileSync(path.join(folder, 'd
 // 防呆:剥注释后仍必须读到真实模板与样式,否则下面的「不出现」断言会空转(剥太狠等于什么都没查)。
 assert.match(activityOverviewCode, /class="feed-item"/, '剥注释后仍必须能读到 feed-item 模板(否则滚动守卫空转)');
 assert.match(activityThemeCode, /\.feed-status\.done\s*\{/, '剥注释后仍必须能读到 .feed-status.done 规则(否则滚动守卫空转)');
-for (const [activityFile, activityCode] of [['HomeOverview.vue', activityOverviewCode], ['dashboard-theme.scss', activityThemeCode]]) {
-  assert.doesNotMatch(activityCode, /scrollIntoView|scrollTop|scrollTo|scrollBy|scrollLeft/, activityFile + ' 不得调用任何滚动 API:30 秒轮询里主动滚动会把用户正在看的位置顶走(只允许注释里提这些词)');
-}
+// 2026-11-10 起 E3 允许「卡片内自动滚动」,但边界写死:只许动本容器的 scrollTop/scrollTo,
+// 禁止 scrollIntoView / scrollBy / window 与 document 级滚动(会连带把整页顶走);样式表里一个滚动 API 都不许有。
+assert.match(activityOverviewCode, /ref="feedEl"/, '滚动容器必须挂 ref="feedEl":没有句柄就没法只滚这一块');
+assert.match(activityOverviewCode, /@mouseenter="pauseActivityScroll"/, '悬停必须暂停自动滚动,否则行在移动中来不及看清、也点不准单号');
+assert.match(activityOverviewCode, /@focusin="pauseActivityScroll"/, '键盘聚焦必须暂停自动滚动(焦点在行上时内容不能自己走)');
+assert.match(activityOverviewCode, /setInterval\(this\.stepActivityScroll, ACTIVITY_SCROLL_INTERVAL_MS\)/, '滚动必须由 ACTIVITY_SCROLL_INTERVAL_MS 驱动的 setInterval 推进,周期不许在组件里再写一个数');
+assert.match(activityOverviewCode, /nextActivityScrollTop\(/, '滚动位置必须走 nextActivityScrollTop 的纯函数边界,不许在组件里另写一套');
+assert.match(activityScript, /activities\(nextItems, prevItems\)[\s\S]{0,300}?restartActivityScroll/, '数据变化后必须重算滚动(条数变化可能让「可滚」变成「不可滚」)');
+assert.doesNotMatch(activityOverviewCode, /scrollIntoView/, 'HomeOverview.vue 不得 scrollIntoView:会把整个页面一起滚走');
+assert.doesNotMatch(activityOverviewCode, /scrollBy\(/, 'HomeOverview.vue 不得 scrollBy:增量滚动会和 nextActivityScrollTop 的边界判断打架');
+// 页面级滚动一律禁止(document.documentElement 本身在 toggleFullscreen 里是合法的全屏目标,只禁它的滚动用法)。
+assert.doesNotMatch(activityOverviewCode, /window\.scroll(To|By)?\(|document\.scrollingElement|document\.documentElement\.scroll/, 'HomeOverview.vue 不得滚动页面:只许滚卡片自己的容器');
+assert.doesNotMatch(activityThemeCode, /scrollIntoView|scrollTop|scrollTo|scrollBy|scrollLeft/, 'dashboard-theme.scss 不得出现任何滚动 API(样式只负责给滚动条配色)');
 
 // —— (9) 样式契约:五条 tone 规则 + is-new 渐隐关键帧 ——
 for (const activityTone of ['done', 'waiting', 'doing', 'danger', 'neutral']) {
@@ -1276,7 +1305,7 @@ for (const activityTone of ['done', 'waiting', 'doing', 'danger', 'neutral']) {
 }
 assert.match(activityThemeCode, /\.feed-item\.is-new\s*\{[\s\S]{0,80}?animation:\s*feed-new-fade\s+3s/, '新增行必须有 is-new 的 3s 渐隐动画,时长与 JS 的 3000ms 定时器一致');
 assert.match(activityThemeCode, /@keyframes\s+feed-new-fade\s*\{[\s\S]{0,400}?\}/, 'is-new 的 @keyframes feed-new-fade 必须存在(否则 animation 引用不存在的动画,高亮静默失效)');
-console.log('E3 最近作业动态断言通过:ACTIVITY_LIMIT=5 与待办条同口径 24h 超时、状态色表四 tone 全覆盖(已完成/已执行=done、待*=waiting、进行中=doing、已驳回/异常=danger)、formatActivityTime 四段(今日补前导 0 / 昨日 / MM-DD / 空与非法→「—」)、activityStatusOf 先按类型分流(io status=null 仍是「已完成」,不落 Number(null)===0 陷阱;未识别类型与未识别盘点 status 回落 neutral)、buildActivityFeed 同单号留 operateTime 最新且倒序截断 5 条(total 8/deduped 1/overflow 2)、盘点行不带占位 itemCount(无「项」)而 io/transfer 必须带「N 项」、原始 id/orderId/orderNo/activityType/direction/status 全保留、超时只标 waiting 且早于 now−24h(done/doing 再老也不标)并幂等、diffActivityIds 首屏不高亮/只返回新增/同批二次为空、模板四段结构与单号 prevent.stop、超时角标、空态固定文案、「全部动态 ›」仍走 open(io)、3000ms 高亮定时器与 beforeDestroy 清理、HomeOverview.vue 与 dashboard-theme.scss 均无滚动 API、scss 五条 tone 规则与 feed-new-fade 关键帧。');
+console.log('E3 最近作业动态断言通过:ACTIVITY_LIMIT=50 与待办条同口径 24h 超时、状态色表四 tone 全覆盖(已完成/已执行=done、待*=waiting、进行中=doing、已驳回/异常=danger)、formatActivityTime 四段(今日补前导 0 / 昨日 / MM-DD / 空与非法→「—」)、activityStatusOf 先按类型分流(io status=null 仍是「已完成」,不落 Number(null)===0 陷阱;未识别类型与未识别盘点 status 回落 neutral)、buildActivityFeed 同单号留 operateTime 最新且倒序最多 50 条(total 8/deduped 1/shown 7/overflow 0)、盘点行不带占位 itemCount(无「项」)而 io/transfer 必须带「N 项」、原始 id/orderId/orderNo/activityType/direction/status 全保留、超时只标 waiting 且早于 now−24h(done/doing 再老也不标)并幂等、diffActivityIds 首屏不高亮/只返回新增/同批二次为空、模板四段结构与单号 prevent.stop、超时角标、空态固定文案、「全部动态 ›」仍走 open(io)、3000ms 高亮定时器与 beforeDestroy 清理、ACTIVITY_LIMIT=50 与 ACTIVITY_SCROLL_INTERVAL_MS=3000、滚动纯函数(不足一屏不滚/一次一行/到底先停底部再回顶/非法测量值归零)、组件只滚本容器且悬停与聚焦暂停、轮询只重算不复位、scss 仍无任何滚动 API、scss 五条 tone 规则与 feed-new-fade 关键帧。');
 
 (async () => {
   const state = { receiving: false, preparedReceipts: [{ requestKey: 'a' }, { requestKey: 'b' }], receiveQueue: [], filters: {}, $confirm: async () => {}, route() {}, $refs: { actions: { showResults() {} } }, refresh() {}, $message: { error(message) { throw new Error(message); } } };

+ 75 - 20
src/views/warehouseManagement/index/components/HomeOverview.vue

@@ -120,15 +120,24 @@
                  ②单据类型 + 单号(可点击下钻)③动作描述(按类型套模板:数量 + 库区 [+ 进度])
                  ④状态(done 绿 / waiting 橙 / doing 青 / danger 红 / neutral 灰);
                  橙色「待*」超过 24h 追加红色「超时」角标(与待办条同口径)。
-                 数据侧:同单号只留最新一条 + 事件时间倒序 + 默认 5 条。交互:整行可点击/可键盘 Enter,
-                 单号段单独可点(@click.stop,避免冒泡到整行触发两次下钻)。新增事件只加 is-new 类做 3 秒渐隐,
-                 不移动 DOM、不调用任何滚动 API。 -->
+                 数据侧:同单号只留最新一条 + 事件时间倒序 + 最多 50 条。交互:整行可点击/可键盘 Enter,
+                 单号段单独可点(@click.stop,避免冒泡到整行触发两次下钻)。新增事件只加 is-new 类做 3 秒渐隐。
+                 滚动:容器内每 3 秒上移一行、到底回到第一行;悬停/键盘聚焦暂停,系统「减少动态效果」时不起定时器。
+                 只动本容器自己的滚动位置,不滚页面、不改 DOM 顺序,轮询也不重置位置。 -->
             <section class="card corner">
               <div class="card-hd">
                 <div><h3>最近作业动态</h3></div>
                 <a class="link" href="#" @click.prevent="$emit('open', 'io')">全部动态 ›</a>
               </div>
-              <div v-if="activities.length" class="feed card-scroll">
+              <div
+                v-if="activities.length"
+                ref="feedEl"
+                class="feed card-scroll"
+                @mouseenter="pauseActivityScroll"
+                @mouseleave="resumeActivityScroll"
+                @focusin="pauseActivityScroll"
+                @focusout="onActivityFeedFocusOut"
+              >
                 <div
                   v-for="item in activities"
                   :key="item.id"
@@ -161,7 +170,7 @@
 </template>
 <script>
 import DashboardChart from './DashboardChart.vue';
-import { displayNumber, formatSignedNumber, formatComparisonBase, formatPpChange, buildTrendWindow, trendWindowDates, trendStreak, trendRisk, buildAgingSegments, formatAverageAgeDays, STAGNANT_DEFAULT_DAYS, ALERT_TOP_LIMIT, buildAlertRows, buildAlertSummary, alertGapAmountText, alertGapAmountReason, formatAlertQuantity, logAlertDrill, homeLog, homeWarn, buildActivityFeed, diffActivityIds } from '../dashboard-utils';
+import { displayNumber, formatSignedNumber, formatComparisonBase, formatPpChange, buildTrendWindow, trendWindowDates, trendStreak, trendRisk, buildAgingSegments, formatAverageAgeDays, STAGNANT_DEFAULT_DAYS, ALERT_TOP_LIMIT, buildAlertRows, buildAlertSummary, alertGapAmountText, alertGapAmountReason, formatAlertQuantity, logAlertDrill, homeLog, homeWarn, buildActivityFeed, diffActivityIds, ACTIVITY_SCROLL_INTERVAL_MS, isActivityFeedOverflow, nextActivityScrollTop } from '../dashboard-utils';
 
 // 周转状态 → 配色与展示文案:目标/预警天数由后端按仓库配置判定状态,前端只做映射,不再内置阈值。
 // 未识别的状态或 null 一律回落中性色 #9FB8D4 且状态文案留空,避免把「算不出来」误报成健康。
@@ -236,7 +245,9 @@ export default {
   // alertTopLimit 只用于 F1 卡片标题文案;E3 两个状态放这里:newActivityIds 必须声明在 data 里才是响应式的,
   // highlightTimer 存 3 秒渐隐的定时器句柄,供 beforeDestroy 清理。
   // isFullscreen:标题带全屏按钮的状态(fullscreenchange 是唯一权威来源——ESC 退出也要能同步图标)。
-  data() { return { alertTopLimit: ALERT_TOP_LIMIT, newActivityIds: [], highlightTimer: null, isFullscreen: false }; },
+  // feedTimer 是自动滚动 setInterval 的句柄(卡片内滚动的唯一驱动),feedPaused 记录悬停/聚焦暂停,
+  // feedReducedMotion 记录系统「减少动态效果」偏好——开着时完全不起定时器,而不是滚得更慢。
+  data() { return { alertTopLimit: ALERT_TOP_LIMIT, newActivityIds: [], highlightTimer: null, isFullscreen: false, feedTimer: null, feedPaused: false, feedReducedMotion: false }; },
   computed: {
     // D1 出入库动态:窗口=近 30 天滚动(含今日),后端只返回有作业的日期,
     // 缺的日期补 null 而不是 0;无作业判定与净差口径全部收在 dashboard-utils 的纯函数里,
@@ -325,7 +336,7 @@ export default {
         unconfiguredTitle: built.unconfiguredCount > 0 ? '未配置=该仓 is_warn=1 配置、物料全局配置与唯一仓级配置兜底都取不到的行数(完全没有阈值配置),不计入预警条数 N' : ''
       };
     },
-    // E3 最近作业动态:去重(同单号只留最新)→ 按事件时间倒序 → 截断 5 条,全部在 dashboard-utils 里完成,
+    // E3 最近作业动态:去重(同单号只留最新)→ 按事件时间倒序 → 最多 50 条,全部在 dashboard-utils 里完成,
     // 组件只负责渲染。口径不允许再内联进模板:一旦写成模板三元表达式,模板、日志与断言会各说一套。
     // 解析/未识别日志由 buildActivityFeed 内部按模块级快照去重打印,这里不重复打。
     activities() {
@@ -574,32 +585,29 @@ export default {
     }
   },
   watch: {
-    // E3 新增事件高亮:只换一批 id 让模板加 class,不移动 DOM 顺序、不调用任何滚动 API——
-    // 30 秒轮询里主动 scrollIntoView/scrollTop 会把用户正在看的位置顶走,属于明确禁止的打断。
+    // E3 两类响应:①新增事件高亮(只换一批 id 让模板加 class,不改 DOM 顺序);
+    // ②数据条数变化后重算「还超不超出可视区」——超出继续滚、不超出停滚。
+    // 30 秒轮询不得把容器 scrollTop 复位:复位等于每次刷新都把用户正在看的那几行顶走。
     // 首屏不整屏高亮:diffActivityIds 在 prevItems 为空(首次加载)时返回空数组,这里天然不触发。
     activities(nextItems, prevItems) {
-      const added = diffActivityIds(prevItems, nextItems);
-      if (!added.length) return;
-      // 连续两批新增时重置定时器:只保留最后一轮的 3 秒,避免先到的一批提前被摘掉。
-      if (this.highlightTimer) clearTimeout(this.highlightTimer);
-      this.newActivityIds = added;
-      homeLog('E3 最近作业动态新增事件', { ids: added.map((id) => String(id)), count: added.length });
-      // 渐隐由 scss 的 feed-new-fade 动画完成(3 秒),JS 只负责到点摘掉 class。
-      this.highlightTimer = setTimeout(() => {
-        this.newActivityIds = [];
-        this.highlightTimer = null;
-      }, 3000);
+      this.markNewActivities(diffActivityIds(prevItems, nextItems));
+      this.$nextTick(this.restartActivityScroll);
     }
   },
   mounted() {
     // 全屏状态跟随浏览器事件同步:用户按 ESC / F11 退出时图标与 title 也要跟着变。
     this.onFullscreenChange = () => { this.isFullscreen = !!document.fullscreenElement; };
     document.addEventListener('fullscreenchange', this.onFullscreenChange);
+    // 减少动态效果:系统偏好开着就完全不起滚动定时器(不是滚得更慢),这是无障碍设置里常见的一项。
+    this.feedReducedMotion = !!(typeof window !== 'undefined' && window.matchMedia
+      && window.matchMedia('(prefers-reduced-motion: reduce)').matches);
+    this.$nextTick(this.restartActivityScroll);
   },
   beforeDestroy() {
     // 组件销毁时清掉高亮定时器:否则 3 秒后会在已销毁实例上写响应式数据(报错/内存泄漏)。
     if (this.highlightTimer) clearTimeout(this.highlightTimer);
     this.highlightTimer = null;
+    this.stopActivityScroll();
     document.removeEventListener('fullscreenchange', this.onFullscreenChange);
   },
   methods: {
@@ -641,6 +649,53 @@ export default {
       homeLog('E3 最近作业动态下钻', { id: item.id, activityType: item.activityType, orderNo: item.orderNo, direction: item.direction });
       this.$emit('business', 'io', item);
     },
+    // 新增事件高亮:连续两批新增时重置定时器,只保留最后一轮的 3 秒,避免先到的一批提前被摘掉。
+    // 渐隐由 scss 的 feed-new-fade 动画完成(3 秒),JS 只负责到点摘掉 class。
+    markNewActivities(added) {
+      if (!added.length) return;
+      if (this.highlightTimer) clearTimeout(this.highlightTimer);
+      this.newActivityIds = added;
+      homeLog('E3 最近作业动态新增事件', { ids: added.map((id) => String(id)), count: added.length });
+      this.highlightTimer = setTimeout(() => {
+        this.newActivityIds = [];
+        this.highlightTimer = null;
+      }, 3000);
+    },
+    // E3 自动滚动:卡片叫「最近动态」,内容必须自己往上走,否则 50 条里能看到的永远只有第一屏。
+    // 三条边界:①只滚本容器 scrollTop,不 scrollIntoView、不碰页面滚动;②不超出可视区就不起定时器
+    // (否则小数据量时容器自己抖);③轮询只重算定时器与边界,绝不把 scrollTop 复位。
+    restartActivityScroll() {
+      this.stopActivityScroll();
+      const el = this.$refs.feedEl;
+      if (!el || this.feedReducedMotion) return;
+      if (!isActivityFeedOverflow(el.scrollHeight, el.clientHeight)) { el.scrollTop = 0; return; }
+      this.feedTimer = setInterval(this.stepActivityScroll, ACTIVITY_SCROLL_INTERVAL_MS);
+    },
+    // 一次滚动一行:行高从真实 DOM 取(省略号/角标都不改行高);到底那一拍停在底部,下一拍才回到顶部。
+    // 回顶不带平滑,否则到底后要反向慢速滚回第一行,用户会以为列表在倒放。
+    stepActivityScroll() {
+      const el = this.$refs.feedEl;
+      if (!el || this.feedPaused) return;
+      const firstRow = el.querySelector('.feed-item');
+      const rowHeight = firstRow ? firstRow.getBoundingClientRect().height : 0;
+      const next = nextActivityScrollTop(el.scrollTop, rowHeight, el.scrollHeight - el.clientHeight);
+      if (typeof el.scrollTo !== 'function') { el.scrollTop = next; return; }
+      el.scrollTo({ top: next, behavior: next === 0 ? 'auto' : 'smooth' });
+    },
+    pauseActivityScroll() { this.feedPaused = true; },
+    resumeActivityScroll() { this.feedPaused = false; },
+    // focusout 在容器内的行之间移动也会触发:焦点还在容器里就不算「离开」,
+    // 否则点一下单号再回来,滚动会在用户手里突然恢复。
+    onActivityFeedFocusOut(event) {
+      const el = this.$refs.feedEl;
+      if (el && event && event.relatedTarget && el.contains(event.relatedTarget)) return;
+      this.feedPaused = false;
+    },
+    stopActivityScroll() {
+      if (this.feedTimer) clearInterval(this.feedTimer);
+      this.feedTimer = null;
+      this.feedPaused = false;
+    },
     // 点击柱体(含无作业日)→ 打开 V4 出入库动态并带入该日 00:00:00~23:59:59;
     // 无作业日同样带日期(列表为空态),不能因为当天没柱体就丢掉日期。
     trendSelect(row) {

+ 37 - 5
src/views/warehouseManagement/index/dashboard-utils.js

@@ -587,10 +587,11 @@ export function logAlertDrill(action, payload) {
 
 
 // ============================== E3「最近作业动态」 ==============================
-// 卡片固定展示 5 条。后端 home-summary 已做 operateTime 倒序 + 同单号 GROUP BY + LIMIT 5,
-// 前端仍再截断一次:因为前端还要按 orderId 再做一次「同一单据只留最新」的去重,去重后条数可能变少,
-// 也可能因后端口径调整而变多;只靠后端 LIMIT 无法保证「卡片正好显示 5 条」这个视觉契约。
-export const ACTIVITY_LIMIT = 5;
+// 卡片最多 50 条,容器内自动滚动(2026-11-10 需求:动态流必须真的在动,5 条填不满一屏就没有可滚内容)。
+// 后端 recentActivities 已做 operateTime 倒序 + 同单号 GROUP BY + LIMIT(同一常量),前端仍再截断一次:
+// 因为前端还要按 orderId 再做一次「同一单据只留最新」的去重,只靠后端 LIMIT 保不住前端的展示条数。
+// 50 与统计接口 STATISTICS_ACTIVITY_MAX_LIMIT 同上限,避免两个入口对「一次能看多少条」各写一个数字。
+export const ACTIVITY_LIMIT = 50;
 // 橙色「待*」状态的超时阈值,与待办条(overdueInbound/overdueOutbound/overdueApproval)完全同口径:24 小时。
 export const ACTIVITY_OVERDUE_HOURS = 24;
 
@@ -877,7 +878,7 @@ export function buildActivityFeed(rows, now = new Date()) {
 
 // E3 解析日志(模块级快照去重,见活动最上方的 activityFeedLoggedSnapshot)。
 // 口径说明:四类分布按「去重后的全部行」统计,便于对照后端四类单据是否都回来了;
-// 待*数与超时数按「实际展示的 5 行」统计——这两个值只对用户看得见的行有意义。
+// 待*数与超时数按「实际下发的行」统计——这两个值只对用户看得见的行有意义。
 const logActivityFeedParsed = (total, deduped, ordered, items, overflow) => {
   const distribution = { inbound: 0, outbound: 0, transfer: 0, inventory: 0, other: 0 };
   ordered.forEach((entry) => {
@@ -905,6 +906,37 @@ const logActivityFeedParsed = (total, deduped, ordered, items, overflow) => {
 //            引用比较会让 30 秒轮询把同一批行全部判成「新增」,整屏反复闪。
 // 易错点三:返回的是 nextItems 各行「原始的 id 值」(不做 String 归一),组件模板用同一个 item.id
 //            做 indexOf 比较,两侧天然一致;id 缺失的行直接跳过(退化为不闪,绝不会误闪)。
+// ============================== E3 自动滚动 ==============================
+// 只滚 .feed 容器自己的 scrollTop,不 scrollIntoView、不碰页面滚动、不改 DOM 顺序:
+// 卡片是「最近动态」,内容必须持续上移,否则 50 条里能看到的永远只有第一屏。
+// 周期 3 秒一行:当天约 30 条时一轮约 90 秒,节奏够慢、行内容在读的时候是静止的。
+export const ACTIVITY_SCROLL_INTERVAL_MS = 3000;
+
+// 内容是否真的超出可视区(1px 容差吸收亚像素/边框取整):
+// 不超出就不许起定时器,否则小数据量时容器会自己抖动或反复触发无意义的 scrollTo。
+export function isActivityFeedOverflow(scrollHeight, clientHeight) {
+  const content = Number(scrollHeight);
+  const view = Number(clientHeight);
+  if (!Number.isFinite(content) || !Number.isFinite(view)) return false;
+  return content - view > 1;
+}
+
+// 下一帧的 scrollTop:每次上移一行;先滚到底(maxScroll)再在下一拍回到 0 形成循环。
+// 先到底再归零,是为了让最后一行也被完整看到——直接「越过末尾就归零」会把末尾那行吞掉。
+// 参数一律归一成非负数:容器被隐藏/折叠时 scrollHeight/clientHeight 可能是 0 或负偏移,
+// 这时必须返回 0,绝不能把列表滚到负坐标(浏览器会静默钳到 0,接着跳位)。
+export function nextActivityScrollTop(scrollTop, rowHeight, maxScroll) {
+  const current = Number(scrollTop);
+  const step = Number(rowHeight);
+  const limit = Number(maxScroll);
+  if (!Number.isFinite(current) || !Number.isFinite(step) || !Number.isFinite(limit)) return 0;
+  if (limit <= 0 || step <= 0) return 0;
+  // 负偏移(容器被折叠过、或读取发生在滚动中)一律按 0 归一后再走一行,否则会算出 14 这种半行位置。
+  const start = current > 0 ? current : 0;
+  if (start >= limit) return 0;
+  return Math.min(start + step, limit);
+}
+
 export function diffActivityIds(prevItems, nextItems) {
   const previous = Array.isArray(prevItems) ? prevItems : [];
   const next = Array.isArray(nextItems) ? nextItems : [];