Wild Workouts Go DDD 示例项目教程

项目的目录结构及介绍

Wild Workouts Go DDD 示例项目的目录结构如下：

wild-workouts-go-ddd-example/
├── api
│   ├── grpc
│   └── http
├── build
├── cmd
│   └── wild-workouts-go-ddd-example
├── configs
├── deployments
├── docs
├── internal
│   ├── app
│   ├── domain
│   │   ├── model
│   │   └── service
│   ├── infrastructure
│   │   ├── database
│   │   ├── firebase
│   │   ├── grpc
│   │   ├── http
│   │   └── metrics
│   ├── ports
│   │   ├── grpc
│   │   └── http
│   └── shared
│       ├── config
│       ├── logger
│       └── metrics
├── migrations
├── pkg
├── scripts
└── test

目录结构介绍

• api: 包含 gRPC 和 HTTP API 的定义。
• build: 用于构建项目的脚本和配置文件。
• cmd: 包含项目的入口文件。
• configs: 项目的配置文件。
• deployments: 部署相关的文件和脚本。
• docs: 项目文档。
• internal: 项目的核心逻辑，包括应用层、领域层、基础设施层和端口层。
  • app: 应用层逻辑。
  • domain: 领域层逻辑，包括模型和服务。
  • infrastructure: 基础设施层，包括数据库、Firebase、gRPC、HTTP 和指标监控。
  • ports: 端口层，包括 gRPC 和 HTTP 端口。
  • shared: 共享组件，包括配置、日志和指标监控。
• migrations: 数据库迁移文件。
• pkg: 公共库和工具。
• scripts: 项目脚本。
• test: 测试相关文件。

项目的启动文件介绍

项目的启动文件位于 cmd/wild-workouts-go-ddd-example 目录下，主要文件是 main.go。

main.go 文件介绍

main.go 文件是项目的入口文件，负责初始化配置、依赖注入和启动服务。以下是 main.go 文件的主要内容：

package main

import (
    "log"
    "os"

    "github.com/ThreeDotsLabs/wild-workouts-go-ddd-example/internal/app"
    "github.com/ThreeDotsLabs/wild-workouts-go-ddd-example/internal/shared/config"
    "github.com/ThreeDotsLabs/wild-workouts-go-ddd-example/internal/shared/logger"
)

func main() {
    cfg, err := config.LoadConfig()
    if err != nil {
        log.Fatalf("Failed to load config: %v", err)
    }

    logger := logger.NewLogger(cfg.LogLevel)

    app, err := app.NewApplication(cfg, logger)
    if err != nil {
        logger.Fatal("Failed to create application", err)
    }

    if err := app.Run(); err != nil {
        logger.Fatal("Application failed", err)
    }
}

主要功能

• 加载配置：通过 config.LoadConfig() 函数加载配置文件。
• 初始化日志：通过 logger.NewLogger(cfg.LogLevel) 初始化日志组件。
• 创建应用实例：通过 app.NewApplication(cfg, logger) 创建应用实例。
• 启动应用：通过 app.Run() 启动应用。

项目的配置文件介绍

项目的配置文件位于 configs 目录下，主要文件是 config.yaml。

config.yaml 文件介绍

config.yaml 文件包含了项目的各种配置信息，例如数据库连接、日志级别、服务端口等。以下是 config.yaml 文件的一个示例：

server:
  port: 8080

database:
  url: "postgres://user:password@localhost:5432/dbname"

logger:
  level: "info"

firebase:
  project_id: "wild-