35 lines
1.6 KiB
Markdown
35 lines
1.6 KiB
Markdown
---
|
||
tags: []
|
||
date created: 星期日, 十二月 7日 2025, 11:44:41 中午
|
||
date modified: 星期日, 十二月 7日 2025, 11:57:43 中午
|
||
---
|
||
|
||
```plaintext
|
||
your-api-project/
|
||
├── cmd/
|
||
│ └── server/
|
||
│ ├── main.go # 调用 wire 注入，获取 app 实例，执行 app.Run()
|
||
│ └── wire.go # Wire 依赖注入
|
||
├── config/ # Viper 配置结构体
|
||
├── internal/
|
||
│ ├── api/ # (DTO层) 纯数据传输对象，无逻辑
|
||
│ │ ├── request/
|
||
│ │ └── response/
|
||
│ ├── controller/ # (接口层) 解析 request -> 调 service -> 组装 response
|
||
│ ├── service/ # (应用服务层) 编排业务逻辑，操作 Entity
|
||
│ ├── repository/ # (资源层) 负责 CRUD，屏蔽数据库差异
|
||
│ ├── entity/ # (领域层) 核心业务实体 (User, Article)，带 GORM tag
|
||
│ ├── router/ # (路由层) NewRouter() *gin.Engine
|
||
│ └── middleware/ # Gin 中间件
|
||
├── pkg/ # (基础设施层) 通用工具
|
||
│ ├── app/ # 统一响应封装 (Gin Result)
|
||
│ ├── auth/ # JWT 签发与解析
|
||
│ ├── hasher/ # 密码加密 (Argon2 / Bcrypt)
|
||
│ ├── logger/ # Zap 配置
|
||
│ └── timeutil/ # 时间处理工具
|
||
├── migrations/ # 数据库变更 SQL
|
||
├── docs/ # Swagger
|
||
├── go.mod
|
||
└── Makefile
|
||
```
|