用途:为 Go 后端 HTTP 传输层生成 Chi 路由实现,遵循模块化架构约定。
主要能力:生成路由文件 internal/modules/<module>/http/chi/router/<resource>_router.go;定义仅持有 handler 的结构体、返回指针的构造函数,以及接收 *chi.Server 的 Setup 方法;通过 server.Router() 注册路由。支持基础 CRUD、自定义动作、嵌套资源、带中间件的路由分组、多 handler 路由,以及 Fx 装配(fx.As(new(chi.Route)) 与 fx.ResultTags(group:"routes"))。
约定:路径统一以 /api/v1/ 前缀,资源名用复数名词,ID 用 :id,非 CRUD 动作用动词;HTTP 方法遵循 REST(GET/POST/PUT/PATCH/DELETE)。命名上结构体为 <Resource>Router,构造函数为 New<Resource>Router,文件为 <resource>_router.go。仅导入 bricks/pkg/http/server/chi 与 handler 包,handler 由构造函数注入,不添加冗余注释。
使用方式:创建路由文件、定义结构体与构造函数、实现 Setup 注册路由、在模块 fx.go 中添加 Fx 装配,最后运行 make lint 校验。
限制:资料未提供安装命令、收费、平台与效果信息;具体中间件与鉴权实现需按项目实际情况处理。