# 配置 mm API Event 事件

## 规则（Rules）

- event.json 位于 `app/{模块名}/event_api/{类型}/{事件名}/event.json`
- `name` 字段全局唯一
- `target` 支持 `*` 通配符路径匹配
- `stage` 可选：`before`、`main`、`after`

## 方法（Methods）

### 步骤1：编写 event.json

```json
{
    "target": "/api/*",
    "name": "my_event",
    "title": "我的事件",
    "description": "事件描述",
    "stage": "main",
    "main": "./main.js",
    "sort": 100,
    "end": true
}
```

### 步骤2：按需调整配置

- 需要前置校验：`stage: "before"`，`sort` 值设小（如 1）
- 需要后置处理：`stage: "after"`，`sort` 值设大（如 999）
- 不希望阻断后续事件：`end: false`
- 匹配精确路径：`target: "/api/user/sign_in"`

## 技巧（Tips）

- `end: true` 时，后续匹配的事件不再执行
- 多个 before 事件按 sort 从小到大执行
- target 只在当前 event_api 目录类型（client/web/manage）内匹配