entity-mapper-expert

What problem does it solve?

This Skill standardizes JPA Entity and EntityMapper creation, enforcing a "Long FK" strategy to decouple entities, prohibiting JPA relationship annotations, and ensuring clean separation between Domain and Persistence layers. It automates the setup of robust, maintainable data models.

Core Features & Use Cases

• Long FK Strategy: Mandates the use of Long foreign keys and strictly forbids JPA relationship annotations (@ManyToOne, @OneToMany, etc.) to simplify entity graphs and prevent N+1 issues.
• Strict Entity Structure: Guides the creation of entities with protected default constructors, private all-fields constructors, and public static of() factory methods, along with Getter-only access for immutability.
• Bidirectional Mapper Generation: Creates @Component mappers responsible for accurate, bidirectional conversion between Domain aggregates and JPA entities (toEntity() and toDomain() methods).
• Zero-Tolerance Rules: Prohibits Lombok, Setters, and direct new Entity() calls, promoting immutability, controlled object creation, and architectural integrity.
• Use Case: When defining new JPA entities or refactoring existing ones, use this skill to generate the entity and its corresponding mapper. This ensures they adhere to strict architectural and coding conventions, saving development time and reducing future refactoring.

Quick Start

Generate a JPA Entity and its mapper for an 'Order' aggregate, applying the Long FK strategy and Getter-only access.