Expand description
§salary-parser-jp — 日本語求人の給与テキスト解析
求人票の自由記述の給与欄(「月給21万円〜26万円」「時給1,200円以上」など)を 正規化し、給与種別と円建て金額へ解析するライブラリ。求人媒体の実データで 鍛えられた置換・判定パターンを、panic 経路のない実装で提供する。
§設計方針
- 精度優先(fail-closed): 確信の持てない入力は推測せずエラーで返す。 種別語と金額の隣接を要求し、金額のみの場合は桁が明確な帯だけ種別を推定する
- 監査可能:
normalizeを公開しており、どの正準形から金額が読まれたかを 突き合わせられる。エラーにも正規化後テキストや金額を含める - 業界非依存: 介護・看護など、どのバーティカルの取り込みからも使い回せる
§使い方
use salary_parser_jp::{MonthlyAssumption, SalaryParser, SalaryType};
let salary = SalaryParser::new().parse("月給21万円〜26万円")?;
assert_eq!(salary.salary_type, SalaryType::Monthly);
assert_eq!(salary.min_yen, 210_000);
assert_eq!(salary.max_yen, Some(260_000));
// タグ付けやスコアリングへ供給する、下限の月給換算
assert_eq!(salary.monthly_min_yen(&MonthlyAssumption::default()), 210_000);§主な項目
| 項目 | 役割 |
|---|---|
SalaryParser | 解析器。唯一の入口(new / with_bounds) |
Salary | 種別 + 円建ての下限・上限(FromStr 実装) |
Salary::monthly_min_yen | 下限の月給換算(種別をまたいだ比較用) |
Salary::monthly_max_yen | 上限の月給換算(上限なしなら None) |
MonthlyAssumption | 時給・日給を月給換算する前提値 |
SalaryType | 時給 / 日給 / 月給 / 年収 |
SalaryType::valid_yen_range | 種別ごとの妥当範囲(健全性チェックの基準) |
SalaryBounds | 種別ごとの妥当範囲(解析器へ渡す設定) |
normalize | 正規化のみを行う(監査・突き合わせ用) |
ParseError | 解析失敗の理由 |
§対応する表記ゆれ(抜粋)
use salary_parser_jp::{SalaryParser, SalaryType};
let parser = SalaryParser::new();
// 全角数字・装飾記号・カンマ区切り
assert_eq!(parser.parse("【月給】210000円")?.min_yen, 210_000);
// 「万」「千」表記と小数
assert_eq!(parser.parse("月給21万5千円")?.min_yen, 215_000);
assert_eq!(parser.parse("月給21.5万円")?.min_yen, 215_000);
// 範囲の右側にだけ付いた単位は左へ分配する
assert_eq!(parser.parse("年収300〜400万円")?.max_yen, Some(4_000_000));
// 「以上」は上限なしの範囲
assert_eq!(parser.parse("時給1,200円以上")?.max_yen, None);
// 賞与などの給与外数値は無視する
assert_eq!(parser.parse("月給20万円(賞与年2回)")?.min_yen, 200_000);
// 種別語がなくても桁が明確なら推定する
assert_eq!(parser.parse("¥250000")?.salary_type, SalaryType::Monthly);§エラー処理
失敗は ParseError の各変種として返る。いずれも
「このレコードは解析できなかった」を意味するだけで、取り込み全体を止める
性質のものではない。呼び出し側でレコード単位に隔離・集計し、種別語辞書や
アダプタの改善材料にすることを想定している。
use salary_parser_jp::{ParseError, SalaryParser};
match SalaryParser::new().parse("時給90000円") {
Ok(salary) => println!("{}: {}円", salary.salary_type, salary.min_yen),
// 妥当範囲外・種別不明などは診断情報を持つ
Err(error @ ParseError::OutOfRange { .. }) => println!("要確認: {error}"),
Err(error) => println!("解析不能: {error}"),
}最低賃金など法令面の検証は本クレートの責務外(minimum_wage_jp などを併用)。
Structs§
- Monthly
Assumption - 時給・日給を月給換算するときの前提値。
- Salary
- 解析済みの給与。金額はすべて円建て。
- Salary
Bounds - 妥当範囲の検証に使う、種別ごとの許容金額(円)。
- Salary
Parser - 給与テキストの解析器。このクレートの唯一の入口。
Enums§
- Parse
Error - 給与テキスト解析のエラー。
- Salary
Type - 給与種別。
Constants§
- DEFAULT_
DAYS_ PER_ MONTH - 月給換算の既定値: 月間労働日数(週 5 日 × 4 週)。
- DEFAULT_
HOURS_ PER_ MONTH - 月給換算の既定値: 月間労働時間(週 40 時間 × 4 週)。
Functions§
- normalize
- 給与テキストを解析用の正準形へ正規化する。