test-frontend/README.md

ghb-base 前端（ghb-frontend）

这是 ghb-base 基础框架的前端（管理后台）。以后每个新系统都基于本框架开发。 基于 JeecgBoot 3.9.2 前端精简。

技术栈

• Vue 3 + Vite + TypeScript
• Ant Design Vue
• 包管理器：pnpm

环境要求

• Node.js 18+、pnpm

第一次启动

pnpm install
pnpm dev

• 开发服务器由 Vite 启动；接口走代理到后端（默认后端 http://localhost:8080/ghb）。
• 先启动后端再启动前端。 后端地址在 .env.development / vite.config.ts 代理配置里调整。

构建

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/，前后端同步