扩展机制

扩展是可选包，用来增加横切能力或更高层的数据结构，同时保持 Oro 核心轻量。

db, err := oro.Open(oro.Config{
    Connections: map[string]oro.ConnectionConfig{
        "default": {Driver: sqlite.Open("app.db")},
    },
    Extensions: []oro.Extension{
        tenant.Extension(tenant.Fields("TenantID")),
        nestedset.Extension(),
    },
})

扩展能做什么

扩展可以接入明确的生命周期点：

查询链 Apply

查询链扩展统一通过 db.Use[T]().Apply(...) 组合，扩展包只提供行为对象，Where、With、OrderBy、分页、聚合等查询能力仍然复用核心 ModelQuery。

products, err := db.Use[Product]().
    Apply(translation.Locale("zh-CN")).
    Where("Status", "online").
    OrderByDesc("ID").
    Get(ctx)

children, err := db.Use[Category]().
    Apply(nestedset.DescendantsOf(root), nestedset.DefaultOrder()).
    Where("Status", "enabled").
    Get(ctx)

结构性业务服务仍保留在扩展包里，例如树形创建、移动、删除使用 nestedset.Use[Category](db)，因为这些不是普通查询条件。

扩展字段嵌入

部分扩展需要模型字段。Oro 通过标记过的匿名字段结构体支持这一点：

type Category struct {
    oro.Model
    nestedset.NodeFields

    Name string
}

nestedset.NodeFields 实现了 Oro 的嵌入字段标记，schema parser 会把其中导出的字段当成模型字段处理。这样扩展字段可以复用，也不需要 tag 或代码生成。

官方扩展