签入版本

This commit is contained in:
小蚂蚁云
2026-10-25 17:24:27 +08:00
parent 48911cc08f
commit fdbeae092a
1010 changed files with 30682 additions and 95274 deletions
@@ -8,7 +8,7 @@
| 文件 | 行数规模 | 职责 |
|------|---------|------|
| `api/v1/example.go` | ~200 行 | 全部 Req/Res + gmeta 注解 |
| `api/v1/example.go` | ~200 行 | 全部 Req/Res + gmeta 标签 |
| `internal/controller/example.go` | ~90 行 | 薄层透传 |
| `internal/service/example.go` | ~75 行 | 手维护接口三件套 |
| `internal/logic/example.go` | ~200 行 | ModuleSpec 声明 + 委托 + 扩展方法 |
@@ -96,4 +96,4 @@ func (c *CXxx) 方法名(ctx context.Context, req *v1.XxxReq) (res *v1.XxxRes, e
| `CUpload` | multipart 上传(`*ghttp.UploadFile` + `p:"file"` 标签) |
| `CGenerator` | 工具类,Preview/Generate/BatchGenerate |
控制器不区分"标准/特殊"写法——统一薄层透传,差异全部体现在请求结构体的 gmeta 注解上。
控制器不区分"标准/特殊"写法——统一薄层透传,差异全部体现在请求结构体的 gmeta 标签上。
@@ -11,7 +11,7 @@
```text
1. 设计符合项目规范的业务表(统一审计列 / del_flag / uk_* 唯一索引 / 注释枚举)
2. 产出并理解 dao/entity/do 四件(gf gen dao 或生成器)
3. 编写 api/v1 请求响应结构体与 gmeta 注解(权限/日志/OpenAPI 一体)
3. 编写 api/v1 请求响应结构体与 gmeta 标签(权限/日志/OpenAPI 一体)
4. 用 ModuleSpec 声明式基座实现逻辑层(筛选/字典/文件字段/钩子)
5. 完成薄层控制器 + 手维护 service 接口 + 路由注册
6. 配置权限节点并完成前端 querySchemas/columns/api 三件套联调
@@ -35,7 +35,7 @@
○ internal/dao/internal/example.go dao 内部实现(勿手改)
○ internal/model/entity/example.go 实体
○ internal/model/do/example.go 数据对象 DO
★ api/v1/example.go 全部 Req/Res 结构体 + gmeta 注解
★ api/v1/example.go 全部 Req/Res 结构体 + gmeta 标签
★ internal/controller/example.go 薄层控制器(转发 service)
★ internal/service/example.go 手维护接口 + Register + 取用函数
★ internal/logic/example.go 业务实现(ModuleSpec 声明 + 方法委托)
@@ -1,7 +1,7 @@
# 3.7 服务注册与路由
:::tip 概述
本项目没有传统的路由表文件逐条登记——路由由 Bind 反射绑定从 gmeta 注解自动生成。手工需要维护的只有两处:service 接口文件(手维护)和 router.go 的一行 Bind 注册(生成器自动写入)。
本项目没有传统的路由表文件逐条登记——路由由 Bind 反射绑定从 gmeta 标签自动生成。手工需要维护的只有两处:service 接口文件(手维护)和 router.go 的一行 Bind 注册(生成器自动写入)。
:::
## service 接口文件(手维护,真实代码摘自 internal/service/example.go)
@@ -95,7 +95,7 @@ Bind(s, new(controller.CXxx)) 对每个导出方法:
→ 调用业务方法 → response.Ok/Fail 信封写出
```
::: tip 注解即事实
::: tip 标签即事实
权限校验与操作日志共用同一份路由元数据(meta 表),gmeta 标签是唯一真相。不存在"代码改了忘改路由表/权限表"的可能。
:::