Jyotisha/docs/tasks/PROGRESS-people-archive-p1-fix-20260925.md

PROGRESS · 人物档案 P0/P1 修复（2026-09-25）

最终整合复验补记

Linux Node22.23.2 / PostgreSQL17 的 final-r4b：全量 3894/3894、DB 64/64，fail/skip/cancel/todo 均0；tsc/lint/build各exit0，lint0error/127既有warning，首页Static。相对开工基线3863/61，顶层及嵌套名称多重集合均无删除、新增失败0。三种首页gzip变化为完整资源+0.1612%、入口增量−0.4536%、专属JS−0.7984%。日志、快照hash、四项修复三栏及验证环境失败保留在 PROGRESS-three-fixes-integration-20260925.md final-r4b节。

以下执行期记录保留作历史；旧面板在整合树保留，不能将本单执行树的删除写成已交付。Python/隐私及最终边界核查另行补记；受控真人、迁移上线和health仍待验，未据自动化绿提前resolved。

基线与门禁

• 开发树：codex/people-archive-p1-fix-20260925，实际开工基线 48fe4daf519dab2a5c6bf4b01dd513067de1647b（任务书之后的新 staging）。不改其它分支、workflow、DNS；未提交、未推送。
• 必须用 Node 22 跑全量测试，并和开工时的基线逐条对比，新增失败为 0 才能推；改任何断言都要写三栏。
• 协调方 Linux Node22 基线：前端 3863/3863、fail0、skip0；数据库 61/61；tsc exit0。旧 Node20 的失败不作为本轮豁免。
• 当前仅本地定向证据：Node v22.23.2，首轮组合 70/70，provider/report/cache 39/39；tsc exit0；前端修改区域 lint 0 error（既有 warning 未顺手修改）；根 Python 三个相关合同 21/21。新增星历用例、Linux全量与DB快照审查仍进行中，完成后由协调方补确数。

实现清单

任务	实现	验收状态
T1 worker	持久化 chartProfileId 经 loadSubjectBirth；他人从 typed columns 读取；候选范围仅本人；人物缺失/外属终止且走既有退款	fake-engine ready 与删除/外属失败退点定向通过；真实模型/线上待验
T2 OR is	复用 unary IS 编译器，支持 null/true/false，不当作字符串或 =null	单测通过；真实 sessions GET + PG 在新增 DB 用例中
T3 时序	同步 last-account 预读仅作暂存选择；账户/目录校验 ready 闸门挡 chart/report/ephemeris/newChat；provider先账户再目录再session	跨账户/目录事件单测通过，受控浏览器待验
T4 消息	metadata merge 保留 hydrated 消息、深链及分页外行；人物不变不广播subject；视图按当前人物过滤，跨账户清除旧数据	纯函数与provider合同通过，生命周期独立审查中
T5 纠偏	新迁移降级旧JSON accepted/confirmed、清active tuple；不改旧迁移、不改profiles；目录失效刷新；未知用量拒绝删除；daily按所选资料；合盘新对话显式self且不改全局；星历暖缓存/首败重试	定向通过；迁移与真机待独立验
T6 清理	有界 ids 预检替代count/head；同账户事务锁确保4人上限；无效UUID 404；report双字段冲突400并规范化持久化；删除死面板、合同改锁/people；编辑标题纠正	DB并发用例新增，所有既有测试名保留
T7 记录	BUG1031/1032，关联1030/990/1024；本记录、设计、changelog、真人清单	BUG状态保持 investigating，未部署

数据边界与设计说明

• 检查迁移：personal_reports.chart_profile_id 为 nullable uuid，无指向 chart_profiles 的 FK；不存在 ON DELETE SET NULL 把他人改成本人的窗口。独立真实DB进一步确认：删除RPC级联删报告/job后，worker不会再看到缺失人物，单靠worker失败退款不足。 新 20260925040000_deleted_report_release.sql 在删除事务内以受限definer触发器复用release_usage，未交付预留退款；ready不退，已completed不退，已released幂等。删除RPC显式校验auth.uid/所有权并按job→report锁序避免running worker完成时死锁。未改旧迁移、未开放通用退款权限。
• 新纠偏迁移在独占表锁事务中临时停用 birth guard，清理完立即恢复。旧JSON保留作兼容，不再赋予校正权威。profiles不写入。
• 人数上限使用 owner 派生的事务 advisory lock 后再独立 count，两个连接争抢第四/第五个名额；预检只改善错误反馈，DB为最终权威。
• Provider内部保留同账户会话，以免深链/消息丢失；可见侧栏按当前人物过滤，不展示对方列表。不同账户不能合并。
• Home未新增useState/useRef。Part B为纯编码豁免。Skill版本不bump。

fabe0114 追溯三栏（完整覆盖11个文件、12个修改位置）

文件/断言	原值	新值	原因
chart-page-view / provider URL	sessions仅limit	limit+subject	历史按当前人物；本轮进一步用bind后捕获subjectId
chart-view-route / birth reader	ACCOUNT_BIRTH_SELECT直读	loadSubjectBirth且拒clientBirth/body.profile	唯一服务端人物解析入口
consultation-entrypoint / disabled	产品/加载/变更3条件	加 !rectificationForSelf	校正仅支持本人
database-admin-account-reset / fixture	role=self	role=other	本人镜像停写，仍覆盖重置他人档案
home-bootstrap-reveal / guards源	只page	page+binder，数量仍2	今日星语移到独立组件，并未减少等待约束
personal-report-api / birth	from(profiles)	loadSubjectBirth	报告取当前人物资料
personal-report-api / GET签名	GET()	GET(request: Request)	支持subject查询参数
report-row-delete / fetch匹配	url==/api/reports	startsWith(/api/reports)	允许subject查询，旧响应复活测试仍保留
secondary-page-entry / state初始化	viewFromSnapshot(peekChartPage())	viewMatchingSubject(subjectId)	防暖缓存显示错人
server-owned-birth-profile / synastry	select ACCOUNT_BIRTH_SELECT	loadSubjectBirth	本人与对方共用权威解析器
session-list-provider / URL	sessions仅limit	limit+subject	当时调用readCurrentSubjectId；本轮进一步bind后捕获subjectId
settings-mvp-contract /菜单	span星盘资料	/people星盘档案并禁止旧span	独立档案页替代已退役对话框

本轮既有断言三栏

范围	原值	新值	原因
adopted-birth-date	死面板 record.profile有效日期	/people selected.profile有效日期	保留日期正确性，转锁实际入口
chart-library-other-profile：保存资格	nextProfile	draft+保存中守卫	新人物页独立保存不依赖户主校正
同文件：保存/删除失败与成功刷新	旧helper调用、云成功文案、deleteOtherChart catch	人物页POST/PUT/DELETE、失败早返、invalidate+load	不再测试不可达代码；失败不得本地伪成功
同文件：添加后合盘	选关系提示/用于合盘按钮	显式和我合盘、保存不触发合盘	保留显式操作语义；无人物关系字段
同文件：pending	死按钮disabled/spinner	hook重入守卫、finally复位和既有通知	真实入口仍不可重入
同文件：列表	ChartLibraryView/list返回片段/添加其他人	editing=false、列表无form、条件ChartProfileForm、添加一个人	名称不删除，锁替代UI
同文件：本人删除/合盘	selfView无删除、死面板历史	本人不能删、self新对话、绑定删除确认id	真实详情操作边界
settings-mvp-contract：编辑	旧本人saveProfile+otherSave	账户readProfile+other独立saveOther	移除死入口，不伪造当前不存在的本人编辑
chart-page-view + session-list-provider URL	调用时readCurrentSubjectId	bind后捕获subjectId	账户与目录闸门先于请求
session-list-provider 401	并行 OR状态检查	先account401，再sessions401	防跨账户预读先发请求；仍各自清理
home-surface、3个Python surface集合	chart-library-panel路径	people/people-page路径	扩散半径同时检索tests/与frontend/；保留测试名
test_supabase_user_data_contract	死样式synastry-report-card/history、旧添加/用于合盘	people-detail/pendingDelete、添加一个人/和我合盘	旧无入口面板退役，重定向合同不删除测试
ephemeris生命周期、report-row-delete fixture	默认无需绑定	显式虚构account已bind	新ready门要求，原行为断言不弱化
personal-report-worker harness	loadProfile只收userId	收userId+subjectId，可注入真实resolver	既有断言不变，扩展P0成功/失败路径

最终对比方法（待协调方冻结后执行）

node -v
npm test > final-tests.log 2>&1
npm run test:db > final-db.log 2>&1
./node_modules/.bin/tsc --noEmit
npm run lint
# 基线和最终日志分别提取完整TAP名称，使用集合差：基线名称 - 最终名称必须空；
# not ok 名单逐条比较：当前Node22基线空，因此最终必须空。

必须记录实际Linux日志路径、失败名称差集、消失名称差集、build Static及gzip；当前不宣称这几项完成。没有受控账号，不借用凭据，真人清单待产品负责人执行。

独立审查闭环与冻结（2026-09-25）

• 修复self worker metadata投影遗漏：唯一出生解析不变，仅self额外读取rectification_case_id；他人不读profiles，候选窗仍self专用。永久worker测试按真实select投影，防mock整行掩盖漏列。
• report subjectId别名与chartProfileId同传先判冲突，移除别名再入原strict schema，不放宽schema。永久测试覆盖别名单传、两者同值成功、冲突拒绝和未知字段仍拒绝。
• 标准?new=1两个bootstrap新建分支改用已绑定当前人物；合盘特殊self独立，不改变全局人物。永久bootstrap行为测试覆盖。
• A人物分页晚回不得覆盖B cursor，scope+generation同时守卫提交/错误/finally；永久React hook测试重放原竞态。
• provider用稳定初始ready避免重复bootstrap，但提供waitUntilReady等待当前reload代；Home调用当前gate。非401目录失败作为可恢复错误，不假登出。永久provider+bootstrap行为测试分别覆盖reload等待和目录503。
• reports/ephemeris共享cache按account+subject隔离，过期异步结果拒写；页面同scope拒晚响应。常规登出是硬导航，跨账号函数级探针不夸大为普通用户路径P0。
• people-refund-r4独立真实PG矩阵六场景通过：queued、running、completed、already-released、ready待结算、running完成与删除双连接并发。原失败探针/修复后探针均保留在协调方忽略artifacts，不提交。
• 本地Node22.23.2最终生产冻结点：tsc exit0；完整lint 0 error / 127 warnings（未顺手修无关warning）；54/54 review定向、fail0；先前辅助5文件51项定向通过。日志本机临时目录people-tsc8.txt、people-lint-final3.txt、people-review-regressions6.txt。不同组合可能重叠，不把它们相加伪称全量。
• Linux中间r1标准DB63/63、全量3868中35fail；后续定向已修各失败组，但中间快照不是最终验收。冻结已通知协调方，下一次直接整合最终Linux全量和永久DB测试。未经最终fail0/名称多重集合差为空不得推。
• 新永久DB退款用例覆盖真实authenticated删除，不再只mock人物null；ready fixture遵循report_document/完成时间/hash CHECK。双连接独立验证已过，最终标准suite待协调方。

独立审查后既有测试三栏补充

文件/范围	原值	新值	原因
chart-page-hook fixture	cache reset后直接挂载	reset后绑定明确虚构账户/空others	新目录ready闸门；原17个超时、401、429、重试和缓存断言不改
report-polling-contract / loadReports取消防线	assert.match(centerSource, /if \(cancelled\.current\) return;/)	assert.equal((centerSource.match(/if \(cancelled\.current || requestedSubject !== readCurrentSubjectScope\(\)\) return;/g) ?? []).length, 2)	成功和异常两分支均在取消或账户/人物scope变化时拒绝提交；检查两处防线，未放宽取消/轮询频率合同。原台账误写ready依赖迁移，现按HEAD实际diff更正
composer-isolation 两否定断言取样	homeSurface混入独立人物表单draft	Home+聊天相关hooks集合	独立编辑draft不是Home根聊天draft；无根useState/value断言不变
daily-starlanguage effect切片	旧guard/旧deps锚点	useEffect起点/含subjectReady的新deps	新ready/profile guard与cleanup；1次重试、清timer、cache指纹断言保留并增强当前人物来源
session-list-lifecycle fetch fixture	只account/sessions，无目录隔离	chart-profiles合法响应，挂载/卸载reset目录	真走新加载链，不预设ready；StrictMode/401/不稳定callbacks收敛断言不改
session-list-provider bootstrap合同	await deps.sessionListReady	await (deps.waitForSessionList?.() ?? deps.sessionListReady)且Home传函数	初始promise已resolve不能代表人物切换reload就绪；永久行为测试同时锁住

新测试编写时的修正不伪装旧基线变更：首次新bootstrap成功测试误以为hydrated=true，按既有正常两阶段揭幕模型改锁phase=prepare+正确account；新pagination探针去掉any并指定hook类型；新增DB ready fixture补齐既有CHECK，均非放宽既有断言。

交付文件边界

交付包含本树tracked修改/删除、3个新增lib（worker-subject、report-subject-request、subject-session-merge）、两份新迁移、两份新people测试、进度及委托补齐docs。所有artifacts/*复现脚本/日志和frontend/node_modulesjunction不进提交。无commit/push、无真实账号凭据、无生产变更。