Jimmer ORM 开发助手用于帮助编写 Jimmer 的实体映射代码和 DSL 查询语句。资料中说明，如果当前上下文中指名了 Jimmer 项目源码的本地路径，应以源码实现作为基准；如需查阅 Jimmer 的具体实现，其代码仓库为 https://github.com/babyfish-ct/jimmer。
核心概念方面，实体定义使用 interface 而非 class，实体是动态对象和不可变对象，只有 getter 没有 setter，由 KSP（Kotlin）或 AnnotationProcessor（Java）在编译时生成实现，并且属性未设置不等于属性为 null。DSL 查询是强类型 SQL DSL，提供编译时安全保证，具备动态谓词（根据参数决定是否添加 SQL 条件）、动态表连接（未使用的连接自动忽略，冲突连接自动合并）、隐式子查询（基于集合关联创建子查询，自动生成父子关联条件）等能力。资料还提到 Jimmer 为 Kotlin 提供了特化的 API 风格。
参考文档与模板：实体映射参考 references/entity-mapping.md；DSL 查询参考 references/dsl-queries.md；实体模板参考 assets/EntityTemplate.kt；DTO 相关参考 references/dto.md。
关键注解速查包括：@Entity 标记实体类型；@MappedSuperclass 标记映射父接口以复用公共字段；@Embeddable 标记嵌入值对象；@Id 标记主键；@GeneratedValue 指定主键生成策略；@Key 标记业务键；@ManyToOne / @OneToMany / @ManyToMany / @OneToOne 用于关联映射；@ManyToManyView 通过中间实体暴露多对多视图；@IdView 关联 id 视图；@JoinColumn 自定义外键列名；@JoinTable 自定义中间表；@Column 自定义列名（仅用于非关联字段）；@Table 自定义表名；@Version 乐观锁版本字段；@LogicalDeleted 逻辑删除字段；@Formula / @Transient 计算属性；Kotlin 中的 ? 标记可空属性。
命名约定：实体名到表名如 BookStore 到 BOOK_STORE；属性名到列名如 firstName 到 FIRST_NAME；多对一外键如 store 到 STORE_ID。
工作流程中，定义实体时：使用 interface 而非 class；根据项目语言参考对应的实体模板和映射文档；中间表有排序、时间、来源等业务字段时，定义中间实体并用 @ManyToManyView 暴露只读多对多视图；需要直接按外键查询或写入 input 时，优先为关联补充 @IdView；参考 assets/EntityTemplate.kt 和 references/entity-mapping.md；参考 references/dto.md 完成 DTO 定义。
编写查询时：优先使用动态谓词（Kotlin: ilike?/between?/valueIn?）；使用动态表连接处理单值关联查询；使用隐式子查询处理集合关联，避免集合 JOIN 导致结果重复和分页失效；API 返回实体时使用 fetcher/DTO 控制投影，不要依赖默认序列化形状；根据项目语言参考对应的 DSL 查询文档，参考 references/dsl-queries.md。
遇到问题时：检查实体是否使用 interface 定义；检查关联映射的 mappedBy 配置；检查动态谓词的参数是否正确；确认表连接路径是否正确。
适用场景为 Jimmer 项目中的实体建模、关联配置与 DSL 查询编写。资料未提供收费、价格、平台或效果方面的信息。