修复 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 全绿。
src/backend —— 内核 crate(package ssw-platform)
一页说明。 读这一页 + src/lib.rs 的「30 秒地图」,就不要再去逐个点开文件了。
它是什么
库。只有 lib 目标(ssw_platform),没有任何二进制 —— 可执行入口在
crates/sspf-admin(bin sspf-admin)。
它把三件事做完就收工:装配(把 crates/* 拼起来)、路由注册、业务层。
目录逐项
| 路径 | 是什么 | 加业务模块时 |
|---|---|---|
Cargo.toml |
lib 目标 + 依赖;末尾 >>>GEN:PACK_DEPS 段由 pack-sync.py 生成、恒空 |
不手改 |
src/routes.rs |
唯一权威装配链(面 A / 面 B 按判别头分流) | 不动 |
src/bootstrap.rs |
装配根:平台表 + 各包 DDL + 业务菜单注入种子 | 不动 |
src/compat.rs |
契约面命名空间别名表(compat::<域>::<handler>,16 个域) |
不动 |
src/forward.rs |
6 个转发壳(低代码 4 + MCP 2),只有 pub use |
不动 |
src/packs_gen.rs |
⚠️ 生成物:业务包注册表 + pack.toml 快照 |
不手改 |
src/test_support.rs |
内核单测共享的 pglite(#[cfg(test)]) |
不动 |
src/modules/ |
业务层:4 个模块文件都是「面 A 适配器 + pub use 转发」→ packs/{asset,demo,shop,books} |
✅ 只动这里 |
db/schema.sql |
平台表(base_*)DDL 唯一真源;业务表的 DDL 跟着各自的包走 |
加平台表才动 |
data/ |
运行期数据目录(gitignore) | 不动 |
测试
| 测什么 | 在哪 | 怎么跑 |
|---|---|---|
内核单测(102 条,含 routes.rs 的路由表钉死) |
各文件内联 #[cfg(test)] |
cargo test -p ssw-platform --lib |
平台集成测试(37 个 *_it.rs,测「装配好的平台」) |
crates/tests/tests/ |
cargo test -p sspf-tests |
🔴 空的 src/backend/tests/ 已删:集成测试的宿主是 crates/tests,
放回这里会让「内核实现细节」与「平台契约」混在一起(历史上 37 个文件跟着内核搬过 3 次)。
这条边界由 scripts/check-arch.sh 的 AR16 钉住。
不要在这里做的事
- ❌ 加
[[bin]](AR16 红)→ 起新应用请复制crates/sspf-admin - ❌ 把集成测试放回
tests/(AR16 红) - ❌ 在
compat.rs/ 平台层里use sspf_pack_*(AR9 红) - ❌ 手改
packs_gen.rs或Cargo.toml的>>>GEN:PACK_DEPS段(下次生成会覆盖)