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 启动）
28 lines
666 B
Python
28 lines
666 B
Python
"""FastAPI 应用工厂。"""
|
|
|
|
from fastapi import FastAPI
|
|
|
|
from app.core.config import get_settings
|
|
from app.core.errors import install_error_handlers
|
|
|
|
|
|
def create_app() -> FastAPI:
|
|
settings = get_settings()
|
|
app = FastAPI(
|
|
title="Hunjing API",
|
|
version="0.1.0",
|
|
# 公共契约位于 docs/contracts 与 openapi/；本服务 docs 仅供开发调试。
|
|
docs_url="/_dev/docs",
|
|
openapi_url="/_dev/openapi.json",
|
|
)
|
|
install_error_handlers(app)
|
|
|
|
@app.get("/healthz", tags=["ops"])
|
|
async def healthz() -> dict[str, str]:
|
|
return {"status": "ok", "env": settings.env}
|
|
|
|
return app
|
|
|
|
|
|
app = create_app()
|