Files
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
..

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 段(下次生成会覆盖)