32 Commits
Author SHA1 Message Date
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}。
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 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/ 只剩装配 + 业务层。
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)
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)
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)
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)。
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)。
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 步全绿。
2026-11-03 13:25:06 +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 条引文)。
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 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
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 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 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 db0ad57921 feat(face-b): 系统数据两族落地(面 B 批次 13,+14 端点)
行政区划 Area(7) + 公有变量 Variate(7);新表 base_province / base_common_variate
(官方 DDL 逐字)⇒ tables 53、BASE_TABLES 50。
影响:/system/Area 与 /system/Variate 页面前端可以真跑(树懒加载、子树排除、
type 是字符串、creatorUser 真填上);回归测试 tests/batch13_it.rs 12 条。

钉子测试不再手抄:删掉 routes.rs 里 255 行 FACE_B_REGISTERED,改成从契约
[ENDPOINT] 读路径(漏抄仍全绿 = 假闸门);CC7 相应只守面 A,并加「清单回来就红」。
顺手把两处写死表数改成与真值源同口径(sspf-store 常量、batch6 的表清单)。
2026-11-02 08:24:20 +08:00
admin 324e82be0d test(pack): 每个包的 List 必须在面 A + 面 B 真应答(批次 12.6)
12.5 让「漏接」变红,但「接错了」仍全绿:路径注册了(405 探针)不等于 handler 跑得通。

- tests/pack_smoke_it.rs:登录 → 遍历 ALL_SPECS/ALL_ROUTES + 包注册表 → 真打 List

  面 A 断言 data 是裸数组;面 B 断言 data.list 是数组且 pagination.total 非空

  一个条目都不写死 ⇒ 加包自动覆盖;失败时一次列全部坏条目

- verify.sh --lib 新增该步(full/smoke 已由 --workspace 覆盖,不重复跑),+2.4s

- 顺手修两处文档失真:测试二进制 45 → 实测 37;--lib 描述「不起库」→「起库」
2026-11-01 23:13:42 +08:00
admin ce30c5b2f6 feat(pack): 框架固定包 + 加模块一条命令(批次 12 + 12.5)
把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 404。

- crates/sspf-plugin:load_static() 收掉装配样板,bootstrap 的 load_packs 缩成一行

- 包统一出口:pub struct Pack + pub const DDLS(生成器不必理解各包常量命名)

- 业务 DDL 跟包走(packs/*/schema/*.sql 经 include_str! 编进二进制)

- packs_gen.rs / modules/mod.rs 5 段 / Cargo.toml / contract.md 三段改由 pack-sync.py 生成

- scripts/new-pack.sh:一条命令产出 5 个后端文件 + 接线 + 可选前端三件套

- scripts/verify.sh 静态闸门一键跑;.workbuddy 记忆与 HANDOFF 见下一提交
2026-11-01 23:04:53 +08:00
admin 6ed89a33ca feat(face-b): 数据连接 + 数据建模只读面落地(面 B 批次 6,+16 端点)
- 新表三张(官方 DDL 逐字):base_db_link(22 列) / base_data_type / base_common_fields,tables 32→35
- 平台字典照官方初始库灌:基准数据类型 7 行 + 常用表字段 10 行(否则建表表单类型下拉全空)
- DataSource 8 条:列表/分组/下拉树(含合成「默认数据库」id=0)/CRUD/测试连接(恒失败不假装)
- DataModel 6 条只读:表清单、表+视图、表信息(hasTableData 真探测)、字段、字段下拉、数据预览
- 🔴 Preview 逐列 "col" AS "col":SELECT * 会被归一成 camelCase ⇒ 前端整表空白
- 尺子补 guard_any(…, &[A,B]) 的守卫推导(官方 mode=OR 那几处)
- 回归 tests/batch6_it.rs(5 条);cargo test --workspace 513 passed
2026-11-01 08:29:03 +08:00
admin ba8883dfb0 feat(face-b): 应用中心 / 系统配置 / 标签落地(面 B 批次 3,+26 端点)
- schema:新增 base_system_top / base_sys_config / base_tag(DDL 逐字对齐官方
  JNPF-PostgreSQL.sql),tables 23 → 26;ensure_schema 改为逐表探 to_regclass
  ⇒ 老库自动补后加的表(此前见到 base_user 就早退,新表永远不出现)
- 应用中心(SystemController):列表/详情/增删改/复制/置顶/偏好 + 应用授权三件套,
  列表返 ListVO 且 isTop 由 base_system_top 现场拼;删除守两道官方闸(主系统、
  应用下还有 base_module);复制只复制应用行 ⇒ 记 partial
- 系统配置(SysConfigController):键值表逐键 upsert,读回做数字/布尔还原;
  库为空时给 39 键默认对象(前端 state.baseForm = res.data 后立刻读 .logCleanPeriod,
  data 不能是 null);企业微信/钉钉/第三方同步恒返 400 + 人话,不假装成功
- 标签(TagController):ListVO + selector(enCode 空 ⇒ 全部)+ CRUD,编码唯一
- 修 check-contract-scan.py 静默失效:面 B 文件已改名 face_b,尺子只认 jnpf
  ⇒ 整片面 B 的守卫检查没在跑(CC6 warning 从 20+ 降到 2)
- 契约登记三处同步:[ENDPOINT] 26 行 / [OFFICIAL] 26 条(5 条 partial)/ B 146→177;
  测试 495 → 499
2026-10-31 22:16:55 +08:00
admin 1d1a3b1ef9 feat(mcp): schema.table.create 落地 + P2-b 冒烟闭环,修 data.query 泄漏口令列
- MCP:新增 schema.table.create(第 26 个业务工具)—— 库内功能按设计稿建表并回写
  f_tables_data;内联 formData/tablesData 只能演练(INLINE_REQUIRES_DRY_RUN);
  写且幂等(表已存在跳 DDL,列不同报 TABLE_EXISTS_DIFFERENT),默认 dryRun=true
- mcp-smoke 32 → 48 条:先 --seed-lowcode-demo 造 receivableDemo,再用同一 PGLITE_DIR
  起 --mcp,python 动态驱动(主键是服务端 UUID)跑通「默认演练不落库 → 真写 → 查证 →
  子表差集三类 → 删除 → 建表演练/幂等」;M4 回复数改为按请求文件计算,不再写死 29
- lowcode-smoke 8 → 15 条:用内联演练钉建表规则(类型映射+dataLength / 复合主键 /
  逻辑删除三列 / 系统列视图类型),外加两条反自证(不开逻辑删除就不加删除列;
  inline 不许落库)
- fix:data.query 不再投影 f_password / f_secretkey(实测能拖走全库口令哈希);
  缺省滤掉并返回 hiddenColumns,显式 columns/where/orderBy 要用 ⇒ SENSITIVE_COLUMN
- docs:PLAN / CLAUDE / docs/mcp / docs/visualdev-mechanism 补 P2-b 结论;
  业务工具数 21 → 26 由 tool_count_matches_doc 钉死;清 f_foreign_id 文档漂移
  (子表外键列来自模型 tableField);补单租户口径的三条交叉证据(K8s 配置 / Java 常量 /
  官方 DDL);记 UNIQUE_CONSTRAINT_VIOLATED / BUSINESS_KEY_VIOLATED
2026-10-31 21:34:37 +08:00
admin f0c77f731c feat(lowcode): 低代码元数据引擎第一波 —— 解析 + 校验 + 3 个只读工具
- 新 crate sspf-lowcode(纯计算,AR7 钉住不依赖 DB/HTTP):widget 把 54 种 jnpfKey 归成 11 类
  (决定「怎么存、能不能接收入参」)/ form 解析控件树 / model 解析表结构 / validate 9 类诊断码
- DDL:base_visual_dev + base_visual_release 逐字对齐官方(21 → 23 张表)
- MCP 3 个只读工具:form.list / form.describe / form.validate,后两个支持 inline JSON
- 真实样例落盘为 fixture(官方初始化数据的「应收费用」:主表 6 字段 / 子表 8 字段)
- 新增 lowcode-smoke.sh 8 条(含两条反自证:改坏 __vModel__ 必被抓、未知控件只 warn)
- 影响:测试 306 → 344;十二闸全绿;三条真实方言已写进注释与测试
2026-10-31 11:47:40 +08:00
admin 16c0704c47 chore(scripts): baseline-smoke 优先 debug、回落 release
- 只 build 过 release 时尺子也能跑(之前硬编码 debug 路径会误报"找不到探针")
- CLAUDE.md 补上探针的构建命令
2026-10-31 11:24:59 +08:00
admin df63306b24 feat(mcp): 授权闭环 + 流程模板 + 基线适配器(P1 主体完成)
- 授权闭环 4 工具:authorize.grant / revoke / effective(四源并集 + 应用过滤两组数)+ user.create
  —— effective 是「授权了但看不见」的唯一诊断入口;user.create 建非管理员账号让闭环可自证
- prompts 3 模板:new_business_module / diagnose_menu_not_visible / verify_all
  —— 测试核对模板里引用的工具 id 是否存在(防腐烂)
- 新 crate sspf-adapter-baseline:PlatformAdapter 第二实现,5 个只读 op + 形状归一化
  —— 用 hyper::client::conn::http1,只支持 http://,口令传密文
- 新增 AR6 与 baseline-smoke.sh(10 条);mcp-smoke 23 → 32 条
- 影响:测试 282 → 306;十一闸全绿;工具 15 → 19;内存仍 7 MB
2026-10-31 11:23:16 +08:00
admin 330436bf01 feat(mcp): 写工具 3 个(menu.create/delete、dict.type.create)+ 修构建缓存坑
- menu.create 写完整 14 列(含 f_en_code / f_system_id),补齐 HTTP 侧 module_save 缺的两列
- 写库前完成全部校验:必填、enCode 形态、urlAddress 无前导斜杠、父节点存在、编码唯一
- menu.delete 一律软删;dict.type.create 查重 enCode
- 读协议改 read_until + from_utf8_lossy(read_line 遇非 UTF-8 会整批静默退出)
- 主循环改单线程串行(去掉 channel 的时序竞争)
- mcp-smoke 20 → 23 条;工具总数 15(12 读 + 3 写)
- 影响:测试 282;已知边界 —— --mcp 模式 stderr 不可为 /dev/null
2026-10-31 10:59:21 +08:00
admin 16266c93c3 feat(mcp): 业务工具扩到 12 个 + --mcp --with-http 双形态
- 新增 8 个只读工具:permission(user/role/authorize) · dict(type/data) · data(query/count) · schema(index)
- data.query/count 走严格白名单:表名 valid_table、列名查 information_schema、值全参数化
  (参数化只防值注入,结构注入必须靠列白名单)
- `--mcp --with-http`:MCP 与 HTTP 同一进程、同一 AppState、同一个库,人机协作不用切进程
- mcp-smoke 13 → 20 条(新增四域可用性 / 列裁剪 / 结构注入防护)
- 影响:测试 280;踩坑两处 —— COALESCE 默认值类型必须与列一致;入参 f_ 列名 / 出参 camelCase 两套命名
2026-10-31 10:47:06 +08:00
admin 217dadf008 feat(mcp): 落地 MCP 工具层 —— 4 元工具 + 分层加载 + 进程内适配器
- 新增 crates/sspf-mcp:registry / jsonrpc / server / 4 个元工具(context·discover·describe·call)
- 内核新增 mcp_adapter.rs(NativeAdapter,直接调 AppState)与 `--mcp` 子命令
- 工具定义自带五段自提示(含 pitfalls/examples),示例必须能被测试跑通
- 新增 scripts/mcp-smoke.sh(13 条)与 docs/mcp.md(接入说明)
- 影响:协议层只暴露 4 个工具(常驻约 1.8K token);业务失败返回结构化 error 而非协议错
- 踩坑记录:内嵌 PG 会抢 fd 0/1,必须在开库前 detach 标准流;tokio 的 stdin 在管道上 ENXIO
2026-10-31 10:29:14 +08:00
admin b11ec26106 refactor(kernel): 拆出 contract/store/sdk 三层 crate,剥离原厂标识
- 新增 sspf-contract(契约类型,不含 axum)、sspf-store(db/config,不认识 HTTP)、
  sspf-sdk(业务包唯一依赖)与 packs/asset 样板包(可独立编译)
- 内核 platform/{envelope,entity,menu,ids,db,config}.rs 改为 re-export,引用路径零变化
- jnpf.rs → face_b.rs,9 处标识符改名;契约字面量(jnpf-origin / jnpfKey)刻意保留
- 新增 check-arch / check-naming / mem-budget 三道闸门;rust-toolchain 锁 1.95.0
- 影响:行为零变化(240 测试 / 九闸全绿 / 空载 7 MB),Profile 从 guard 迁到 config 断开假依赖
2026-10-31 10:10:34 +08:00
sukyboor 9771fa844d init: 尚数网平台 JNPF 7.0 兼容后端(多应用 + 面 A/面 B 双契约)
- axum 0.8 + pglite:12 张表,多应用按 App-Code 头解析 f_system_id 隔离
- 面 A(ssw/react 形状)+ 面 B(官方 JNPF 形状,Vue-Version: 3)双契约并存
- 业务模块 asset/DataResource;面 B 用户 CRUD 9 条已落地
- 六道闸门 + 两把运行时尺子(perm-smoke 43 / perm-smoke-jnpf 23)
- scripts/:前端接口清单、页面依赖反查、运行时探针
2026-10-30 22:08:31 +08:00