同步实体缓存与扁平转换开发
基于Twenty实体模型规范生成扁平缓存服务与DTO转换方法,输出统一映射的高性能同步元数据层代码。
功能与用途
本功能面向开源CRM Twenty的后端内核开发者,用于在定义实体类型后构建核心同步管道。用户提供实体定义与关联键,系统引导编写带软删除支持的工作区缓存服务,并实现普通实体转换为扁平实体、输入DTO解析为带全局通用唯一标识符(Universal Identifier)通用扁平对象的转换脚本,保障后续校验与迁移执行效率。
适用场景
- 生成工作区扁平实体缓存服务:为新实体编写带WorkspaceCache注解的缓存服务,预载全量及软删除数据并输出ID与名称字典。
- 构建DTO到通用扁平实体转换器:在实体入库前提取并解析关联外键,完成文本数据清洗并绑定全局唯一标识符转换。
- 封装扁平实体NestJS模块:注册TypeORM元数据数据源,并将完成的缓存服务导出供校验器与动作处理器统一调用。
适用人群
- Twenty开源项目贡献者
- CRM后端架构师
- NestJS全栈开发工程师
使用步骤
- 基于实体定义编写继承工作区缓存装饰器的 CacheService。
- 实现实体到扁平数据结构的转换函数并分配唯一通用ID。
- 编写创建与更新输入DTO转通用扁平实体的解析处理函数。
- 在Flat模块中注册元数据数据源并导出缓存服务供上层调用。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-28
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Create cache services and transformation utilities for syncable entities in Twenty. Use when implementing entity-to-flat conversions, input DTO transpilation to universal flat entities, or cache recomputation for syncable entities.
依赖与权限
- 读取用户主动提供的内容