从 UI 到内核：Oinone 的全栈可扩展方法论 — Hook/AOP/扩展点与 SPI 的实践
Oinone 把“每个需求都是一个独立模块、支持各业务线差异化扩展、从框架到组件可深度扩展”作为设计目标。体系由 四条纵向能力（交互、模型、函数、应用生命周期）与 两条横向机制（API 生命周期扩展、平台 SPI 扩展）构成，通过字段/函数重写、Hook/AOP、扩展点（前置/后置/覆盖）与主题/母版/视图/路由/动作等粒度化插拔，做到既能快速装配，也能深入定制。
1. 设计目标
- 模块化：每个需求都能被打包成独立模块，独立发布与回滚。
- 差异化：同一能力在不同业务线可走不同实现与配置。
- 深度扩展：不仅页面可配，模型、函数、生命周期乃至平台内核都可扩展。
| 演示环境 | 相关视频 |
|---|---|
| ⚡ 直达演示环境
☕ 账号：admin ☕ 密码：admin |
🎬 1. [数式Oinone] #产品化演示# 后端研发与无代码辅助
🎬 2. [数式Oinone] #产品化演示# 前端开发 🎬 3. [数式Oinone] #个性化二开# 后端逻辑 🎬 4. [数式Oinone] #个性化二开# 前端交互 🎬 5. [数式Oinone] #个性化二开# 无代码模式 |
2. 总体框架
Oinone 的扩展体系可以概括为：
-
四条纵向能力
- 交互可扩展：主题、母版（布局）、视图、字段组件、路由、动作均可增加/替换/指定/组合。
- 模型可扩展：支持字段重写、增强模型与五类继承（抽象继承、扩展继承、代理继承、多表继承、临时继承）。
- 函数可扩展：函数重写、Hook 机制（AOP）、扩展点机制（前置/后置/覆盖）。
- 应用生命周期可扩展：模块安装/升级/重启逻辑，以及构建前/构建后、生命周期前/生命周期后的处理逻辑与元数据编排。
-
两条横向机制
- 基于 API 的生命周期扩展：对应用层事件（安装、升级、重启等）开放 API，让模块声明自己的编排与执行。
- 基于 SPI 的平台能力扩展：网络协议层 SPI、驱动层 SPI、FaaS 层 SPI（执行约束 SPI、RPC 调用 SPI）、持久层 SPI、ORM 层 SPI 等，允许替换/新增底座能力。
3. 交互可扩展：把“界面设计”拆到最小颗粒
从“看得见”的地方降本增效，是扩展的第一现场。
- 主题可扩展：风格可增加/替换/切换，适配多租户、多品牌。
- 母版（布局）可扩展：页面框架可替换/指定，如后台与大屏使用不同母版。
- 视图可扩展：列表/表单/看板/图表等视图类型可增补，与数据模型绑定。
- 字段可扩展：字段组件可增加/替换/指定，如把文本框替换成带校验的选择器。
- 路由可扩展：路由表项可增加/替换，模块自带路径不必侵入主工程。
- 动作可扩展：动作可增加/替换/指定/组合，支持将“审批+发运”等复合动作编排为一步。
示例（片段）
{
"module": "po-approval",
"views": {
"PurchaseOrder.Detail": {
"fields": {
"expectedDate": { "component": "DatePicker", "override": true }
},
"actions": [
{ "id": "approveAndShip", "type": "compose", "steps": ["approve", "ship"] }
],
"routes": [
{ "path": "/po/:id/ship", "component": "ShipView" }
]
}
},
"theme": { "extends": ["theme:default"] }
}
4. 模型可扩展：差异只写在差异处
模型层提供结构与行为的“正交”扩展：
-
字段重写：允许对已有字段的校验、渲染器、默认值进行重写。
-
增强模型：基于搜索/索引的查询增强、校验规则增强、派生字段等。
-
五类继承
- 抽象继承：提取公共字段/方法的抽象基类，不可直接实例化。
- 扩展继承：在不改变基类语义的前提下，向目标模型增量加字段/约束。
- 代理继承：行为转发/包装到另一个模型，便于隔离合规或跨域访问。
- 多表继承：一个逻辑模型映射多张表，支持冷热分层/历史归档。
- 临时继承：按租户/活动在运行期注入短期字段/规则，撤销即回退。
示例（伪 DSL）
// 在 BaseOrder 上做扩展继承
model PurchaseOrder extends BaseOrder with ExtendsInheritance {
@override field expectedDate: Date
field supplierRating: Int?
enhance {
searchIndex "supplier_name, po_no, sku_code"
}
}
5. 函数可扩展：Hook + AOP + 扩展点
函数层聚焦“时机与顺序”的控制：
-
函数重写（Override）：在不改主流程签名的情况下，替换实现。
-
Hook 机制（AOP 能力）：在切面前/后/异常挂载逻辑，跨越模块复用。
-
扩展点机制
- 前置扩展点：在核心逻辑运行前拦截/补充数据。
- 后置扩展点：在核心逻辑完成后做派生动作（审计、通知等）。
- 覆盖扩展点：完全取代默认实现。
示例（TypeScript 伪代码）
export const hooks = registerHooks('po')({
before('submit', async (ctx) => { await verifyBudget(ctx) }),
after('submit', async (ctx, result) => { audit(ctx, result) }),
override('calculateTax', async (ctx) => calcRegionalTax(ctx)) // 覆盖式扩展
})
6. 应用生命周期扩展：模块的一等公民地位
针对“安装/升级/重启”等事件，模块可以声明自己的执行逻辑；针对“构建前/构建后、生命周期前/生命周期后”，平台提供钩子做元数据编排与系统级处理。
- onInstall / onUpgrade / onRestart
- beforeBuild / afterBuild
- beforeLifecycle / afterLifecycle
- 元数据编排：将模型、视图、路由、动作、Hook 等产物做依赖拓扑排序，生成稳定装配序列（支持幂等与回滚）。
示例
export const lifecycle = {
async onInstall(ctx) { await seedDicts(ctx) },
async onUpgrade(ctx) { await migrate('v2->v3', ctx) },
async beforeBuild(ctx) { validateMetadata(ctx.graph) },
async afterBuild(ctx) { warmupCaches() }
}
7. 平台自身能力 SPI：内核也能被替换
当差异需要下沉到底座时，使用 SPI（Service Provider Interface）：
- 网络协议层 SPI：自定义编解码/传输策略。
- 驱动层 SPI：接入自研/第三方驱动（消息、存储、设备）。
- FaaS 层 SPI：执行约束 SPI（限流/超时/重试）与 RPC 调用 SPI。
- 持久层 SPI 与 ORM 层 SPI：数据源路由、审计字段、软删、分片等。
示例
export interface StorageSPI {
put(object: Buffer, meta: Meta): Promise<URL>
get(url: URL): Promise<Buffer>
}
@Spi('storage')
export class MinIOStorage implements StorageSPI { /* ... */ }
SPI 的价值在于：当“函数扩展不够用”时，仍可在标准接口之下替换底座实现，而无需修改上层业务代码。
8. 元数据编排：把碎片装配成系统
Oinone 将模型/视图/路由/动作/Hook/SPI等产物抽象为统一元数据，通过声明式依赖与编排规则完成构建与运行期装配：
- 依赖声明：
dependsOn: [user, workflow@>=2.1] - 装配顺序：
order: [model, view, hook] - 作用域/租户选择器：
tenantSelector: ["region==EMEA"] - 冲突解决：优先级、命名空间、策略（覆盖/合并/忽略）
- 可回滚：每一步装配都有幂等检查与反向操作
示例（module.yaml）
name: po-approval
version: 1.3.0
dependsOn:
- user
- workflow@>=2.1
order: [model, view, hook]
guards:
tenantSelector: ["region==EMEA"]
9. 典型落地场景
-
多业务线的差异表单
- 用“字段重写 + 视图替换”实现 B2B 与零售两套表单，同步复用校验 Hook。
-
合规化审计
- 在“后置扩展点”统一落审计日志，接入“持久层 SPI”发送到冷存。
-
跨地域税则
- 覆盖
calculateTax函数，在租户维度启用差异化策略。
- 覆盖
-
活动期临时字段
- 通过“临时继承”与“租户选择器”在活动期注入派生字段，活动结束即回收。
-
替换存储底座
- 基于 “StorageSPI” 从本地盘切换到对象存储，无需业务改动。
10. 工程化与治理
- 版本与灰度：模块语义化版本 + 兼容性检查；按租户/环境灰度装配。
- 隔离性：命名空间、权限最小化；动作与 Hook 执行的资源限额。
- 可观测性：对每个扩展点输出指标/日志/追踪，如
hook.duration、override.count。 - 安全：Hook 的输入输出做 Schema 校验；SPI 提供沙箱/白名单。
- 稳定性：扩展点默认要幂等；提供熔断/降级与开关管理。
- 开发体验：热重载、扩展点可视化、冲突检测与一键回滚。
11. 心智模型：三板斧
- 先装配，后编码：能用元数据/编排解决的，优先不用代码。
- 优先 Hook，慎用 Override：Hook 可叠加且更安全，Override 只在语义确实需要替换时使用。
- API→SPI 的下沉路径：当应用层扩展不够用，再通过 SPI 下沉到底座。
Oinone 把“可扩展”做成了一套从 UI 到模型、从函数到生命周期、再到平台内核的完整方法论。通过 API 生命周期扩展 + 平台 SPI 扩展 两条通道，叠加 字段/函数重写、Hook/AOP、扩展点 与 主题/视图/路由/动作 等颗粒化插拔，既能支撑快速装配，又能承载深度定制。最终让开发者只写差异，让系统在复杂业务下稳定演进。
