admin
|
f4d7823968
|
docs(memory): 记 glibc 实测验收数据与两个新踩的坑
|
2026-11-13 13:01:15 +08:00 |
|
admin
|
b6990909fc
|
build(armv7): 加 glibc 版本门禁,冒烟换老 glibc 镜像并实测验收
收编 TDS 侧重编的 glibc26 引擎后,补上 issue #1 关联问题 2 的实测验收,
并把「版本回退会重新绑高」这件事变成构建期可拦的门禁。
- 新增纯宿主侧 glibc 版本门禁(build-armv7.sh 第 3 步):读 ELF 动态符号的
版本节点,超过 GLIBC_2.18 直接构建失败。用宿主自带 LLVM objdump 即可读
arm ELF,不起容器、秒级。阈值可用 GLIBC_MAX_MINOR= 覆盖。
- 冒烟镜像由 bookworm-slim(glibc 2.36,与编译 sysroot 同版本 ⇒ 天然掩盖
问题)改为 buster(2.28)⇒ 版本回退会当场暴露。
- 实测版本需求:postgres 封顶 GLIBC_2.17、initdb 封顶 GLIBC_2.14、
sspf-admin 封顶 GLIBC_2.18(Rust std thread_local 析构,2.18 是理论下限)
⇒ 全部 ≤ 2.18,低于 ZYNQ 基线 2.26。libpglite.a 的 fcntl64 undefined 引用归零。
- 实测老 glibc:buster(2.28) 与 stretch(2.24,低于 ZYNQ) 里 initdb/postgres
正常;用已发布包里的 sspf-admin 在两个镜像上跑 stdout 三形态全部探活 200、
进程常驻、导入 14255 条示例数据。已发布包与本次编译 sha256 一致(可复现)。
- 文档:docs/armv7-glibc-compat.md 补 §5.1 收编结果与实测数据,
§2.5 的建议标注为已落实。
commit: 关联 issue #1 的关联问题 2
|
2026-11-13 13:00:14 +08:00 |
|
admin
|
019945385e
|
fix(boot): fd 1 非管道导致内嵌 PG exit 100,改管道 + 转发
修复 Gitea issue #1(armv7 包只在 stdout 为管道时能启动)。
根因:pglite 的 initDummyPort() 设 s.sock = 1,把 fd 1 当「名义客户端
socket」;pq_init() 把它注册进 WaitEventSet。Linux 走 epoll,而 epoll 不接受
普通文件与字符设备(实测 EPERM)⇒ ereport(ERROR) ⇒ longjmp ⇒ exit(100)。
macOS 走 kqueue(接受普通文件/字符设备)⇒ 同样形态正常,故此前未暴露。
- 重写 ensure_stdout_for_pglite():pipe + dup 原始 stdout + dup2 让 fd 1
成为管道写端 + drain 线程把内容转发回原 stdout。drain 是必需的:
pgl_fcntl 是 dummy ⇒ pg_set_noblock(fd 1) 无效 ⇒ fd 1 始终阻塞 ⇒
管道写满 64KB 会永久阻塞。macOS 分支保留空实现(kqueue 无需替换)。
- 开库前固化 PGLITE_RUNTIME_DIR 为带 arch + 构建指纹(路径/大小/mtime 的
FNV-1a)的路径,消除 x86_64/armv7 共用 runtime 目录的抢占;用户显式设置时不覆盖。
- 失败路径改为打印「启动诊断」,不再静默 dup2。
门禁:scripts/build-armv7.sh 冒烟改为三 case(A 管道 / B 普通文件 / C /dev/null)
× 各自干净数据目录,断言 HTTP 通 + 进程常驻;B/C 另断言出现「启动诊断」
(证明替换路径真的走到)。探活改用 bash 内建 /dev/tcp(armhf 镜像无 wget/curl)。
验证:旧二进制 case B = EXIT 100 + 46 字节 banner;新二进制 = HTTP 200、
14255 条示例数据、登录返 200、优雅关闭。三 case 全绿。
|
2026-11-13 12:42:08 +08:00 |
|
admin
|
e95b37ca51
|
build(armv7): 收编 glibc26 引擎,产物绑定 GLIBC 2.18
- 引擎默认目录改为 dist/pglite-engine-armv7-glibc26(TDS 侧按
docs/armv7-glibc-compat.md 重编,pqcomm.o/noblock_srv.o 不再引用 fcntl64)。
- sysroot 换成 zlib-only(上游完整 sysroot 的 libc 是 2.36 ⇒ 产物又绑 GLIBC_2.34+)。
- zig-cc-armv7.sh 增补:丢弃 rustc 的 --target / -target(zig 不认 unknown OS 名)、
注入 explicit_bzero/getrandom 兼容 shim(glibc 2.25 才有)、target 降到 2.26。
- release.sh 清理指向其它引擎的 build script 实例与 rlib,并绕过 sccache
(rustc 指纹不含 native 静态库内容 ⇒ 换引擎会命中旧缓存 ⇒ undefined fcntl64)。
影响:armv7 产物 GLIBC 需求降到 ≤2.18,ZYNQ(2.26)/海光(2.28) 可启动;
x86_64 本机构建路径不变。
|
2026-11-13 12:42:00 +08:00 |
|
ssw-tds-test
|
5420c0f4de
|
docs(armv7): 记录 glibc 版本不匹配问题与整改规格
armv7 平台包的引擎用 Debian 12 的 GLIBC 2.36 当 sysroot,符号被绑到
GLIBC_2.34 版本节点,在 glibc 2.28(海光)实测已起不来:
initdb: libc.so.6: version 'GLIBC_2.34' not found
被抬高版本号的符号本身在 2.26 即存在,故非缺功能而是版本标签问题。
给出两条修法(musl 静态 / 降级 sysroot)与可复现的验收命令。
|
2026-11-12 20:40:12 +08:00 |
|
admin
|
7da10f71f5
|
chore(memory): 记 armv7 交叉编译链与三个坑
|
2026-11-12 20:19:54 +08:00 |
|
admin
|
39201143c5
|
feat(armv7): 交叉编译 32 位 ARM 平台包,自建 pglite 引擎
上游 pglite-rs 只有 aarch64/x86_64 四架构引擎,没有 armv7 ⇒ 自建。
上游认 PGLITE_LIB_DIR,用它喂自建的 libpglite.a + pglite-runtime.tar。
构建链(amd64 容器 + arm-linux-gnueabihf 交叉工具链 + zig cc 链接):
- build-pglite-engine.sh / build-libpglite-cross.sh / relocate-runtime-cross.sh
- zig-cc-armv7.sh(改写 -Wl,/abs/path + 注入 armhf sysroot)
- build-armv7.sh(一键:引擎 → Rust 交叉编译 → arm/v7 容器冒烟)
三个坑(详见 docs/armv7-build.md):
- strip="symbols" 让 rustc 重建 native 静态库时破坏全局符号 ⇒ 交叉构建强制 strip=none
- PG configure 在 cross_compiling 时假定不支持 --export-dynamic ⇒ 强制 cache 变量
- 上游把 runtime 可移植化拆成独立脚本(RPATH + libpq + libz)⇒ 新增交叉版
release.sh 支持 --target <triple>:跳过宿主消费方编译自检改验架构,
rlib 走隔离目录,解包目录名带 target 后缀(多平台互不覆盖)。
实测(linux/arm/v7 容器):initdb、单用户模式、pglite 读写探针、
sspf-admin 启动 + 14255 条示例数据、登录接口、CurrentUser 菜单树全部通过;
从发布包 tar 解出的二进制端到端复测同样通过。
|
2026-11-12 20:17:26 +08:00 |
|
admin
|
c2231a7f3c
|
chore(release): 资产包独立发布通道,两个 release 已上线
- pack-jnpf-assets.sh 新增 --publish:发到独立 release `jnpf-assets-<JNPF版本>`,
同名 asset 幂等覆盖、附整包 .sha256、tag 不存在时自动推、凭据复用 git credential。
- 平台包仍由 release.sh --publish 覆盖 v0.5.0;两条发布链互不耦合,
换 JNPF 版本的资产包不必重发平台包。
- CHANGELOG 记两个 release 的分发入口,工作日志补发布结论与下载 URL 主机注意点。
|
2026-11-06 16:13:57 +08:00 |
|
admin
|
d8a9d16d2c
|
feat: JNPF 7.0 通用资产包独立分发,示例数据与官方 init SQL 对齐
- 新增 pack-jnpf-assets.sh:web 构建产物 + 示例数据库种子按 JNPF 版本单独出包,
与 sspf 版本、OS/CPU、工具链解耦;manifest 声明版本绑定,SHA256SUMS 可逐项校验。
- demo_seed.sql 以官方 jnpf_dbnull_init.sql 为真源:58 表 / 14242 行,
补齐行政区划、国际化、地图三张表,DDL 幂等可重复启动。
- 新增 SSW_ASSETS_DIR / SSW_DEMO_SEED_FILE 外置加载,编译期内嵌为兜底;
换 JNPF 版本的演示数据无需重编二进制;release.sh 以资产包为 web/ 唯一真源,
并加 --no-web 剥离选项。
- 修 SSW_STATIC_DIR 相对路径在 PGlite chdir 后失效;补 14 张官方图标并加
/api/file/Image 精确白名单,其它 /api/** 仍保持信封 404。
- 新增 65 页 A/B 走查报告与 CHANGELOG v0.5.0 条目:UI/路由/接口形状与
init SQL 基础数据页已 1:1,运行时业务数据页差异源于参考库额外演示数据。
jnpf-assets-7.0
|
2026-11-06 15:50:15 +08:00 |
|
admin
|
8af5b901b5
|
chore(issues): 加 Gitea issue 模板 —— 平台优化反馈入口
- .gitea/ISSUE_TEMPLATE/platform-issue.md:现象/最小复现/期望/环境(sspf 版本、rustc host)
- config.yaml:允许空白 issue
(技能仓 SKILL.md/README.md 已指向本仓 issues)
|
2026-11-05 14:47:02 +08:00 |
|
admin
|
dc051d485d
|
docs: 平台仓改为公开 —— 消费方可匿名 clone / 拉 release 包
- Gitea 仓 private=false(API 改;实测匿名 GET repo/release/asset 均 200/206,gzip 正常)
- docs §6.2 与 CLAUDE §4.2 补「公开仓无需凭据;fetch-platform.sh 自动有凭据带凭据、无凭据走匿名」
|
2026-11-05 14:44:37 +08:00 |
|
admin
|
3093ec49fe
|
docs(CLAUDE): 补 §4.2 发布物与消费方契约(方案 C)+ 命令速查 + 红线 14
- 新增 §4.2:出包/发布(release.sh --publish、target 后缀、Gitea Release)、
两个自检(path 离线 / rlib 零重编)、Gitea 附件上限 500 的告警,
以及消费方五条硬约束(rustc 1.95 / --extern 同源 axum / 不声明依赖 / lto=false / 只需 lib)
- §9 命令速查加 release.sh 出包与 --publish
- §7 加红线 14:包的消费契约不许静默破坏(改则同步 §6 文档与技能仓 fetch-platform.sh)
|
2026-11-05 14:05:05 +08:00 |
|
admin
|
3f2d56be20
|
feat(release): 按 tag+目标平台发包到 Gitea Release(--publish)+ 修包内 README
- release.sh: 产物名带 target 后缀(sspf-vX.Y.Z-<target>.tar.gz,rlib 与平台绑定)
- 新增 --publish:幂等创建/复用 Gitea Release(tag vX.Y.Z) → 删同名 asset → 上传
(GITEA_URL/REPO/USER/PASS 可覆盖;凭据缺省取本机 git credential)
- 修 README 模板:删掉「保留 axum/tokio 依赖、自己编一次」的旧说法(与 §6.3 矛盾),
改为「全走 --extern 取 lib/、Cargo.toml 不声明、release 必须 lto=false、注明目标平台」
- docs §6.2/6.3 同步:--publish 用法、Gitea 附件上限 100M→本机已调 500 的告警
|
2026-11-05 13:45:17 +08:00 |
|
admin
|
86859a77e2
|
docs(pkg): 消费方只需解 lib/ + rust-toolchain,不需要平台源码
|
2026-11-05 12:50:45 +08:00 |
|
admin
|
6ee0cd14d8
|
feat(pkg): 方案 C —— lib/ 预编译 rlib 完整闭包,消费方零重编
- release.sh step2.5: 出包前 cargo clean 隔离目录 + 关 lto/embed-bitcode
(旧 profile 多 hash 残留会 head -1 选错;LLVM22 bitcode 让 macOS ld(libLTO21) 解析失败)
- step3.2.5: lib/ 改为拷贝 deps/ 整目录(rlib+rmeta+proc-macro dylib+原生 a),
只 glob lib*.rlib 会漏 serde_derive/tokio_macros 的 dylib → E0463
- 修正 grep -m1 channel 误匹配注释行(工具链串显示成注释)
- docs §6 重写:方案 C 机制 + 三条硬约束(编译器版本/lib 完整闭包/axum 同源)+ lto=false
- 双自检通过:A path 依赖离线编译;B 消费方零编译平台闭包直链 rlib
包体 288M → 160M(bitcode-free rlib 426KB vs 2.3MB)。
|
2026-11-05 11:41:04 +08:00 |
|
admin
|
f6c3ff64ee
|
feat(pkg): 每版本出包替代 git 依赖(release.sh + 文档同步)
- 新增 scripts/release.sh:读 crates/sspf 版本 → 编译预编译 sspf-admin 二进制
→ 组装自包含发布包 dist/sspf-vX.Y.Z.tar.gz(预编译二进制 + 平台 crate 闭包
+ Cargo.lock + rust-toolchain.toml + 前端源码),并自检验证离线可编。
- docs/SSPF-PLATFORM-PACKAGE.md §6 改为「每版本出包、消费方 path 依赖」模型,
废弃原 git tag 依赖写法;README/HANDOFF/CHANGELOG 同步。
- .gitignore 忽略 dist/
|
2026-11-05 09:28:47 +08:00 |
|
admin
|
60af816ded
|
docs(req): 记业务侧 v0.5.0 切换完成(tdc-rs e13768e)
- §11 补切换表、两条新判据、业务侧验收数字
- 状态行改为「业务侧已完成切换」
|
2026-11-04 23:08:23 +08:00 |
|
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 |
|