xiong
30fd159041
- Introduced Vite configuration files (vite.config.js, vite.config.ts, vite.config.d.ts) for the React frontend. - Configured server proxy settings for API endpoints. - Added Vitest configuration files (vitest.config.js, vitest.config.ts, vitest.config.d.ts) for testing. - Updated architecture overview to reflect the separation of the platform admin frontend into its own React project. - Modified quickstart documentation to guide users on starting the platform admin frontend.
1.1 KiB
1.1 KiB
Tiku 平台管理前端
独立部署的 React + TypeScript 平台管理端。业务接口契约只从 Tiku.Api 实时 OpenAPI 文档生成，不依赖旧静态前端的接口适配代码。
本地开发
首次使用先安装前端依赖：
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 进程，前端仍应独立构建和部署。
接口契约
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 地址；同域反向代理时可以留空。