---
description: 变更时关联层检查清单，防止漏改（前端/后端/管理端/表结构）
globs: ["miniprogram/**/*", "soul-admin/**/*", "soul-api/**/*"]
alwaysApply: false
---

# Soul 创业派对 - 变更关联检查清单（防漏改）

在 **miniprogram/**、**soul-admin/** 或 **soul-api/** 下做任何**修改、优化、新增**后，必须按下列项过一遍，确认关联层已同步，避免只改一端导致数据不一致或功能缺管理入口。

## 一、按「你改了什么」对表检查

| 你改的是… | 必须同时检查/修改的关联 |
|-----------|--------------------------|
| **前端（小程序或管理端）** 新增/改了**字段**或**接口入参/出参** | soul-api 对应接口的 request/response、model 是否已改？数据库表是否有对应列（无则加迁移/字段）？ |
| **小程序** 新增或改了一个**功能**（页面、能力、配置项） | soul-api 是否已有或需新增接口（挂到 `/api/miniprogram/...`）？**管理端**是否需要对应的**配置、审核、统计、列表**？ |
| **管理端** 新增或改了**列表/表单/配置项** | soul-api 的 admin/db 接口是否已提供对应数据或写接口？字段名与类型是否与前端一致？ |
| **soul-api** 新增/改了**接口**（路径、请求体、响应体、model） | 小程序或管理端是否有**调用处**？类型/字段是否已同步更新？若改了表结构，迁移是否已加？**路径是否按使用方区分**（小程序用 `/api/miniprogram/*`，管理端用 `/api/admin/*` 或 `/api/db/*`，禁止通用路径混用）？ |
| **soul-api** 新增/改了**表或字段** | 相关 handler、model 是否已改？是否有接口暴露给小程序/管理端？若有，前端是否已对接？ |

## 二、按「业务功能」想三端

以**功能/领域**为单位（如：提现、推荐、章节权限、找伙伴、配置项），问一句：

- **小程序**：用户侧是否已实现/已更新？
- **soul-api**：接口是否在正确路由组（miniprogram / admin / db）、请求响应是否一致？若两端共用，是否显式挂到 miniprogram 组（`/api/miniprogram/xxx`），禁止仅提供 `/api/xxx` 混用？
- **管理端**：该功能是否需要**配置、审核、统计、列表**？有则需在 soul-admin 与 soul-api 的 admin/db 下补齐。

## 三、执行约定

- **每次**在 miniprogram、soul-admin、soul-api 内完成一轮修改后，**先过一遍上表 + 二**，再视为本次变更完成。
- 若本次变更涉及多端（例如小程序新功能 + 管理端配置页），应在同一次任务内一并完成或明确记录未做项，避免漏改。
- 更详细的检查流程：**必须使用 Read 工具读取 `.cursor/skills/change-checklist/SKILL.md` 的完整内容**（相对本仓库根），按其「以领域为单位思考」的方法逐项确认。

## 四、聊天中触发变更检查

编码完成后在聊天中说**「变更完成」「检查一下」「准备提交」**，AI 会主动加载本清单 + change-checklist/SKILL.md 完成核对。**不需要正在编辑文件，直接说触发词即可。**

未通过上述检查即提交视为可能漏改，需补全后再提交。