feat(架构): 完善基础架构设计

Makefile

@@ -3,9 +3,25 @@
 # 应用信息
 APP_NAME := tyapi-server
 VERSION := 1.0.0
-BUILD_TIME := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
-GIT_COMMIT := $(shell git rev-parse --short HEAD)
-GO_VERSION := $(shell go version | awk '{print $$3}')
+
+# 检测操作系统
+ifeq ($(OS),Windows_NT)
+    # Windows 环境
+    BUILD_TIME := $(shell powershell -Command "Get-Date -Format 'yyyy-MM-ddTHH:mm:ssZ'")
+    GIT_COMMIT := $(shell powershell -Command "try { git rev-parse --short HEAD } catch { 'dev' }")
+    GO_VERSION := $(shell go version)
+    MKDIR := mkdir
+    RM := del /f /q
+    RMDIR := rmdir /s /q
+else
+    # Unix 环境
+    BUILD_TIME := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ")
+    GIT_COMMIT := $(shell git rev-parse --short HEAD 2>/dev/null || echo 'dev')
+    GO_VERSION := $(shell go version | awk '{print $$3}')
+    MKDIR := mkdir -p
+    RM := rm -f
+    RMDIR := rm -rf
+endif
 
 # 构建参数
 LDFLAGS := -ldflags "-X main.version=$(VERSION) -X main.commit=$(GIT_COMMIT) -X main.date=$(BUILD_TIME)"
@@ -32,58 +48,132 @@ DOCKER_LATEST := $(APP_NAME):latest
 help:
 	@echo "TYAPI Server Makefile"
 	@echo ""
-	@echo "使用方法: make [目标]"
+	@echo "Usage: make [target]"
 	@echo ""
-	@echo "可用目标:"
-	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  %-20s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+	@echo "Development Basics:"
+	@echo "  help                 Show this help message"
+	@echo "  setup                Setup development environment"
+	@echo "  deps                 Install dependencies"
+	@echo "  fmt                  Format code"
+	@echo "  lint                 Lint code"
+	@echo "  test                 Run tests"
+	@echo "  coverage             Generate test coverage report"
+	@echo ""
+	@echo "Build & Compile:"
+	@echo "  build                Build application"
+	@echo "  build-prod           Build production version"
+	@echo "  build-all            Cross compile for all platforms"
+	@echo "  clean                Clean build files"
+	@echo ""
+	@echo "Run & Manage:"
+	@echo "  dev                  Run in development mode"
+	@echo "  run                  Run compiled application"
+	@echo "  migrate              Run database migration"
+	@echo "  version              Show version info"
+	@echo "  health               Run health check"
+	@echo ""
+	@echo "Docker Containers:"
+	@echo "  docker-build         Build Docker image"
+	@echo "  docker-build-prod    Build production Docker image"
+	@echo "  docker-push-prod     Push image to registry"
+	@echo "  docker-run           Run Docker container"
+	@echo "  docker-stop          Stop Docker container"
+	@echo ""
+	@echo "Production Environment:"
+	@echo "  deploy-prod          Deploy to production"
+	@echo "  prod-up              Start production services"
+	@echo "  prod-down            Stop production services"
+	@echo "  prod-logs            View production logs"
+	@echo "  prod-status          Check production status"
+	@echo ""
+	@echo "Development Environment:"
+	@echo "  services-up          Start dev dependencies"
+	@echo "  services-down        Stop dev dependencies"
+	@echo "  services-update      Update dev dependencies (rebuild & restart)"
+	@echo "  dev-up               Alias for services-up"
+	@echo "  dev-down             Alias for services-down"
+	@echo "  dev-update           Alias for services-update"
+	@echo ""
+	@echo "Tools & Utilities:"
+	@echo "  env                  Create .env file from template"
+	@echo "  logs                 View application logs"
+	@echo "  docs                 Generate API documentation"
+	@echo "  bench                Run performance benchmark"
+	@echo "  race                 Run race condition detection"
+	@echo "  security             Run security scan"
+	@echo "  mock                 Generate mock data"
+	@echo ""
+	@echo "CI/CD Pipeline:"
+	@echo "  ci                   Run complete CI pipeline"
+	@echo "  release              Run complete release pipeline"
 
-## 安装依赖
+## Install dependencies
 deps:
-	@echo "安装依赖..."
+	@echo "Installing dependencies..."
 	$(GOMOD) download
 	$(GOMOD) tidy
 
-## 代码格式化
+## Format code
 fmt:
-	@echo "格式化代码..."
+	@echo "Formatting code..."
 	$(GOFMT) ./...
 
-## 代码检查
+## Lint code
 lint:
-	@echo "代码检查..."
+	@echo "Linting code..."
+ifeq ($(OS),Windows_NT)
+	@where golangci-lint >nul 2>&1 && golangci-lint run || echo "golangci-lint not installed, skipping lint check"
+else
 	@if command -v golangci-lint >/dev/null 2>&1; then \
 		golangci-lint run; \
 	else \
-		echo "golangci-lint 未安装，跳过代码检查"; \
+		echo "golangci-lint not installed, skipping lint check"; \
 	fi
+endif
 
-## 运行测试
+## Run tests
 test:
-	@echo "运行测试..."
+	@echo "Running tests..."
+ifeq ($(OS),Windows_NT)
+	$(GOTEST) -v -coverprofile=coverage.out ./...
+else
 	$(GOTEST) -v -race -coverprofile=coverage.out ./...
+endif
 
-## 生成测试覆盖率报告
+## Generate test coverage report
 coverage: test
-	@echo "生成覆盖率报告..."
+	@echo "Generating coverage report..."
 	$(GOCMD) tool cover -html=coverage.out -o coverage.html
-	@echo "覆盖率报告已生成: coverage.html"
+	@echo "Coverage report generated: coverage.html"
 
-## 构建应用 (开发环境)
+## Build application (development)
 build:
-	@echo "构建应用..."
+	@echo "Building application..."
+ifeq ($(OS),Windows_NT)
+	@if not exist "$(BUILD_DIR)" mkdir "$(BUILD_DIR)"
+else
 	@mkdir -p $(BUILD_DIR)
+endif
 	$(GOBUILD) $(LDFLAGS) -o $(BUILD_DIR)/$(APP_NAME) $(MAIN_PATH)
 
-## 构建生产版本
+## Build production version
 build-prod:
-	@echo "构建生产版本..."
+	@echo "Building production version..."
+ifeq ($(OS),Windows_NT)
+	@if not exist "$(BUILD_DIR)" mkdir "$(BUILD_DIR)"
+else
 	@mkdir -p $(BUILD_DIR)
+endif
 	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD) $(LDFLAGS) -a -installsuffix cgo -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PATH)
 
-## 交叉编译
+## Cross compile
 build-all:
-	@echo "交叉编译..."
+	@echo "Cross compiling..."
+ifeq ($(OS),Windows_NT)
+	@if not exist "$(BUILD_DIR)" mkdir "$(BUILD_DIR)"
+else
 	@mkdir -p $(BUILD_DIR)
+endif
 	# Linux AMD64
 	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD) $(LDFLAGS) -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PATH)
 	# Linux ARM64
@@ -95,147 +185,323 @@ build-all:
 	# Windows AMD64
 	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GOBUILD) $(LDFLAGS) -o $(BUILD_DIR)/$(APP_NAME)-windows-amd64.exe $(MAIN_PATH)
 
-## 运行应用
+## Run application
 run: build
-	@echo "启动应用..."
+	@echo "Starting application..."
 	./$(BUILD_DIR)/$(APP_NAME)
 
-## 开发模式运行 (热重载)
+## Run in development mode
 dev:
-	@echo "开发模式启动..."
-	@if command -v air >/dev/null 2>&1; then \
-		air; \
-	else \
-		echo "air 未安装，使用普通模式运行..."; \
-		$(GOCMD) run $(MAIN_PATH); \
-	fi
+	@echo "Starting development mode..."
+	$(GOCMD) run $(MAIN_PATH)
 
-## 运行数据库迁移
+## Run database migration
 migrate: build
-	@echo "运行数据库迁移..."
+	@echo "Running database migration..."
 	./$(BUILD_DIR)/$(APP_NAME) -migrate
 
-## 显示版本信息
+## Show version info
 version: build
-	@echo "版本信息:"
+	@echo "Version info:"
 	./$(BUILD_DIR)/$(APP_NAME) -version
 
-## 健康检查
+## Health check
 health: build
-	@echo "执行健康检查..."
+	@echo "Running health check..."
 	./$(BUILD_DIR)/$(APP_NAME) -health
 
-## 清理构建文件
+## Clean build files
 clean:
-	@echo "清理构建文件..."
+	@echo "Cleaning build files..."
 	$(GOCLEAN)
-	rm -rf $(BUILD_DIR)
-	rm -f coverage.out coverage.html
+ifeq ($(OS),Windows_NT)
+	@if exist "$(BUILD_DIR)" $(RMDIR) "$(BUILD_DIR)" 2>nul || echo ""
+	@if exist "coverage.out" $(RM) "coverage.out" 2>nul || echo ""
+	@if exist "coverage.html" $(RM) "coverage.html" 2>nul || echo ""
+else
+	$(RMDIR) $(BUILD_DIR) 2>/dev/null || true
+	$(RM) coverage.out coverage.html 2>/dev/null || true
+endif
 
-## 创建 .env 文件
+## Create .env file
 env:
+ifeq ($(OS),Windows_NT)
+	@if not exist ".env" ( \
+		echo Creating .env file from production template... && \
+		copy .env.production .env && \
+		echo .env file created, please modify configuration as needed \
+	) else ( \
+		echo .env file already exists \
+	)
+else
 	@if [ ! -f .env ]; then \
-		echo "创建 .env 文件..."; \
-		cp env.example .env; \
-		echo ".env 文件已创建，请根据需要修改配置"; \
+		echo "Creating .env file from production template..."; \
+		cp .env.production .env; \
+		echo ".env file created, please modify configuration as needed"; \
 	else \
-		echo ".env 文件已存在"; \
+		echo ".env file already exists"; \
 	fi
+endif
 
-## 设置开发环境
+## Setup development environment
 setup: deps env
-	@echo "设置开发环境..."
-	@echo "1. 依赖已安装"
-	@echo "2. .env 文件已创建"
-	@echo "3. 请确保 PostgreSQL 和 Redis 正在运行"
-	@echo "4. 运行 'make migrate' 创建数据库表"
-	@echo "5. 运行 'make dev' 启动开发服务器"
+	@echo "Setting up development environment..."
+	@echo "1. [OK] Dependencies installed"
+	@echo "2. [OK] .env file created from production template"
+	@echo "3. [TODO] Please edit .env file and set your configuration"
+	@echo "4. [NEXT] Run 'make services-up' to start PostgreSQL + Redis"
+	@echo "5. [NEXT] Run 'make migrate' to create database tables"
+	@echo "6. [NEXT] Run 'make dev' to start development server"
+	@echo ""
+	@echo "Tip: Use 'make help' to see all available commands"
 
-## 构建 Docker 镜像
+## Build Docker image
 docker-build:
-	@echo "构建 Docker 镜像..."
+	@echo "Building Docker image..."
 	docker build -t $(DOCKER_IMAGE) -t $(DOCKER_LATEST) .
 
-## 运行 Docker 容器
+## Build production Docker image with registry
+docker-build-prod:
+	@echo "Building production Docker image..."
+	docker build \
+		--build-arg VERSION=$(VERSION) \
+		--build-arg COMMIT=$(GIT_COMMIT) \
+		--build-arg BUILD_TIME=$(BUILD_TIME) \
+		-t docker-registry.tianyuanapi.com/tyapi-server:$(VERSION) \
+		-t docker-registry.tianyuanapi.com/tyapi-server:latest \
+		.
+
+## Push Docker image to registry
+docker-push-prod:
+	@echo "Pushing Docker image to production registry..."
+	docker push docker-registry.tianyuanapi.com/tyapi-server:$(VERSION)
+	docker push docker-registry.tianyuanapi.com/tyapi-server:latest
+
+## Deploy to production
+deploy-prod:
+	@echo "Deploying to production environment..."
+ifeq ($(OS),Windows_NT)
+	@if exist "scripts\\deploy.sh" ( \
+		bash scripts/deploy.sh $(VERSION) \
+	) else ( \
+		echo "Deploy script not found" \
+	)
+else
+	@if [ -f scripts/deploy.sh ]; then \
+		./scripts/deploy.sh $(VERSION); \
+	else \
+		echo "Deploy script not found"; \
+	fi
+endif
+
+## Start production services
+prod-up:
+	@echo "Starting production services..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.prod.yml" ( \
+		docker-compose -f docker-compose.prod.yml up -d \
+	) else ( \
+		echo docker-compose.prod.yml not found \
+	)
+else
+	@if [ -f docker-compose.prod.yml ]; then \
+		docker-compose -f docker-compose.prod.yml up -d; \
+	else \
+		echo "docker-compose.prod.yml not found"; \
+	fi
+endif
+
+## Stop production services
+prod-down:
+	@echo "Stopping production services..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.prod.yml" ( \
+		docker-compose -f docker-compose.prod.yml down \
+	) else ( \
+		echo docker-compose.prod.yml not found \
+	)
+else
+	@if [ -f docker-compose.prod.yml ]; then \
+		docker-compose -f docker-compose.prod.yml down; \
+	else \
+		echo "docker-compose.prod.yml not found"; \
+	fi
+endif
+
+## View production logs
+prod-logs:
+	@echo "Viewing production logs..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.prod.yml" ( \
+		docker-compose -f docker-compose.prod.yml logs -f \
+	) else ( \
+		echo docker-compose.prod.yml not found \
+	)
+else
+	@if [ -f docker-compose.prod.yml ]; then \
+		docker-compose -f docker-compose.prod.yml logs -f; \
+	else \
+		echo "docker-compose.prod.yml not found"; \
+	fi
+endif
+
+## Check production status
+prod-status:
+	@echo "Checking production status..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.prod.yml" ( \
+		docker-compose -f docker-compose.prod.yml ps \
+	) else ( \
+		echo docker-compose.prod.yml not found \
+	)
+else
+	@if [ -f docker-compose.prod.yml ]; then \
+		docker-compose -f docker-compose.prod.yml ps; \
+	else \
+		echo "docker-compose.prod.yml not found"; \
+	fi
+endif
+
+## Run Docker container
 docker-run:
-	@echo "运行 Docker 容器..."
+	@echo "Running Docker container..."
 	docker run -d --name $(APP_NAME) -p 8080:8080 --env-file .env $(DOCKER_LATEST)
 
-## 停止 Docker 容器
+## Stop Docker container
 docker-stop:
-	@echo "停止 Docker 容器..."
+	@echo "Stopping Docker container..."
 	docker stop $(APP_NAME) || true
 	docker rm $(APP_NAME) || true
 
-## 推送 Docker 镜像
-docker-push:
-	@echo "推送 Docker 镜像..."
-	docker push $(DOCKER_IMAGE)
-	docker push $(DOCKER_LATEST)
-
-## 启动开发依赖服务 (Docker Compose)
+## Start development dependencies (Docker Compose)
 services-up:
-	@echo "启动开发依赖服务..."
+	@echo "Starting development dependencies..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.dev.yml" ( \
+		docker-compose -f docker-compose.dev.yml up -d \
+	) else ( \
+		echo docker-compose.dev.yml not found \
+	)
+else
 	@if [ -f docker-compose.dev.yml ]; then \
 		docker-compose -f docker-compose.dev.yml up -d; \
 	else \
-		echo "docker-compose.dev.yml 不存在"; \
+		echo "docker-compose.dev.yml not found"; \
 	fi
+endif
 
-## 停止开发依赖服务
+## Stop development dependencies
 services-down:
-	@echo "停止开发依赖服务..."
+	@echo "Stopping development dependencies..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.dev.yml" ( \
+		docker-compose -f docker-compose.dev.yml down \
+	) else ( \
+		echo docker-compose.dev.yml not found \
+	)
+else
 	@if [ -f docker-compose.dev.yml ]; then \
 		docker-compose -f docker-compose.dev.yml down; \
 	else \
-		echo "docker-compose.dev.yml 不存在"; \
+		echo "docker-compose.dev.yml not found"; \
 	fi
+endif
 
-## 查看服务日志
+## Alias for dev-up (start development dependencies)
+dev-up: services-up
+
+## Alias for dev-down (stop development dependencies)
+dev-down: services-down
+
+## Update development dependencies (rebuild and restart)
+services-update:
+	@echo "Updating development dependencies..."
+ifeq ($(OS),Windows_NT)
+	@if exist "docker-compose.dev.yml" ( \
+		docker-compose -f docker-compose.dev.yml down && \
+		docker-compose -f docker-compose.dev.yml pull && \
+		docker-compose -f docker-compose.dev.yml up -d --build \
+	) else ( \
+		echo docker-compose.dev.yml not found \
+	)
+else
+	@if [ -f docker-compose.dev.yml ]; then \
+		docker-compose -f docker-compose.dev.yml down && \
+		docker-compose -f docker-compose.dev.yml pull && \
+		docker-compose -f docker-compose.dev.yml up -d --build; \
+	else \
+		echo "docker-compose.dev.yml not found"; \
+	fi
+endif
+
+## Alias for services-update
+dev-update: services-update
+
+## View application logs
 logs:
-	@echo "查看应用日志..."
+	@echo "Viewing application logs..."
+ifeq ($(OS),Windows_NT)
+	@if exist "logs\\app.log" ( \
+		powershell -Command "Get-Content logs\\app.log -Wait" \
+	) else ( \
+		echo "Log file does not exist" \
+	)
+else
 	@if [ -f logs/app.log ]; then \
 		tail -f logs/app.log; \
 	else \
-		echo "日志文件不存在"; \
+		echo "Log file does not exist"; \
 	fi
+endif
 
-## 生成 API 文档
+## Generate API documentation
 docs:
-	@echo "生成 API 文档..."
+	@echo "Generating API documentation..."
+ifeq ($(OS),Windows_NT)
+	@where swag >nul 2>&1 && swag init -g $(MAIN_PATH) -o docs/swagger || echo "swag not installed, skipping documentation generation"
+else
 	@if command -v swag >/dev/null 2>&1; then \
 		swag init -g $(MAIN_PATH) -o docs/swagger; \
 	else \
-		echo "swag 未安装，跳过文档生成"; \
+		echo "swag not installed, skipping documentation generation"; \
 	fi
+endif
 
-## 性能测试
+## Performance benchmark
 bench:
-	@echo "运行性能测试..."
+	@echo "Running performance benchmark..."
 	$(GOTEST) -bench=. -benchmem ./...
 
-## 内存泄漏检测
+## Race condition detection
 race:
-	@echo "运行竞态条件检测..."
+	@echo "Running race condition detection..."
 	$(GOTEST) -race ./...
 
-## 安全扫描
+## Security scan
 security:
-	@echo "运行安全扫描..."
+	@echo "Running security scan..."
+ifeq ($(OS),Windows_NT)
+	@where gosec >nul 2>&1 && gosec ./... || echo "gosec not installed, skipping security scan"
+else
 	@if command -v gosec >/dev/null 2>&1; then \
 		gosec ./...; \
 	else \
-		echo "gosec 未安装，跳过安全扫描"; \
+		echo "gosec not installed, skipping security scan"; \
 	fi
+endif
 
-## 生成模拟数据
+## Generate mock data
 mock:
-	@echo "生成模拟数据..."
+	@echo "Generating mock data..."
+ifeq ($(OS),Windows_NT)
+	@where mockgen >nul 2>&1 && echo "Generating mock data..." || echo "mockgen not installed, please install: go install github.com/golang/mock/mockgen@latest"
+else
 	@if command -v mockgen >/dev/null 2>&1; then \
-		echo "生成模拟数据..."; \
+		echo "Generating mock data..."; \
 	else \
-		echo "mockgen 未安装，请先安装: go install github.com/golang/mock/mockgen@latest"; \
+		echo "mockgen not installed, please install: go install github.com/golang/mock/mockgen@latest"; \
 	fi
+endif
 
 ## 完整的 CI 流程
 ci: deps fmt lint test build
@@ -243,4 +509,4 @@ ci: deps fmt lint test build
 ## 完整的发布流程
 release: ci build-all docker-build
 
-.PHONY: help deps fmt lint test coverage build build-prod build-all run dev migrate version health clean env setup docker-build docker-run docker-stop docker-push services-up services-down logs docs bench race security mock ci release 
+.PHONY: help deps fmt lint test coverage build build-prod build-all run dev migrate version health clean env setup docker-build docker-run docker-stop docker-push docker-build-prod docker-push-prod deploy-prod prod-up prod-down prod-logs prod-status services-up services-down services-update dev-up dev-down dev-update logs docs bench race security mock ci release