chenxin
3fbcd0437c
- Makefile：统一命令入口（backend/engine/docker/openapi/generate，含 make help） - backend：FastAPI + uv 最小工程，统一错误体（契约第 7 节）、ADR-015 平台 ID 生成与校验（uuid-utils）；pytest 7 项、ruff、mypy strict、启动冒烟全部通过 - engine：灵台引擎 C++23/CMake 骨架，按 Lingtai C ABI 契约实现 lingtai.h（13 个 HjStatus、版本协商、句柄表防二次释放、线程局部错误上下文）；doctest 5 用例通过，nm 验证仅导出 hj_* 符号 - openapi：OpenAPI 3.1 单一真源初始版（错误体/分页/Money/首批平台 ID/ContentBlock 全 21 类型/流事件 envelope），Redocly lint 0 错误、bundle 通过 - frontend：Next.js 最小骨架，openapi-typescript 生成 API 类型并通过 strict tsc - docker：hunjing-postgres（pgvector:17）compose；.env.example 与 config 示例 - ADR-025：登记测试与契约工具链（doctest/libFuzzer/Redocly/openapi-typescript/uuid-utils） - desktop：Tauri v2 占位与初始化说明（WP-10 启动）
73 lines
2.4 KiB
Makefile
73 lines
2.4 KiB
Makefile
# 默认目标：显示帮助
|
||
.DEFAULT_GOAL := help
|
||
|
||
# ===== 后端（Python / FastAPI，uv 管理） =====
|
||
|
||
.PHONY: backend-setup
|
||
backend-setup: ## 安装后端依赖（uv sync）
|
||
cd backend && uv sync
|
||
|
||
.PHONY: backend-dev
|
||
backend-dev: ## 启动后端开发服务（127.0.0.1:8000）
|
||
cd backend && uv run uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
|
||
|
||
.PHONY: backend-test
|
||
backend-test: ## 运行后端测试（pytest）
|
||
cd backend && uv run pytest
|
||
|
||
.PHONY: backend-lint
|
||
backend-lint: ## 后端静态检查（ruff + mypy）
|
||
cd backend && uv run ruff check . && uv run mypy app
|
||
|
||
# ===== 灵台引擎（C++23 / CMake） =====
|
||
|
||
.PHONY: engine-build
|
||
engine-build: ## 构建灵台引擎（CMake + Ninja/Makefile）
|
||
cmake -S engine -B engine/build -DCMAKE_BUILD_TYPE=Release && cmake --build engine/build
|
||
|
||
.PHONY: engine-test
|
||
engine-test: ## 运行灵台引擎测试（ctest）
|
||
cmake -S engine -B engine/build -DCMAKE_BUILD_TYPE=Debug && cmake --build engine/build && ctest --test-dir engine/build --output-on-failure
|
||
|
||
# ===== 数据库（PostgreSQL 统一，ADR-024） =====
|
||
|
||
.PHONY: docker-up
|
||
docker-up: ## 启动本地 PostgreSQL（docker compose）
|
||
docker compose -f docker/docker-compose.yml up -d
|
||
|
||
.PHONY: docker-down
|
||
docker-down: ## 停止本地 PostgreSQL
|
||
docker compose -f docker/docker-compose.yml down
|
||
|
||
.PHONY: backend-migrate
|
||
backend-migrate: ## 执行数据库迁移（Alembic upgrade head）
|
||
cd backend && uv run alembic upgrade head
|
||
|
||
# ===== 契约（OpenAPI 3.1 单一真源） =====
|
||
|
||
.PHONY: openapi-lint
|
||
openapi-lint: ## 校验 OpenAPI 契约（redocly lint + bundle）
|
||
npx --yes @redocly/cli@latest lint openapi/openapi.yaml --config openapi/redocly.yaml && npx --yes @redocly/cli@latest bundle openapi/openapi.yaml -o openapi/bundled.json
|
||
|
||
.PHONY: generate
|
||
generate: openapi-lint ## 生成代码（TypeScript 类型等）
|
||
cd frontend && npm run generate:api
|
||
|
||
# ===== 前端与桌面（Next.js / Tauri v2） =====
|
||
|
||
.PHONY: frontend-setup
|
||
frontend-setup: ## 安装前端依赖
|
||
cd frontend && npm install
|
||
|
||
.PHONY: frontend-dev
|
||
frontend-dev: ## 启动前端开发服务（127.0.0.1:3000）
|
||
cd frontend && npm run dev
|
||
|
||
# ===== 帮助 =====
|
||
|
||
.PHONY: help
|
||
help: ## 显示本帮助
|
||
@echo "Hunjing 统一命令入口（详见各目标 ## 说明）"
|
||
@echo
|
||
@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf " \033[36m%-16s\033[0m %s\n", $$1, $$2}'
|