# 前端开发指南

> 本项目的前端开发最佳实践。

---

## 概述

本目录包含前端开发指南。用项目的具体规范填充每个文件。

---

## 指南索引

| 指南 | 描述 | 状态 |
|-------|-------------|--------|
| [目录结构](./directory-structure.md) | 模块组织和文件布局 | 待填写 |
| [组件指南](./component-guidelines.md) | 组件模式、props、组合 | 待填写 |
| [Hook 指南](./hook-guidelines.md) | 自定义 hooks、数据获取模式 | 待填写 |
| [状态管理](./state-management.md) | 本地状态、全局状态、服务端状态 | 待填写 |
| [质量指南](./quality-guidelines.md) | 代码标准、禁止的模式 | 待填写 |
| [类型安全](./type-safety.md) | 类型模式、验证 | 待填写 |

---

## 如何填写这些指南

对于每个指南文件：

1. 记录项目的**实际规范**（不是理想状态）
2. 包含来自代码库的**代码示例**
3. 列出**禁止的模式**及其原因
4. 添加团队犯过的**常见错误**

目标是帮助 AI 助手和新团队成员理解 YOUR 项目是如何工作的。

---

**语言**：所有文档应使用**英文**编写。
