Skip to content

a-pavithraa/springboot-skills-marketplace / plugins/springboot-architecture/skills/creating-springboot-projects

creating-springboot-projects

Verified

Use 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/value-object.java

View on GitHub
package {{PACKAGE}}.{{MODULE}}.domain.vo;

import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonValue;
import jakarta.persistence.Embeddable;

/**
 * Value Object template - immutable, self-validating, type-safe.
 *
 * Replace:
 *   {{PACKAGE}} - base package (e.g., com.example)
 *   {{MODULE}} - module name (e.g., products)
 *   {{NAME}} - VO name (e.g., ProductSKU, Email, Price)
 *   {{TYPE}} - wrapped type (e.g., String, Long, BigDecimal)
 *   {{FIELD}} - field name (e.g., code, value, amount)
 *
 * @Embeddable lets this record be used in JPA entities via @Embedded /
 * @EmbeddedId — required by Jakarta Persistence 3.2 §2.7 even though records
 * are otherwise the standard embeddable shape on Hibernate 6.2+. Drop the
 * annotation (and the import) if this VO will never be stored by JPA.
 */
@Embeddable
public record {{NAME}}(@JsonValue {{TYPE}} {{FIELD}}) {

    // DELEGATING mode pairs with @JsonValue on the single component: Jackson
    // deserializes the whole JSON scalar (e.g. "ABC-123") and hands it to the
    // canonical/compact constructor, instead of expecting a JSON object with
    // a {{FIELD}} property. Drop @JsonCreator entirely if Jackson 2.12+ /
    // Jackson 3 record auto-detection is enough for your stack.
    @JsonCreator(mode = JsonCreator.Mode.DELEGATING)
    public {{NAME}} {
        // Validation - fail fast at construction
        if ({{FIELD}} == null) {
            throw new IllegalArgumentException("{{NAME}} cannot be null");
        }
        // Add domain-specific validation here
        // Example for SKU: if (!SKU_PATTERN.matcher(code).matches()) { throw... }
        // Example for Price: if (amount.compareTo(BigDecimal.ZERO) < 0) { throw... }
    }

    // Factory method
    public static {{NAME}} of({{TYPE}} {{FIELD}}) {
        return new {{NAME}}({{FIELD}});
    }

    // Optional: generation method for IDs/codes
    // public static {{NAME}} generate() {
    //     return new {{NAME}}(TSIDUtil.generateTsidString());
    // }
}

// ============================================================
// EXAMPLES
// ============================================================

// --- Simple String VO ---
// public record ProductSKU(@JsonValue String code) {
//     @JsonCreator
//     public ProductSKU {
//         if (code == null || code.isBlank()) {
//             throw new IllegalArgumentException("SKU cannot be null or blank");
//         }
//     }
//     public static ProductSKU of(String code) { return new ProductSKU(code); }
// }

// --- Email with regex validation ---
// public record Email(@JsonValue String value) {
//     private static final Pattern EMAIL_PATTERN =
//         Pattern.compile("^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$");
//
//     @JsonCreator
//     public Email {
//         if (value == null || !EMAIL_PATTERN.matcher(value).matches()) {
//             throw new IllegalArgumentException("Invalid email: " + value);
//         }
//     }
// }

// --- Price with BigDecimal ---
// public record Price(@JsonValue BigDecimal amount) {
//     public static final Price ZERO = new Price(BigDecimal.ZERO);
//
//     @JsonCreator
//     public Price {
//         if (amount == null || amount.compareTo(BigDecimal.ZERO) < 0) {
//             throw new IllegalArgumentException("Price cannot be negative");
//         }
//     }
//     public boolean isFree() { return amount.compareTo(BigDecimal.ZERO) == 0; }
// }

// --- ID with TSID generation ---
// public record ProductId(@JsonValue Long id) {
//     @JsonCreator
//     public ProductId {
//         if (id == null || id < 0) {
//             throw new IllegalArgumentException("Invalid ID");
//         }
//     }
//     public static ProductId generate() {
//         return new ProductId(TSIDUtil.generateTsidLong());
//     }
// }
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall