feat(bmm): 添加 TypeORM 数据库迁移标准化工作流

- 创建 create-db-migration 工作流，标准化双 Data Source 架构下的迁移流程
- 工作流定义存放在 _bmad/ (升级安全)
- Skill 包装器存放在 .claude/commands/bmad/ (升级可能覆盖)
- 更新 project-context.md 记录自定义工作流和升级恢复步骤
- 添加"常见陷阱与解决方案"章节，包括：
  - 迁移文件命名规范（必须以数字结尾）
  - 迁移类必须包含 name 属性
  - 主键列名差异（person_id vs id）
  - migration:generate 可能失败及手动创建方案
  - 更新 migrations/index.ts 的必要性
- 经过完整验证：撤回→按工作流执行→回滚→重跑
- 创建 disabled_person_phone 表迁移文件

测试发现：
- migration:generate 在此项目中不可靠（Glob 和显式路径都测试失败）
- 手动创建迁移是可靠的工作方式

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

_bmad/bmm/workflows/5-utilities/create-db-migration/workflow.md

@@ -257,6 +257,104 @@ public async up(queryRunner: QueryRunner): Promise<void> {
 
 ---
 
+## 常见陷阱与解决方案
+
+### ⚠️ 迁移文件命名规范（重要！）
+
+**问题**：迁移文件必须以数字结尾才能被 Glob 模式匹配。
+
+| 文件名 | 是否匹配 `*[0-9].ts` | 说明 |
+|--------|---------------------|------|
+| `Migrate...1737260000000.ts` | ✅ 匹配 | 以数字结尾 |
+| `1768968781678-Create...Table.ts` | ❌ 不匹配 | 以字母结尾 |
+
+**正确命名格式**：
+```
+[描述性名称][时间戳].ts
+```
+
+示例：`CreateDisabledPersonPhoneTable1768968781678.ts`
+
+### ⚠️ 迁移类必须包含 name 属性
+
+```typescript
+export class CreateDisabledPersonPhoneTable1768968781678 implements MigrationInterface {
+  name = 'CreateDisabledPersonPhoneTable1768968781678';  // 必须有！
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    // ...
+  }
+}
+```
+
+没有 `name` 属性会导致迁移无法被 TypeORM CLI 识别。
+
+### ⚠️ 主键列名差异
+
+**问题**：不同表可能使用不同的主键列名。
+
+```typescript
+// ❌ 错误：假设所有表都用 id 作为主键
+referencedColumnNames: ["id"]
+
+// ✅ 正确：检查实际表的主键列名
+// disabled_person 表的主键是 person_id，不是 id！
+referencedColumnNames: ["person_id"]
+```
+
+**解决方法**：在创建外键前，先检查被引用表的实际主键列名：
+```bash
+psql -h 127.0.0.1 -U postgres -c "\d+ table_name"
+```
+
+### ⚠️ migration:generate 可能失败
+
+**问题**：TypeORM 有时无法检测实体变化，报告 "No changes in database schema were found"。
+
+**可能原因**：
+1. 实体文件没有被 Glob 模式正确加载
+2. 实体与数据库表已完全同步
+3. TypeScript 编译问题
+
+**解决方案**：手动创建迁移文件
+```typescript
+import { MigrationInterface, QueryRunner, Table, TableForeignKey } from "typeorm";
+
+export class YourMigrationTimestamp implements MigrationInterface {
+  name = 'YourMigrationTimestamp';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    // 手动编写迁移逻辑
+    await queryRunner.createTable(
+      new Table({
+        name: "your_table",
+        columns: [/* ... */],
+      }),
+      true
+    );
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.dropTable("your_table", true);
+  }
+}
+```
+
+### ⚠️ 更新 migrations/index.ts
+
+创建迁移文件后，必须更新 `packages/server/migrations/index.ts`：
+
+```typescript
+import { YourMigrationTimestamp } from './YourMigrationTimestamp';
+
+export const migrations: any[] = [
+  MigrateNotWorkingToPreWorking1737260000000,
+  YourMigrationTimestamp,  // 按时间戳顺序添加
+]
+```
+
+---
+
 ## 注意事项
 
 ### ⚠️ 生产环境迁移

packages/server/migrations/CreateDisabledPersonPhoneTable1768970000000.ts

@@ -0,0 +1,76 @@
+import { MigrationInterface, QueryRunner, Table, TableForeignKey, TableIndex } from "typeorm";
+
+/**
+ * 创建残疾人本人电话表
+ *
+ * 用于支持残疾人本人多个电话号码，与监护人电话表结构保持一致
+ *
+ * 注：此迁移是手动创建的，因为 migration:generate 在此项目中不可靠
+ */
+export class CreateDisabledPersonPhoneTable1768970000000 implements MigrationInterface {
+  name = 'CreateDisabledPersonPhoneTable1768970000000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.createTable(
+      new Table({
+        name: "disabled_person_phone",
+        columns: [
+          {
+            name: "id",
+            type: "int",
+            isPrimary: true,
+            isGenerated: true,
+            generationStrategy: "increment",
+            comment: "本人电话ID",
+          },
+          {
+            name: "person_id",
+            type: "int",
+            isNullable: false,
+            comment: "残疾人ID",
+          },
+          {
+            name: "phone_number",
+            type: "varchar",
+            length: "20",
+            isNullable: false,
+            comment: "本人电话号码",
+          },
+          {
+            name: "is_primary",
+            type: "smallint",
+            default: 0,
+            isNullable: false,
+            comment: "是否为主要联系电话：1-是，0-否",
+          },
+        ],
+      }),
+      true
+    );
+
+    // 创建外键约束 - 注意：disabled_person 表的主键是 person_id
+    await queryRunner.createForeignKey(
+      "disabled_person_phone",
+      new TableForeignKey({
+        columnNames: ["person_id"],
+        referencedColumnNames: ["person_id"],
+        referencedTableName: "disabled_person",
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      })
+    );
+
+    // 创建索引
+    await queryRunner.createIndex(
+      "disabled_person_phone",
+      new TableIndex({
+        name: "idx_disabled_person_phone_person_id",
+        columnNames: ["person_id"],
+      })
+    );
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.dropTable("disabled_person_phone", true);
+  }
+}

packages/server/src/data-source-cli.ts

@@ -27,7 +27,14 @@ export const AppDataSource = new DataSource({
     // allin-packages 中的模块
     "../allin-packages/channel-module/src/entities/*.ts",
     "../allin-packages/company-module/src/entities/*.ts",
-    "../allin-packages/disability-module/src/entities/*.ts",
+    // 显式路径：测试 Glob 模式是否是 migration:generate 失败的原因
+    "../allin-packages/disability-module/src/entities/disabled-person.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-person-phone.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-person-guardian-phone.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-bank-card.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-photo.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-remark.entity.ts",
+    "../allin-packages/disability-module/src/entities/disabled-visit.entity.ts",
     "../allin-packages/order-module/src/entities/*.ts",
     "../allin-packages/statistics-module/src/entities/*.ts",
     "../allin-packages/platform-module/src/entities/*.ts",