huang
6fc90abeb6
主要变更: 1. 新增 cmd/api/docs.go 实现文档自动生成逻辑 2. 修改 cmd/api/main.go 在服务启动时调用文档生成 3. 重构 cmd/gendocs/main.go 提取生成函数 4. 更新 .gitignore 忽略自动生成的 openapi.yaml 5. 新增 Makefile 支持 make docs 命令 6. OpenSpec 框架更新和变更归档 功能特性: - 服务启动时自动生成 OpenAPI 文档到项目根目录 - 保留独立的文档生成工具 (make docs) - 生成失败时记录错误但不影响服务启动 - 所有代码已通过 openspec validate --strict 验证 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
39 lines
710 B
Makefile
39 lines
710 B
Makefile
.PHONY: run build test lint clean docs
|
|
|
|
# Go parameters
|
|
GOCMD=go
|
|
GOBUILD=$(GOCMD) build
|
|
GOCLEAN=$(GOCMD) clean
|
|
GOTEST=$(GOCMD) test
|
|
GOGET=$(GOCMD) get
|
|
BINARY_NAME=bin/junhong-cmp
|
|
MAIN_PATH=cmd/api/main.go
|
|
WORKER_PATH=cmd/worker/main.go
|
|
WORKER_BINARY=bin/junhong-worker
|
|
|
|
all: test build
|
|
|
|
build:
|
|
$(GOBUILD) -o $(BINARY_NAME) -v $(MAIN_PATH)
|
|
$(GOBUILD) -o $(WORKER_BINARY) -v $(WORKER_PATH)
|
|
|
|
test:
|
|
$(GOTEST) -v ./...
|
|
|
|
clean:
|
|
$(GOCLEAN)
|
|
rm -f $(BINARY_NAME)
|
|
rm -f $(WORKER_BINARY)
|
|
|
|
run:
|
|
$(GOBUILD) -o $(BINARY_NAME) -v $(MAIN_PATH)
|
|
./$(BINARY_NAME)
|
|
|
|
run-worker:
|
|
$(GOBUILD) -o $(WORKER_BINARY) -v $(WORKER_PATH)
|
|
./$(WORKER_BINARY)
|
|
|
|
# Generate OpenAPI documentation
|
|
docs:
|
|
$(GOCMD) run cmd/gendocs/main.go
|