---
description: 当修改数据库Schema、依赖或配置时，提醒记录到待部署变更清单
globs: backend/prisma/schema.prisma, backend/package.json, frontend-v2/package.json, extraction_service/requirements*.txt, r-statistics-service/**, backend/Dockerfile, frontend-v2/Dockerfile, extraction_service/Dockerfile, frontend-v2/nginx.conf, backend/.env.example
alwaysApply: false
---

# 部署变更追踪提醒

当你修改了以下文件，必须同步更新 `docs/05-部署文档/03-待部署变更清单.md`：

## 触发条件 → 记录内容

| 修改的文件 | 清单区域 | 记录什么 |
|-----------|---------|---------|
| `schema.prisma` | 数据库变更 | 迁移文件名 + 变更描述 |
| `backend/package.json` (新依赖) | 后端变更 | 新增的 npm 包 |
| `backend/Dockerfile` | 后端变更 | Dockerfile 变更原因 |
| `frontend-v2/package.json` (新依赖) | 前端变更 | 新增的 npm 包 |
| `frontend-v2/nginx.conf` | 前端变更 | Nginx 配置变更 |
| `requirements*.txt` | Python 变更 | 新增/升级的 pip 包 |
| `r-statistics-service/**` | R 引擎变更 | R 包或工具变更 |

## 操作步骤

1. 完成代码修改
2. 打开 `docs/05-部署文档/03-待部署变更清单.md`
3. 在对应区域追加一行记录
4. 提交代码时包含清单更新

## schema.prisma 额外规则

- 修改 Schema 后必须运行 `npx prisma migrate dev --name xxx` 生成迁移
- 禁止使用 `prisma db push`（除非原型探索，事后必须补迁移）
- 迁移生成后同步更新 `docs/01-平台基础层/07-数据库/01-Prisma迁移历史与变更日志.md`