|
@@ -1092,8 +1092,10 @@ const {
|
|
|
formatActivityTime, activityStatusOf, buildActivityFeed, diffActivityIds
|
|
formatActivityTime, activityStatusOf, buildActivityFeed, diffActivityIds
|
|
|
} = utilsLogged;
|
|
} = utilsLogged;
|
|
|
// const 常量落在 vm 词法作用域、不会成为上下文属性,必须用 utilConst 取(同 STAGNANT_DEFAULT_DAYS / ALERT_TOP_LIMIT)。
|
|
// 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 小时,
|
|
// 超时口径必须与待办条(overdueInbound/overdueOutbound/overdueApproval)同源 24 小时,
|
|
|
// 否则同一屏上「待入库单超时」与「入库流水超时」会用两个阈值各说一套。
|
|
// 否则同一屏上「待入库单超时」与「入库流水超时」会用两个阈值各说一套。
|
|
|
assert.equal(utilConst('ACTIVITY_OVERDUE_HOURS'), 24, '待* 超时阈值必须与待办条同口径 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: 9 }), '状态待核实/neutral', '未识别盘点 status 必须回落 neutral,绝不猜成某个已知状态');
|
|
|
assert.equal(activityStatus({ activityType: 'inventory', status: null }), '状态待核实/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 而不是先到者。
|
|
// 重复的两条刻意把「旧的一条排在前面」,用来证明去重认的是 operateTime 而不是先到者。
|
|
|
const activityFeedRows = [
|
|
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: '一号库' },
|
|
{ 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] || {};
|
|
const activityById = (feed, id) => feed.items.filter((item) => item.id === id)[0] || {};
|
|
|
assert.equal(activityFeed.total, 8, 'total 必须是入参条数 8(含重复),用于核对后端到底回了几行');
|
|
assert.equal(activityFeed.total, 8, 'total 必须是入参条数 8(含重复),用于核对后端到底回了几行');
|
|
|
assert.equal(activityFeed.deduped, 1, 'deduped 必须记 1 条被去掉的重复单据');
|
|
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 次,否则同一张单会被看两遍');
|
|
assert.equal(activityFeed.items.filter((item) => item.orderId === 'O6').length, 1, '同一 orderId 在卡片上只能出现 1 次,否则同一张单会被看两遍');
|
|
|
// 盘点动作文案:以「盘点」开头 + 带库区 + **绝不出现「项」**。
|
|
// 盘点动作文案:以「盘点」开头 + 带库区 + **绝不出现「项」**。
|
|
|
// 后端盘点行的 itemCount 是占位常量 1(WmsHomeMapper.xml 盘点分支 CAST 成 1),拼成「盘点 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.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 必须完全一致');
|
|
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:首屏不整屏高亮、只标新增、同批二次为空 ——
|
|
// —— (6) diffActivityIds:首屏不整屏高亮、只标新增、同批二次为空 ——
|
|
|
// prev 为空=首次加载:返回空数组,否则首屏 5 行全部高亮,等于什么都没强调,只是让卡片闪一下。
|
|
// prev 为空=首次加载:返回空数组,否则首屏 5 行全部高亮,等于什么都没强调,只是让卡片闪一下。
|
|
|
assert.equal(diffActivityIds([], [{ id: 'n1', orderId: 'N1' }]).length, 0, '首次加载(prev 为空)必须返回空数组,首屏不得整屏高亮');
|
|
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;
|
|
const activityScript = activitySfc.script.content;
|
|
|
assert.match(activityScript, /setTimeout\(\(\) => \{[\s\S]{0,200}?\}, 3000\)/, '新增事件高亮必须是 3000ms 定时器(与 scss 的 3s 渐隐动画同长)');
|
|
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 秒后往已销毁实例写响应式数据)');
|
|
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 stripCodeComments = (source) => source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/[^\n]*/g, '$1');
|
|
|
const activityOverviewCode = stripCodeComments(overviewSource);
|
|
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(activityOverviewCode, /class="feed-item"/, '剥注释后仍必须能读到 feed-item 模板(否则滚动守卫空转)');
|
|
|
assert.match(activityThemeCode, /\.feed-status\.done\s*\{/, '剥注释后仍必须能读到 .feed-status.done 规则(否则滚动守卫空转)');
|
|
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 渐隐关键帧 ——
|
|
// —— (9) 样式契约:五条 tone 规则 + is-new 渐隐关键帧 ——
|
|
|
for (const activityTone of ['done', 'waiting', 'doing', 'danger', 'neutral']) {
|
|
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, /\.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 引用不存在的动画,高亮静默失效)');
|
|
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 () => {
|
|
(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); } } };
|
|
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); } } };
|