34 lines
918 B
Markdown
34 lines
918 B
Markdown
# AdCloud Server
|
||
|
||
面向开发者和 coding agent 的广告云埋点与广告推送后端。使用 FastAPI 开发，依赖和虚拟环境统一由 **uv** 管理。
|
||
|
||
当前为开发脚手架，提供健康检查与 API 文档；埋点与广告推送功能待实现。
|
||
|
||
## 开发
|
||
|
||
```sh
|
||
uv sync
|
||
uv run uvicorn adcloud_server.main:app --reload --host 127.0.0.1 --port 8000
|
||
```
|
||
|
||
- 健康检查：`http://localhost:8000/health`
|
||
- API 文档：`http://localhost:8000/docs`
|
||
- OpenAPI：`http://localhost:8000/openapi.json`
|
||
|
||
默认允许来自 `http://localhost:3000`、`http://localhost:5173` 的浏览器请求。
|
||
通过环境变量配置逗号分隔的允许来源：
|
||
|
||
```sh
|
||
CORS_ORIGINS=https://your-frontend.example uv run uvicorn adcloud_server.main:app
|
||
```
|
||
|
||
## 检查
|
||
|
||
```sh
|
||
uv run pytest
|
||
uv run ruff check .
|
||
uv run ruff format --check .
|
||
```
|
||
|
||
提交 `uv.lock`，在其他电脑使用 `uv sync --locked` 复现依赖。
|