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
This commit is contained in:
34
.cursor/rules/deployment-change-tracking.mdc
Normal file
34
.cursor/rules/deployment-change-tracking.mdc
Normal file
@@ -0,0 +1,34 @@
|
||||
---
|
||||
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`
|
||||
Reference in New Issue
Block a user