README

# 前端规范

> **版本**：v1.0.0  
> **更新日期**：2026-01-11
> **维护者**：前端团队

---

## &#128193; 文档结构

| 文档 | 说明 | 行数 |
|------|------|------|
| [核心规范.md](./核心规范.md) | 禁止修改清单、主题配置原理、颜色规范、布局规范 | ~200 |
| [组件配置手册.md](./组件配置手册.md) | 57 个组件的标准配置，含正确/错误示例 | ~1800 |
| [页面模板.md](./页面模板.md) | 列表页面、弹窗表单、详情页面开发模板 | ~280 |
| [问题排查指南.md](./问题排查指南.md) | 主题问题、样式问题、常见陷阱 | ~70 |
| [TypeScript最佳实践.md](./TypeScript最佳实践.md) | 类型检查流程、Git Hooks、编码实践 | ~150 |

---

## &#128640; 快速导航

### 按场景查找

| 场景 | 推荐文档 |
|------|---------|
| 新建页面，找模板 | [页面模板.md](./页面模板.md) |
| 使用组件，查配置 | [组件配置手册.md](./组件配置手册.md) |
| 主题/样式出问题 | [问题排查指南.md](./问题排查指南.md) |
| 了解红线规则 | [核心规范.md](./核心规范.md) |
| TypeScript 类型检查 | [TypeScript最佳实践.md](./TypeScript最佳实践.md) |

### 按需求查找组件

| 需求 | 推荐组件 | 文档位置 |
|------|---------|---------|
| 输入文字 | Input | 组件配置手册.1 |
| 选择选项 | Select | 组件配置手册.2 |
| 选择日期 | DatePicker | 组件配置手册.3 |
| 弹窗 | Modal | 组件配置手册.33 |
| 表单 | Form | 组件配置手册.55 |
| 数据列表 | Table | 组件配置手册.16 |

---

## ⚠️ 核心红线

### 禁止修改的文件

| 类型 | 文件路径 | 原因 |
|------|---------|------|
| 主导航栏 | `ProLayoutWrapper.tsx` | 全局复用 |
| 全局Provider | `AntdAppProvider.tsx` | 主题配置 |
| 主题修复CSS | `dark-theme-fix.css` | 已统一配置 |
| 全局布局 | `layout.tsx` | 根布局 |

### 禁止的操作

| 操作 | 原因 |
|------|------|
| `style={{ background: '#fff' }}` | 破坏暗色主题 |
| `className="bg-white text-black"` | 破坏暗色主题 |
| 硬编码颜色 `#07C160` | 无法适配主题 |

---

## &#128279; 相关文档

- [前端颜色与组件规范](./前端颜色与组件规范.md) - 颜色配置详解
- [前端页面模板](./前端页面模板.md) - 更多页面模板
- [类型安全规范体系](../类型安全规范体系.md) - TypeScript 类型规范