---
description: Generates a complete Spring Boot CRUD feature (entity, repository, service, controller, DTOs, tests) in an existing project. Use when user asks to "add CRUD for", "generate entity", "create a feature for", "add REST endpoints for", "scaffold a feature", or "build CRUD for".
argument-hint: "<EntityName> [fields: field:type, ...] [Java version] [Spring Boot version]"
---

# /java-crud — Spring Boot CRUD Generator

You are a Spring Boot code generator. Add a complete CRUD feature to an **existing** project.

> **Starting a new project from scratch?** Use `/java-scaffold` instead.

## Step 1 — Gather requirements

Parse arguments if provided. Otherwise ask (in a single message):

1. **Entity name** — e.g., `Product`, `CustomerOrder`
2. **Fields** — name and type, e.g., `name:String, price:BigDecimal, category:String, active:boolean`
3. **Soft delete?** — yes/no
4. **Java version** — check `pom.xml` / `build.gradle`, ask if not found
5. **Spring Boot version** — 2.x (`javax.persistence`) or 3.x+ (`jakarta.persistence`)

Confirm before generating:
```
Adding CRUD feature: Product
Fields: id (auto), name (String), price (BigDecimal), category (String), active (boolean)
Java: 17 | Spring Boot: 3.2 | Soft delete: no
Generate? (yes to proceed)
```

## Step 2 — Detect base package

Check `src/main/java/` for the existing package structure. Match the project's conventions.

## Step 3 — Generate all layers

Use the templates in `references/templates.md`. Generate files in this order, stating the full path before each:

1. `src/main/java/{package}/entity/{Entity}.java`
2. `src/main/java/{package}/repository/{Entity}Repository.java`
3. `src/main/java/{package}/dto/{Entity}Request.java` + `{Entity}Response.java`
4. `src/main/java/{package}/service/{Entity}Service.java`
5. `src/main/java/{package}/controller/{Entity}Controller.java`
6. `src/test/java/{package}/service/{Entity}ServiceTest.java`

**Spring Boot version rules:**
- 3.x+: use `jakarta.persistence.*`, `@SQLRestriction` for soft delete
- 2.x: use `javax.persistence.*`, `@Where(clause = "deleted = false")` for soft delete

**Java version rules:**
- 16+: use records for DTOs
- 8–15: use plain classes with constructors and getters

## Step 4 — Post-generation checklist

- [ ] Replace `com.example` with actual base package
- [ ] Add `spring-boot-starter-validation` if not already in build file
- [ ] Add a `GlobalExceptionHandler` (`@RestControllerAdvice`) if not already present
- [ ] Run `mvn compile` or `./gradlew build` to verify

## Step 5 — Next Steps

- Add more tests → `/java-test`
- Review the generated code → `/java-review`
- Check JPA patterns → `/java-jpa`
- Security review → `/java-security-check`