20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# Research: Proxy Module Delegation
|
||
|
||
## Decisions
|
||
|
||
- **模块调度边界**: 通用 proxy 仅负责路由到 module handler，所有缓存/回源/重写由模块内实现。
|
||
- **Rationale**: 减少跨类型分支，新增仓无需改通用层，风险集中在各自模块。
|
||
- **Alternatives**: 保留通用 handler + 按类型分支（现状）；放弃模块化，统一代码路径。均会牵扯多处改动且增加回归面，故弃用。
|
||
|
||
- **模块注册契约**: hubmodule 注册需同时提供元数据和 handler 绑定接口；缺 handler 视为配置错误。
|
||
- **Rationale**: 避免运行期静默回落，统一观测与错误路径。
|
||
- **Alternatives**: 允许回退到 legacy handler；但会掩盖缺失，违背模块自洽目标。
|
||
|
||
- **现有仓兼容**: docker/npm/pypi/go/composer 模块保留各自策略与路径重写，迁移时不得改变对外响应/日志字段。
|
||
- **Rationale**: 避免生产回归；满足 SC-001/SC-004。
|
||
- **Alternatives**: 统一一套通用策略；但会改变缓存键/TTL，引入不必要风险。
|
||
|
||
## Clarifications Resolved
|
||
|
||
- None pending; spec中无 NEEDS CLARIFICATION。
|