mirror of
https://github.com/whyour/qinglong.git
synced 2026-09-20 16:07:11 +08:00
57 lines
3.6 KiB
Markdown
57 lines
3.6 KiB
Markdown
# ADR-0312：Local Profile Composition 的 Subpath 收敛
|
||
|
||
- 状态：Accepted
|
||
- 日期：2026-08-09
|
||
- 关联 RFC：QL-RFC-0001 D-06、D-17、D-87、D-257
|
||
- 关联 ADR：ADR-0042、ADR-0063、ADR-0267、ADR-0276、ADR-0295、ADR-0311
|
||
|
||
## 背景
|
||
|
||
`@qinglong/local-profile` 与 `@qinglong/local-adopted-profile` 都只有 root、Edge、Standalone 三个文件。
|
||
ADR-0295 曾用 artifact closure delta 证明二者不是任意平铺实现，但后续 pack 实证又证明：基础 Profile 的
|
||
每个制品必然已经安装 `@qinglong/local-sqlite`，Adopted Profile 的每个制品必然已经安装
|
||
`@qinglong/local-admin`、`@qinglong/local-sqlite` 与 `@qinglong/local-secret`。两个 package 因而没有独立
|
||
制品、依赖隔离、authority owner 或版本收益，只留下 manifest/importer 开销。
|
||
|
||
编辑前 GitNexus 将六个公开 bootstrap、两个校验函数、审计映射与失败清理函数全部判为 LOW：两个主
|
||
bootstrap 各 2 个直接包装调用、0 条已识别跨模块执行流程。这个结果只允许物理归属迁移，不允许改变启动、
|
||
栅栏或清理语义。
|
||
|
||
## 决策
|
||
|
||
1. storage-only composition 进入 `@qinglong/local-sqlite/profile`，Edge/Standalone 固定入口分别为
|
||
`/profile/edge` 与 `/profile/standalone`。
|
||
2. adopted composition 进入 `@qinglong/local-admin/adopted-profile`，固定入口分别为
|
||
`/adopted-profile/edge` 与 `/adopted-profile/standalone`；activation authority 仍使用 dynamic import，
|
||
disabled 分支不得加载可执行 adoption runtime。
|
||
3. 目录级审计替代微包防火墙：SQLite `profile/` 只能跨到 `runtime/runtimeDatabase`；Admin
|
||
`adopted-profile/` 只能跨到 package 内 `runtime`，并且只能消费 SQLite 的 `/profile` 子路径。
|
||
4. 两个旧 package 名成为全局 tombstone。Application 只允许三个受审 composition owner 导入新 subpath。
|
||
5. Package ledger hard cap 18→16；任何未来新 package 仍须提供独立 deployable、authority、重依赖隔离、
|
||
replaceable adapter 或多 production consumer 证据。
|
||
|
||
## 低配与集群影响
|
||
|
||
- Edge/Standalone closure 从 4 个 package 降为 3 个：3,623,093/3,623,129 bytes、331 files、49 modules。
|
||
- Adopted closure 从 7 个 package 降为 5 个：4,222,699/4,222,759 bytes、369 files、50 modules。
|
||
- Application closure 从 12 个 package 降为 10 个：4,720,548/4,720,668 bytes、428 files、110 modules。
|
||
- AI 基础档为 5,010,628/5,010,676 bytes、395 files；Application AI 最大档为
|
||
6,108,149/6,108,281 bytes、492 files；十档均在原 byte/file/RSS 预算内。
|
||
- Cluster、Worker、PostgreSQL package 和 deployment 均未改变；没有新增常驻进程、timer、listener、连接、
|
||
migration 或第三方依赖。
|
||
|
||
## 验收
|
||
|
||
- boundary ledger：16/16、`singleSourcePackages=[]`、`shallowSourcePackages=[]`、零 finding；workspace
|
||
仍为 781 source，root 31→25、nested 750→756。
|
||
- local-sqlite 203/203、local-admin 91/91、dependency 50/50 与受影响 image/service 契约通过。
|
||
- 十档真实 pack/install/import/RSS 审计全部 compatible。旧 package 没有进入 lockfile、Docker build、SBOM
|
||
或 runtime inventory。
|
||
- 本批不改 SQL、migration、PostgreSQL/Cluster runtime 或部署资源，因此不重复运行 PostgreSQL HA 门。
|
||
|
||
## 被否决方案
|
||
|
||
1. 继续把三文件 public entrypoint 当永久浅包：已有 artifact 闭包不能证明额外裁剪价值。
|
||
2. 把 adopted composition 合入基础 SQLite Profile：会让路由器基础档取得 local-admin/Secret authority，拒绝。
|
||
3. 为每个 Edge/Standalone 入口继续拆包：Profile 是参数化组合，不是两个独立 authority 或产品生命周期。
|