ff_partyfinder（FF14 固定・PT募集ファインダー）

FF14 のロードストーン日記から「固定・PT募集」を検索し、 タイトルとタグを解析してコンテンツ／進行フェーズ／募集ロール／空き枠に分解して一覧表示する。

• PHP 8.2以上 / Laravel 12 / Blade + Tabler 1.7.1 + 素のJavaScript（ビルド不要）
• 外部 API キーは不要（ロードストーンの公開ページを取得して解析する）
• コーディング規約: PER Coding Style (PER-CS) / 静的検査は Laravel Pint
• ビルド工程なし（npm 不要）

設計の詳細・ファイル間の連動仕様は docs/ARCHITECTURE.md を参照。 Tablerの配信・共通コンポーネント・ブラウザ検証手順は docs/UI-DESIGN-SYSTEM.md を参照。

セットアップ

composer install
cp .env.example .env
php artisan key:generate
php artisan test          # ネットワーク不要（HTTPはフィクスチャで差し替え）
php artisan serve         # http://localhost:8000/

.env に秘密情報は不要。APP_KEY だけ key:generate で生成する。

構成

ファイル	役割
app/Services/LodestoneBlogService.php	検索URL組み立て・HTML取得（3件並列＋5分キャッシュ）・DOMXPathでの抽出・日記本文の取得
app/Services/RecruitAnalyzer.php	タイトルから「コンテンツ／フェーズ／募集ロール／空き枠」を解析、コンテンツ別のグルーピング
config/ff14.php	解析に使う語彙（コンテンツ辞書・ロール名）。パッチ更新時はここを直す
app/Http/Controllers/PartyFinderController.php	検索条件の解決・バリデーション・「固定」絞り込み・並び替え・CSV出力
resources/views/partyfinder/index.blade.php・partials/	検索フォーム・保存条件・除外・結果（表／カード）
resources/views/layouts/partyfinder.blade.php・components/partyfinder/	専用レイアウトと共通UI部品
public/css/partyfinder.css・public/js/partyfinder.js	Tablerへの最小補正／保存・復元・除外・検索中状態
public/vendor/tabler/1.7.1/	公式Tabler CSS・JS・ライセンス・取得元
routes/web.php	GET /（検索）、GET /export（CSV）
tests/Feature/RecruitAnalyzerTest.php	解析の回帰テスト（実際の日記タイトルをケースに使用）
tests/Feature/PartyFinderPageTest.php	画面・CSVの結合テスト（tests/Fixtures の実HTMLで Http::fake）

前身のスクリプトとの対応

もともと手元で動かしていた Python スクリプト（検索条件が固定でコンソール出力のみ）を、 条件をWebから変えられるように作り直したもの。

Python版	Web版
base_url の q パラメータ	「ロードストーン検索キーワード」
keywords（タイトルAND判定）	「絞り込みキーワード（AND）」
range(1, 11)	「走査ページ範囲」（1〜20で指定可）
print 出力	カード一覧表示 ＋ CSVダウンロード

Python版との差異:

• Python版は find_all でページ全体を走査していたため、検索結果と無関係な 「ピックアップ日記」も判定対象に含んでいた。Web版は entry__block__wrapper 配下（＝実際の検索結果50件）だけを対象にしている。
• 除外キーワード、投稿期間の絞り込み、ホームワールド／言語／並び順の指定、 投稿日時・コメント数・いいね数・タグの表示を追加している。

募集内容の解析（コンテンツ別の表）

検索結果のタイトルを解析して、募集の中身を項目に分けて表示する。 基本の判定材料はタイトルとタグ。本文取得がONの場合は、フェーズ不明の記事だけ 本文を読み補完する（下記「本文からのフェーズ判定」）。実際の募集日記はタイトルに条件を詰め込む書き方が 主流なので、これで実用になる範囲を拾っている。

読み取れなかった項目は推測で埋めず「—」と表示する。

項目	判定内容
固定	タイトルに「固定」を含むか。「タイトルに『固定』を含むものだけ」で絞り込める（初期値OFF）
コンテンツ	config/ff14.php の辞書で判定。載っていないものは汎用ルール（8.0零式 / 天獄編零式 / 極◯◯ / ◯◯激闘戦）で拾い、それでも不明なら「その他・不明」
フェーズ	P3 / フェーズ2 / 1-4層 / 最初から / アポカリから など（下記）
募集ロール	MT ST PH BH H1 D1〜D4 近接 レンジ キャス タンク ヒーラー とジョブ名。D2以外 は取り消し線で表示
空き枠	@4 ＠２名 募集 1名 から。済1名 は数えない

募集ロールは検索条件としても使える（下記「募集ロールで絞り込む」）。

表記ゆれの吸収と誤爆よけ:

• 全角英数（Ｄ３）・半角カナ（ﾒﾝﾊﾞｰ）・波ダッシュ（〜 ～）を正規化してから照合する。
• ＠MTSTD4BH のように略称が連続する書き方、D1orD2 のような or 区切りに対応。 逆に BEST の ST のような英単語の一部は拾わない。
• H3構成 T3H1構成 はPT構成の説明なので募集ロールにしない。
• DC不問 はロール指定として扱わない（ジョブ不問 なんでも は「ジョブ不問」として拾う）。
• 9月中旬から 集まり次第 のような開始時期はフェーズにしない。

フェーズの出し分け

全体の「最初から」と「P5の最初から」は別物として表示する。

タイトル	表示
【最初から】絶妖星乱舞 週5	最初から
…@クリアorP5最初からも可	P5最初〜
絶妖星乱舞 P3後半から攻略	P3後半〜
絶エデンP3アポカリから	P3アポカリ〜
P3BH3•4回目〜（修飾語が7文字以上）	P3〜

• P の後ろの修飾語（最初 後半 時間切れ やギミック名）は 6文字までラベルに載せる。 長いものは列が崩れるので落とし、元の表記はフェーズの開閉表示とCSVで確認できる。
• JP22時 の P はフェーズではないので拾わない。ただし クリアorP5 のように or/and でつないだ書き方は拾う。

本文からのフェーズ判定（任意・低速）

「フェーズ不明の記事は本文も読む（遅い）」を入れると、タイトルからフェーズを読めなかった 日記だけ本文を取りに行って判定する。本文由来のフェーズには表に 本文 バッジが付き、 表示ラベルと原文が異なる場合は、フェーズを開くと本文の表記が出る。CSVには「フェーズの判定元」列が付く。

• 本文は div.txt_selfintroduction から取り、<br> とブロック要素を改行にして行単位で見る。
• 取得は3件並列・30分キャッシュ。1回の検索で読むのは最大60件まで （超えた分はサマリに「本文未確認 N 件（上限）」と出す）。
• 実測: 24件の本文取得で +1.4秒（キャッシュ後は0.1秒）。24件中8件のフェーズが埋まった。

判定は「募集の話をしている行」に絞ってから行う。本文には紛らわしい記述が多いため:

拾わないもの	例
処理法の羅列	P1,2,3リリドP4,P5ぬけまる（安置基準/扇前）
ギミック解説	・P2 カーターライズ スキップしません
早期解散などの条件文	火力不足によりP2.5の進捗が芳しくない場合は早期解散もあります
現メンバーの進捗	✒T1：暗黒騎士 Mike Tester(p3～) / D3:募集中
一般的な言い回し	最初から全部完璧に覚えなくていいです / 各拡張最初以外の零式の初週経験がある方

具体的には、行が「攻略／募集／進捗／開始／スタート／固定」のいずれかを含むことを条件にし、 ロール名で始まる行（D3: ✒T1：）と、見出しが募集条件でない 見出し：値 の行を落とす。 P2.5 のような小数は進捗の話とみなさない。1-3層未クリアでも4層から は範囲より 「N層から」を優先する。

実際の募集日記24件（タイトルにフェーズなし）で検証して、24件とも手作業の判定と一致・ 誤検出0。うち8件のフェーズが判明した（最初から 6件 / P2〜 1件 / 4層 1件）。 読めなければ「不明」のままにする。曖昧なものは拾わない方に倒してある。

募集ロールで絞り込む

フォームの「募集ロールで絞り込む」で、MT / ST / H1 / H2 / D1〜D4 / 不明 を選ぶ（複数選択＝OR）。 何も選ばなければ絞り込まない。除外件数はサマリに「ロール条件で除外 N 件」と出る。

枠と表記の対応は config/ff14.php の role_filters に定義してある。 タイトルの書き方が揺れるので、枠の別名・総称・ジョブ名もまとめて拾う。

選択	拾うタイトルの表記
MT / ST	MT ST タンク ＋ タンクジョブ名（ナイト・戦士・暗黒騎士・ガンブレイカー）
H1	H1 PH ピュアヒーラー ヒーラー 白魔道士 占星術師
H2	H2 BH バリアヒーラー ヒーラー 学者 賢者
D1 / D2	D1 D2 近接 メレー DPS ＋ 近接ジョブ名（モンク・竜騎士・忍者・侍・リーパー・ヴァイパー）
D3	D3 レンジ 遠隔 DPS 吟遊詩人 機工士 踊り子
D4	D4 キャス DPS 黒魔道士 召喚士 赤魔道士 ピクトマンサー
不明	ロールの記載を読み取れなかった日記

• ＠6なんでも 全ジョブ可 のような枠を限定しない募集は、どの枠を選んでも出る （role_filter_wildcards）。ただし「不明」だけを選んだときには出ない。 ほかに枠が書いてあれば（D4募集…全ジョブ分トークン周回）、その枠の募集として扱う。
• ST以外 と書かれている日記は、ST を選んだときには出さない。
• ロールをタイトルに書かない募集も多い（実測で約1/3）。取りこぼしたくないときは 「不明（タイトルに記載なし）」も一緒に選ぶ。

フェーズで絞り込む

フォームの「フェーズで絞り込む」で、最初から / P1〜P9 / その他 / 不明 を選ぶ（複数選択＝OR）。 何も選ばなければ絞り込まない。除外件数はサマリに「フェーズ条件で除外 N 件」と出る。

• 区分は「フェーズ×募集枠の件数」の行と同じ。P5最初〜 P5以降 はどちらも P5。 その他 は 3層 アポカリから のような P 番号以外の表記。選択肢は config/ff14.php の phase_filters。
• 本文から読んだフェーズも使うので、絞り込みは本文の取得のあとに行う。
• 「不明」を選ばないと、フェーズを読めなかった日記（本文を読まない設定のとき・本文の読み込み上限を超えた分を含む）は出ない。

常に除外する語

config/ff14.php の title_ng_words（既定は 感想）を含むタイトルは、画面の除外キーワードに関係なく外す。 「絶妖星乱舞感想戦」のような募集ではない日記が混ざるため。

件数の集計

結果サマリの下に 「募集枠の内訳」（全体のロール別・ジョブ別件数）を出す。 さらにコンテンツ別の表では、見出しの下に 「フェーズ×募集枠の件数」 を折りたためる表で出す。 「P5のレンジ募集が1件、タンクは2件」を読み取るための表。

This is the beginning of the README. Read the rest at the original. Read the full README ↗