SuperAPI AI 工具集

mx-pg-controller-migration

数据与分析

查看项目

更新于 10-16 01:33

技能介绍

用途:在 mx-core 完成 MongoDB→PostgreSQL 切换后,逐模块验证并移植控制器,确保服务端、SDK(packages/api-client)与后台(admin-vue3)三层数据形状一致。

主要能力:按固定流程排查迁移差异——对比 PG 切换提交与最后 Mongo 提交,逐路由检查字段名、关联数据(populate/$lookup)、聚合顺序、死代码与冗余别名;提供 Mongo→PG 字段映射(_id 移除、created→createdAt、modified→modifiedAt、pin→pinAt、count.read/like→readCount/likeCount,category/related 需仓库 attach* 显式加载);统一 ref_type 为单数小写('post'|'note'|'page'|'recently')。

使用方式:先快照迁移差异,再走查每个端点,修补仓库(批量 attach<Foo>,避免 N+1)与控制器(select 白名单强制保留关联键),随后同步 SDK 模型与 Pick 引用、更新后台模型与视图,最后分别运行 pnpm -C apps/core exec tsc --noEmit、pnpm -C packages/api-client exec tsc --noEmit、pnpm -C apps/admin run typecheck。

适用场景:迁移后字段丢失、关联为空、排序失效、编辑表单状态丢失等问题的定位与修复。

限制:不提供服务端向后兼容别名,需向下游传播重命名;不要改动 BaseModel/TextBaseModel 以免影响未迁移模块;具体价格、平台与效果暂未提供。