组合模块
从 `vef.Run(...)` 开始,让 FX 组装配置、数据库、ORM、中间件、安全、存储、MCP 与应用服务。
FX 装配、资源驱动 API 与内置基础设施
围绕显式资源、类型化处理器和源码可见的默认行为来构建 Go 服务,而不是依赖隐藏在脚手架后的黑盒约定。
心智模型
顺着运行时的形状来理解 VEF 最容易:组合模块、注册资源,然后交给 API 引擎去分发操作。
从 `vef.Run(...)` 开始,让 FX 组装配置、数据库、ORM、中间件、安全、存储、MCP 与应用服务。
通过 `api.NewRPCResource(...)` 或 `api.NewRESTResource(...)` 定义接口,再用 `vef.ProvideAPIResource(...)` 注册。
把 `fiber.Ctx`、`orm.DB`、Principal、Logger、Params、Meta、Storage、Event、Cron 直接注入处理器,而不是手写胶水层。
核心能力
这些能力会最早出现在真实项目里,而且都能直接在当前源码树中找到对应实现。
RPC 和 REST 都是一级资源类型;每个操作都显式携带认证、超时、限流、审计和版本控制。
创建、更新、删除、分页、树查询、导入导出、批量操作与 Hook 都能通过类型化 builder 组合出来。
基于 Bun,提供审计模型、事务辅助、搜索标签、分页能力,以及面向企业场景的默认行为。
支持 Bearer、Signature 与公开接口,并能配合 RBAC 权限检查与请求级数据权限解析。
认证、存储、Schema 检查、监控与 MCP 都能以内置资源和中间件的形式直接使用。
扩展点按 FX group 显式组织:API 资源、应用中间件、CQRS 行为、参数解析器与 MCP provider。
建议入口
这些页面是理解 VEF 应用结构以及核心 API 用法的最快路径。