# CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在本项目中提供操作指南。

## 项目概述

这是一个 Vue 2 微前端应用，使用 `w-vue-middle` 作为主框架。作为组件服务平台，可作为子应用挂载到主系统中。

## 常用命令

```bash
# 安装依赖
yarn install

# 开发服务器 (端口 8984)
yarn serve

# 生产构建
yarn build

# 代码检查与修复
yarn lint
```

## 架构

### 微前端结构
- 使用 `w-vue-middle` 作为主框架和微前端注册 (`src/main.js`)
- 导出生命周期函数: `bootstrap`、`mount`、`unmount`、`update`
- 可通过 single-spa-vue 作为子应用挂载

### 核心目录
- `src/components/` - 可复用 Vue 组件 (glSqlEditor, gptMarkIt, winIcon, winTitle)
- `src/views/` - 页面组件，按服务分类 (systemService, home, gpt 等)
- `src/layouts/` - 布局组件 (BasicLayout)
- `src/router/` - 路由配置 (router.config.js 定义路由)
- `src/store/` - Vuex 状态管理
- `src/api/` - API 服务 (axios 实例, appService, userService, translateService)
- `src/utils/` - 工具函数 (appAnalysis, htmlToPdf, modalDrag)
- `src/i18n/` - 国际化文件
- `static/` - 构建时复制的静态资源

### 状态管理
- Vuex 存于 `src/store/index.js` - 管理 router、themes、userInfo
- 使用 w-vue-middle 的 `$storage` 访问 localStorage

### API 层
- Axios 实例位于 `src/api/axios.js`，配置了拦截器
- 服务模块位于 `src/api/appService/`、`src/api/userService/`、`src/api/translateService/`

### UI 库
- Ant Design Vue (`ant-design-vue`)
- win-design (内部库，安装命令: `npm i win-design --registry http://172.16.9.242:8081/repository/npm-group/`)
- VXE Table 用于数据表格

### 路由
- 路由定义在 `src/router/router.config.js`
- 使用 `BasicLayout` 作为主布局组件
- 支持路由级代码分割，使用动态 import

### 视图模块
- `src/views/systemService/` - 系统服务 (机构、用户、角色、应用、参数、字典等)
- `src/views/home/` - 首页组件
- `src/views/gpt/` - WiNEX 数灵功能
- `src/views/skCoc/` - COC 组件

## 开发注意事项

- 开发服务器代理配置在 `vue.config.js` - API 请求转发到各后端服务
- 生产环境输出路径: `/webui-basis`
- 使用 svg-sprite-loader 处理 SVG 图标
- Monaco 编辑器支持，自定义 webpack 配置
- 生产环境启用 Gzip 压缩
- win-design 为内部 UI 库，安装命令: `npm i win-design --registry http://172.16.9.242:8081/repository/npm-group/`
- static 目录下的文件会在构建时复制到 dist/static