E04 修到零被拒线,harness 补七刀:跨进程租约与广播桥、原子写、引用墙、对话区按序号排

活动侧(E04 2.1.0 → 2.1.9,I01 1.2.2):
- 覆盖闭合成为机检:基座新增 distinct 读数,「计划盖住的客户数 = 候选行数」钉进
  S3 收步 / S4 哨兵 / 放行 L2;人加的候选客户不再被整单无视
- 「关键人待识别」占位句式全链退役:查无联系人先发数据录入卡收人;契约新增 refersTo,
  计划/回执的 contact_code 只许引用真实存在的联系人(安装期核引用目标)
- 台账更新确认摆全落库面:客户档案/联系人档案两张落库预览(touched: 数据源,
  正式现值 + 草稿叠加),可补改、可加行(自增主键由基座续号);姓名升必填
- 更新明细:update_key 位置键 + 「同一处只留一条」L2;依据写人话不带机器键;
  标题旁不摆单号;判据与文案不夹字段名;行标识去掉单标识那一段
- 回执骨架 = 计划行数钉进 S3 收步与 S4 哨兵;重做分支不许删计划凑数
- 阶段刻度对齐文档 7 步;起单样例预填满

基座侧:
- 两个后端连同一个库:task-claim 跨进程租约(迁移 0030)+ Postgres LISTEN/NOTIFY
  广播桥;对话区按任务内记忆序号排,不按墙上时钟;并卡「刚说过话」按记忆序列判紧邻
- 多行 write 整批先验后写(dryRun),被拒 = 一行都没落
- 决策卡意见与本单草稿字面比对,归属以观察进轨迹(note-anchors)
- 括号栈补「补闭括号」两形(少一个 } / 行对象没关直接跟下一行)
- 件上加行:空着的自增主键直进续号,不从别的行借号;未落下的行点名回给前端
- 人答复落库那一刻就把 runtime 翻 running(task.wake),两块同帧变脸
- 试跑单可落真库(land_master,迁移 0031,默认开);数据域按活动分组;
  JSON 列不再是 [object Object];按钮键感 + 在办进度条 + 防抖
- 报价链 A1–A7 从系统卸载(只卸不删源码),种子只装 E04/I01

契约变更(api-report 已刷新):FieldDeclaration.distinct / refersTo,
objectDeclaration.file,landMaster,unkeyed,assetFiles,ledgerByActivityRoute。
1700 测 / typecheck / lint / depcruise / api:check 绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX
This commit is contained in:
xcs
2026-08-25 01:23:30 +08:00
co-authored by Claude Fable 5
parent 92dd729c36
commit f3397a60ef
91 changed files with 3919 additions and 350 deletions
+72
View File
@@ -0,0 +1,72 @@
/**
* 会去请求服务端的那种按钮 —— 三面共用(2026-08-24 用户:「点击了都不知道点没点上」)。
*
* 一枚按钮按下去之后,人要在**三个时刻**都看得见东西:
* · **按下那一刻** —— 键帽下沉(`:active`,纯 CSS,见 `styles/press.css`),证明这一下点着了;
* · **在办事的这一段** —— `aria-busy` 亮着,按钮脚下走一道不定长进度条,鼠标也进不来
* (`pointer-events: none`)。这一段从前是**完全静默**的:屏上什么都没变,人只好再点一次;
* · **办完那一刻** —— 条收掉,按钮恢复可按。
*
* 为什么用 `aria-disabled` + `pointer-events: none`,不用原生 `disabled`:
* `disabled` 会把按钮画成灰的 —— 那是「这件事现在做不了」,而它此刻正在**做**。
* 界面不撒谎:在办事就画成在办事,别画成不可用。真正做不了的照旧给 `disabled`。
*
* 在办的判断有两条路,谁先来算谁:
* · `busy`(常用)—— 把 react-query 的 `isPending` 递进来;
* · `onClick` 返回了 Promise —— 自己盯着它落地。
* 两条路之外还有唯一通道上的去重闸(`typed-fetch`),那是**最后一道**:
* 就算这里漏了,同一笔请求也不会真的发两遍。
*/
import { useCallback, useEffect, useRef, useState, type ButtonHTMLAttributes, type MouseEvent, type ReactNode } from 'react';
type BtnProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> & {
/** 在办事(通常是 `mutation.isPending`) */
busy?: boolean | undefined;
/** 返回 Promise 的话,不必再给 `busy` —— 落地之前一直算在办 */
onClick?: ((e: MouseEvent<HTMLButtonElement>) => unknown) | undefined;
children?: ReactNode;
};
function isThenable(v: unknown): v is Promise<unknown> {
return typeof v === 'object' && v !== null && typeof (v as { then?: unknown }).then === 'function';
}
export function Btn({ busy, onClick, disabled, type = 'button', ...rest }: BtnProps) {
const [awaiting, setAwaiting] = useState(false);
const alive = useRef(true);
// 上来先把旗子插回去 —— StrictMode 开发下 effect 走「挂载 → 拆卸 → 再挂载」,
// 只在拆卸时落旗的话第二次挂载后它永远是 false,靠 Promise 收尾的按钮会一直亮着「在办事」。
useEffect(() => {
alive.current = true;
return () => {
alive.current = false;
};
}, []);
const pending = busy === true || awaiting;
const fire = useCallback(
(e: MouseEvent<HTMLButtonElement>) => {
// 在办事的时候再点一下:什么也不做(不是拒绝,是这一下本来就是余震)
if (pending || disabled === true || onClick === undefined) return;
const r = onClick(e);
if (!isThenable(r)) return;
setAwaiting(true);
const settle = (): void => {
if (alive.current) setAwaiting(false);
};
r.then(settle, settle);
},
[pending, disabled, onClick],
);
return (
<button
{...rest}
type={type}
disabled={disabled === true}
{...(pending ? { 'aria-busy': true, 'aria-disabled': true } : {})}
onClick={fire}
/>
);
}