# 埋点接口清单

本文档列出了所有已添加埋点注解（`@TrackEvent`）的接口方法。

## 一、流量数据（TRAFFIC）

| 序号 | 接口路径 | HTTP方法 | 方法名 | 所在类 | 事件类型 |
|------|---------|---------|--------|--------|---------|
| 1 | `/aiSearch/search` | POST | `search` | `AiSearchController` | SEARCH |

## 二、互动数据（INTERACTION）

| 序号 | 接口路径 | HTTP方法 | 方法名 | 所在类 | 事件类型 |
|------|---------|---------|--------|--------|---------|
| 2 | `/collect/addCollect` | POST | `addCollect` | `LifeCollectController` | COLLECT |
| 3 | `/storeClockIn/addStoreClockIn` | POST | `addStoreClockIn` | `StoreClockInController` | CHECKIN |
| 4 | `/renovation/requirement/consultRequirement` | POST | `consultRequirement` | `StoreRenovationRequirementController` | CONSULT |
| 5 | `/userDynamics/addOrUpdate` | POST | `addOrUpdate` | `LifeUserDynamicsController` | POST_PUBLISH |
| 6 | `/userDynamics/addTransferCount` | GET | `addTransferCount` | `LifeUserDynamicsController` | POST_REPOST |
| 7 | `/comment/like` | POST | `like` | `LifeCommentController` | POST_LIKE |
| 8 | `/commonComment/addComment` | POST | `addComment` | `CommonCommentController` | POST_COMMENT |
| 9 | `/user-violation/reporting` | POST | `reporting` | `UserViolationController` | REPORT |
| 10 | `/life-blacklist/blackList` | POST | `blackList` | `LifeBlacklistController` | BLOCK |

## 三、服务质量（SERVICE）

| 序号 | 接口路径 | HTTP方法 | 方法名 | 所在类 | 事件类型 |
|------|---------|---------|--------|--------|---------|
| 11 | `/commonRating/addRating` | POST | `add` | `CommonRatingController` | RATING_ADD |
| 12 | `/commentAppeal/submit` | POST | `submitAppeal` | `CommentAppealController` | APPEAL |

## 四、价目表（PRICE）

| 序号 | 接口路径 | HTTP方法 | 方法名 | 所在类 | 事件类型 |
|------|---------|---------|--------|--------|---------|
| 13 | `/store/price/getById` | GET | `getById` | `StorePriceController` | PRICE_VIEW |
| 14 | `/store/cuisine/getByCuisineType` | GET | `getByCuisineType` | `StoreCuisineController` | PRICE_VIEW |

## 五、优惠券（COUPON）

| 序号 | 接口路径 | HTTP方法 | 方法名 | 所在类 | 事件类型 |
|------|---------|---------|--------|--------|---------|
| 15 | `/life-discount-coupon-store-friend/setFriendCoupon` | POST | `setFriendCoupon` | `LifeDiscountCouponStoreFriendController` | COUPON_GIVE |
| 16 | `/coupon/verify` | GET | `verify` | `LifeCouponController` | COUPON_USE |

## 六、WebSocket埋点（非HTTP接口）

| 序号 | 触发场景 | 消息类型 | 处理类 | 事件类型 | 说明 |
|------|---------|---------|--------|---------|------|
| 17 | 用户咨询店铺 | WebSocket消息 | `WebSocketProcess` | CONSULT | 当接收者是店铺（receiverId以store_开头）且是普通消息时触发 |
| 18 | 用户分享店铺 | WebSocket消息（type="3"或"14"） | `WebSocketProcess` | SHARE | 当消息类型为链接分享（type="3"）或人员分享（type="14"）时触发，从消息内容中解析storeId |

## 统计汇总

- **总埋点数**：18个
- **HTTP接口总数**：16个
- **WebSocket埋点**：2个
- **流量数据**：1个
- **互动数据**：9个（包含2个WebSocket埋点）
- **服务质量**：2个
- **价目表**：2个
- **优惠券**：2个

---

**文档版本**：v1.2  
**最后更新**：2026-01-22
