adcloud-developer-console/README.md

AdCloud · 开发者控制台

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

启动

需要 Node.js 20.19+ 或 22.12+。

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

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

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 目录运行：

CORS_ORIGINS=http://localhost:5173,http://localhost:5174 uv run uvicorn adcloud_server.main:app --reload