SuperAPI AI 工具集

react-webapp

前端与建站

查看项目

更新于 10-16 07:18

技能介绍

用途:在平台上构建 React SPA。技术栈为 Vite + TypeScript,构建为静态文件,由原生 nginx:alpine 提供服务;镜像在各环境字节一致,API URL、OIDC 配置、开关等按环境值在请求时通过 window.env 注入,而非构建时。

主要能力与流程:按 Layout 脚手架;先写 src/env.ts,再由各依赖的 OpenAPI 契约生成 src/generated/,然后写 src/api.ts 与页面。验证命令:npm install、npx tsc --noEmit、npm run build,构建脚本为 tsc --noEmit && vite build,退出码 0 即通过;不要运行 npm audit 或 npm audit fix。

关键约束:运行时配置而非构建时,平台挂载 /env-config.js 填充 window.env,不要生成或提交该文件;import.meta.env.VITE_、process.env.REACT_APP_、NEXT_PUBLIC_* 与 .env 均不适用。键名固定:API_BASE_URL、<UPSTREAM>_URL、<NAME>URL、<DEP>*(OIDC)等,缺失键应抛错而非默认空值。应用服务在主机根路径,不要设置 base;仅静态 nginx,无 proxy_pass、无 /oidc/ 块、无 envsubst。若声明 auth 依赖,需加 src/auth.ts 并附加 Bearer 令牌。客户端契约优先,用 openapi-typescript 生成类型并经 openapi-fetch 调用,提交 src/generated/。

限制:资料未提供收费、价格、平台支持范围等信息。