# Tiku 平台管理前端

独立部署的 React + TypeScript 平台管理端。业务接口契约只从 `Tiku.Api` 实时 OpenAPI 文档生成，不依赖旧静态前端的接口适配代码。

## 本地开发

首次使用先安装前端依赖：

```bash
npm install
```

之后从仓库根目录运行 `dotnet run --project Tiku.Api`，ASP.NET Core 的开发代理会自动启动本工程的 Vite 服务。访问 <http://localhost:5173>。开发服务器默认代理 `/api` 到 `http://localhost:5090`；需要修改目标时设置 `VITE_DEV_API_TARGET`。

也可以在本目录单独执行 `npm run dev`，便于只调试前端。Production 环境不会由 API 启动 Node 进程，前端仍应独立构建和部署。

## 接口契约

```bash
OPENAPI_URL=http://localhost:5090/openapi/v1.json npm run generate:api
```

生成结果包括完整 OpenAPI TypeScript 类型，以及全部 `/api/platform-admin/**`、`/api/backoffice/platform/**` 接口的页面操作元数据。`npm test` 会验证每个后端平台接口都已归入且只归入一个页面组。

生产部署通过 `VITE_API_BASE_URL` 指定 API 地址；同域反向代理时可以留空。