# LTD-Admin-Naive

**Repository Path**: ltd_1/ltd-admin-naive

## Basic Information

- **Project Name**: LTD-Admin-Naive
- **Description**: LTD-Admin-Naive 是一个简洁高效的后台管理系统，基于现代前端框架，提供直观易用的界面和强大的管理功能，适用于各类企业级应用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# LTD-Admin-Naive

基于 Vue 3 + TypeScript + Naive UI 的后台管理快速开发框架

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![Vue 3](https://img.shields.io/badge/Vue-3-42b883.svg)](https://vuejs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6.svg)](https://www.typescriptlang.org/)
[![Naive UI](https://img.shields.io/badge/Naive%20UI-2.x-18a058.svg)](https://www.naiveui.com/)

[English](./README.en.md) | 中文

</div>

## 项目简介

LTD-Admin-Naive 是一个面向快速开发的后台管理系统前端框架，提供开箱即用的布局、认证、权限、CRUD 等基础能力，开发者只需关注业务逻辑。

## 特性

- **Vue 3 + TypeScript** — 最新技术栈，类型安全
- **Naive UI** — 企业级 UI 组件库
- **SCSS 样式体系** — 完整的设计令牌、变量系统、公共工具类
- **多页签 + KeepAlive** — 页签切换状态完整保留
- **RBAC 权限模型** — 菜单 + 按钮级别权限控制
- **SSE 流式传输** — 支持 POST 请求的 Server-Sent Events
- **WebWorker 线程池** — 耗时计算从主线程剥离
- **TipTap 富文本编辑器** — 可扩展的富文本编辑能力
- **多类型文件预览** — PDF / Word / Excel / PPT / 图片 / 音视频
- **键盘快捷键** — Ctrl+K 命令面板，提升操作效率
- **国际化** — vue-i18n 多语言支持（中/英）
- **Mock 数据** — 开发环境独立调试
- **代码规范** — Prettier + Husky + commitlint

## 快速开始

### 环境要求

- Node.js >= 18
- pnpm >= 8

### 安装与运行

```bash
# 克隆项目
git clone https://gitee.com/ltd_1/ltd-admin-naive.git

# 进入项目目录
cd ltd-admin-naive

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev
```

### 构建部署

```bash
# 构建生产版本
pnpm build

# 预览构建结果
pnpm preview
```

## 目录结构

```
src/
├── api/                  # API 请求层
│   ├── modules/          # 按业务模块拆分
│   └── request.ts        # Axios 封装
├── components/           # 全局公共组件（LTD- 前缀）
│   └── common/           # 通用业务组件
├── composables/          # 组合式函数
├── layouts/              # 布局系统
│   ├── DefaultLayout.vue # 后台主布局
│   ├── BlankLayout.vue   # 空白布局
│   └── components/       # 布局子组件
├── router/               # 路由配置
├── stores/               # Pinia 状态管理
├── styles/               # SCSS 样式体系
│   ├── index.scss        # 样式入口
│   ├── reset.scss        # 重置样式
│   ├── variables.scss    # CSS 变量
│   ├── theme.scss        # 主题色
│   ├── naive-overrides.scss  # Naive UI 覆盖
│   └── common.scss       # 公共工具类（ltd- 前缀）
├── types/                # 类型定义
├── utils/                # 工具函数
├── workers/              # WebWorker 脚本
├── views/                # 页面视图
├── App.vue
└── main.ts
```

## 技术栈

| 技术 | 版本 | 用途 |
|------|------|------|
| Vue | 3.x | 前端框架 |
| TypeScript | 5.x | 类型系统 |
| Vite | 5.x | 构建工具 |
| Naive UI | 2.x | UI 组件库 |
| Pinia | 2.x | 状态管理 |
| Vue Router | 4.x | 路由管理 |
| SCSS | - | 样式预处理 |
| Axios | 1.x | HTTP 客户端 |
| @vueuse/core | 10.x | 组合式工具集 |
| TipTap | 2.x | 富文本编辑器 |
| ECharts | 5.x | 数据可视化 |
| vue-i18n | 11.x | 国际化 |

## 参与贡献

欢迎任何形式的贡献！请阅读 [贡献指南](./CONTRIBUTING.md) 了解详情。

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'feat: add amazing feature'`)
4. 推送到远程 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

## 社区行为准则

本项目遵循 [行为准则](./CODE_OF_CONDUCT.md)，请在参与贡献前阅读。

## 安全问题

如发现安全漏洞，请查看 [安全政策](./SECURITY.md) 了解上报流程。

## 更新日志

详见 [CHANGELOG.md](./CHANGELOG.md)。

## 许可证

[MIT License](./LICENSE) © 2025-2026 LTD