[4ster1sk]

まだ未テスト

Base: develop ← Head: feat/mahjong

概要

misskey-dev/misskey#13112（feat: 麻雀）の実装を Cheripia 向けに移植し、ローカルユーザー4人で遊べる最小構成のヨンマを追加します。

• ルーム作成・参加・準備完了・対局開始
• 打牌、ツモ、ロン、ポン、チー、カン、暗槓、加槓、リーチ
• ツモ和了、ロン和了、流局、次局、東風戦4局での終局
• CPU（AI）との対局
• 対局結果（役・ドラ・点数）表示と最終点数表示

変更内容

麻雀エンジン

• packages/misskey-mahjong を追加
  • 牌・面子・待ち形・役判定・符計算用の待ち判定
  • 4人麻雀の対局エンジン（親子・局進行・鳴き・リーチ・和了）
  • クライアント側の対局状態エンジン
  • 役判定・点数計算のテスト

バックエンド

• MahjongService を追加
  • Redis ベースのルーム管理
  • ルーム作成・参加・退出・準備完了
  • ターンタイマー、鳴き・ロン回答タイマー、次局確認
  • CPU 参加と簡易 AI
  • ルーム単位のロックによる同時操作の競合防止
  • 他家の手牌・暗槓の秘匿
  • 他家のツモ牌・嶺上牌を WebSocket で伏せる処理
• 以下の API を追加
  • mahjong/create-room
  • mahjong/join-room
  • mahjong/show-room
• WebSocket チャンネル mahjongRoom を追加
• CoreModule / ServerModule / Connection / GlobalEventService / JSON schema へ統合

フロントエンド

• /mahjong トップページ
• /mahjong/g/:roomId ルーム画面
  • ルーム URL の共有・コピー
  • CPU 追加、準備完了
  • 対局画面（手牌・捨て牌・副露・リーチ・鳴き・和了）
  • 対局結果オーバーレイ、終局時の最終点数表示
• /games に麻雀へのリンクを追加
• 牌画像・効果音・背景アセットを追加
• 日本語ロケールを追加

ビルド・周辺対応

• pnpm-workspace.yaml / root package.json / backend・frontend の依存へ追加
• Dockerfile、開発用・クリーン用スクリプト、lint / storybook CI、federation compose へ追加
• misskey-js の API 型・streaming 型・API レポートを再生成
• i18n の locale 型を再生成

動作確認

自動テスト

• pnpm --filter misskey-mahjong test
  • 86 tests passed
• pnpm --filter misskey-mahjong build
• pnpm --filter backend typecheck / build
• pnpm --filter frontend typecheck / build
• pnpm --filter misskey-js typecheck / build

手動確認

テスト用 PostgreSQL / Redis を起動し、実際に API と WebSocket で確認しました。

• ローカルユーザー4人でルーム作成 → 参加 → 全員準備完了 → 対局開始
• 打牌、次局進行を確認
• CPU 3人 + 人間1人で開始し、CPU の打牌・ツモ進行を確認
• 他家の手牌・暗槓がクライアントに渡らないことを確認

既知の制限

今回の PR は「まずヨンマが動くこと」を優先した最小構成です。以下は未対応です。

• 三麻
• 東風戦4局固定（親の連荘、本場、供託なし）
• 搶槓、流し満貫、四風連打、九種九牌、四槓散了、三家和了
• 符計算（翻数ベースの簡易点数）
• ゲーム履歴の永続化、ルーム一覧、招待、観戦、CRC による desync 復旧
• 3D 描画
• AI は簡易的（ポン・カンはランダム、ロンは常に宣言、チー・リーチなし）

関連

• Cheripia issue: 麻雀 #22
• 元 PR: feat: 麻雀 misskey-dev/misskey#13112