---
description: e-code 前后端开发文档渐进加载路由
---

# 开发文档路由

本文件是机器路由的人工说明，不承载完整规范。优先执行：

```bash
按本文技术域表选择目标领域 Skill；目标 Skill 使用自身检索脚本加载文档。
```

再通过对应领域 Skill 的 `search.mjs` 加载返回文档的摘要或目标章节。

## 1. 必须先判断

输出以下字段：

- `technicalDomain`: `frontend`、`backend`、`fullstack`、`unknown`
- `frontendFramework`: `react`、`vue`、`none`、`unknown`
- `scenarios`: 实际涉及的开发场景列表
- `documentsToLoad`: 本轮需要读取的文档

判断不清时先向用户确认，不得同时加载全部前后端文档。

## 2. 前端路由

技术域包含前端时，先读取：

- `../../frontend-development/references/baseline.md`

按场景追加：

| 场景 | 加载文档 |
|---|---|
| React、组件复写、组件替换、新页面 | `../../frontend-development/references/react.md` |
| `@weapp/ui` 组件选型、属性、事件、示例 | 使用 `$e10-ui-components` Skill |
| `@weapp/utils`、工具函数、SDK、跨应用加载、路由或运行环境能力 | 使用 `$e10-utils-knowledge` Skill |
| 用户明确要求 Vue | `../../frontend-development/references/vue.md` |
| 前端请求、请求/响应拦截 | `../../frontend-development/references/request-interceptor.md` |
| 前端代码不生效、报错、屏蔽定位 | `../../frontend-development/references/debugging.md` |

React 是默认前端路径。未明确 Vue 时，不加载 Vue 文档。

## 3. 后端路由

技术域包含后端时，先读取：

- `../../backend-development/references/baseline.md`

按场景追加：

| 场景 | 加载文档 |
|---|---|
| 本地项目初始化、依赖、子模块 | `backend-project-init` |
| HTTP 接口、Action、开放平台、WebService | `e10-backend-api` |
| 标准服务、定时任务、配置、缓存、MQ、用户租户、UUID、锁、线程池、日志、国际化 | `e10-backend-sdk` |
| 数据库、自定义 SQL、事务、数据源 | `e10-backend-db` |
| 编译、打包、部署 | `backend-project-init` |

后端详细示例按专题文档指向的章节读取，禁止默认读取整个 `dev-spec-full.md`。

## 4. 混合需求

混合需求分别加载前端、后端基线，再加载实际涉及的专题。前后端接口契约需同时检查：

- 后端使用 `WeaResult`。
- 前端通过 `devRequest` 调用允许访问的 `/api` 接口。
- 前端通过 `devRequest` 和准入名单访问接口，不绕过准入控制直调 OpenAPI、`/openserver/`。

## 5. 故障与权限

只有需求包含故障排查、代码不生效、权限、监控平台、部署异常时，读取：

- [`troubleshooting-router.md`](troubleshooting-router.md)

## 6. 上下文约束

1. 每轮先读基线，再读最多必要的专题。
2. 不得因“可能有用”加载无关框架、故障、权限或完整参考。
3. 优先读取标题和目标章节；只有当前章节不足时才扩展。
4. 输出“本轮加载文档”，让加载决策可审计。
5. UI 组件任务使用 `$e10-ui-components`，只加载命中组件的必要章节。
6. Utils 任务使用 `$e10-utils-knowledge`；精确命中后默认只加载 `summary`，场景检索最多保留三个候选。
7. 每轮普通文档最多三个，单次加载最多 12288 bytes；超限必须缩小章节。
