docs: 文档全面审查更新与规范集中化重构

docs/README.md

@@ -31,11 +31,11 @@ docs/
 
 ## 入口文档
 
-| 入口                              | 定位                                   |
-| --------------------------------- | -------------------------------------- |
-| [项目 README](../README.md)       | 项目整体介绍、快速开始、文档引导       |
-| [开发文档](development/README.md) | 开发入口、全局规则、常用命令、质量门禁 |
-| [用户文档](user/README.md)        | 使用、配置、部署、排障入口             |
+| 入口                              | 定位                                                     |
+| --------------------------------- | -------------------------------------------------------- |
+| [项目 README](../README.md)       | 项目整体介绍、快速开始、文档引导                         |
+| [开发文档](development/README.md) | 开发入口、**全部开发规范**、常用命令、质量门禁、专题索引 |
+| [用户文档](user/README.md)        | 使用、配置、部署、排障入口                               |
 
 ## 按任务阅读路径
 
@@ -54,28 +54,30 @@ docs/
 
 ## 文档归属矩阵
 
-| 变更类型                                                  | 默认更新位置                             |
-| --------------------------------------------------------- | ---------------------------------------- |
-| 项目定位、核心能力、快速开始、顶层文档导航                | `README.md`                              |
-| 文档路由、文档更新规则、文档归属矩阵                      | `docs/README.md`、`openspec/config.yaml` |
-| 开发入口、常用命令、质量门禁、全局工程规则、OpenSpec 约定 | `docs/development/README.md`             |
-| 架构边界、启动流程、运行时流程、前后端边界                | `docs/development/architecture.md`       |
-| 后端 API、配置加载、logger、helpers、类型规范、后端测试   | `docs/development/backend.md`            |
-| 前端技术栈、组件、样式、数据层、前端测试                  | `docs/development/frontend.md`           |
-| 构建、发布、脚本、前后端静态资源集成                      | `docs/development/release.md`            |
-| 快速开始、安装配置                                        | `docs/user/usage.md`                     |
-| YAML 配置、变量语法、server/storage/logging、JSON Schema  | `docs/user/config.md`                    |
-| 生产构建、可执行文件运行、运行时配置                      | `docs/user/deploy.md`                    |
-| 常见运行问题、配置校验、变量解析、构建失败                | `docs/user/troubleshoot.md`              |
+| 变更类型                                                 | 默认更新位置                             |
+| -------------------------------------------------------- | ---------------------------------------- |
+| 项目定位、核心能力、快速开始、顶层文档导航               | `README.md`                              |
+| 文档路由、文档更新规则、文档归属矩阵                     | `docs/README.md`、`openspec/config.yaml` |
+| 开发规范（全局规则、库优先级、类型规范、样式、测试等）   | `docs/development/README.md`             |
+| 开发入口、常用命令、质量门禁、目录边界、OpenSpec 约定    | `docs/development/README.md`             |
+| 架构边界、启动流程、运行时流程、前后端边界               | `docs/development/architecture.md`       |
+| 后端模块 API、工具函数索引、数据库 schema、AI 层实现     | `docs/development/backend.md`            |
+| 前端运行时代码结构、组件索引、页面组成、hooks/工具清单   | `docs/development/frontend.md`           |
+| 构建、发布、脚本、前后端静态资源集成                     | `docs/development/release.md`            |
+| 快速开始、安装配置                                       | `docs/user/usage.md`                     |
+| YAML 配置、变量语法、server/storage/logging、JSON Schema | `docs/user/config.md`                    |
+| 生产构建、可执行文件运行、运行时配置                     | `docs/user/deploy.md`                    |
+| 常见运行问题、配置校验、变量解析、构建失败               | `docs/user/troubleshoot.md`              |
 
 ## development 文档如何更新
 
 开发文档解释"如何实现和维护"。代码变更影响开发者理解、开发流程、测试方式或架构边界时，必须更新 `docs/development/` 对应文档。
 
 - 全局规则、常用命令、质量门禁、目录边界、OpenSpec 约定更新到 `docs/development/README.md`。
+- **全部开发规范**（全局规则、后端规范、前端通用规范、样式规范、测试规范）统一维护在 `docs/development/README.md`。
 - 架构图、启动链路、运行时流程、前后端边界更新到 `docs/development/architecture.md`。
-- 后端 API、配置加载、logger、helpers、类型规范和后端测试规范更新到 `docs/development/backend.md`。
-- 前端技术栈、组件边界、数据流、样式规则和前端测试规范更新到 `docs/development/frontend.md`。
+- 后端模块 API、工具函数索引、数据库 schema、AI 层实现、日志模块更新到 `docs/development/backend.md`。
+- 前端运行时代码结构、组件索引、页面组成、hooks/工具清单更新到 `docs/development/frontend.md`。
 - 构建、脚本和发布验证更新到 `docs/development/release.md`。
 - 不新增"杂项"开发文档；优先把内容放入上述最贴近的专题，确需新增专题时先更新本文档和 `openspec/config.yaml`。