Files
AIclinicalresearch/.cursor/rules/deployment-change-tracking.mdc
HaHafeng 6124c7abc6 docs(platform): Add database documentation system and restructure deployment docs
Completed:
- Add 6 core database documents (docs/01-平台基础层/07-数据库/)
  Architecture overview, migration history, environment comparison,
  tech debt tracking, seed data management, PostgreSQL extensions
- Restructure deployment docs: archive 20 legacy files to _archive-2025/
- Create unified daily operations manual (01-日常更新操作手册.md)
- Add pending deployment change tracker (03-待部署变更清单.md)
- Update database development standard to v3.0 (three iron rules)
- Fix Prisma schema type drift: align @db.* annotations with actual DB
  IIT: UUID/Timestamptz(6), SSA: Timestamp(6)/VarChar(20/50/100)
- Add migration: 20260227_align_schema_with_db_types (idempotent ALTER)
- Add Cursor Rule for auto-reminding deployment change documentation
- Update system status guide v6.4 with deployment and DB doc references
- Add architecture consultation docs (Prisma guide, SAE deployment guide)

Technical details:
- Manual migration due to shadow DB limitation (TD-001 in tech debt)
- Deployment docs reduced from 20+ scattered files to 3 core documents
- Cursor Rule triggers on schema.prisma, package.json, Dockerfile changes

Made-with: Cursor
2026-02-27 14:35:25 +08:00

35 lines
1.6 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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`