SuperAPI AI 工具集

ssd-frontend-setup

前端与建站

查看项目

更新于 10-15 23:41

技能介绍

用途:用于新建 SSD 前端项目时的工程规范,包括 React 目录结构、TypeScript/React 命名规范、需要安装的工具与标准包清单等咨询场景。

主要能力:明确 SSD 前端以 React + TypeScript(TSX)为主,必须基于 SSD 的 GitHub 标准 Template,禁止自建空项目;文件须为 UTF-8 编码,行尾用 CRLF;仅可使用指定包,额外包需先向上级请示;新文件须立即遵循 Style Guide。

工具:VS Code 扩展包括 Auto Close Tag、Auto Rename Tag、ESLint、Path Intellisense、Prettier、ES7+ React/Redux/React-Native snippets、Error Lens;浏览器扩展包括 Redux Devtools、React Developer Tools。.prettierrc 配置为 trailingComma es5、tabWidth 4、semi true、singleQuote false、printWidth 120、editorconfig false、eslintIntegration true、stylelintIntegration true、endOfLine crlf。

标准包:Vite 4.3.9、React 18.2、@mui/material ^5.13.4、@tanstack/react-query ^4.29.17、axios 1.4.0、formik 2.4.1、react-redux 8.0.7、redux-persist 6.0.0、react-router-dom 6.12.1、oidc-client-ts 2.2.4、dayjs 1.11.8、@mui/x-date-pickers ^6.9.0、sweetalert2 11.7.12;按需使用 zod、zod-formik-adapter、apexcharts、pdfmake、html-to-image。

结构与命名:src/app 下含 layout、api、modules、routes、redux;api 分为 NSwag 生成的 *.client.ts、自写 *.ts 与 *.query.ts。module 名首字母大写,页面以 Page 结尾,首个页面为 IndexPage.tsx。

TypeScript/JavaScript:PascalCase 用于类、接口、类型、枚举、组件函数、TSX;camelCase 用于变量、参数、函数、方法、属性;CONSTANT_CASE 用于全局常量与枚举值。2 个单词以上缩写全大写(DTO、API、HTML),单单词缩写用 PascalCase(Id、Doc、Cust);禁止 any,改用 unknown 或明确类型;禁止 {},改用 Record<string, T>。React 文件用 .tsx,组件文件名 PascalCase,文件夹主组件用 index.tsx。路由全小写,用 - 代替空格,无标点,不超过 70 字符。

环境变量:先在 vite-env.d.ts 的 ImportMetaEnv 中声明(名称须以 VITE_ 开头),再在 .env、.env.production、.env.uat、.env.dev、.env.local 中配置,并建议通过 /src/const.ts 导出使用;不得直接使用 import.meta.env。

RPA 与自动化测试:标准表单组件须正常工作,Button 加 name 属性,Label、Typography 加 name,动态渲染组件加 id。

限制:资料未提供模板下载地址、完整安装命令及具体收费信息;使用范围与审批要求以 SSD 内部规定为准。