spring-boot-full-stack

mduongvandinh's avatarfrom mduongvandinh

Complete Java Spring Boot skill set for building enterprise applications.Includes modular architecture with optional components:- PostgreSQL database with JPA/Hibernate + Flyway migration- Redis caching (optional)- Kafka/RabbitMQ messaging (optional, choose one)- JWT + OAuth2 authentication (optional OAuth2)- RBAC authorization (optional)- TDD with Mockito- Spec-First Development with OpenSpec

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 26, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive, enterprise-grade Java Spring Boot framework designed for rapid and modular application development. It streamlines the creation of robust backends by integrating essential components like PostgreSQL, Redis, and Kafka, while enforcing high-quality engineering standards through Spec-First development and Test-Driven Development (TDD).

Use Cases

  • Rapidly bootstrapping production-ready microservices with pre-configured database migrations (Flyway) and modular architecture.
  • Implementing a Spec-First development workflow to ensure API consistency and alignment with business requirements using OpenSpec.
  • Integrating advanced security features including JWT, OAuth2, and Role-Based Access Control (RBAC) into enterprise Java applications.
  • Building scalable messaging systems by easily toggling between Kafka and RabbitMQ through Maven profiles.
  • Ensuring high code reliability and maintainability by utilizing built-in TDD patterns with Mockito and global exception handling.
namespring-boot-full-stack
version1.0.0
description|
authorExpert Panel (AI Generated)
dependencies[]

Spring Boot Full Stack Skill

Overview

This skill provides a complete, modular framework for building Java Spring Boot applications with enterprise-grade features.

Quick Start

# Minimal setup (PostgreSQL + JWT only)
mvn clean install -Pminimal

# With Redis caching
mvn clean install -Dmodule.redis.enabled=true

# Full stack (all modules)
mvn clean install -Pfull-stack

# Run application
mvn spring-boot:run -Dspring-boot.run.profiles=local

Module Selection

Module Default Enable Flag
PostgreSQL ON -Dmodule.postgresql.enabled=true
Redis OFF -Dmodule.redis.enabled=true
Kafka OFF -Dmodule.kafka.enabled=true
RabbitMQ OFF -Dmodule.rabbitmq.enabled=true
OAuth2 OFF -Dmodule.oauth2.enabled=true

Development Workflow

  1. Spec First: Define specifications in openspec/specs/
  2. TDD: Write tests first (RED)
  3. Implement: Write minimal code (GREEN)
  4. Refactor: Improve code quality
  5. Archive: Update specs after implementation

Docker Options

# Without Docker (services installed locally)
make dev

# With Docker infrastructure
make dev-docker

# Full Docker deployment
docker compose --profile with-app up -d

Skills Included

Core (Always enabled)

  • spring-project-init - Project initialization
  • spring-maven-modular - Maven profiles & BOM
  • spring-error-handling - Global exception handling
  • spring-validation - Request validation
  • spring-logging - Structured logging
  • spring-testing - Unit + Integration testing
  • spring-tdd-mockito - TDD with Mockito
  • spring-openspec - Spec-First Development

Optional

  • spring-redis - Redis caching
  • spring-kafka - Kafka messaging
  • spring-rabbitmq - RabbitMQ messaging
  • spring-oauth2 - OAuth2/OIDC
  • spring-rbac - Role-based access control
  • spring-docker - Docker containerization
  • spring-api-docs - OpenAPI/Swagger
  • spring-monitoring - Actuator + Prometheus

File Structure

src/
├── main/
│   ├── java/
│   │   └── com/company/app/
│   │       ├── config/           # Configuration classes
│   │       ├── controller/       # REST controllers
│   │       ├── service/          # Business logic
│   │       ├── repository/       # Data access
│   │       ├── domain/           # Entities
│   │       ├── dto/              # Data transfer objects
│   │       ├── exception/        # Custom exceptions
│   │       └── security/         # Security configuration
│   └── resources/
│       ├── application.yml
│       ├── application-local.yml
│       ├── application-dev.yml
│       ├── application-prod.yml
│       └── db/migration/         # Flyway migrations
├── test/
│   └── java/
│       └── com/company/app/
│           ├── unit/             # Unit tests
│           └── integration/      # Integration tests
└── openspec/
    ├── AGENTS.md
    ├── specs/                    # Feature specifications
    └── changes/                  # Proposed changes

References