docs(M08-D): 回填加盟申请与跟进运营

This commit is contained in:
Codex
2026-08-10 13:18:51 +08:00
parent aa4a6bd014
commit bd00aa6275
6 changed files with 55 additions and 6 deletions
@@ -73,3 +73,15 @@
| GET/POST/PUT | `/admin-api/advertisements[/:id]` | 新增广告更新;写入同时校验原广告范围、目标范围和图片素材范围,门店管理员只能维护授权门店广告。 |
响应新增广告 `imageAssetId`,用于无损编辑既有记录;素材和装修列表上限分别为 200/100 条,均按租户和授权门店裁剪。
## 加盟申请与跟进运营增量
| 方法 | 路径 | 权限与变更 |
|---|---|---|
| POST | `/app-api/franchise-applications` | 按 `x-wechat-appid`/可选 `tenant-id` 解析有效租户,支持匿名或当前租户登录用户提交,`clientRequestId` 幂等。 |
| GET | `/admin-api/franchise-applications` | `tenant.manage` 或平台管理权限;支持状态、负责人、关键字和分页,平台跨租户必须显式请求 tenantId。 |
| GET | `/admin-api/franchise-applications/:id` | 返回申请详情与实际操作人跟进历史,严格按目标租户读取。 |
| PATCH | `/admin-api/franchise-applications/:id/assignee` | 负责人必须是线索所属租户的有效 STAFF 用户;支持取消分派。 |
| POST | `/admin-api/franchise-applications/:id/follow-ups` | 新增电话、微信、面谈或备注记录,更新下次跟进时间,并执行 `NEW → CONTACTED → QUALIFIED → CONVERTED/REJECTED` 受控流转。 |
联系电话只进入受权限保护的业务表和响应,不写入审计 metadata;`CONVERTED` 表示已签约待开通,不创建租户,真实开通编排留在 M10-C。