# 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`）