3D Print Log

3D Print Log API

3D Print Log を支えるバックエンド API です。3D プリント、プリンター、フィラメントを追跡するウェブアプリケーションで、本番環境では api.3dprintlog.com/swagger で稼働しています。

機能

• プリント — 所要時間、材料の使用量、品質評価、画像とともにプリントジョブを記録します
• プリンター — プリンターごとの統計情報を確認しながら、プリンターの一覧を管理します
• フィラメント — フィラメントの在庫、使用量、コストを追跡します
• プロジェクト — 関連するプリントをまとめ、プロジェクト単位の画像ギャラリーを作成します
• スライサー連携 — Cura、OrcaSlicer、PrusaSlicer、Bambu Studio からプリント設定を直接インポートします
• プリンター Webhook — OctoPrint および Klipper/Moonraker との連携により、プリントを自動記録します
• 電気料金の追跡 — プリンターごとのワット数を記録し、プリントごとの電気代を計算します
• 二重認証 — ウェブアプリには Auth0 JWT Bearer、連携には API キー（X-Api-Key ヘッダー）を使用します
• 画像のアップロード — Azure Blob Storage を使って、プリントごとおよびプロジェクトごとの画像を保存します

API ドキュメント

稼働中の API をご覧ください：api.3dprintlog.com/swagger

はじめに

ローカル環境のセットアップ、設定、テストの実行については、CONTRIBUTING.md をご覧ください。

フロントエンドは HoffmanEngineering/3d-print-log-ui にあります。ほとんどの機能開発では、両方をローカルで実行する必要があります。

技術スタック

• ASP.NET Core (.NET 10)
• Entity Framework Core + SQL Server
• Auth0（JWT Bearer 認証）
• Azure Blob Storage（ファイルストレージ）
• Stripe（サブスクリプションの課金）

インフラストラクチャ

本番環境は Azure（App Service、SQL Server、Blob Storage）で稼働しています。この部分は手動で管理されています。例外はメールです。Amazon SES、その DNS、イベント Webhook トピックは、HoffmanEngineering/3d-print-log-infra の Terraform で定義されています。

メールは Email セクションで設定します（PrintLogApi/Email/EmailOptions.cs にすべてのキーとデフォルト値が記載されており、サンプルの appsettings ファイルで設定の構成を確認できます）。デフォルトでは無効で、Email:Enabled が true になるまでメールは送信されません。docs/email-runbook.md ではドライラン、本番稼働への移行、キーのローテーション、単一インスタンス要件について説明し、docs/email-metrics.md ではホールドアウト測定について説明しています。

貢献にインフラストラクチャの変更（新しい環境変数、Azure リソースの設定など）が必要な場合は、コードのリリース前にメンテナーが変更を調整できるよう、PR の説明にその旨を明記してください。

質問とディスカッション

使い方に関する質問は、3D Print Log Discussions で尋ねるのが最適です。この掲示板はプロジェクト全体（ウェブアプリ、このリポジトリ、2 つのスライサープラグイン）への窓口なので、質問先のリポジトリを調べる必要がなく、今後同じ質問をする人も回答を検索できます。

バグ報告や機能リクエストは、引き続きこのリポジトリのイシューに投稿してください。

AI エージェントと一緒に使う

API は https://api.3dprintlog.com/mcp で MCP サーバー を公開しており、 このリポジトリでは、エージェントが MCP サーバーを適切に使う方法を説明するエージェントスキルも公開しています： skills/3d-print-log。

# The skill, for any agent the skills CLI supports
npx skills add HoffmanEngineering/3d-print-log-api

# The skill and the MCP server together, as a Claude Code plugin
claude plugin marketplace add HoffmanEngineering/3d-print-log-api
claude plugin install 3d-print-log@3d-print-log

リポジトリのルートは Agent Plugins パッケージでもあります（plugin.json と mcp.json）。

開発を支援する

3D Print Log が役に立ったと感じたら、開発へのご支援をご検討ください。

• Pro に登録して、広告なしの利用と追加のクラウドストレージをご利用ください
• PayPal で寄付して、コーヒーをごちそうしてください
• Patreon でPatron になる

ライセンス

GNU Affero General Public License v3.0