# AdCloud · 开发者控制台

管理应用接入、广告位与流量收益。 React + TypeScript + Vite 独立前端项目。

## 启动

需要 Node.js 20.19+ 或 22.12+。

```sh
npm ci
cp .env.example .env
npm run dev
```

开发地址：`http://localhost:5174`。通过 `VITE_API_BASE_URL` 配置共享后端地址，默认 `http://localhost:8000`。
`VITE_` 配置会进入浏览器代码，不用于保存服务器密钥。

```sh
npm run typecheck
npm run build
npm run preview
```

## 当前范围

提供导航、空数据概览、内存中的应用草稿预览，以及共享后端的 `/health` 状态检查。
草稿刷新即清空；尚未实现登录、持久化、广告发布或业务报表。界面中的 `—` 表示尚无真实数据。

后续业务范围：应用与广告位管理、SDK / coding agent 接入文档、流量及收益报表。

## 项目边界

- `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
```

## 事件字典管理

新增“事件字典”页面，连接真实后端：浏览 33 个标准事件的必选/可选字段、查看标准特征窗口与上限、加载应用事件、保存 JSON 规则草稿、示例试算、发布、停用和历史版本回滚。
当前尚未接入客户账号登录。平台受控后端调用 POST /v1/registry/apps 创建应用后，将对应 management_key 提供给管理操作者；该页面凭据仅存当前内存，不使用平台 SERVICE_TOKEN，不写入 localStorage。
正式管理操作使用 HTTPS；当前公网 HTTP 后端只用于合成测试数据。VITE_API_BASE_URL 设置连接后端，页面也可手动输入测试地址。CORS 需允许控制台实际来源。
规则试算按钮会先保存当前草稿，再执行无埋点/特征写入的试算；发布按钮会保存并产生不可变规则版本。事件参数结构修改需创建新的 event_version。
本页已接入注册表业务 API，其他收入、应用草稿与登录页面仍是原有脚手架。本仓库没有新增公网前端部署。