24 lines
871 B
Markdown
24 lines
871 B
Markdown
# 03. Mock 系统（开发联调与脱网演示）
|
||
|
||
## 挂载方式
|
||
|
||
- `vue.config.js`：`devServer.setupMiddlewares = require('./mock')`
|
||
- `mock/index.js`：
|
||
- 将路由集合转换为 express 形式
|
||
- 使用 `mockjs` 返回数据
|
||
- 监听 `mock/` 变更并热更新（`chokidar`）
|
||
|
||
## 路由定义约定（供 AI 生成/扩展）
|
||
|
||
在 `mock/controller/*.js` 中，每个路由对象通常包含：
|
||
|
||
- `url`：不含 `baseURL` 前缀的路径（中间件会自动拼上 `baseURL`）
|
||
- `type`：`get` / `post` / ...
|
||
- `response(req, res)`：返回对象或函数
|
||
|
||
## AI 新增业务 API 的推荐动作
|
||
|
||
1) 在 `src/api/<domain>.ts` 新增函数（调用 `request({ url, method })`）
|
||
2) 在 `mock/controller/<domain>.js` 新增对应 mock 路由，路径保持一致
|
||
3) 在模块规格中补充接口契约（建议写到 `openspec-lite/modules/<domain>.yaml`）
|