/** * 検索の照合に使う文字列の正規化（指示書AG D-1〜D-5）。 * * ★5系統（清掃詳細ログ / 施設マスタ / スケジュール / D-S制御盤 / レポート）が * すべてこの1本を呼ぶ★。CLAUDE.md §4.6 が契約フラグに課したのと同じ規律 * （「純粋関数1箇所に閉じ込める」）を、検索の照合規則にも当てる。 * 以前は照合規則が3種類に分裂しており、同じシリアルを同じ社内画面で探しても * 入力欄によって当たったり当たらなかったりしていた。 * * ------------------------------------------------------------------------ * ★なぜ強さの違う2種類があるのか★ = フィールドによって記号の意味が違うから（D-2） * ------------------------------------------------------------------------ * | 強さ | 使うフィールド | * |----------------------|-----------------------------------------------------| * | `foldName`（強） | facility_name / prefecture | * | `foldPlain`（弱） | address / serial_number / maker / model / model_name | * * ★施設名だけ強いのは、店名の記号が表記ゆれで、桁位置の意味を持たないから★ * 実データが `ドン・キホーテ戸塚` のとき、`ドンキホーテ` や `ドンキ` と打つのは * 自然な操作だが、記号を残したままでは 0件になる。 * * ------------------------------------------------------------------------ * ★★シリアルと住所に `foldName` を使ってはいけない★★（D-2。実データで誤ヒットする） * ------------------------------------------------------------------------ * 住所 — ★ハイフンは番地の区切り★: * * 東京都○○区1-2-3 →（記号除去）→ 東京都○○区123 * 東京都○○区2-3-4 →（記号除去）→ 東京都○○区234 * * 住所欄に `23` と入れるとこの2件が両方ヒットしてしまう（現状はどちらもヒットしない）。 * 言い換えると `1-23番地` と `12-3番地` と `1-2-3番地` が区別できなくなる。 * * シリアル — ★桁の境界が消える★: * * PUDU-CC1-0001 →（記号除去）→ PUDUCC10001 * * シリアル欄に `10001`（連番10001号機のつもり）と入れると、`CC1` の `1` と `0001` が * 繋がった `PUDU-CC1-0001` にヒットしてしまう（現状は0件）。 * ★そして利得がほぼ無い★ — 実データの主形式 `8111R5628060011` には記号が1文字も無く、 * 記号除去は no-op。`DS-001` 形式のために上のリスクを負うことになる。 * さらに `lib/config/index.ts` が「シリアルの文字種は絞らない（形式が未確定）」と * 明示しており、「記号は意味を持たない」という前提を置くこと自体が * CLAUDE.md §7「仕様が不明な箇所を推測で実装しない」に反する。 * * メーカー・機種は `ROBOT_MODELS`（`lib/config/index.ts`）に記号が1文字も無いので、 * 記号除去の効果がそもそもゼロ。直すべきは `cc1` が当たらないことのほうである。 * * ------------------------------------------------------------------------ * ★入れていないもの（意図的に残した穴。D-4。ユーザーが選ばなかった。2026-09-13）★ * ------------------------------------------------------------------------ * - ★カナ・全半角の統一★（Unicode 正規化 / NFKC を含む） * → `ﾄﾞﾝ` や `どん` では `ドン・キホーテ` を引けないまま。 * - ★スペース区切りの AND 検索★ * → `ドン・キホーテ 戸塚` はスペースが除かれて1語として扱われる。 * - ★英字とカナの読み替え（`MEGA` ⇄ `メガ`）★ * → どの語を対にするかは仕様判断（CLAUDE.md §7）。 * ★実店舗名が `MEGAドン・キホーテ` なので「メガドンキホーテ」では引けない。これは仕様★。 * 不具合として報告されたら、この行と指示書AG D-4 を示すこと。 * * ------------------------------------------------------------------------ * ★正規化は必ず「両側」に掛ける（D-5）★ * ------------------------------------------------------------------------ * 入力側だけ正規化してもデータ側の中点が残るので、結局ヒットしない。 * 呼び出し側が片側だけ正規化する間違いをできないよう、比較まで含めた * `includesFoldName` / `includesFoldPlain` を使うこと（`foldName` を直接呼ばない）。 * * ★DBアクセスなし・例外を投げない純粋関数★（CLAUDE.md §9.1。表示整形なので `lib/format/`）。 */ /** * ★`foldName` が除く記号（D-3）★。これ以外は除かない。 * * | 種類 | 文字 | 何のため | * |------------|-------------------------------------------------------|----------------------------------------------| * | 中点 | `・`(U+30FB) `･`(U+FF65) `·`(U+00B7) `•`(U+2022) | `ドンキホーテ` → `ドン・キホーテ`（本命） | * | 長音 | `ー`(U+30FC) | `サーバ` で `サーバー` を引けるのと同じ | * | 空白 | 半角スペース(U+0020) / `　`(U+3000) / タブ(U+0009) | `ドンキホーテ港南` → `MEGAドン・キホーテ 港南` | * | ハイフン類 | `-`(U+002D) `‐`〜`―`(U+2010-2015) `－`(U+FF0D) `_`(U+005F) | 店名の区切り | * * ★正規表現の文字クラスではなくコードポイントの集合で持つ理由★ * 1. 除く文字に半角スペース・全角スペース・タブが含まれ、リテラルで書くと * **読んで確認できない**（空白とタブが目で見分けられない）。 * 2. 文字クラスの中では `-` が範囲指定に化ける。`[…\t-‐…]` のように並べると * タブから U+2010 までの**約8000文字**が静かに除去対象になり、 * エラーもテスト失敗も出ないまま検索結果だけが狂う。 */ const NAME_SYMBOL_CODE_POINTS: readonly number[] = [ // 中点4種 0x30fb, // ・ KATAKANA MIDDLE DOT 0xff65, // ･ HALFWIDTH KATAKANA MIDDLE DOT 0x00b7, // · MIDDLE DOT 0x2022, // • BULLET // 長音 0x30fc, // ー KATAKANA-HIRAGANA PROLONGED SOUND MARK // 空白3種 0x0020, // 半角スペース 0x3000, // 　 IDEOGRAPHIC SPACE 0x0009, // タブ // ハイフン類 0x002d, // - HYPHEN-MINUS 0x2010, // ‐ HYPHEN 0x2011, // ‑ NON-BREAKING HYPHEN 0x2012, // ‒ FIGURE DASH 0x2013, // – EN DASH 0x2014, // — EM DASH 0x2015, // ― HORIZONTAL BAR 0xff0d, // － FULLWIDTH HYPHEN-MINUS 0x005f, // _ LOW LINE ]; const NAME_SYMBOLS: ReadonlySet = new Set( NAME_SYMBOL_CODE_POINTS.map((code) => String.fromCodePoint(code)) ); /** * 大文字小文字だけを揃える（★記号は残す★）。 * 住所・シリアル・メーカー・機種で使う（記号を除いてはいけない理由はファイル冒頭）。 */ export function foldPlain(value: string): string { return value.toLowerCase(); } /** * 大文字小文字を揃え、さらに記号（中点・長音・空白・ハイフン類）を除く。 * 施設名・都道府県で使う。除く記号の集合は `NAME_SYMBOL_CODE_POINTS` の表を見ること。 * * ★記号だけの入力（例 `・`）は空文字になる★ — これは正しい（除く記号しか無いのだから）。 * ★この関数は「空文字になった」という事実を返すだけで、当たり外れは決めない★。 * ★記号だけの入力を「当たらない」に倒す判断は `includesFoldName` が持つ★ * （2026-09-14。理由はそちらの docstring）。★ここを変えないこと★ — * `foldName("・") === ""` を固定した既存テストは正しい。 */ export function foldName(value: string): string { let folded = ""; for (const char of foldPlain(value)) { if (!NAME_SYMBOLS.has(char)) folded += char; } return folded; } /** * haystack と needle の**両方**を `foldName` に通してから部分一致を見る。 * 施設名・都道府県の照合はこれを使う（D-2 / D-5）。 * * ------------------------------------------------------------------------ * ★記号だけの入力は「当たらない」（0件）★（★ユーザー判断 2026-09-14。案A★） * ------------------------------------------------------------------------ * | 入力（needle） | 判定 | * |---------------------|------------------------------| * | `""`（未指定） | ★true（素通し）★ | * | `・` `-` `　` など | ★false（記号だけ）★ | * | `ドン・` | 従来どおり（記号を除いて照合）| * * ★★なぜ「未指定（空文字）」と「記号だけ」を区別するのか★★ * どちらも `foldName` を通せば `""` になるが、★利用者の意図が正反対★である。 * - ★`""` は「絞り込まない」という指示★ … 一覧を全部見たい。素通しが正しい。 * - ★`・` は「この語で絞り込む」という指示★ … 利用者は何かを入力している。 * ★これを素通しにすると「検索したのに全件が出る」★ — 0件と違って * ★画面上は成功に見えるので、打ち間違いに気づけない★。 * ★キーボードの切替ミスで `-` だけ残った状態で「絞り込めている」と誤認するのが * いちばん危ない★（翌朝確認の運用で、見落としが「全件表示」に紛れる）。 * ★`foldName(needle) === ""` だけで判定してはいけない★ — それでは `""` も巻き込んで * 未指定が 0件になり、★施設名を入力していないのに一覧が空になる★ * （`facilityIdsMatchingName` の `null` / `[]` の区別と同じ罠）。 * * ★★なぜ `includesFoldPlain` を同じにしないのか★★（★揃えないのが正しい★） * `foldPlain` は★記号を残す★ので、`-` は `-` のまま照合される。 * ★`-` はシリアル `PUDU-CC1-0001` に実際に当たる★ = ★意味のある検索★であり、 * 弾いてはいけない。施設マスタ・スケジュール・D-S制御盤の検索欄は * ★「施設名 OR シリアル」★なので、`-` と打つと * ★施設名では 0件・シリアルでは当たる → ハイフン入りのシリアルの行だけが出る★。 * これが狙った結果である（★「全件」でも「0件」でもない★）。 * ★`includesFoldPlain` にも同じ早期 return を足さないこと★ — 足すと * ★シリアルをハイフンで探せなくなる★。 */ export function includesFoldName(haystack: string, needle: string): boolean { // 1. 未指定 — 絞り込まない（★ここは従来どおり★） if (needle === "") return true; const foldedNeedle = foldName(needle); // 2. 記号だけ — 入力はあるのに条件が消えるので、素通しではなく「当たらない」に倒す if (foldedNeedle === "") return false; // 3. それ以外 — 両側を `foldName` に通して部分一致（D-5） return foldName(haystack).includes(foldedNeedle); } /** * haystack と needle の**両方**を `foldPlain` に通してから部分一致を見る。 * 住所・シリアル・メーカー・機種の照合はこれを使う（D-2 / D-5）。 */ export function includesFoldPlain(haystack: string, needle: string): boolean { return foldPlain(haystack).includes(foldPlain(needle)); }