a-pavithraa/springboot-skills-marketplace / plugins/springboot-architecture/skills/creating-springboot-projects
creating-springboot-projects
VerifiedUse when starting a new Spring Boot project or service: scaffolding or bootstrapping a backend, REST API, microservice or modular monolith; choosing how to structure it (layered, package-by-module, modular monolith, tomato, DDD-hexagonal); selecting Spring Boot 4 features; generating the base project with progen or Spring Initializr; or applying the bundled templates and references in this skill. Not for migrating existing projects or for isolated JPA/repository work without broader project-creation context.
assets/rich-entity.java
View on GitHubpackage {{PACKAGE}}.{{MODULE}}.domain;
import {{PACKAGE}}.{{MODULE}}.domain.vo.*;
import {{PACKAGE}}.shared.BaseEntity;
import jakarta.persistence.*;
/**
* Rich Entity template - aggregate root with behavior.
*
* Key principles:
* - Use @EmbeddedId with Value Object for ID
* - Embed Value Objects with @AttributeOverride
* - Factory methods for creation (not public constructors)
* - Business logic methods (not just getters/setters)
* - Protected no-arg constructor for JPA
* - @Version for optimistic locking
*
* Compatibility note: when the ID and embedded value objects are Java
* records (as in `value-object.java`), record-as-@Embeddable requires
* Hibernate 6.2+. Spring Boot 4 ships Hibernate 7.x, so this works out
* of the box. Known tooling gotchas: QueryDSL APT (querydsl#3695) does
* not accept record embeddables; some MapStruct setups need explicit
* @Mapping overrides for nested embeddable records.
*/
@Entity
@Table(name = "{{TABLE_NAME}}")
class {{NAME}}Entity extends BaseEntity {
@EmbeddedId
@AttributeOverride(name = "id", column = @Column(name = "id"))
private {{NAME}}Id id;
@Embedded
@AttributeOverride(name = "code", column = @Column(name = "code", unique = true))
private {{NAME}}Code code;
// Embed composite Value Objects
@Embedded
@AttributeOverrides({
@AttributeOverride(name = "name", column = @Column(name = "name")),
@AttributeOverride(name = "description", column = @Column(name = "description"))
})
private {{NAME}}Details details;
@Enumerated(EnumType.STRING)
@Column(name = "status")
private {{NAME}}Status status;
@Version
private int version;
// Protected constructor for JPA
protected {{NAME}}Entity() {}
// Private constructor - use factory method
private {{NAME}}Entity({{NAME}}Id id, {{NAME}}Code code,
{{NAME}}Details details, {{NAME}}Status status) {
this.id = id;
this.code = code;
this.details = details;
this.status = status;
}
// ==================== FACTORY METHODS ====================
public static {{NAME}}Entity create({{NAME}}Details details) {
return new {{NAME}}Entity(
{{NAME}}Id.generate(),
{{NAME}}Code.generate(),
details,
{{NAME}}Status.DRAFT
);
}
// ==================== BUSINESS LOGIC ====================
public boolean isActive() {
return status == {{NAME}}Status.ACTIVE;
}
public void activate() {
if (status == {{NAME}}Status.ACTIVE) {
return; // Idempotent
}
// Add business rule checks here
this.status = {{NAME}}Status.ACTIVE;
}
public void deactivate() {
if (status == {{NAME}}Status.INACTIVE) {
return; // Idempotent
}
this.status = {{NAME}}Status.INACTIVE;
}
// ==================== GETTERS ONLY - NO SETTERS ====================
public {{NAME}}Id getId() { return id; }
public {{NAME}}Code getCode() { return code; }
public {{NAME}}Details getDetails() { return details; }
public {{NAME}}Status getStatus() { return status; }
}
// ============================================================
// EXAMPLE: ProductEntity
// ============================================================
// @Entity
// @Table(name = "products")
// class ProductEntity extends BaseEntity {
//
// @EmbeddedId
// private ProductId id;
//
// @Embedded
// @AttributeOverride(name = "code", column = @Column(name = "sku", unique = true))
// private ProductSKU sku;
//
// @Embedded
// private ProductDetails details;
//
// @Embedded
// @AttributeOverride(name = "amount", column = @Column(name = "price"))
// private Price price;
//
// @Embedded
// @AttributeOverride(name = "value", column = @Column(name = "quantity"))
// private Quantity quantity;
//
// @Enumerated(EnumType.STRING)
// private ProductStatus status;
//
// @Version
// private int version;
//
// protected ProductEntity() {}
//
// public static ProductEntity create(ProductSKU sku, ProductDetails details,
// Price price, Quantity quantity) {
// return new ProductEntity(ProductId.generate(), sku, details,
// price, quantity, ProductStatus.DRAFT);
// }
//
// public boolean isInStock() {
// return quantity.value() > 0;
// }
//
// public void adjustPrice(Price newPrice) {
// if (newPrice.amount().compareTo(BigDecimal.ZERO) < 0) {
// throw new InvalidPriceException("Price cannot be negative");
// }
// this.price = newPrice;
// }
//
// public void decreaseStock(int amount) {
// if (quantity.value() < amount) {
// throw new InsufficientStockException("Not enough stock");
// }
// this.quantity = Quantity.of(quantity.value() - amount);
// }
// }
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |