46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# AdCloud · 广告商控制台
|
|
|
|
管理广告、投放计划与效果数据。 React + TypeScript + Vite 独立前端项目。
|
|
|
|
## 启动
|
|
|
|
需要 Node.js 20.19+ 或 22.12+。
|
|
|
|
```sh
|
|
npm ci
|
|
cp .env.example .env
|
|
npm run dev
|
|
```
|
|
|
|
开发地址：`http://localhost:5173`。通过 `VITE_API_BASE_URL` 配置共享后端地址，默认 `http://localhost:8000`。
|
|
`VITE_` 配置会进入浏览器代码，不用于保存服务器密钥。
|
|
|
|
```sh
|
|
npm run typecheck
|
|
npm run build
|
|
npm run preview
|
|
```
|
|
|
|
## 当前范围
|
|
|
|
提供导航、空数据概览、内存中的广告草稿预览，以及共享后端的 `/health` 状态检查。
|
|
草稿刷新即清空；尚未实现登录、持久化、广告发布或业务报表。界面中的 `—` 表示尚无真实数据。
|
|
|
|
后续业务范围：广告创建与审核、素材管理、预算及投放计划、投放报表。
|
|
|
|
## 项目边界
|
|
|
|
- `adcloud-advertiser-console`：广告商投放、预算和效果管理。
|
|
- `adcloud-developer-console`：开发者应用、广告位、接入和收益管理。
|
|
- `adcloud-server`：共享后端，统一负责身份认证、角色权限、埋点、广告投放和报表 API。
|
|
- `adcloud-react-sdk`：提供给第三方应用集成的 SDK。
|
|
|
|
两套控制台独立构建和部署。角色权限与数据隔离需要由后端校验。
|
|
本项目目前只调用 `/health`；后端业务接口未定义，之后可按 OpenAPI 生成共用管理 API 客户端。
|
|
|
|
后端默认 CORS 允许 3000、5173 端口。要同时运行两套控制台，在 `adcloud-server` 目录运行：
|
|
|
|
```sh
|
|
CORS_ORIGINS=http://localhost:5173,http://localhost:5174 uv run uvicorn adcloud_server.main:app --reload
|
|
```
|