mcpField
S
spring-boot-full-stack

spring-boot-full-stack

github.com/mduongvandinh开发6147 次安装44 周前更新
代码仓库

关于 spring-boot-full-stack

spring-boot-full-stack 是面向 Java 开发者的模块化 Spring Boot 应用构建技能，涵盖测试、错误处理和验证等基础实践。可按需启用 PostgreSQL、Redis、消息队列及 OAuth2 等模块，并包含规格驱动与 TDD 工作流。

主要功能

  1. 01按 Maven 配置选择模块
  2. 02支持 PostgreSQL、Redis 与消息队列
  3. 03包含错误处理、验证和日志技能
  4. 04提供单元与集成测试实践
  5. 05采用规格优先和 TDD 工作流

适用场景

  1. 01初始化模块化 Spring Boot 项目
  2. 02按需加入缓存或消息组件
  3. 03为应用实现测试驱动开发
  4. 04通过 Docker 启动开发基础设施

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mduongvandinh/skills-java-spring --skill spring-boot-full-stack

安装后在 Claude Code 中输入/spring-boot-full-stack确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.continuerc.json
.cursorrules
.gitignore
.windsurfrules
AGENTS.md
CLAUDE.md
docker-compose.yml
Dockerfile
Makefile
pom.xml
QUICKSTART.md
README.md
.github/
copilot-instructions.md
openspec/
AGENTS.md
README.md
openspec/changes/example-user-registration/
proposal.md
tasks.md
openspec/changes/example-user-registration/specs/auth/
registration.md
openspec/specs/api/
rest.md
openspec/specs/architecture/
layers.md
openspec/specs/testing/
tdd.md
scripts/
start-local.ps1
start-local.sh
src/main/java/com/company/app/
Application.java
src/main/java/com/company/app/config/
ConditionalOnModuleEnabled.java
ModuleProperties.java
SecurityConfig.java
src/main/java/com/company/app/controller/
HealthController.java
ModuleController.java
SystemController.java

详细介绍

Spring Boot 全栈技能

概览

此技能提供一个完整的模块化框架，用于构建具备企业级功能的 Java Spring Boot 应用程序。

快速开始

# 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

模块选择

模块默认状态启用标志
PostgreSQLON-Dmodule.postgresql.enabled=true
RedisOFF-Dmodule.redis.enabled=true
KafkaOFF-Dmodule.kafka.enabled=true
RabbitMQOFF-Dmodule.rabbitmq.enabled=true
OAuth2OFF-Dmodule.oauth2.enabled=true

开发工作流

  1. 规范优先：在 openspec/specs/ 中定义规范
  2. TDD：先编写测试（RED）
  3. 实现：编写最精简的代码（GREEN）
  4. 重构：提升代码质量
  5. 归档：实现后更新规范

Docker 选项

# Without Docker (services installed locally)
make dev

# With Docker infrastructure
make dev-docker

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

包含的技能

核心（始终启用）
  • spring-project-init - 项目初始化
  • spring-maven-modular - Maven 配置文件和 BOM
  • spring-error-handling - 全局异常处理
  • spring-validation - 请求验证
  • spring-logging - 结构化日志
  • spring-testing - 单元测试和集成测试
  • spring-tdd-mockito - 使用 Mockito 进行 TDD
  • spring-openspec - 规范优先开发
可选
  • spring-redis - Redis 缓存
  • spring-kafka - Kafka 消息传递
  • spring-rabbitmq - RabbitMQ 消息传递
  • spring-oauth2 - OAuth2/OIDC
  • spring-rbac - 基于角色的访问控制
  • spring-docker - Docker 容器化
  • spring-api-docs - OpenAPI/Swagger
  • spring-monitoring - Actuator 和 Prometheus

文件结构

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

参考资料

评论

支持 Markdown