# Lyzsys 项目文档导航

欢迎使用 Lyzsys 企业级后台管理系统！本文档导航将帮助您快速找到所需的文档资源。

---

## 📚 文档目录

### 🚀 快速开始

| 文档 | 说明 | 适用人群 |
|-----|------|---------|
| [项目介绍](./项目介绍.md) | 项目概述、技术栈、核心特性 | 所有人 |
| [部署指南](./部署指南.md) | 环境搭建、安装部署、配置说明 | 运维、开发 |
| [常见问题](./常见问题.md) | FAQ、故障排查、解决方案 | 所有人 |

### 🏗️ 架构设计

| 文档 | 说明 | 适用人群 |
|-----|------|---------|
| [架构设计](./架构设计.md) | 系统架构、技术选型、设计思路 | 架构师、开发 |
| [数据库设计](./数据库设计.md) | 数据库表结构、字段说明、ER图 | 开发、DBA |

### 💻 开发文档

| 文档 | 说明 | 适用人群 | 重要程度 |
|-----|------|---------|---------|
| [后端开发文档](./后端开发文档.md) | 后端开发指南、核心功能、代码示例 | 后端开发 | ⭐⭐⭐⭐⭐ |
| [前端开发文档](./前端开发文档.md) | 前端开发指南、组件使用、最佳实践 | 前端开发 | ⭐⭐⭐⭐⭐ |
| [编码规范](./编码规范.md) | 命名规范、代码规范、最佳实践 | 所有开发 | ⭐⭐⭐⭐⭐ |
| [新模块开发指南](./新模块开发指南.md) | 新模块开发完整教程（含 Demo 示例） | 所有开发 | ⭐⭐⭐⭐⭐ |

---

## 🎯 按场景查找文档

### 场景 1：我是新加入的开发人员

**推荐阅读顺序**：
1. [项目介绍](./项目介绍.md) - 了解项目概况
2. [部署指南](./部署指南.md) - 搭建开发环境
3. [编码规范](./编码规范.md) - 熟悉编码规范 ⚠️ **必读**
4. [后端开发文档](./后端开发文档.md) 或 [前端开发文档](./前端开发文档.md) - 根据岗位选择
5. [新模块开发指南](./新模块开发指南.md) - 学习如何开发新功能

### 场景 2：我要开发一个新的业务模块

**推荐步骤**：
1. **必读** → [编码规范](./编码规范.md) - 了解命名规范和菜单结构规范
2. **必读** → [新模块开发指南](./新模块开发指南.md) - 按照步骤创建模块
3. **参考** → Demo 模块代码（`lyzsys-module-demo`）- 作为实现参考
4. **参考** → [后端开发文档](./后端开发文档.md) - 查阅具体技术实现
5. **参考** → [前端开发文档](./前端开发文档.md) - 前端页面开发

### 场景 3：我遇到了问题

**查找方式**：
1. [常见问题](./常见问题.md) - 先查看 FAQ
2. [后端开发文档](./后端开发文档.md) - 查看附录的常见问题
3. GitHub Issues - 搜索或提交问题

### 场景 4：我要了解系统架构

**推荐阅读**：
1. [项目介绍](./项目介绍.md) - 快速了解
2. [架构设计](./架构设计.md) - 详细架构说明
3. [数据库设计](./数据库设计.md) - 数据模型
4. [后端开发文档](./后端开发文档.md) - 核心功能实现

---

## 📖 重点文档说明

### 🔥 编码规范（必读）

**文件**：[编码规范.md](./编码规范.md)

**核心内容**：
- ⚠️ **驼峰命名规范**：第一个单词不能只有一个字母（重要！）
- 📋 **菜单结构规范**：业务菜单优先，系统管理放最后
- 🏗️ **代码结构规范**：Controller-Service-DAL 三层架构
- 💾 **数据库设计规范**：表名、字段名、索引规范
- 🔌 **API 接口规范**：RESTful 风格、统一响应格式
- 🎨 **前端开发规范**：组件规范、权限控制

**为什么重要**：
- 避免 MyBatis Plus 字段映射问题
- 提高代码可读性和可维护性
- 统一团队开发风格

### 🚀 新模块开发指南（必读）

**文件**：[新模块开发指南.md](./新模块开发指南.md)

**核心内容**：
- ✅ 完整的开发流程（从数据库设计到前端页面）
- 📝 逐步操作指南（包含完整代码示例）
- 🎯 以 **Demo 模块**为参考案例
- ✔️ 开发检查清单

**包含内容**：
1. 创建后端模块（Maven 配置、实体类、Service、Controller）
2. 创建前端页面（API 接口、列表页、表单组件）
3. 配置菜单权限（一级菜单、二级菜单、按钮权限）
4. 常见问题解决

### 📦 Demo 示例模块

**模块位置**：
- 后端：`lyzsys_backend/lyzsys-module-demo`
- 前端：`lyzsys-ui-admin/src/views/demo/project`
- SQL：`lyzsys_backend/sql/mysql/demo_*.sql`

**功能展示**：
- ✅ 项目管理的完整 CRUD 功能
- ✅ 分页查询、批量删除、Excel 导出
- ✅ 遵循所有编码规范的标准实现
- ✅ 前后端完整联调示例

**如何使用**：
1. 查看 Demo 模块的代码结构
2. 参考其命名方式和代码风格
3. 复制并修改为自己的业务模块
4. 详细步骤见 [新模块开发指南](./新模块开发指南.md)

---

## 📂 文档结构

```
doc/
├── README.md                  # 📖 本文档（文档导航）
├── 编码规范.md                # ⭐⭐⭐⭐⭐ 命名规范、开发规范
├── 新模块开发指南.md          # ⭐⭐⭐⭐⭐ 新模块开发教程
├── 后端开发文档.md            # 后端开发指南
├── 前端开发文档.md            # 前端开发指南
├── 项目介绍.md                # 项目概述
├── 架构设计.md                # 架构设计文档
├── 数据库设计.md              # 数据库设计文档
├── 部署指南.md                # 部署运维文档
└── 常见问题.md                # FAQ 文档
```

---

## 🔑 关键规范速查

### 驼峰命名规范

⚠️ **核心原则**：第一个单词不能只有一个字母

```java
// ✅ 正确
projectId, projectName, establishDate

// ❌ 错误
pId, pName, eDate
```

**详细说明**：[编码规范 - 命名规范](./编码规范.md#1-命名规范)

### 菜单结构规范

```
1-90.  业务菜单（优先展示）
98.    系统管理
99.    基础设施
```

**详细说明**：[编码规范 - 菜单结构规范](./编码规范.md#2-菜单结构规范)

### 权限标识格式

```
{模块名}:{业务}:{操作}

示例：
demo:project:query
demo:project:create
demo:project:update
```

**详细说明**：[编码规范 - 菜单配置规范](./编码规范.md#23-权限标识规范)

---

## 🛠️ 开发工具推荐

### 后端开发
- **IDE**：IntelliJ IDEA（推荐）
- **JDK**：1.8+
- **Maven**：3.6+
- **数据库工具**：Navicat、DataGrip

### 前端开发
- **IDE**：VSCode、WebStorm
- **Node.js**：16+
- **包管理器**：npm、pnpm

### 版本管理
- **Git 客户端**：Git、SourceTree、GitKraken
- **代码托管**：GitHub、GitLab

---

## 📞 获取帮助

### 文档问题
- 查看 [常见问题](./常见问题.md)
- 搜索 GitHub Issues

### 技术支持
- 提交 GitHub Issue
- 联系开发团队

### 参与贡献
- Fork 项目
- 提交 Pull Request
- 完善文档

---

## 📝 文档更新记录

| 日期 | 版本 | 更新内容 | 作者 |
|-----|------|---------|------|
| 2024-01 | v1.0 | 创建文档导航，新增编码规范和新模块开发指南 | 开发团队 |
| 2024-01 | v1.0 | 添加 Demo 示例模块说明 | 开发团队 |

---

## 🎉 开始使用

如果您是第一次使用 Lyzsys，建议按以下顺序阅读文档：

1. ✅ [项目介绍](./项目介绍.md) - 5分钟了解项目
2. ✅ [部署指南](./部署指南.md) - 搭建开发环境
3. ✅ [编码规范](./编码规范.md) - **必读**，熟悉编码规范
4. ✅ [新模块开发指南](./新模块开发指南.md) - 开发第一个模块
5. ✅ [后端开发文档](./后端开发文档.md) / [前端开发文档](./前端开发文档.md) - 深入学习

祝您使用愉快！🚀

---

**文档维护**：Lyzsys 开发团队
**最后更新**：2024年
**文档版本**：v1.0
