NARUBROWN/spine has 110 GitHub stars and 13 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and +6 in 15 days. Last checked 2026-11-18 03:59 UTC. Last push 2026-11-14.
計測したスター増加
- 24時間
- 0
- 7日間
- 0
- 15日間
- +6
- 1か月
- 履歴を収集中
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
요청 처리 과정을 명시적으로 드러내는 실행 중심 백엔드 프레임워크, Execution-centric backend framework that makes request handling explicit.
Web・アプリREADME.ja.md
オリジナル한국어 | English | 日本語 | 简体中文 | 繁體中文
リリースチャネル: Preview → RC → Stable。 このソースの対象バージョンは
v0.7.0です。リリース手順、import の移行ガイド、公開済みリリースを参照してください。
v0.6.5 は HTTP・WebSocket・event・validator の公開契約と独立した実装選択を統合します。コアは標準ライブラリのみを使用します。v0.6.5 移行ガイドを参照してください。
Spine
v0.6.0以降、新しいプロジェクトは Spine CLI のnewで作成します。CLI が Echo プラットフォームと依存関係を設定します。既存アプリは移行ガイドを参照してください。開発ソースのイベント連携は
spine.WithEventAdapterと Kafka/RabbitMQ プラットフォームを使用します。旧 boot 設定からの移行は イベントプラットフォーム移行ガイドを参照してください。
開発ソースの WebSocket は
contract/websocketと Gorilla プラットフォームに分離しました。spine.New(echoPlatform.Option(), gorillaPlatform.Option())で両方を選択します。WS 移行ガイドを参照してください。
🦴 Spine
Spineは、リクエストの実行フローを明示するバックエンドフレームワークです。
リクエストがどのように解釈され、実行されるのかを隠しません。
コアコンセプト
- 実行順序と責務をコード構造として固定します
- メソッドシグネチャがAPIの契約です
path.*、query.*、httperr.*のセマンティック型を使用します
企業導入の無償技術サポート
SpringやNestJSで慣れ親しんだビジネスアーキテクチャと開発方法を、Goでも活かせるよう支援します。 Spineの導入を検討中、または利用中の企業や開発チームは、開発者による無償サポートを利用できます。 参加企業数の上限や、一律の支援終了期限は設けません。
- サービスにSpineを適用できるか検討し、コントローラー、サービス、リポジトリの役割と依存関係を確認します。
- 初期設定や関連コードをレビューし、依存性注入(DI)やフレームワークの利用で困っている点を確認します。
- 問題を再現し、原因に応じて回避策や修正方法を検討します。
お問い合わせは24時間365日受け付けます。開発者が対応可能な時間に確認し、応答時間や復旧時間は保証しません。 文章、コード、ログを使った非同期のやり取りを基本とし、追加の議論が必要な場合は打ち合わせの日程を相談します。
本番環境への影響と回避策の有無で優先順位を決めます。 同じ優先順位では、受付順と他の利用者への影響も考慮します。
| お問い合わせの種類 | 判断基準 |
|---|---|
| 緊急 | 本番サービスの主要機能が停止している、またはデータ整合性の問題が発生している場合 |
| 導入を妨げる問題 | ビルド、起動、主要機能のエラーにより導入や開発を進められない場合 |
| 一般 | 使い方や設計の相談、関連コードのレビュー、回避策のあるエラー |
| 改善提案 | 新機能、使いやすさ、ドキュメント、サンプルに関する提案 |
企業側の開発チームが業務機能の実装とサービス運用を担当し、インフラや外部サービスの費用を負担します。 プロジェクト全体の開発、常時運用の代行、企業専用機能の長期開発が必要な場合は、支援範囲を別途相談してください。
サービス概要、現在の技術構成、導入予定の範囲、質問をお知らせください。 エラーの場合は、SpineとGoのバージョン、期待する動作と実際の動作、最小限の再現手順を添えてください。 GitHub Issuesは公開されます。機密情報を除いた概要や最小限の再現コードを共有してください。
推奨環境
- 推奨Goバージョン: 1.27.3
リンク
- 公式サイト: https://spine.na2ru2.me/ja/
- Spine CLI(プロジェクト生成・実行契約の検査): https://github.com/NARUBROWN/spine-cli
- Bun ORM + Swagger統合サンプルプロジェクト: https://github.com/NARUBROWN/spine-user-demo
- Kafka MSAサンプルプロジェクト: https://github.com/NARUBROWN/spine-simple-msa-demo
- シンプルなWebSocketチャットのサンプルプロジェクト: https://github.com/NARUBROWN/spine-simple-chat-demo
Spine CLI で始める
Spine v0.6.0 以降、公式のプロジェクト作成方法は spine new です。Spine CLI のインストールガイドに従って spine コマンドをインストールし、対応バージョンを確認してください。
new はインストールした CLI に含まれる検証済みレシピに従い、互換性のある Spine、Echo プラットフォーム、Echo のバージョンを設定します。選択されたバージョンは生成された go.mod で確認してください。
プロジェクトを作成し、開発サーバーを起動します。
次の例は @latest で正式版 CLI をインストールします。内蔵レシピが、このチェックアウトの Preview コアを生成するとは限りません。HTTP v3 Preview を使う場合はインストールコマンドを go install github.com/NARUBROWN/spine-cli/cmd/spine@preview に置き換え、HTTP v3 移行ガイドを参照してください。@preview は更新されるブランチを追跡します。再現可能なインストールには公開 CLI タグを指定し、spine version と生成された go.mod を確認してください。
go install github.com/NARUBROWN/spine-cli/cmd/spine@latest
spine version
spine new todo-api --module github.com/acme/todo-api
cd todo-api
spine dev
CLI 自体を更新する場合は、同じ go install コマンドを再実行します。spine update はプロジェクトの Spine と Echo プラットフォームの依存関係を更新するコマンドであり、CLI 実行ファイルは更新しません。
別のターミナルで標準の health endpoint を確認します。200 OK と {"status":"ok"} が返ります。
curl http://localhost:8080/health
new は標準で Echo プラットフォームの設定、依存関係のインストール、静的契約の検査とビルドを完了してからプロジェクトを作成します。サーバーは spine dev で起動します。--skip-install でファイルだけを生成した場合は、その後に go mod tidy と go mod download all を実行してください。静的検査で MODULE_GRAPH_UNAVAILABLE が表示された場合も、この2つのコマンドでモジュールのメタデータを揃えてから再検査します。
プロジェクトのディレクトリで契約とローカル検査を実行します。
spine context --root . --json
spine contract check --root . --warnings-as-errors --json
spine verify --root . --warnings-as-errors --json
spine verify は静的契約、コード書式、go vet と Go テストを検査します。データベース、メッセージブローカー、デプロイ環境の動作は別途検証してください。
ジェネレーターは標準で既存ファイルを上書きしません。dry-run の変更内容と base_hash を確認し、同じ値を --if-match に渡してください。
spine g resource order --root . --dry-run --json
spine g resource order --root . --if-match <base_hash> --json
CLI は HTTP、DI、インターセプター、コンシューマー、WebSocket の登録を解析し、契約スナップショットの比較と OpenAPI/AsyncAPI の出力を提供します。手動のプラットフォーム接続と App API は移行ガイド、全コマンドと解析範囲は CLI ドキュメントを参照してください。
支援
SpineはFOSS for All Microgrants 2026の支援対象プロジェクトに選定されました。
FOSS for Allは、持続可能な自由・オープンソースのエコシステムに向けて、 プロジェクトやコミュニティの開発と運営を支援しています。 Spineを支援してくださるFOSS for Allと寄付者の皆さまに感謝します。
ロゴ出典:FOSS for All公式サイト。 FOSS for Allロゴの著作権はFOSS for Allに帰属します(© FOSS for All)。 このロゴはSpineのMITライセンスの対象には含まれません。 ロゴの出典と権利表記。
ライセンス
MIT
