项目结构说明
目录结构概览
Go-ES 项目采用领域驱动设计（DDD）架构，目录结构清晰，各层次职责分明。以下是项目的主要目录结构：
go-es/
├── cmd/ # 应用程序入口
│ └── api/ # API 服务入口
├── config/ # 配置
├── domain/ # 领域层
│ ├── entity/ # 实体
│ ├── repository/ # 仓储接口
│ └── service/ # 领域服务
├── infrastructure/ # 基础设施层
│ ├── persistence/ # 持久化
│ ├── elasticsearch/ # ES 操作
│ └── repository/ # 仓储实现
├── interfaces/ # 接口层
│ ├── api/ # API
│ │ ├── handler/ # 处理器
│ │ ├── middleware/ # 中间件
│ │ └── router/ # 路由
│ └── dto/ # 数据传输对象
├── application/ # 应用层
│ └── service/ # 应用服务
├── docs/ # 文档
└── pkg/ # 公共包
└── utils/ # 工具函数各层详细说明
1. 领域层（Domain）
领域层是整个应用的核心，包含业务逻辑和规则，与技术实现细节无关。
实体（Entity）
domain/entity/ 目录包含核心业务实体，如 Product：
- 定义了产品的基本属性和行为
- 包含业务规则验证
- 提供实体转换方法
仓储接口（Repository Interface）
domain/repository/ 目录定义了仓储接口，为领域层提供数据访问抽象：
ProductRepository接口定义了产品数据的存取操作- 隔离了领域层与数据存储实现的依赖
领域服务（Domain Service）
domain/service/ 目录包含领域服务，处理不适合放在单个实体中的业务逻辑：
ProductService实现了产品相关的核心业务逻辑- 协调多个实体完成复杂业务场景
2. 应用层（Application）
应用层负责协调领域对象完成用户用例，是领域层与接口层之间的桥梁。
应用服务（Application Service）
application/service/ 目录包含应用服务：
ProductAppService处理产品相关的用户场景- 负责 DTO 与领域实体之间的转换
- 调用领域服务完成业务逻辑
3. 接口层（Interfaces）
接口层负责处理来自外部的请求，包括 API 接口、请求参数解析等。
处理器（Handler）
interfaces/api/handler/ 目录包含 API 处理器：
ProductHandler处理产品相关的 HTTP 请求- 解析请求参数和构造响应
- 调用应用服务完成操作
数据传输对象（DTO）
interfaces/dto/ 目录包含数据传输对象：
- 定义 API 请求和响应的数据结构
- 提供与领域实体之间的转换方法
路由（Router）
interfaces/api/router/ 目录设置 API 路由：
- 注册 API 路径与处理器的映射
- 应用中间件
中间件（Middleware）
interfaces/api/middleware/ 目录包含 HTTP 中间件：
- 实现请求预处理，如跨域处理、认证等
4. 基础设施层（Infrastructure）
基础设施层提供技术实现，支持上层业务逻辑的运行。
持久化（Persistence）
infrastructure/persistence/ 目录处理数据库连接：
- 提供数据库初始化和连接管理
- 实现表结构迁移
Elasticsearch 操作
infrastructure/elasticsearch/ 目录封装 Elasticsearch 操作：
EsClient提供基础的 ES 操作ProductIndexer实现产品索引管理
仓储实现（Repository Implementation）
infrastructure/repository/ 目录实现领域层定义的仓储接口：
ProductRepositoryImpl实现了产品仓储接口- 负责数据库操作和 Elasticsearch 索引同步
5. 入口与配置
应用入口
cmd/api/main.go 是应用程序的入口点：
- 初始化配置、数据库和 Elasticsearch
- 构建依赖注入链
- 启动 HTTP 服务
配置
config/ 目录处理应用配置：
- 定义配置结构和加载逻辑
- 提供配置访问接口
文件关系图
以下是核心组件的关系图，展示了各部分如何协同工作：
│
├── HTTP请求 ────────────┐
│ ↓
├── Router ────────► Handler ────────┐
│ │ │
├── Middleware ◄────────┘ │
│ ↓
├── DTO ◄───────► Application Service ◄───┐
│ │ │
│ ↓ │
├── Entity ◄────── Domain Service │
│ │ │
│ ↓ │
├── Repository Interface │
│ ↑ │
│ │ │
├── Repository Implementation ────────────┘
│ │
│ ↓
├── Database / Elasticsearch
│这种分层架构使得代码更易于理解、测试和维护，同时也便于团队协作开发。