Snail - 企業向けマイクロサービス高速開発スキャフォールディング

クイックスタート • ドキュメント • 貢献 •

🐌 Snail - 軽量 Spring Boot 高速開発スキャフォールド

Snail は Spring Boot 3

をベースにしたモダンなマイクロサービス高速開発フレームワークであり、認証・認可・ゲートウェイ・リソースサービス等のコア機能をすぐに利用でき、企業の安全・拡張可能なクラウドネイティブアプリケーション構築をサポートします。

🚀 すぐ使える | 安全・信頼性 | 拡張性 | フロント・バック一体化

🌟 特長

• ✅ 最新技術スタック：Spring Boot 3.5.5 + Spring Cloud 2025.0.0 +

• 🔐 OAuth2認証・認可：Spring Security + JWT 統合、統合認証・細粒度権限管理をサポート
• 🌐 マイクロサービスアーキテクチャ：モジュール分割、認証・認可・ゲートウェイ・リソースサービスを含み、独立デプロイと水平スケールに対応
• ⚡ 高パフォーマンスゲートウェイ：Spring Cloud Gateway ベースでルーティング・レート制限・ブレーク・認証を実現
• 🧩 クラウドネイティブ対応：Nacos、Sentinel、Seataと互換、サービス発見・構成管理・分散トランザクションに対応
• 🎨 モダン管理画面：shadcn-vue/ui

• 📚 充実したドキュメント：アーキテクチャ設計・デプロイガイド・APIドキュメント・二次開発説明を網羅

🛠 技術スタック

| カテゴリ | 技術 | |-----------|-------------------------------------------------------------------| | バックエンドフレームワーク | Spring Boot 3.5.5, Spring Cloud 2025.0.0, Spring Security, OAuth2 | | マイクロサービス管理 | Nacos（登録センター & 設定センター）, | | ゲートウェイ | Spring Cloud Gateway | | データベース | MySQL 8 | | フロントエンドフレームワーク | Vue 3 + Vite + TypeScript + shadcn/ui | | ビルドツール | Maven, Docker, Docker Compose | | 監視 | Spring Boot Actuator, Prometheus（オプション）, Grafana（オプション） |

🏗 プロジェクト構成

snail/
├── authentication/           # 認証サービス（OAuth2 認可サーバー）
├── authorization/          # 認可サービス（権限管理、ロール、メニュー）
├── gateway/               # APIゲートウェイ（ルーティング、認証、レート制限）
├── resource/              # リソースサービス（ビジネスAPIサンプル）
├── snail-vue-app/          # 管理画面（Vue3 + shadcn/ui）
└── pom.xml                      # Maven 親プロジェクト