# lexi-ide-frontend

**Repository Path**: rajan_admin/lexi-ide-frontend

## Basic Information

- **Project Name**: lexi-ide-frontend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dp-vue3-app

基于 Vue 3 + TypeScript + Tailwind CSS 的项目模板，遵循组合式 API 与分层架构规范。

## 技术栈

- Vue 3 + `<script setup>`
- TypeScript
- Vite 6
- Tailwind CSS v4
- Vue Router 4
- Pinia
- Axios

## 开发

```bash
pnpm install
pnpm dev
```

## 脚本

| 命令 | 说明 |
|------|------|
| `pnpm dev` | 启动开发服务器 |
| `pnpm build` | 构建生产版本 |
| `pnpm preview` | 预览构建结果 |
| `pnpm type-check` | TypeScript 类型检查 |
| `pnpm lint` | ESLint 检查并修复 |

## 目录结构

```
src/
├── views/          # 页面（路由视图）
├── components/     # 全局通用组件
├── features/       # 业务模块（示例：user）
├── composables/    # 全局组合式函数
├── services/       # Service 统一导出
├── stores/         # Pinia 全局状态
├── utils/          # 工具函数
├── lib/http/       # HTTP 客户端封装
├── router/         # 路由
└── types/          # 全局类型
```

## 路由（自动注册）

路由基于 `src/views/**/*View.vue` **自动生成**，无需在 `routes.ts` 中手动 import 每个页面。

### 新增页面

1. 在 `views/` 下创建 `XxxView.vue`（如 `views/order/OrderListView.vue`）
2. 在 `router/route-meta.ts` 中补充 meta（path、title、导航等，可选）

```ts
// router/route-meta.ts
OrderList: {
  path: 'orders',        // 不填则按目录自动生成
  title: '订单列表',
  navLabel: '订单列表',
  navOrder: 3,
},
```

### 约定

| 规则 | 说明 |
|------|------|
| 文件命名 | `XxxView.vue`，路由 name 为 `Xxx` |
| 404 页面 | 固定放在 `views/error/NotFoundView.vue` |
| 侧边栏 | 配置了 `navLabel` 的路由自动出现在导航中 |
| 懒加载 | 通过 `import.meta.glob` 自动懒加载 |

## 分层约定

- **View / Component** 不直接调用 Service
- 业务逻辑通过 **Composable** 编排
- API 请求统一在 **Service** 层
- 跨页面状态使用 **Pinia Store**

## Cursor AI 规则

项目内置 `.cursor/rules/`，脚手架创建后自动生效：

| 规则文件 | 说明 |
|----------|------|
| `dp-vue3-core.mdc` | 核心原则与目录结构（始终生效） |
| `dp-vue3-vue-components.mdc` | SFC / TSX 组件规范 |
| `dp-vue3-layering.mdc` | 业务分层与 feature 模块 |
| `dp-vue3-service-store.mdc` | Service、HTTP、Pinia |
| `dp-vue3-style-ts.mdc` | 样式、路由、TypeScript |

完整规范文档见仓库 `docs/development-standards.md`。