Commit Graph
86 Commits
Author SHA1 Message Date
admin 9b90bc2010 docs(log): 记 v0.5.0 实施与技能仓路径重映射 2026-11-04 23:00:49 +08:00
admin 509c6b1d1f feat(db): v0.5.0 业务库操作收进同一个 Db —— query_json_raw / query_rows / lock_owned
- Db::query_json_raw:持 Db.lock、row_to_json 包裹、不做 JSON 键归一(给自带归一语义的厚业务仓)
- Db::query_rows:持锁返回原始 pglite::Row(pg_catalog 元数据 / 取首行首列)
- Db::lock_owned():与所有 Db::* / DbTransaction 共用同一把锁,guard 内可用裸句柄跑自有 SQL
- query_json_inner 拆出共用段 query_json_inner_raw ⇒ SQL 包裹只有一份,query_json* 行为未改
- 闸门 AR20(raw 不归一 / 共用段 / 8 个公开入口全持锁)+ 反自证 14 → 15 项
- 探针 db_raw_it(4 条):raw 不归一 · 归一路径同时成立 · guard 期间 Db::exec 被阻塞 · query_rows 读 pg_catalog
- 销掉 known-limitations 的「双锁」条;CHANGELOG / README 版本表升 0.5.0
- 验收:653 passed / 0 failed;verify.sh --smoke 14/14;check-arch 25/25 自证 15/15
v0.5.0
2026-11-04 22:54:35 +08:00
admin 18a6586c1d docs(handoff): 澄清 tag 与 main 的关系(tag 固定 ff34ca5,main 可有后置纯文档提交) 2026-11-04 22:36:54 +08:00
admin db3f891f7a docs(log): 记 v0.4.0 口径修正与技能仓第二批完成 2026-11-04 22:36:44 +08:00
admin 060e6eb755 docs(req): 修正第三份需求的业务侧切换面(12 处写路径已收拢)
- 切换面从 5 个函数改为 6 个:新增 platform::db::exec_params
- 业务层原有 12 处裸 state.db.query 已全部收拢,护栏 check-db-access.sh 跑绿
- 同步 v0.4.0 tag 已重打到 ff34ca5 的事实,删掉过时的未提交改动说明
2026-11-04 22:22:18 +08:00
admin ff34ca50c1 docs(handoff): 记发布口径修正与新需求入库 v0.4.0 2026-11-04 22:14:56 +08:00
admin 3b6750d3ec docs(req): 收入第三份业务仓需求(DB 访问收口,目标 v0.5.0,待实现) 2026-11-04 22:14:43 +08:00
admin 62fceee074 chore(release): 门面 sspf cargo 版本对齐 0.4.0(tag 与 crate 版本一致) 2026-11-04 22:14:43 +08:00
admin 225b83891f docs: 清理批次按 v0.4.0 已发布口径同步 CHANGELOG / README / HANDOFF 2026-11-04 22:00:24 +08:00
admin ecb77b230f 平台包零业务:示例移到技能仓、解绑 example-packs、闸门全部改防回流
- 物理移出 packs/{asset,books,demo,shop}、modules/ 四个面 A 适配器、纯技能副本、
  纯业务测试 crud_it.rs 与 new-pack 脚手架(v0.3.0 tag 完整保留旧形态)。
- 删 example-packs feature / example_packs() / sspf-pack-* 依赖 / packs/* member;
  packs_gen.rs 与 modules/mod.rs 生成段降级为恒空的注入点,装配链一条不删;
  pack-sync.py 把「零包」钉成合法目标态。
- 尺子不再「跳过」:CP1 防回流清单、check-module 三条、AR2/PACK1 正向断言、
  AR17 升级为零业务依赖判据(含注入式反自证)、契约反自证换平台锚点、FACE 零包重算。
- 面 A 冒烟 43→21 条(17 条平台权限闭环 + 4 条业务端点 404);pack_smoke_it 改
  运行时防回流探针;auth/db/batch7/permission/seed/routes 单测换平台内置夹具。
- 契约 [MENU_TREE] 收成 5 条系统菜单、[RULER] 改 21/3;README/CLAUDE/HANDOFF/
  CHANGELOG/contract §5.1/schema.sql/db.rs 注释同步。

验收:cargo test --workspace --no-fail-fast 649 passed / 0 failed / 6 ignored;
verify.sh --smoke 14/14;check-arch 24/24 + 反自证 14/14;
cargo tree -p sspf 无 sspf-pack-*。前端 src/frontend 按要求保留。
2026-11-04 21:54:22 +08:00
admin ca8abf9cc9 docs: v0.3.0 发布口径同步 —— 决策 D 变更为直接推送
- 需求稿 §7.4/§7.5/§11.1/§11.4/§11.6 改按已发布口径,补仓外 tag 探针实测
- HANDOFF 0-bis 同步发布范围;工作日志记离线模式无法 checkout file:// git 依赖
v0.3.0
2026-11-04 18:27:56 +08:00
admin 6d6e0ee329 feat(platform): 标准平台包 v0.3.0 —— 业务自带状态的可组合装配
- Db 暴露同一个 Arc<PGlite>(Db::pg());Platform 两阶段装配 Assembled/Finish
- Extras 加自带状态路由 / 可替换兜底 / 全局层,with_state 前移;默认路径行为不变
- 新增探针 business_composition_it 与闸门 AR19(反自证 14/14)
- 文档:CHANGELOG / known-limitations / 需求稿实施记录与勘误
2026-11-04 18:20:03 +08:00
admin 2b4f4d15b4 docs: 记录 v0.2.0 已发布 + git tag 依赖实测通过(需求 §6 的 ⚠️ 消) 2026-11-04 16:49:09 +08:00
admin 3d3fd69c1d docs(memory): 记录标准平台包 P0(门面 sspf / 示例包选装 / AR17·AR18)与两个静默坑 2026-11-04 16:40:01 +08:00
admin 9083394b8a feat(platform): 标准平台包 v0.2.0 —— 门面 crate sspf + 示例包选装
- 新增 crates/sspf(0.2.0):Platform builder(packs/ddl/menus/router/static_dir/on_ready)
  + build_app/serve/serve_mcp;契约与运行时类型原样重导出(业务仓不碰 19 个 sspf-*)
- 内核 4 个示例包降为 example-packs feature(依赖 optional + 生成段 [features]);
  packs_gen.rs / modules/mod.rs 改为 feature/not-feature 两份同名定义(整段 cfg 会让
  all_specs() 在默认 feature 下不存在)
- 七步启动迁入门面;平台表清单 / 白名单对账落在内核 boot.rs;sspf-admin 1111 → 381 行
- routes::build_app_with(state, extras) + bootstrap::{ensure_base_with, ensure_schema_all_with},
  旧签名保留 ⇒ 既有 704 个测试零改动;静态 SPA 托管手写在 routes.rs(不引 tower-http)
- 新增探针 crates/tests/tests/external_consumer_it.rs;闸门 AR17/AR18(反自证 13/13)

影响:业务仓只依赖 sspf 即可起服务;默认依赖树无 sspf-pack-*;面 A/B 行为一字未改。
回归:710 passed / 0 failed;check-arch 29/29;perm-smoke 43、perm-smoke-jnpf 23、
lowcode/baseline/mcp-smoke 15/10/14 全绿;仓外探针 /api/health = {"ok":true,"tables":177}。
v0.2.0
2026-11-04 16:39:47 +08:00
admin acf076df5a refactor: 内核瘦身 —— 示例搬成业务包 + 装配/测试各归其位
- 内核只有 lib:启动装配 → crates/sspf-admin(bin sspf-admin);37 个集成测试 → crates/tests(package sspf-tests)。
- demo/shop/books 的 spec/菜单/DDL/面 B 路由搬进 packs/{demo,shop,books};内核 modules/*.rs 只剩「面 A 适配器 + pub use」⇒ 内核零业务知识,示例可整目录搬走。面 A 与前端零改动。
- 示例表 DDL 按平台规则补 f_tenant_id + 复合主键(spec 不加 ⇒ JSON 键与响应逐字不变)。
- 修 is_builtin_table 只认 schema.sql 的漏洞:包表(含 asset_data_resource)此前可被建模页删除/改;现为「平台 DDL ∪ 包表」。
- sspf-compat-online_dev → onlinedev(包名/模块/文件/路由别名同步);6 个 5 行转发壳合并为 forward.rs。
- 新增 AR16 闸门 + lib.rs「30 秒地图」+ src/backend/README.md;pack-sync 补两处判据(module_key=None 的 urlAddress、apiFile 查存在性)。
- 回归:704 tests / 6 道静态闸门全绿;health 181 表;四个包面 A/面 B 运行时全部 200。
2026-11-04 14:46:12 +08:00
admin 5c0935e874 docs(memory): 记录全局记忆补 dev-cache-layout 规范约定 + 纠正两处不准确说法 2026-11-04 09:41:02 +08:00
admin 1086495361 docs(memory): 记录 dev-cache-layout 技能 Rust 部分更新(含两处纠错) 2026-11-04 09:05:16 +08:00
admin a27389d0d0 docs: 补《编译膨胀问题及处理》—— target/ 58G 的根因、处置与规矩
新增 docs/build-bloat.md,记录 2026-11-03 这次磁盘膨胀的完整处置:

- 现象:target/ 58G(deps 45G + incremental 12G + release 820M),磁盘 87%
- 根因:cargo 默认传 -C incremental=…,而 sccache 遇 incremental 直接拒缓存
  (server 端日志 CannotCache(incremental))⇒ 8.4G 缓存全是废的,每轮从零重编
- 处置:根 Cargo.toml 加 [profile.dev] incremental = false + cargo clean
- 结果:58G → 1.2G;清空后重建 63s → 14.14s(缓存命中,命中率 86.71%);
  磁盘 87% → 75%(跑完测试后 76%)
- 定位方法论:发现 sccache 命中率异常时看 server 端日志
  (SCCACHE_LOG=debug + SCCACHE_ERROR_LOG),client 端统计只说「没命中」
- 区分表:哪些是编译中间产物(该清)、哪些不是(node_modules / pglite 数据,
  按既定约定不动)
- 沉淀 6 条规矩(清前 pgrep、用 cargo clean 而非 rm -rf、sccache 缓存不在项目内、
  改 profile 要重新体检 target 体积等)

索引同步:docs/README-project.md(链接区 + 目录树)、README.md(目录树)。

验证:check-citations 4/4、check-naming 3/0/1、check-arch 20/20、
check-boundary 12/12、check-contract 10/10、check-module 123/123 全绿。
2026-11-03 23:11:26 +08:00
admin efb4cd6500 docs(memory): 记录 target 清理与 sccache 空转根因 2026-11-03 22:57:36 +08:00
admin 827c054780 build: 关掉 dev 增量编译 —— 修 sccache 全程空转的根因,target 58G → 1.2G
现象:target/ 曾达 58G(debug/deps 45G + debug/incremental 12G),磁盘已用 87%;
而 ~/.cargo/config.toml 已配 rustc-wrapper = sccache、缓存实体 8.4G,
但 sccache --show-stats 的 Cache hits 恒为 0。

根因(实测定位):cargo 默认给 rustc 传 -C incremental=<target/debug/incremental>,
而 sccache 遇到 incremental 直接拒缓存 —— server 端日志明确报
`CannotCache(incremental)`。表现为 Non-cacheable calls 等于请求数、
Cache hits 恒为 0 ⇒ 8.4G 缓存全是废的,每轮构建都从零重编。

修法:根 Cargo.toml 加 [profile.dev] incremental = false。
- 收益:清空 target 后重建走缓存命中 —— 实测 14s(vs 全量 63s);
  日常改一处重编也走命中(命中率 86.71%)。
- 代价:失去 cargo 自己的增量加速,由 sccache 命中替代(且跨 cargo clean 仍有效)。
- 附带:target/debug/incremental 不再产生(实测残留为空目录 0B)。

验证:cargo build 全量通过;cargo test --workspace 695 passed / 0 failed / 2 ignored
(79 个二进制,与 M1 基线完全一致);check-arch 20/20、check-boundary 12/12、
check-contract 10/10、check-module 123/123、check-citations 4/4 全绿。
v0.1.8-target-cleanup
2026-11-03 22:57:26 +08:00
admin 867552af37 refactor(arch): M7 删 platform/ 转发壳 —— 壳层收口,平台能力只剩真源
- 删 src/backend/src/platform/ 下 38 个转发壳 ⇒ 平台层只有真源(在 crates/)
- 新增 src/backend/src/compat.rs 别名表(16 个域)⇒ routes.rs 的 1010 处
  compat::<域>:: 调用点零改动,风险面从 1010 处降到 1 个文件
- test_support.rs 从 platform/ 迁到壳侧根(依赖装配根 ensure_schema_all ⇒ 认识业务层)
- 全仓改写 import:crate::platform::X → sspf_core::X(44 处/9 文件);
  ssw_platform::platform::X → sspf_core::X(229 处/38 文件)
- 修 check-contract-scan.py 的 plat_key 推导:按 crate 名判定(原按路径段数猜,
  M7 拆 crate 后必然失效 ⇒ CC6 静默失效);新增 derive_plat_key + 20 条断言自证
- 新增 AR15 防旧平台路径复活(三层判据,含目录级「含 .rs 才算复活」)
- 闸门去壳路径:check-arch / check-boundary / check-module / check-contract-scan
- 文档同步:CRATES-MIGRATION / contract / HANDOFF / HOWTO_MODULE / CLAUDE.md

验证:cargo build 零警告;cargo test 695 passed / 0 failed(与 M1 基线一致);
check-arch 20/20;--self-test 10/10;check-boundary 12/12;check-contract 10/10
(反自证 12 例 + 20 条推导断言);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿。

至此 M1–M7 全部完成:crates/ 17 个包,src/backend/src/ 只剩装配 + 业务层。
v0.1.7-m7
2026-11-03 22:17:34 +08:00
admin 210a885f79 refactor(arch): M6 MCP 适配层下沉 —— 2 模块 / 3,283 行迁入 sspf-mcp-adapter
迁入 src/backend/src/mcp_{adapter,compat}.rs(3,283 行)到 crates/sspf-mcp-adapter/,
原路径变转发壳(pub use sspf_mcp_adapter::<mod>::*)⇒ --mcp 启动路径与集成测试零感知。

依赖(比计划瘦):sspf-mcp + sspf-core + 仅四个 compat 域包
(system/permission/workflow/online_dev)+ sspf-lowcode + sspf-lowcode-exec
+ axum + pglite-rs。原计划写「所有 compat 包」,实际 msg/ext/compat-core 不必依赖。

闸门:
- 新增 AR14(依赖白名单 + 源码不许 use sspf_pack_*),反自证 9/9
- CP1/CP2 纳入适配层真源 + 新增 CP1'' 扫描面反自证
- CP1 抓出 5 处既有业务标识符泄漏(hint 提示语与单测断言里)⇒ 已改通用形态
- 契约 [RULER] check-boundary.sh 由 11 改 12

验证:cargo build 零警告;cargo test 695/0;check-arch 19/19;
check-boundary 12/12;check-contract 10/10;check-module 123/123;
check-citations 4/4;verify.sh --smoke 14 步全绿(397.3s)
v0.1.6-m6
2026-11-03 21:13:22 +08:00
admin 98b93967da refactor(arch): M5 低代码执行层下沉 —— 4 模块 / 2,674 行迁入 sspf-lowcode-exec
把 src/backend/src/lowcode_{crud,ddl,check,seed}.rs 下沉到 crates/sspf-lowcode-exec/,
原路径全部变成 5 行转发壳 ⇒ CLI(--seed-lowcode-demo)与 MCP 适配器的调用路径零感知。

与 sspf-lowcode 的分工不变:前者纯计算(AR7 白名单不动),本 crate 是执行层
(连库 / 跑 SQL / 比对真实库列 / 事务 / 回写模型)。

依赖:sspf-lowcode + sspf-core + sspf-store + sspf-mcp + pglite-rs + chrono + serde_json
(比原计划多三个:pglite::ToSql/Error 是直接用的、now_iso() 用 chrono::Local::now()、JSON payload)

闸门改造:
- check-arch.sh 新增 AR13(两层:依赖白名单 + 源码不许 use sspf_pack_*)
- check-arch.sh 反自证 7→8(两处都注入:越界依赖 axum + 业务包引用,按路径分别验)
- check-boundary.sh 新增 LOWCODE_EXEC ⇒ CP1/CP2 纳入执行层真源
  (反向验证:插 LEAK_PROBE ⇒ CP1 报红;还原后 11/11)
- check-contract-scan.py 不用改 —— 契约里零 lowcode 端点(低代码是 MCP 工具不是 HTTP 路由)

🔴 踩坑:改写时把 use crate::lowcode_ddl; 一并改成 use crate::ddl; ⇒ 编译不过。
教训:搬 crate 只改跨 crate 的前缀(crate::platform:: → sspf_core::),
模块名一律不动;文档内链([`crate::lowcode_crud`])也不能跟着改(改了就变死链)。

数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 17/17;--self-test 8/8;check-boundary 11/11;check-contract 10/10;
check-module 123/123;check-citations 4/4;check-naming 3/0/1;
verify.sh --smoke 14 步全绿(377.6s)
v0.1.5-m5
2026-11-03 20:12:50 +08:00
admin e821770f58 refactor(arch): M4 契约面下沉 —— 14 模块 / ~49,000 行迁入 6 个 crate
把 src/backend/src/platform/compat/ 下的 14 个契约面模块拆进 6 个 crate,
原路径全部变成 5 行转发壳 ⇒ 上层 import 零感知,695 个测试一个没改。

新 crate(按官方模块名切,实测依赖图定分组):
- sspf-compat-system     system + scheduletask + core
- sspf-compat-permission permission(单向依赖 system,4 符号)
- sspf-compat-msg        message + msg_center
- sspf-compat-workflow   workflow + report + visualdata
- sspf-compat-ext        extend + teamwork + ai + mobile(单向依赖 system + msg)
- sspf-compat-online_dev online_dev(🔴 Rust 包名不能带连字符)

闸门改造:
- check-arch.sh 新增 PLAT_SRC_DIRS(动态 glob)⇒ AR9/AR10 扫真源
- check-arch.sh 新增 AR12(契约面各包彼此独立,Cargo.toml 级判据 + 3 条单向白名单)
- check-contract-scan.py 动态收编所有 crates/sspf-compat-*/src(不写死列表)
- check-boundary.sh 新增动态 COMPAT_DIRS ⇒ CP1/CP2 纳入契约面包
- 修 8 条引文路径(行号 1:1 未变 ⇒ 迁移是纯搬运)

🔴 三个「尺子是假的」的坑(都是反自证抓出来的):
1. CC6 守卫推导静默失效 —— compat_dirs 只收了 sspf-compat-core,六包真源没收
   ⇒ 改动态 glob;反向验证:改坏真源 EN_ROLE ⇒ CC6 精确报出
2. CP1 业务标识符未扫契约面包 ⇒ 加 COMPAT_DIRS;反向验证:插 LEAK_PROBE ⇒ 精确报出
3. macOS 的 BSD grep 不支持 \s(POSIX ERE)⇒ AR11/AR12 的 Cargo.toml 级判据
   永远匹配不到 ⇒ 永远「通过」(AR11 从 M3 起就没真正生效过)
   ⇒ 改 [[:space:]];全仓扫过 scripts/*.sh 确认只有这一处

数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 15/15;--self-test 7/7;check-boundary 11/11;check-contract 10/10
(反自证 12 例全过);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿(300.9s)
v0.1.4-m4
2026-11-03 18:57:00 +08:00
admin eea3d0329f refactor(arch): M3 契约面公共底座下沉 —— helper/res 进 crates/sspf-compat-core
平台能力全迁 crates/ 迁移计划第 3 批(docs/CRATES-MIGRATION.md)。
本批次 = M3:被 14 个契约面模块共用的底座先下沉,M4 的 6 个包才能都依赖它。

搬迁:
- compat/helper.rs(994) + compat/res.rs(460) git mv 进 crates/sspf-compat-core/src/
- src/backend/src/platform/compat/{helper,res}.rs 改成 pub use sspf_compat_core::<mod>::*
  ⇒ 14 个契约面模块的 use super::helper::{…} 零感知
- 路径改写 crate::platform::X → sspf_core::X(独立 crate 不能用 crate::X)
- pub(super) → pub(54 处):转发壳的 pub use …::* 只转发 pub 项(含 struct 字段)
- helper 的 8 个单测自足 ⇒ 随迁,总测试数不变 695

闸门改造(同 M2 纪律 = 两处都扫:真源 + 转发壳):
- check-arch.sh AR11 扫 crates/sspf-compat-core/src/helper.rs + 壳,
  并新增 Cargo.toml 级判据(sspf-compat-core 不许依赖 sspf-compat-* ⇒ M4 的 6 个包)
- check-arch.sh 反自证 6/6 两处注入探针、按路径分别验
- check-contract-scan.py 的 plat_files 对 compat__<mod> 收真源 + 壳同键拼接
  (守卫常量 EN_ROLE 等在 helper 真源里,漏收 ⇒ CC6 假漂移)
- 修 1 条引文:compat/helper.rs:89-92 → crates/sspf-compat-core/src/helper.rs:87-91

反向验证:只往真源 helper 塞 use crate::res::Res; ⇒ AR11 报红;清理后恢复绿。

顺带落档四个决策(§11):壳最后删 / compat 拆 6 包 / mcp_compat 放 crates / tests 跟着拆。

影响:功能零变化(响应形状、路由、语义均未动),纯结构下沉。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10(CC6 零漂移);
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿(561.3s)。
v0.1.3-m3
2026-11-03 17:48:41 +08:00
admin 94d05f4649 refactor(arch): M2 平台核心下沉 —— 19 模块迁入 crates/sspf-core + 闸门扫真源
平台能力全迁 crates/ 迁移计划第 2 批(docs/CRATES-MIGRATION.md,基线 tag v0.1.0)。
本批次 = M2:平台核心从 src/backend/src/platform/ 下沉到 crates/sspf-core/。

搬迁:
- 19 个模块 git mv 进 crates/sspf-core/src/(保留历史):
  auth/authorization/cipher/config/crud/db/entity/envelope/guard/ids/menu/
  monitor/registry/route/seed/session/state/sys/variate_catalog
- src/backend/src/platform/*.rs 全改成 pub use sspf_core::<mod>::* 转发壳(5 行/个)
  ⇒ 上层零感知:routes / modules / 695 个测试的 import 一个没改
- crate 内路径改写 crate::platform::X → crate::X(compat 除外,那是 M3/M4)
- pub(crate) → pub(10 处,跨 crate 后失效)

闸门改造(🔴 本批最大风险不是代码是闸门 —— 搬迁后闸门扫空壳 = 虚假安全感):
- 纪律 = 「两处都扫」:真源 crates/sspf-core/src/(管实现)+ 转发壳(防塞私货)
- check-arch.sh AR9/AR10 扫两处;反自证 2/6、5/6 两处注入探针且按路径分别验
- check-boundary.sh 新增 PLATFORM_CORE;CP1/CP2 两处扫;CP6 的 seed.rs 改读真源
- check-contract-scan.py 的 plat_files 两处都收、重名键拼接(覆盖会丢函数 ⇒ 推不出守卫)
- check-module.sh 的 CRUD 改读 crates/sspf-core/src/crud.rs(软删契约要看 SQL)
- gen-function-catalog.py 的 OUT 改写真源(否则覆盖转发壳 ⇒ 上层 import 全断)
- 反向验证:只往 crates/sspf-core/ 塞违规 ⇒ AR9/AR10 都报红(证明真在扫真源)

测试归属调整:crud.rs 3 个测试原依赖 crate::modules::all_specs()(业务层)
⇒ 改用契约层合成 spec 参数化测试;registry.rs 测试改自建库 + seed::ensure_base(db, &[])。
顺带记录技术债:write_cast 的 numeric 映射是列名枚举而非 spec 声明。

影响:功能零变化(路由、响应形状、语义均未动),纯结构下沉。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10(反自证 12 例全过);
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿(512.3s)。
v0.1.2-m2
2026-11-03 15:49:00 +08:00
admin 215b5e8fcf refactor(arch): M1 解耦 —— 拆掉三处跨 crate 循环依赖 + 加 AR10/AR11 闸门
平台能力全迁 crates/ 的迁移计划见 docs/CRATES-MIGRATION.md(基线 tag v0.1.0)。
本批次 = M1:先把三处跨 crate 循环依赖解开,否则后续拆 crate 时编译器直接报错。

断环(实测定位,非推断):
- 环 A(平台层 → 契约面):auth.rs 的面 B 判据改走契约层唯一真源
  sspf_contract::headers::is_face_b;面 B 分流点上移到装配根 routes.rs,
  平台层与契约面互不知道对方;resolve_user 由 pub(crate) 提为 pub。
- 环 B(契约面底座 helper ↔ system):menu_node / official_view_path 搬进 helper。
- 环 C(契约面底座 helper ↔ permission):USER_DETAIL_COLUMNS / organize_name_of 搬进 helper。

闸门:
- 新增 AR10「平台层不许反向依赖契约面」(拆 crate 的前置条件)。
- 新增 AR11「契约面底座 helper 不许依赖其它契约面模块」(14 个模块依赖它 ⇒ 反向依赖即成环)。
- 反自证由 4 条扩到 6 条(新增 AR10/AR11 两条真实违规注入),确认尺子能抓到。

影响:功能零变化(面 A / 面 B 的响应形状、路由、语义均未动),仅为依赖方向解耦。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10;
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿。
v0.1.1-m1
2026-11-03 13:25:06 +08:00
admin 1694e77324 docs(memory): 记录 v0.1.0 基线 tag 与 crates 迁移计划要点
- 复核结论:crates 与 src/backend 是分工不是重叠(转发壳 / 纯计算↔执行 / trait 实现)
- 三处跨 crate 循环依赖的实测定位与解法
- 最大风险是闸门脚本路径写死导致扫不到文件、永远"通过"
- 踩坑:grep -o 配字符类对长 use 路径返回空,依赖结论必须用 ripgrep + 逐条核行号
2026-11-03 12:16:51 +08:00
admin 639ade7923 docs(migration): 打 v0.1.0 基线 tag + 制定「平台能力全迁 crates/」迁移计划
## 影响

- 新增 docs/CRATES-MIGRATION.md:7 批次迁移计划(依赖图 / 三处循环依赖解法 / 闸门改造 / 风险 / 回滚)
- CLAUDE.md / HANDOFF.md 挂上计划入口,HANDOFF 新增 §0-0-pre 交接段
- 纯文档,**零代码改动** ⇒ 695 测试 / 12 道闸门基线不变

## 改动

- 打 tag v0.1.0(commit b957a11,已推 origin)= 迁移前可回滚锚点
- 计划含实测数据:壳 5,664 行(6%)vs 平台能力 61,500 行;crates 7 个 → 目标 15 个
- 定位三处跨 crate 循环依赖(auth↔compat/helper、helper↔system、helper↔permission)及各自解法
- 标注最大风险:check-contract-scan.py / check-boundary-scan.py 路径写死 ⇒ 搬迁后闸门静默失效
- 4 个待确认决策(转发壳删不删 / compat 包数 / mcp_compat 归属 / tests 是否拆)

## 设计(仅记录明确拒绝的方案)

- ❌ 不按 ssw-mvp 的 biz/entity/controller 三件套切 —— 本仓 compat 是「契约面 handler」不是「业务实体」
- ❌ 不把 compat 做成不认 axum 的纯 crate —— 会与 AR6/AR7 纪律冲突;ssw-mvp 的 *-controller 本身就带 axum
2026-11-03 12:16:08 +08:00
admin b957a11b4c feat(compat): 批次 25 补齐官方大屏 52 条端点(blade-visual 53/53)
官方大屏设计器(jnpf-visualdata)8 个 Controller / 53 条端点,此前本仓
只有 1 条「恒失败」占位 ⇒ 真实缺口 52 条,本批全部补齐。

三源对照:官方后端源码(8 Controller)+ 官方 PostgreSQL DDL(9 张
blade_visual* 表)+ 官方前端 api(jnpf-web-datascreen-vue3/src/api/**)。

关键设计:
- 列族是 Blade 系(id / is_deleted / create_time),与本仓其它契约面的
  f_ 列族不同 ⇒ 不复用 compat::res 引擎,另建 BRes 专用层;DDL 逐字照官方。
- 分页用官方 VisualPageVO(records/current/size/total/pages),不是 PageListVO;
  入参只认 size(默认 10)/ current,官方 VisualPaginationModel 没有
  pageSize / currentPage。
- 官方形状不统一照抄:category/list、visual/category、db/db-list、
  map/lazy-list 返裸数组;visual/copy 返裸 id;visual/Selector 是两级树。
- 删除走 query 的 ids(逗号分隔);软删只对 3 张有 is_deleted 的表,
  其余 6 张官方是物理删。
- 需要外部通道的(外部库连接 / 动态 SQL / 任意 URL 转发 / 文件服务 /
  导入导出 / 地图数据源)⇒ 明确业务失败,绝不返假连接成功 / 假 geojson。

新增:platform/compat/visualdata.rs、tests/visualdata_it.rs(11 条)、
scripts/official-visualdata-sources.json(53 条出处)、db/schema.sql 追加
9 张表、sspf_store::db::VISUALDATA_TABLES。

验证:cargo test --workspace 695 passed / 0 failed;verify --smoke 14 步
全绿;check-contract PASS=10(契约 1040 条,官方台账覆盖 1026/1031);
check-citations PASS=4(1264 条引文)。
v0.1.0
2026-11-03 10:56:03 +08:00
admin 6956af5f34 feat(compat): 批次 24 补齐官方移动端 39 条端点(mobile-gap 39/39)
官方移动端(jnpf/7.0-jnpf-app-vue3)的 api/** 有一批**只在移动端出现**的端点
—— 官方 Web 前端 src/api/** 里没有 ⇒ 上一轮「Web 前端 900/900」天然覆盖不到。

新增:
- platform/compat/mobile.rs —— 39 个 handler(App 菜单 / App 用户 / 版本号 /
  工作日志 / 扫码登录 / 第三方登录 / 组织用户 / 首页 / 日程 / 待办 /
  流程引擎 / 审批前后动作)
- ext_work_log 表(登记进 sspf_store::db::EXTEND_TABLES ⇒ 孤儿 DDL 闸门自动放行)
- tests/mobile_it.rs —— 11 条集成测试
- scripts/official-mobile-sources.json —— 39 条官方移动端出处台账

判别头不变:移动端 utils/request.js 同样带 Vue-Version: 3 ⇒ 仍走面 B。
另补 GET /api/oauth/Login/socials(官方 LoginController.java:117 的
method={GET,POST} 通配同收;Web 前端 POST、移动端 GET)。

修掉三个真 bug(写测试才暴露):
- f_creator_user_id / f_to_user_id 官方存的是 user id(不是账号)⇒
  「我发出的」原用 account 会永远为空;落库与判据两侧都改 user.user_id
- workflow_operator.f_handle_status 官方口径是 NULL=待办 / 0=拒绝 / 1=通过
  (FlowNature.java:231/235)⇒ 待办改判 IS NULL,驳回落库写 0(原写 3)
- 常用菜单真源是 base_module_data(f_module_type='App')而非 base_app_data
  ⇒ 后者 f_object_type 是 VARCHAR 当数字用会运行期 SQL 报错

顺手修既有 bug:scripts/mcp-smoke.sh 两处 "$RC(…)" —— bash 变量后紧跟全角
括号会被并入变量名 ⇒ unbound variable;改成 "${RC}(…)"。

诚实失败(6 类):扫码票据 / OAuth provider / 地图服务 / 账号注销 /
SaaS 邀请 ⇒ 一律 400 + 人话,不返假 URL / 假坐标 / 假成功。

契约:[ENDPOINT] 988 条(面 B 958,+40);[OFFICIAL] 979 条,覆盖 974/979。
验证:cargo test --workspace 684 passed / 0 failed(基线 673 + 11);
verify.sh --smoke 14 步全绿;check-contract PASS=10;check-citations PASS=4。
2026-11-03 09:39:29 +08:00
admin 929fe0592a fix(ai): 供应商改名时不得用空口令清空已存密钥
- 列表/详情的 credential 恒空(安全收紧)⇒ 前端保存会带回空串
- update 时把空串当「不修改」;只有空 credential 的请求直接 200(不报「没有字段」)
- 补测试:改名 + 空口令后 credentialConfigured 仍为 true
2026-11-03 02:36:57 +08:00
admin adfd954303 feat(compat): 批次 21–23 补齐官方前端最后 179 条端点(fe-gap 900/900)
- aiCenter 75:智能体/供应商/模型/知识库/文档/MCP/提示词/服务/技能/工具/会话历史真落库;
  文档切片与关键词召回真做;LLM / 连通性 / MCP 同步如实失败
- extend 64:CRM / 销售订单 / 员工 / 甘特 / 控件示例 / 邮件 / 大数据落 ext_* 15 张表;
  SMTP/IMAP / Excel / 文件服务动作如实失败
- teamwork 40:文件元数据(目录/移动/复制/分享/回收站/标签/空间)+ 日程真落库;
  上传/打包/分片合并如实失败
- 收尾 4:Dataset/Selector、DatasetLog、saveInterfaceList、ShortLink 两个配置形态
- 新增 platform/compat/res.rs 通用资源引擎;ext_* 18 张表在 sspf_store 登记并放行孤儿 DDL 闸门
- 新增 tests/ext_batches_it.rs 6 条;全量 673 passed,verify.sh --smoke 14 步全绿
2026-11-03 02:25:31 +08:00
admin 135d8cf822 docs(memory): 记录 MCP 扩面到 52 个工具的结论与两个踩坑 2026-11-02 23:55:11 +08:00
admin b1875ccbca feat(mcp): 补 3 个直调工具,工具面到 52
- permission.organize.tree(机构平铺列表,建用户前取 organizeId)
- form.selector(挂菜单/绑流程选功能)
- ops.db.stats(关键表行数 + 库体积,快速判断空库/错库)
- 同步 docs/mcp.md / PLAN / HANDOFF 的 52 个口径;全量测试与八道静态闸门全绿
2026-11-02 23:54:50 +08:00
admin c55d111e88 feat(mcp): 参考 dacli 扩面到 49 个业务工具
- 新增 workflow×7 / form.create|update|delete / ops×4 / dict×3 / menu×2 / permission×3 / context.app.list
- 实现方式:mcp_compat 进程内直调契约面 handler(与 HTTP 同一函数),不重写 SQL
- 自动把 formData 等对象字段序列化为 TEXT,避免 value_to_text 静默丢弃
- 管理员头缓存按 SessionStore 实例缓存并设上界(防地址复用 602 与无界内存)
- 新增 tests/mcp_tools_it.rs 6 条;全量 667 passed,verify.sh --smoke 14 步全绿
2026-11-02 23:46:17 +08:00
admin 31e0e457ba fix(compat): 修复真实系统性验证发现的 6 处运行时缺陷
- ResetPassword 改读官方 userPassword(已是 md5,原样落库),兼容 password/newPassword;改密后吊销该用户会话
- 修复三处 count SQL 与参数不匹配导致的 code=500;RecordList 同时补 f_monitor_id 过滤(原先会串监控记录)
- updatePasswordMessage 改 200 + data:null(官方前端每页无条件调用且不 catch)
- ensure_schema_all 不再吞掉业务包装载错误
- 路径参数非法时返回信封 400,不再吐纯文本
- 新增 tests/verify_fixes_it.rs 7 条回归;全量 661 passed,verify.sh --smoke 14 步全绿
2026-11-02 23:15:40 +08:00
adminandClaude Code fc31804f4e feat(msgCenter): 补齐消息中心族 50 条端点并同步契约三处
- 影响:面 B 新增 51 条 `/api/message/**` 端点(契约端点 714 → 765,面 B 684 → 735),官方端点覆盖 700/706 → 751/757,`fe-gap` 的 `msgCenter` 列 49/50 → 50/50。
- 改动:新增 `platform/compat/msg_center.rs` —— 真落库 44 条(账号/发送配置/模板含两张子表/敏感词/接收/监控/供应商,落官方 `base_msg_*` + `base_intg_supplier*` 表),诚实失败 7 条(无 HTTP 客户端 ⇒ 接不了任何消息服务商)。
- 改动:契约生成器新增 msgCenter 族(7 个官方 Controller + 3 条官方前端独有路径),`[ENDPOINT]` +51、`[OFFICIAL]` +51,`[FACE]` 面 B 同步。
- 改动:修 8 处创建人/修改人列(存登录账号不是 UUID)、账号复制列与 CAST 长度错位、子表 `SELECT *` 抄错列、复制账号复制出两个默认账号。
- 改动:新增 `tests/batch20_it.rs`(6 条)—— 逐条打 51 条路径防 matchit 冲突 + CRUD 落库 + 两个 ListVO 形状 + 诚实失败断言 + 未登录 602。
- 设计:官方前端 `testConfig` 声明的是动态路径 ⇒ 加同语义别名 `POST /api/message/Account/{id}` 接住;官方 Java 多暴露、官方前端从不调的 12 条端点本期不做。

Co-Authored-By: Claude Code <[email protected]>
2026-11-02 22:29:30 +08:00
adminandClaude Code 824a0571e9 docs(handoff): 记下批次 19 收尾与「本会话无自动续跑」的事实
- 影响:后续 session 接手时能立刻看出面 B 剩下四族是**用户明确暂缓**,不该自己续跑。
- 改动:§6 定时任务表补一条 2026-11-02 实查结论(CronList 为空 + 暂缓理由)。
- 改动:§1/§3/§5 补批次 19 的数字、范围与坑位。

Co-Authored-By: Claude Code <[email protected]>
2026-11-02 19:42:40 +08:00
adminandClaude Code 4ffd1e0ccb feat(workflow): 补齐 workFlow 族 104 条端点并同步契约三处
- 影响:面 B 新增 104 条 `/api/workflow/**` 端点(契约端点 610 → 714),官方端点覆盖 596/602 → 700/706,`fe-gap` 的 `workFlow` 列 0/104 → 104/104。
- 改动:新增 `platform/compat/workflow.rs` —— 真实现 62 条(流程模板/版本/节点/任务/评论/委托/监控读),诚实失败 42 条(引擎动作 27 + 无文件服务 2 + 无在线表单设计器 13)。
- 改动:新增 24 张 `workflow_*` 表(官方 DDL 逐字导入),登记为 `WORKFLOW_TABLES` 固定装置,不导 Flowable 的 `act_*` 引擎表。
- 改动:契约生成器新增 workflow 族(控制器映射 / 官方前端独有路径 / 引擎·文件·表单三类 partial),`[ENDPOINT]` +104、`[OFFICIAL]` +104。
- 改动:修 pglite 参数类型推断坑(`$N::integer` → `$N::text::integer`),workflow 21 处、report 3 处潜伏 bug。
- 设计:官方流程引擎是独立 HTTP 服务(`FlowAbleUrl`)⇒ 动作类端点一律明确业务失败,不返假流程号、不返假 URL。

Co-Authored-By: Claude Code <[email protected]>
2026-11-02 19:42:12 +08:00
admin 1c224b7b79 feat(core): 补齐 core 族 22 条端点并同步契约三处
按官方三源(LoginController / UtilsController / LocationController +
官方前端 api/core/*.ts)逐条核对,实现 22 条 core 端点:
- 真实现 6 条:锁屏解锁、免密登录票据、扫码凭证状态流转
- 诚实失败 16 条:文件族 4 + 导入族 4 + 地图族 3 + 改密通知 1
  + SaaS 族 3 + socials 1(无文件存储 / 无导入引擎 / 无地图服务 /
  无邮件短信通道 / 无多租户切库 / 无第三方账号 ⇒ code=400 + 人话,
  不返假 URL、不返假坐标)

新增 TicketStore(进程内内存票据表,官方用 Redis 而本仓无 Redis):
两种票据带前缀隔离(tkt- / scc-),不互相串用。

同批修掉一个真偏差:Login/saas 原先写成 let _ = require_login_face_b(..)
丢弃了 Err ⇒ 实际不拦,但静态闸门推成「登录」⇒ 契约标签与运行时行为
不符;已改成真拦(官方 TenantSaasGranter.checkTenantUser 要求已有登录态)。

契约三处同步:[ENDPOINT] +22 / [OFFICIAL] +22 / [FACE] 面 B 558→580,
并顺手修正契约 §6 头两个无人校验的散文数字(132→610 条、53→607 行)。
2026-11-02 17:34:03 +08:00
admin cf154d50ff feat(onlineDev): 补齐 onlineDev 78 条 + 在线报表 23 条端点并同步契约三处
契约面(面 B):从 487 涨到 588 条,官方端点覆盖 474/580 -> 574/580。

实现
- platform/compat/online_dev.rs:表单设计 / 门户 / 短链 / 在线数据 / 个人化 /
  日志 / 分享 / OCR / 行政区划 / 仪表盘 共 78 条
- platform/compat/report.rs:在线报表 23 条(模板 / 版本 / 菜单)
- 报表元数据就地落库(report_template + report_version,官方 DDL 逐字导入):
  官方 /api/Report/* 属独立部署的第三方报表服务,主后端无对应 Controller

契约与尺子
- 新增 scripts/gen-contract-endpoints.py:从代码真实路由自动生成 [ENDPOINT] 与
  [OFFICIAL] 两段(守卫复用扫描器同一套推导,幂等、不覆盖已登记条目)
- check-contract-scan.py 修复守卫推导:三段路径解析、compat 文件纳入 plat_files、
  跨文件常量回落、「无守卫」判据(原先 compat 模块守卫全部推不出,CC6 静默失效)
- docs/contract.md 三处同步:+101 条端点、+101 条官方台账、面 B 计数 457 -> 558

修复的真 bug(集成测试抓到,静态闸门看不出来)
- 3 处 SQL 引用官方 DDL 里不存在的列:base_visual_release.f_platform_release、
  base_system.f_app_key/f_app_name、base_notice.f_full_name(官方是 f_title)
- 3 处官方契约形状偏差:getReleaseMenu 返裸对象(非 ListVO)、
  systemFilter 按官方 SystemListVO 投影(且官方忽略 category 入参)、
  Dashboard/Notice 返 ListVO 且入参 typeList 是数组
- visual_dev_list 计数 SQL 参数个数与 $N 不匹配;visual_dev_update 漏写
  f_last_modify_user_id;report_save_version 模板 id 兼容 id 且返 data:null

测试
- 新增 tests/batch17_it.rs:11 个集成测试(含 101 条端点逐条打一遍防 matchit
  参数名冲突)

数字:check-contract PASS=10 FAIL=0;cargo test --workspace 全绿 0 failed;
fe-gap 541/900(onlineDev 100/101、permission 137/137、system 196/196)
2026-11-02 16:01:24 +08:00
admin 1a41aed3b7 refactor(platform): 契约面按官方模块名重组,去掉 face_* 序号式命名
影响:
- 路由、响应形状、契约台账**零变化**(620 测试全绿,fe-gap 缺口 441/900 不变)
- 官方模块名 ↔ 官方前端 `api/<模块>/**` 目录名一一对应,查缺口不用猜

改动:
- 新增 `platform/compat/`:按官方模块拆成 system / permission / message /
  scheduletask / core + helper(公共底座:导入 / 通用工具 / 判别头 / 守卫 /
  共享常量 / 菜单与用户信息构造)
- `face_b.rs`(26578 行 / 371 端点)→ `platform/compat/` 六个模块文件
- `face_c.rs` 草稿暂不入库(onlineDev 未接线)
- `platform/system.rs` → `platform/registry.rs`(多应用注册表,让位官方模块名)
- `platform/permission.rs` → `platform/authorization.rs`(授权引擎,同上)

设计:
- 不用 `jnpf/` 这一层 —— 本仓要弱化原厂概念,且 `check-naming.sh` 的 NM1
  规则会把含原厂名的目录判为阻断
- 跨模块引用一律 `pub(super)`,不让契约面细节外泄到 crate 公共 API
- impl 块跟随其类型走(否则 Rust 报「不能为 crate 外的类型定义 inherent impl」)
2026-11-02 13:17:40 +08:00
adminandClaude Opus 4.7 16b4a4b8b4 chore(db): 一次性全量导入官方 123 张 base_* 平台表
影响:官方业务表从 62 张扩到 123 张(本仓原缺的 61 张逐字补入 schema.sql),
BASE_TABLE_COUNT 62→123,main.rs 的 BASE_TABLES 同步扩容,db.rs 断言通过,
pglite 17.5 运行时建表验证(batch16 集成测试全绿)。

说明:
- 只导入 base_* 表(官方 DDL 逐字,无 FK/SERIAL/CHECK/UNIQUE 等不兼容构造)。
- 排除 ct*/mt*(低代码引擎运行时动态生成的表,不可静态导入)、workflow_*
  (工作流引擎运行时表)、blade_visual*/ext_*/data_report(Deferred 模块)。
- 这为 workFlow/onlineDev/core/aiCenter/msgCenter/extend/teamwork 各模块提供了
  完整的表地基,后续无需再分次补表。

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
2026-11-02 11:55:56 +08:00
adminandClaude Opus 4.7 0456b4357a feat(permission): 补齐权限关系族 26 条端点并闭环契约/测试
影响:permission 缺口 26 → 0(137/137 100%);契约端点 461 → 487(面 B 431 → 457)。

改动:
- 新增权限关系族 26 条面 B 端点:角色绑定 / 在线用户 / 自定义范围 / 用户工作详情 /
  第三方账号 / 三实体导入导出;复用既有表,未新增表。
- 修 f_object_type 大小写真 bug:统一为官方 PermissionConst 全小写(user/organize/
  position),授权引擎只认小写,写成首字母大写会让绑定「成功但权限永不生效」。
- 在线用户 userId 改为会话指纹 md5(token),绝不外泄真 token;删按指纹精确踢人。
- Organize/SelectedList 的 <组织id>--<后缀> 原样带回且按入参顺序;OrganizeCondition
  遇 $/@ 数据接口变量明确失败。
- 导入导出 15 条:ImportData(type=false) 真落库(必填+判重+默认口令 md5('123456')),
  type=true 及 12 条文件服务缺失一律明确失败(不返 data:null);socials 两条明确失败。
- 角色绑定逐字对齐官方 roleAddObjectIds:三态返回 / 超管不能添加 / 绑完踢下线。
- 删除 [OFFICIAL] 里 4 条早先的 oos/absent 旧账,CC10 台账漂移归零(覆盖 473/479)。
- 新增 tests/batch16_it.rs(10 条)钉死上述契约点;verify.sh 全量 9 步全绿,
  cargo test --workspace 620 passed / 0 failed。

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
2026-11-02 10:58:18 +08:00
admin 454caa5e29 docs: 同步批次 14/15 收尾(HANDOFF + memory) 2026-11-02 10:04:46 +08:00
admin c82a7d1f3d feat(face-b): 系统服务族落地(面 B 批次 15,+39 端点)
多语言/表单套件/缓存管理/任务调度/IM 会话/收藏菜单/公式目录/系统监控 + 三处
Actions/Export;新表 8 张(官方 DDL 逐字)⇒ tables 65,BASE_TABLES 62。

影响:
- 多语言是「一行一语种 + f_group_id 聚组」,列表 id = groupId;tableHead 的列来自
  字典 Language(seed 按官方初始库种子化);PUT 时 map 里没有的语种要删掉。
- CacheManage 落到本仓真实的内存会话表:DELETE 真的把人踢下线、ClearAll 保留操作者
  自己、overdueTime 恒 null(会话不过期,不编时间)、绝不把 token 放进响应。
- scheduletask 只登记不执行(本仓无 XXL-JOB):runCount 恒 0、lastRunTime/nextRunTime
  恒 null、TaskMethods 返空 list(返错会让新建表单整条红)。
- 三处 Export 与 BaseLang 模板/导入 = 明确业务失败(无文件服务),不返假 url;
  Kit 那条尤其不能用 data:null(官方前端 res.data.url 会抛 JS 异常)。
- Monitor 真读宿主机指标;macOS 的 CPU 占空比用负载均值近似(契约标 partial)。

顺手修掉 fe-api-inventory.py 的嵌套模板串截断(真因):内层反引号会截断 URL、内层 }
会截断变量替换 ⇒ 产出畸形路径,让 system 永远差 2 条。改成深度配对 + 丢掉「拼查询串
的三元片段」后,system 缺口 41 → 0(196/196)。另把 3 条「官方前端声明但官方后端
从无映射、也无人调用」的死接口记进 [OFFICIAL] 的 oos(带判据,不进分母)。

回归测试 tests/batch15_it.rs 12 条;全量 610 passed / 0 failed;verify.sh 全绿。
2026-11-02 10:04:42 +08:00
admin e961904252 feat(face-b): 数据中心五族 + 数据同步(面 B 批次 14,+29 端点)
基准数据类型/控件映射/数据库/字段类型映射/常用字段的增删改查 + getKeyList
+ 数据同步四条 + 接口变量下拉;新表 base_data_type_mapping / base_data_base /
base_data_type_relation / base_data_interface_variate(官方 DDL 逐字)⇒ tables 57。
影响:dataCenter 五个页面能真跑;数据同步四条明确拒绝(本仓内嵌单库,无驱动层),
不再假装成功。回归测试 tests/batch14_it.rs 7 条。

五族形状一致 ⇒ 抽了声明式 Flat(一份声明 + 五个薄壳),不再逐族手抄。
过程中修掉扫描器两个同源缺陷:check-contract-scan / fe-gap 都只认每条 .route()
的**第一个**方法 ⇒ 链式 get().post() 的后半段静默消失(契约写 implemented、
代码被判「没有这条路由」)。现在按 .route( 切块取全部方法。
写路径的两处语义也一并钉住:判重是「每列各自唯一」不是「联合唯一」;
列表把 typeId 覆盖成名称而详情必须返回真 id。
2026-11-02 09:13:46 +08:00
admin 3bf7f91461 docs: 同步批次 13 收尾(HANDOFF + memory)
§1 现状数字更新(393 端点 / tables 53 / 588 测试 / 覆盖 379-386 / fe-gap 38.3%)
+ 新增「批次 13」小节与 §5「批次 13 新增的坑」四条;顺手改掉「业务包目前是死的」
这段已失效的口径(批次 12 已接线),避免下一轮重做。
2026-11-02 08:24:25 +08:00