Oplus-server

OplusBot 現時点の全容¶

• Discordサーバー「Oplus」向けの総合管理Bot
• Python / discord.py / PostgreSQL で構築
• VPS上で systemd により常時起動
• DB名は discordbot
• サーバー内通貨は zel
• 公式サイト oplus-official.com と同じDBを共有する方針

実装済みの主な機能¶

• 面談管理

  • 面談開始
  • 性別ロール付与
  • 面談合格処理
  • 仮メンバー期間管理

• 仮メンバー管理

  • 仮メンバー期間の確認
  • 期限切れ後の評価中移行
  • 手動バッチ実行

• 招待・紹介コード

  • 個人紹介コード発行
  • 紹介コード入力
  • 紹介者・入力者への zel 報酬付与

• zelウォレット

  • 残高確認
  • 管理者による対象者確認
  • 取引履歴確認
  • 各種報酬・購入履歴の記録

• ランクシステム

  • BRONZE ～ SINGULARITY までのランク管理
  • RP / MP 管理
  • /rank get 画像表示
  • /rank top 画像ランキング表示
  • RPランキング / MPランキング切り替え
  • ランク経験値バー表示
  • ランク画像・進行バーの素材反映
  • ランクロール同期
  • 全員同期ジョブ
  • RP / MP 増減ログ
  • ランク履歴表示
  • JST時刻対応

• ランクシーズン

  • Generation / Split 管理
  • 現在シーズン表示
  • シーズン一覧
  • シーズン作成
  • 次Split移行
  • リセットプレビュー
  • ランクリセット実行
  • 全シーズン情報リセット
  • リセットジョブ状態確認
  • 1000人規模を想定したジョブ処理

• ランク報酬

  • ランク到達報酬
  • Generation単位で報酬管理
  • 受け取り済み管理
  • 管理者による再計算・付与確認
  • 報酬額は累計最大 500,000 zel

• VC滞在ポイント

  • RPはVC滞在で加算
  • MPはMASTER以上向け
  • MPは最低2人以上、AFK除外、サーバースピーカーミュート除外
  • Botは判定対象外

• 個室システム

  • 通常個室作成
  • 鍵付き個室作成
  • 通常個室は空室時に自動削除
  • 鍵付き個室は空室でも保持
  • 通常個室はカテゴリ権限を継承
  • 鍵付き個室は専用カテゴリ対応
  • 直接削除されたVCのDB補正
  • 5分ごとの存在確認
  • 個室ログ出力

• 通常個室パネル

  • 部屋名変更
  • 人数上限 1人 / 2人 切り替え

• 鍵付き個室パネル

  • 部屋名変更
  • 招待
  • 招待一覧
  • 招待取り消し
  • 人数枠購入
  • 人数上限設定
  • 有効期限延長
  • 部屋削除
  • 所有者確認

• 鍵ショップ

  • 1日鍵
  • 3日鍵
  • 1週鍵
  • 1月鍵
  • 購入確認
  • 所持鍵一覧
  • 鍵価格管理
  • 鍵使用による鍵付き個室延長

• 個室管理者コマンド

  • 個室一覧
  • 個室詳細
  • 強制削除
  • 所有者確認
  • 鍵付与
  • 鍵剥奪
  • 鍵所持確認
  • 管理系操作ログ

• Oplusカード連携

  • Botから /oplus_card でカード表示
  • 自分のカード表示
  • 対象ユーザー指定表示
  • 生成済みカード画像を公式サイト側ディレクトリから取得
  • /home/botuser/oplus-official/public/generated/cards/{discord_user_id}.png を参照
  • Embedではなく画像単体で送信

• カード素材管理

  • /card_item grant
  • /card_item revoke
  • /card_item list
  • /card_item catalog
  • 一般ユーザーは自分の所持素材を確認可能
  • 管理者は対象指定可能
  • 素材一覧は画像表示対応
  • ページング対応

• サーバーステータス・ヘルスチェック

  • Bot稼働確認
  • DB接続確認
  • 主要状態確認

今後の実装予定¶

• Oplusカード / 公式サイトDB連携の仕上げ

  • /card UIをDB素材一覧へ完全移行
  • 未所持素材の表示防止
  • 未所持素材の保存防止
  • profile_settings 保存API実装
  • localStorage保存からDB保存へ移行
  • カード保存時の画像自動生成
  • Bot側カード再生成コマンド

• 個室システム仕上げ

  • /room_admin 周りの細かい確認
  • 管理者用ログの整理
  • 鍵付き個室の料金・枠購入バランス調整
  • 個室利用履歴の見やすさ改善

• ランクシステム仕上げ

  • シーズン運用開始前の最終確認
  • 報酬バランス調整
  • ランク通知文の調整
  • ランキング画像の細部調整
  • 大規模同期時の監視性向上

• ショップ機能拡張

  • 鍵以外の商品追加
  • Oplusカード素材販売
  • 限定素材販売
  • 購入履歴表示
  • 管理者による商品管理

• 公式サイト連携

  • Discordログインユーザーごとのカード素材表示
  • 所持zel表示
  • カード編集内容のDB保存
  • WebとBotのカード表示統一
  • 将来的なPass / Game / Shop連携

• 評価システム

  • 内容は後で再設計予定
  • 評価コマンド
  • 評価履歴
  • 評価者権限
  • ランクや報酬との連動
  • 不正防止設計

• 運用・保守

  • DBバックアップ手順整理
  • migration管理整理
  • Redmineでチケット管理
  • 本番反映手順の標準化
  • エラーログ監視
  • 権限設定の最終整理