41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# ghb-base 前端（ghb-frontend）
|
||
|
||
> 这是 **ghb-base 基础框架**的前端（管理后台）。以后每个新系统都基于本框架开发。
|
||
> 基于 JeecgBoot 3.9.2 前端精简。
|
||
|
||
## 技术栈
|
||
- Vue 3 + Vite + TypeScript
|
||
- Ant Design Vue
|
||
- 包管理器：**pnpm**
|
||
|
||
## 环境要求
|
||
- Node.js 18+、pnpm
|
||
|
||
## 第一次启动
|
||
```bash
|
||
pnpm install
|
||
pnpm dev
|
||
```
|
||
- 开发服务器由 Vite 启动；接口走代理到后端（默认后端 `http://localhost:8080/ghb`）。
|
||
- **先启动后端再启动前端。** 后端地址在 `.env.development` / `vite.config.ts` 代理配置里调整。
|
||
|
||
## 构建
|
||
```bash
|
||
pnpm build # 生产构建
|
||
pnpm preview # 预览构建产物
|
||
pnpm lint # ESLint
|
||
pnpm stylelint # 样式检查
|
||
```
|
||
|
||
## 新人必读（开始写代码前全部读完）
|
||
1. **`CLAUDE.md`**（本目录）/ base 根 `../CLAUDE.md` — AI 开发总纲
|
||
2. **`../.claude/frontend.md`** — 样式/命名/注释/组件铁律/页面模板/检查表
|
||
3. **`../.claude/contract.md`** — 接口契约与返回格式
|
||
4. **`../contract/`** — 接口契约（独立 git submodule），调接口前先看
|
||
|
||
## 铁律速记（详见 .claude/frontend.md）
|
||
- 颜色/字号/间距禁硬编码，走主题变量/全局类（无裸 `color:#`、无裸字号）
|
||
- 组件、命名按规范；类名别过长
|
||
- 接口返回判成败看统一返回格式的 code，不依赖 message 文案
|
||
- 改后端接口 → 先更新 `contract/`，前后端同步
|