first commit

2026-07-18 21:00:26 +08:00
commit 14722be770
105 changed files with 25004 additions and 0 deletions
@@ -0,0 +1,19 @@
+# ADR-001：采用 FastAPI 作为服务框架
+
+## 状态
+已接受
+
+## 背景
+原版本以脚本为主，不利于前端接入、统一 API 文档和长期演进。
+
+## 决策
+使用 FastAPI 作为应用入口，核心能力全部通过 REST endpoint 暴露，并保留清晰的 service/provider/repository 分层。
+
+## 结果
+- 自动生成 Swagger 和 ReDoc；
+- 前端可直接调用；
+- 输入输出由 Pydantic 校验；
+- 已通过统一认证中间件保护业务 API；后续仍可增加任务队列和前端界面。
+
+## 不做的事情
+当前不引入微服务、消息队列或分布式任务系统，避免超出当前核心需求。