40 lines
3.2 KiB
Plaintext
40 lines
3.2 KiB
Plaintext
---
|
||
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 工具读取 `e:\Gongsi\Mycontent\.cursor\skills\change-checklist\SKILL.md` 的完整内容**，按其「以领域为单位思考」的方法逐项确认。
|
||
|
||
## 四、聊天中触发变更检查
|
||
|
||
编码完成后在聊天中说**「变更完成」「检查一下」「准备提交」**，AI 会主动加载本清单 + change-checklist/SKILL.md 完成核对。**不需要正在编辑文件，直接说触发词即可。**
|
||
|
||
未通过上述检查即提交视为可能漏改，需补全后再提交。
|