📚 OpenLibraryRent

マルチテナント対応図書貸出管理システム

Finbuckle.MultiTenantによるテナント分離を実現

✨ 特徴

🔐 マルチテナント分離 - Finbuckle.MultiTenantによるアプリケーションレベルの分離
🎫 柔軟なユーザー登録 - オープン/ホワイトリスト/承認制の3モード
📖 Open Library連携 - ISBNから自動で書籍情報を取得
📱 ISBNスキャン - カメラを使ったバーコードスキャン
🔑 権限管理 - きめ細かいロール・権限システム
🚀 Aspire対応 - 開発環境をワンコマンドで起動

🖼️ スクリーンショット


書籍管理	貸出管理

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                        SvelteKit SPA                        │
│                    (Static Site + ZXing)                    │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                  ASP.NET Core Web API                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │   Tenant    │  │    Book     │  │      Rental         │ │
│  │ Controller  │  │ Controller  │  │    Controller       │ │
│  └─────────────┘  └─────────────┘  └─────────────────────┘ │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │              Finbuckle.MultiTenant                      │ │
│  │              + Permission Filters                       │ │
│  └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                     PostgreSQL                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │  Tenant A   │  │  Tenant B   │  │     Tenant C        │ │
│  │  (RLS)      │  │  (RLS)      │  │      (RLS)          │ │
│  └─────────────┘  └─────────────┘  └─────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

🚀 クイックスタート

前提条件

ツール	バージョン	リンク
.NET SDK	10.0+	ダウンロード
Node.js	20+	ダウンロード
Docker	最新	ダウンロード
PostgreSQL	17+	ダウンロード

1️⃣ クローン

git clone https://github.com/your-org/OpenLibraryRent.git
cd OpenLibraryRent

2️⃣ 設定

OpenLibraryRent/appsettings.Development.json を作成：

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=openlibraryrent;Username=postgres;Password=postgres"
  },
  "Authentication": {
    "Microsoft": {
      "ClientId": "your-client-id",
      "ClientSecret": "your-client-secret"
    }
  },
  "Encryption": {
    "Key": "your-32-character-encryption-key!!"
  }
}

3️⃣ 起動

Aspireを使用（推奨）：

dotnet run --project OpenLibraryRent.AppHost

直接起動：

cd OpenLibraryRent
dotnet ef database update
dotnet run

4️⃣ アクセス

🌐 アプリケーション: http://localhost:5000
📖 API ドキュメント: http://localhost:5000/swagger
🗄️ pgAdmin (Aspire): http://localhost:5050

📋 機能詳細

ユーザー登録モード

モード	説明	ホワイトリストユーザー
🔓 Public	誰でもログイン可能	-
🔒 Private	ホワイトリストのみ許可	即座にログイン可能
📝 Approval	申請→承認制	承認スキップでログイン

graph LR
    A[ユーザーログイン] --> B{登録モード?}
    B -->|Public| C[ログイン成功]
    B -->|Private| D{ホワイトリスト?}
    D -->|Yes| C
    D -->|No| E[拒否]
    B -->|Approval| F{ホワイトリスト?}
    F -->|Yes| C
    F -->|No| G{承認済み?}
    G -->|Yes| C
    G -->|No| H[申請画面へ]

権限システム

テナント権限

権限	説明
`tenant.user.read`	ユーザー一覧・詳細閲覧
`tenant.user.manage`	ユーザー作成・編集・削除
`tenant.role.read`	ロール閲覧
`tenant.role.manage`	ロール作成・編集・削除
`tenant.book.read`	書籍閲覧
`tenant.book.manage`	書籍登録・編集
`tenant.rental.read`	貸出閲覧
`tenant.rental.manage`	貸出・返却操作

システム権限

権限	説明
`system.tenant.create`	テナント作成
`system.tenant.read`	テナント一覧閲覧
`system.tenant.manage`	テナント設定変更
`system.tenant.delete`	テナント削除

📁 プロジェクト構成

OpenLibraryRent/
├── 📂 OpenLibraryRent.AppHost/       # Aspireホスト
│   └── AppHost.cs                    # インフラ定義
│
├── 📂 OpenLibraryRent.ServiceDefaults/ # 共通設定
│
├── 📂 OpenLibraryRent/               # メインプロジェクト
│   ├── 📂 Controllers/
│   │   ├── AuthController.cs         # 認証
│   │   ├── TenantsController.cs      # テナント管理
│   │   ├── BooksController.cs        # 書籍API
│   │   ├── RentalsController.cs      # 貸出API
│   │   ├── UsersController.cs        # ユーザー管理
│   │   ├── UserApprovalController.cs # 承認フロー
│   │   └── SystemAuthController.cs   # システム認証
│   │
│   ├── 📂 Models/
│   │   ├── ApplicationUser.cs        # ユーザー
│   │   ├── ApplicationTenantInfo.cs  # テナント
│   │   ├── Book.cs / BookCopy.cs     # 書籍
│   │   ├── Rental.cs                 # 貸出
│   │   └── UserApprovalRequest.cs    # 承認リクエスト
│   │
│   ├── 📂 Services/
│   │   ├── TenantManagementService.cs
│   │   ├── RentalService.cs
│   │   ├── OpenLibraryService.cs     # Open Library API
│   │   └── EncryptionService.cs
│   │
│   ├── 📂 Filters/
│   │   ├── RequireAnyAttribute.cs    # OR条件権限
│   │   └── RequireAllAttribute.cs    # AND条件権限
│   │
│   ├── 📂 OpenLibraryRent.Client/    # SvelteKitフロントエンド
│   │   ├── src/routes/
│   │   │   ├── [tenant]/             # テナント別ページ
│   │   │   │   ├── books/            # 書籍管理
│   │   │   │   ├── rentals/          # 貸出管理
│   │   │   │   ├── users/            # ユーザー管理
│   │   │   │   ├── apply/            # 申請フォーム
│   │   │   │   └── admin/approvals/  # 承認管理
│   │   │   └── create-tenant/        # テナント作成
│   │   └── src/lib/
│   │       ├── stores/auth.ts        # 認証ストア
│   │       └── components/           # UIコンポーネント
│   │
│   └── 📂 Migrations/                # EF Coreマイグレーション
│
└── 📂 submodules/MaskedUUID/         # UUIDマスキング

🔌 API リファレンス

認証

GET  /{tenant}/auth/login          # OIDCログイン開始
GET  /{tenant}/auth/me             # 現在のユーザー情報
POST /{tenant}/auth/logout         # ログアウト

システム認証（テナント作成用）

GET  /api/systemauth/microsoft-login   # Microsoft OAuth開始
GET  /api/systemauth/check             # 認証状態確認

テナント

GET  /api/tenants                      # 一覧（システム管理者）
GET  /api/tenants/by-identifier/{id}   # 識別子で取得
POST /api/tenants/create               # 作成（Microsoft認証必要）
PUT  /api/tenants/{id}/registration-settings  # 登録設定更新

書籍

GET  /{tenant}/api/books                           # 一覧
POST /{tenant}/api/books                           # 登録
POST /{tenant}/api/books/fetch-from-openlibrary/{isbn}  # Open Library取得
GET  /{tenant}/api/books/{id}/copies               # 書籍コピー一覧

貸出

GET  /{tenant}/api/rentals                # 一覧
POST /{tenant}/api/rentals/borrow         # 貸出
POST /{tenant}/api/rentals/{id}/return    # 返却
GET  /{tenant}/api/rentals/overdue        # 延滞一覧

ユーザー承認

POST /{tenant}/api/userapproval/apply               # 申請送信
GET  /{tenant}/api/userapproval/status              # ステータス確認
GET  /{tenant}/api/userapproval/requests            # 申請一覧（管理者）
POST /{tenant}/api/userapproval/requests/{id}/approve  # 承認
POST /{tenant}/api/userapproval/requests/{id}/reject   # 却下

⚙️ 環境変数

変数名	必須	説明
`ConnectionStrings__DefaultConnection`	✅	PostgreSQL接続文字列
`Authentication__Microsoft__ClientId`	✅	Microsoft OAuth Client ID
`Authentication__Microsoft__ClientSecret`	✅	Microsoft OAuth Client Secret
`Encryption__Key`	✅	暗号化キー（32文字）
`Cors__AllowedOrigins`		CORS許可オリジン（本番必須）

🔧 設定例

Microsoft OAuth設定

Azure Portal → アプリの登録
新規登録
- 名前: OpenLibraryRent
- リダイレクトURI: https://your-domain/auth/microsoft-callback
ClientId と ClientSecret を取得

申請フォームのカスタマイズ

テナント設定で JSON でフィールド定義：

[
  {"name": "department", "label": "部署名", "type": "text", "required": true},
  {"name": "employee_id", "label": "社員番号", "type": "text", "required": true},
  {"name": "reason", "label": "利用目的", "type": "textarea", "required": false}
]

🧪 テスト

# 単体テスト
dotnet test

# フロントエンド型チェック
cd OpenLibraryRent/OpenLibraryRent.Client
npm run check

📦 デプロイ

Docker Compose

version: '3.8'
services:
  app:
    image: openlibraryrent:latest
    environment:
      - ConnectionStrings__DefaultConnection=Host=postgres;Database=openlibraryrent;Username=postgres;Password=postgres
      - Authentication__Microsoft__ClientId=${MS_CLIENT_ID}
      - Authentication__Microsoft__ClientSecret=${MS_CLIENT_SECRET}
      - Encryption__Key=${ENCRYPTION_KEY}
    ports:
      - "5000:8080"
    depends_on:
      - postgres

  postgres:
    image: postgres:17
    environment:
      POSTGRES_PASSWORD: postgres
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

🤝 コントリビュート

フォーク
ブランチ作成 (git checkout -b feature/amazing)
コミット (git commit -m 'Add amazing feature')
プッシュ (git push origin feature/amazing)
プルリクエスト作成

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。

Made with ❤️ by Your Team

⬆ トップに戻る

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.github/workflows		.github/workflows
OpenLibraryRent.AppHost		OpenLibraryRent.AppHost
OpenLibraryRent.ServiceDefaults		OpenLibraryRent.ServiceDefaults
OpenLibraryRent.Tests		OpenLibraryRent.Tests
OpenLibraryRent		OpenLibraryRent
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE.txt		LICENSE.txt
OpenLibraryRent.slnx		OpenLibraryRent.slnx
README.md		README.md

License

actbit/OpenLibraryRent

Folders and files

Latest commit

History

Repository files navigation