SQLの致命的なバグをいくつか修正

[TinyKitten]

Summary by CodeRabbit

リリースノート

• 新機能

  • 駅名・路線名の検索機能を改善し、ひらがな・カタカナの正規化に対応しました
  • ローカライズされた駅名・路線名と色情報の表示精度を向上させました

• テスト

  • 日本語名前の正規化処理に関する包括的なテストスイートを追加しました

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

概要

このPRは、駅・路線データの検索・取得機能を改善するもので、COALESCEを用いた駅名・路線色のエイリアスデータ統合、LEFT JOINからINNER JOINへの結合タイプの厳密化、日本語駅名の正規化処理の追加、および包括的なユニットテストの拡充を行っています。

変更内容

コホート / ファイル(s)	変更概要
SQLクエリ・メタデータ .sqlx/query-25923b43426ac7b1829aaf1c726635b00edeb2b60996e3e7333772ed9202f327.json	COALESCEを用いた駅名・路線色のエイリアスデータ統合。line_name、line_name_k、line_color_cなどの列をエイリアスデータ経由で解決。スキーママッピングと出力カラムの大幅な再編。
SQLクエリ・メタデータ .sqlx/query-269872b7f724f7361c016b696ddc05ca06ee06027d6a0e4bd07cf73e8554226b.json	station_station_typesとtypesのLEFT JOINからINNER JOINへの変更。JOIN条件にフィルタリングロジックを移動し、より厳密なマッチングを実現。
正規化処理テスト stationapi/src/domain/normalize.rs	ひらがな→カタカナ変換、全角→半角変換、混合入力シナリオなど、包括的な正規化ユニットテストスイートを追加。テスト対象：東京の駅名パターン等の実践的ケース。
路線リポジトリ stationapi/src/infrastructure/line_repository.rs	find_by_station_idクエリをCOALESCEベースのエイリアスデータ統合に修正。line_group_cd?とtype_cd?オプショナルフィールドの処理を追加。Noneおよび Some シナリオのテスト追加。
駅リポジトリ stationapi/src/infrastructure/station_repository.rs	get_by_nameに正規化ベースの検索パターン生成を実装（normalize_for_searchの適用）。JOIN条件を明示化し、station_station_typesの結合ロジックを更新。日本語駅名パターンの正規化テストを追加。
クエリユースケース stationapi/src/use_case/interactor/query.rs	get_stations_by_nameの呼び出し時に正規化ステップを削除（station_nameを直接渡すように変更）。DBレイヤーで正規化処理を一元管理。

推定レビュー工数

🎯 3 (Moderate) | ⏱️ ~25分

関連する可能性のあるPR

• 経路検索関係のバグを修正 #1323: line_group_cdフィールドの抽出・伝播方法の変更に関連
• 名前検索でIDが被らないようにした #1343: station_repository.rsのCOALESCE/路線名投影の修正に関連
• 全ての種別が停車しない駅を路線リストに入れない&駅検索パフォチュー #1189: station_repository.rsとline_repository.rsの同一SQL・結合ロジック変更に関連

推奨レビュアー

• 10mocy

ポエム

🐰 ぴょんぴょん、正規化すれば
駅名もぐっと整い、🚃
COALESCEで色も名前も
ふわふわ、つながる〜✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 77.78% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	プルリクエストのタイトルは、SQLの致命的なバグの修正という主要な変更内容を的確に要約しており、複数のSQLクエリとリポジトリコードの修正を含む変更セットの主要な目的を明確に反映している。

✨ Finishing touches

• 📝 Generate docstrings

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

stationapi/src/infrastructure/line_repository.rs (1)

214-281: 別名優先の名称解決と LEFT JOIN 化で、駅単位取得のバグは潰せていそうです

find_by_station_id のクエリで

• COALESCE(alias_data.line_name, l.line_name) 等により alias 側を優先して名称・カラーを解決し、
• LEFT JOIN station_station_types ... AND sst.pass <> 1 によって、型情報が無い駅でも 1 行返るようになった点は、テストとコメントの意図に沿っていて良さそうです。

なお、他のメソッドでは s.e_status = 0 / l.e_status = 0 を明示的に条件に入れている箇所もあるので、挙動を統一したい場合はここにも同様の条件を追加することを検討しても良いかもしれません（既存仕様依存なので必須ではありません）。

📜 Review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b16ca5d and 6be5d1f.

📒 Files selected for processing (6)

• .sqlx/query-25923b43426ac7b1829aaf1c726635b00edeb2b60996e3e7333772ed9202f327.json
• .sqlx/query-269872b7f724f7361c016b696ddc05ca06ee06027d6a0e4bd07cf73e8554226b.json
• stationapi/src/domain/normalize.rs
• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/infrastructure/station_repository.rs
• stationapi/src/use_case/interactor/query.rs

🧰 Additional context used

📓 Path-based instructions (6)

stationapi/src/domain/**/*.rs

📄 CodeRabbit inference engine (AGENTS.md)

In Rust domain layer, entity definitions and repository abstractions should be organized in the entity/ module mirroring the gRPC schema, with repository interfaces using async_trait

Files:

• stationapi/src/domain/normalize.rs

stationapi/src/**/*.rs

📄 CodeRabbit inference engine (AGENTS.md)

Run cargo test --lib --package stationapi or make test-unit for unit tests focusing on entities and repository mocks without database

Files:

• stationapi/src/domain/normalize.rs
• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

**/*.rs

📄 CodeRabbit inference engine (AGENTS.md)

**/*.rs: Before committing, run cargo fmt on all Rust code
Before committing, run cargo clippy --all-targets --all-features and resolve new Clippy warnings unless covered by existing #![allow] attributes

Files:

• stationapi/src/domain/normalize.rs
• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

stationapi/src/infrastructure/**/*.rs

📄 CodeRabbit inference engine (AGENTS.md)

stationapi/src/infrastructure/**/*.rs: Repository implementations in infrastructure layer should share an Arc<PgPool> connection pool
Integration tests in infrastructure layer must use #[cfg_attr(not(feature = "integration-tests"), ignore)] attribute to conditionally ignore tests when the feature is not enabled

Files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/infrastructure/station_repository.rs

stationapi/src/use_case/**/*.rs

📄 CodeRabbit inference engine (AGENTS.md)

Application logic in use case layer should implement contract traits defined in traits/ module (e.g., QueryUseCase in interactor/query.rs)

Files:

• stationapi/src/use_case/interactor/query.rs

stationapi/src/use_case/interactor/query.rs

📄 CodeRabbit inference engine (AGENTS.md)

When modifying QueryInteractor, ensure enrichment steps (companies, train types, line symbols) still behave as expected and verify helper methods such as update_station_vec_with_attributes and build_route_tree_map

Files:

• stationapi/src/use_case/interactor/query.rs

🧠 Learnings (9)

📓 Common learnings

Learnt from: TinyKitten
Repo: TrainLCD/StationAPI PR: 1305
File: stationapi/.sqlx/query-55bee6b45754d1da9bf555d319f015ce232f8574a41c3ef25b730d11071f8428.json:3-3
Timestamp: 2025-08-06T12:47:37.438Z
Learning: TinyKittenのStationAPIプロジェクトにおいて、SQLクエリの `pass <> 1` 条件は一部のクエリでは不要であり、PostgreSQL移行時にコードの最適化として意図的に除去された。この条件の有無についてはドメイン知識が必要で、機械的にチェックすべきではない。

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Implement text normalization logic in `normalize.rs` for search functionality

Applied to files:

• stationapi/src/domain/normalize.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/**/*.rs : Run `cargo test --lib --package stationapi` or `make test-unit` for unit tests focusing on entities and repository mocks without database

Applied to files:

• stationapi/src/domain/normalize.rs
• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/use_case/interactor/query.rs : When modifying `QueryInteractor`, ensure enrichment steps (companies, train types, line symbols) still behave as expected and verify helper methods such as `update_station_vec_with_attributes` and `build_route_tree_map`

Applied to files:

• stationapi/src/domain/normalize.rs
• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs
• .sqlx/query-269872b7f724f7361c016b696ddc05ca06ee06027d6a0e4bd07cf73e8554226b.json

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/domain/repository/**/*.rs : Use `async_trait` for defining repository abstractions in Rust

Applied to files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/use_case/**/*.rs : Application logic in use case layer should implement contract traits defined in `traits/` module (e.g., `QueryUseCase` in `interactor/query.rs`)

Applied to files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/domain/**/*.rs : In Rust domain layer, entity definitions and repository abstractions should be organized in the `entity/` module mirroring the gRPC schema, with repository interfaces using `async_trait`

Applied to files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/use_case/interactor/query.rs
• stationapi/src/infrastructure/station_repository.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Applies to stationapi/src/infrastructure/**/*.rs : Integration tests in infrastructure layer must use `#[cfg_attr(not(feature = "integration-tests"), ignore)]` attribute to conditionally ignore tests when the feature is not enabled

Applied to files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/infrastructure/station_repository.rs

📚 Learning: 2025-11-25T10:50:36.694Z

Learnt from: CR
Repo: TrainLCD/StationAPI PR: 0
File: AGENTS.md:0-0
Timestamp: 2025-11-25T10:50:36.694Z
Learning: Run integration tests with `source .env.test && cargo test --lib --package stationapi --features integration-tests` or `make test-integration` using a dedicated schema behind `TEST_DATABASE_URL`

Applied to files:

• stationapi/src/infrastructure/line_repository.rs
• stationapi/src/infrastructure/station_repository.rs

🧬 Code graph analysis (2)

stationapi/src/infrastructure/line_repository.rs (2)

stationapi/src/use_case/interactor/query.rs (2)

• find_by_station_id (1367-1369)
• find_by_station_id (1769-1771)

stationapi/src/domain/repository/line_repository.rs (2)

• find_by_station_id (8-8)
• find_by_station_id (194-196)

stationapi/src/infrastructure/station_repository.rs (1)

stationapi/src/domain/normalize.rs (1)

• normalize_for_search (1-20)

🔇 Additional comments (8)

stationapi/src/domain/normalize.rs (1)

37-104: 正規化テストの網羅性は十分で、仕様とも整合しています

ひらがな→カタカナ、小文字、範囲端、全角数字/英字、混在ケース、実在駅名までカバーされていて、normalize_for_search の仕様とリポジトリ側の検索ロジックをしっかり守ってくれそうです。このままで問題ないと思います。

.sqlx/query-25923b43426ac7b1829aaf1c726635b00edeb2b60996e3e7333772ed9202f327.json (1)

3-3: find_by_station_id 用メタデータは SQL と構造体に整合しています

COALESCE(alias_data.*, l.*) による line_name 系と line_color_c の解決、sst.line_group_cd AS "line_group_cd?" / sst.type_cd AS "type_cd?"、および nullable 情報はいずれも LineRow の Option フィールドと整合しており、InternalLineRepository::find_by_station_id のクエリ内容とも一致しているように見えます。このままで問題ないと思います。

Also applies to: 23-55, 162-173

stationapi/src/use_case/interactor/query.rs (1)

195-217: 駅名検索の正規化をリポジトリ層に委譲した変更は妥当です

get_stations_by_name で事前に normalize_for_search せず、そのまま文字列を StationRepository::get_by_name に渡すようにしたことで、

• Kanji 等の「そのままマッチさせたい」パターンを壊さず、
• 正規化ロジック（ひらがな→カタカナ変換など）をリポジトリ側のパターン生成に集約できています。

get_lines_by_name では引き続き行名検索用に正規化を使っており、用途ごとの使い分けも整理されていると思います。

.sqlx/query-269872b7f724f7361c016b696ddc05ca06ee06027d6a0e4bd07cf73e8554226b.json (1)

3-3: line_group_cd ベースの INNER JOIN への変更は筋が良いが、仕様確認だけお願いします

station_station_types / types を INNER JOIN にして

• sst.line_group_cd = $1 AND sst.station_cd = s.station_cd
• t.type_cd = sst.type_cd

で絞り込む形になっているため、指定された line_group_cd に紐づき、かつ有効な種別情報を持つ駅だけが返るようになりました。
「station_station_types にエントリが無い駅は、このクエリでは返さない」という仕様で問題ない想定であれば、この変更は妥当だと思いますが、運用上その前提が崩れないかだけ確認しておくと安心です。

Also applies to: 247-300, 307-367

stationapi/src/infrastructure/line_repository.rs (1)

1525-1651: LineRow のオプション項目と station_station_types 欠如ケースを明確にテストできています

• test_line_row_with_optional_line_group_cd_none / some で、line_group_cd / type_cd が None/Some の両方を Line に正しく反映できることが確認できています。
• test_find_by_station_id_without_station_station_types により、station_station_types に行が無い駅でも find_by_station_id が Some を返し、line_group_cd / type_cd が None になる、という今回の LEFT JOIN 仕様がきちんと担保されています。

どちらも今回の SQL 変更の意図に沿ったテストで、リグレッション防止に有効だと思います。

stationapi/src/infrastructure/station_repository.rs (3)

9-13: 駅名検索の正規化パターン分離は意図どおりに機能しそうです

get_by_name で

• station_name_pattern = "%{station_name}%" を station_name / station_name_rn / station_name_zh / station_name_ko に使い、
• station_name_k_pattern = "%{}%"（normalize_for_search 適用）を station_name_k 用にだけ使う、

という分離は、

• ひらがな入力 → カタカナの station_name_k でヒットさせる（例: "しんじゅく" → "シンジュク"）、
• 漢字入力やその他のスクリプトは元の文字列で検索する、

という要件にうまく合っています。
上で追加されている get_by_name_tests もこの振る舞いをカバーしており、正規化ロジックとクエリの整合性も取れていると思います。

Also applies to: 1003-1148

---

1150-1233: get_by_line_group_id の JOIN 条件はシンプルかつ意図に沿っています

get_by_line_group_id の SQL が

• JOIN station_station_types AS sst ON sst.line_group_cd = $1 AND sst.station_cd = s.station_cd
• JOIN types AS t ON t.type_cd = sst.type_cd

という形に整理され、WHERE から余計な関連条件を外しているので、指定された line_group_id に属する列車種別付きの駅だけをきれいに取得できるようになっています。

このクエリは「line_group に紐づかない駅は結果に含めない」という前提に立っているので、その前提がドメイン的に正しい前提であることだけ、他の利用箇所（例: 経路検索）とあわせて確認しておくと安心です。

---

1722-1800: 検索パターンと JOIN 構造のテスト追加は狙いが明確で良いです

• get_by_name_tests で、ひらがな・カタカナ・漢字・混在入力それぞれに対する %...% パターンと normalize_for_search の挙動を直接確認しており、アプリケーションレベルの検索仕様をドキュメント代わりにテストできています。
• get_by_line_group_id_tests は JOIN 条件やパラメータ型変換自体のテストではありますが、過去にあった「JOIN 条件の抜けで意図しない駅が返る」バグに対する軽量なガードとしては十分意味があると思います。
• 末尾の DB 統合テスト群は #[ignore] が付いており、インフラ層テストを feature / 環境前提で切り替えるというガイドラインにも沿っています。

このあたりのテスト追加は、今回の SQL 修正の意図を将来の変更時にも伝えてくれるので良いと思います。

Also applies to: 1806-1827, 1833-1851