spring-boot-full-stack

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

モジュールの選択

モジュール	デフォルト	有効化フラグ
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

開発ワークフロー

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

参考資料

• Anthropic Skills 仕様
• OpenSpec - 仕様駆動開発
• Spring Boot ドキュメント