xiaotutongxue

lovife/xiaotutongxue

Fork 0

Commit Graph

Author	SHA1	Message	Date
lovife	db6a51d617	docs: 清掉三处"会静默过期"的小账 + check-test-profile 加固（F-98）一、附录 A 从"手抄表"改成"可再生成的命令" check-api-parity.py 加 --extra，现算"代码有、契约 §4 没有"的接口 = 41 个（旧手抄表写 83/62/21，已差近一倍，而且没人会记得回来改它）。并按"谁去改什么"分六类 —— 只有 E 类（8 个）要客户定口径，其余是文档侧补记。二、F-6 已修：frontend-pc 的 Mock 说明 AGENTS.md 那句改正之外，连带修了 .agents/skills/project-api/SKILL.md —— 它整篇仍以 vite-plugin-mock / mock/** 为主线，而该项目里 mock/ 目录与插件都已删除。只改指路牌、不改路的尽头，等于没改。三、docs/03 两处文档内部口径冲突加 ⚠️ 注（不改口径，只把冲突摆明） §2 notifyBizType 的 5/6 与 §13.5、落库值不一致 → 实现以 §13.5 为准（催报去重按 5）； §3.6/§9.5 的 collect_file.source 字段表（入口来源）与建表注释（谁传的）冲突 → 实现以建表口径为准。两处都写明"待客户确认"，见 F-30 / F-38 / F-39。四、check-test-profile.py 加固（新增 F-98） · 子进程输出落盘（不再用没人读的 PIPE）：失败时能看见"停在哪一行"，成功时打出启动用时（基线 ~10 秒 / 72 行 / 9.5KB）； · 开跑前按 jar + profile 清残留 JVM，且保留 dev 后端（E2E 正打着它）； · 等待期间每 15 秒报一次进度，卡住时不留沉默。教训：随机端口这个防撞设计把残留 JVM 藏起来了 —— 撞不到端口就永远发现不了，于是表现成"时好时坏"，而失败时连日志都读不到。验证：python scripts/verify-all.py --with-e2e → 通过 8 / 失败 0 / 跳过 0 （E2E 36 脚本 / 1548 断言 / 278s；prodguard 9/9；test profile 能起） python scripts/verify-docs.py → 22 项全部通过	2026-09-30 09:10:34 +08:00
lovife	30c3714d35	test(scripts): 36 个 E2E 与 6 个机械校验工具（1548 条断言）+ 一键交付自检新增：check-api-parity（契约 121 接口 ↔ 控制器，自带「必须恰好 121」自检）、 check-entity-columns（基类要求的列 vs 迁移建表列，F-35 那个坑踩了四次之后上的工具）、 check-manual（手册引用的错误码与提示文案对得上代码）、check-test-profile（test profile 真起一次）、 e2e-prodguard、load-test（四场景、按端点分别统计）、verify-all（一条命令跑完交付自检）、 dev-seed-audit（界面验收用的演示数据），以及 M1~M9 各轮 E2E。压测抓到一个真缺陷并修掉（F-92）：门禁 IP 限流原来计「所有请求」，于是一个班连同一个 WiFi 时 60 个不同学生同时核验只过了 20 个 → 改为只计失败 + 单独的成功上限，20/60 → 60/60。度量工具的偏差会伪装成产品缺陷（F-60/F-77/F-97），所以每个脚本都断言「动作自己的结论字段」（submitted / created / canExport），而不是 HTTP 200 + code 0。验证：verify-all.py --quick 5/5；--with-e2e 见 docs/09 §8。	2026-09-30 09:02:57 +08:00

Author

SHA1

Message

Date

lovife

db6a51d617

docs: 清掉三处"会静默过期"的小账 + check-test-profile 加固（F-98）

一、附录 A 从"手抄表"改成"可再生成的命令"
   check-api-parity.py 加 --extra，现算"代码有、契约 §4 没有"的接口 = 41 个
   （旧手抄表写 83/62/21，已差近一倍，而且没人会记得回来改它）。
   并按"谁去改什么"分六类 —— 只有 E 类（8 个）要客户定口径，其余是文档侧补记。

二、F-6 已修：frontend-pc 的 Mock 说明
   AGENTS.md 那句改正之外，连带修了 .agents/skills/project-api/SKILL.md ——
   它整篇仍以 vite-plugin-mock / mock/** 为主线，而该项目里 mock/ 目录与插件都已删除。
   只改指路牌、不改路的尽头，等于没改。

三、docs/03 两处文档内部口径冲突加 ⚠️ 注（不改口径，只把冲突摆明）
   §2 notifyBizType 的 5/6 与 §13.5、落库值不一致 → 实现以 §13.5 为准（催报去重按 5）；
   §3.6/§9.5 的 collect_file.source 字段表（入口来源）与建表注释（谁传的）冲突 →
   实现以建表口径为准。两处都写明"待客户确认"，见 F-30 / F-38 / F-39。

四、check-test-profile.py 加固（新增 F-98）
   · 子进程输出落盘（不再用没人读的 PIPE）：失败时能看见"停在哪一行"，
     成功时打出启动用时（基线 ~10 秒 / 72 行 / 9.5KB）；
   · 开跑前按 jar + profile 清残留 JVM，且保留 dev 后端（E2E 正打着它）；
   · 等待期间每 15 秒报一次进度，卡住时不留沉默。
   教训：随机端口这个防撞设计把残留 JVM 藏起来了 —— 撞不到端口就永远发现不了，
   于是表现成"时好时坏"，而失败时连日志都读不到。

验证：python scripts/verify-all.py --with-e2e → 通过 8 / 失败 0 / 跳过 0
      （E2E 36 脚本 / 1548 断言 / 278s；prodguard 9/9；test profile 能起）
      python scripts/verify-docs.py → 22 项全部通过

2026-09-30 09:10:34 +08:00

lovife

30c3714d35

test(scripts): 36 个 E2E 与 6 个机械校验工具（1548 条断言）+ 一键交付自检

新增：check-api-parity（契约 121 接口 ↔ 控制器，自带「必须恰好 121」自检）、
check-entity-columns（基类要求的列 vs 迁移建表列，F-35 那个坑踩了四次之后上的工具）、
check-manual（手册引用的错误码与提示文案对得上代码）、check-test-profile（test profile 真起一次）、
e2e-prodguard、load-test（四场景、按端点分别统计）、verify-all（一条命令跑完交付自检）、
dev-seed-audit（界面验收用的演示数据），以及 M1~M9 各轮 E2E。

压测抓到一个真缺陷并修掉（F-92）：门禁 IP 限流原来计「所有请求」，于是一个班连同一个
WiFi 时 60 个不同学生同时核验只过了 20 个 → 改为只计失败 + 单独的成功上限，20/60 → 60/60。

度量工具的偏差会伪装成产品缺陷（F-60/F-77/F-97），所以每个脚本都断言「动作自己的结论字段」
（submitted / created / canExport），而不是 HTTP 200 + code 0。

验证：verify-all.py --quick 5/5；--with-e2e 见 docs/09 §8。

2026-09-30 09:02:57 +08:00

2 Commits