Privacy-first, browser-based metadata correction tool for research institutions 研究機関向けプライバシー重視型・ブラウザ完結型メタデータ補正ツール
Open Metadata Update Service (OMUS) is a privacy-first, standalone web application designed for research institutions to align global metadata (OpenAlex / Crossref) with precise internal organizational structures.
External databases often record only a top-level institution name (e.g., "Kyushu University") without the full departmental hierarchy (faculty, center, laboratory). OMUS uses your institution's Personnel Master CSV as the ground truth and automatically rewrites incomplete metadata to a correct, fully-qualified affiliation path.
Built with Vanilla JavaScript, it ensures high stability and prevents performance freezes during large-scale analysis. All data processing is done locally within your browser — no personnel records or CSV data are ever sent to a server.
| Feature | Description |
|---|---|
| 🏗️ 3-Tier Hierarchy Sync | Automatically reconstructs Faculty/Center, Division/Field, and Lab/Group names from your local personnel master |
| 🏛️ Hierarchical ROR Mapping | Dynamically assigns the most specific ROR ID based on department keywords from the Child-ROR master |
| 🔤 Name Disambiguation Engine | Normalizes author names (e.g., S. Kawai ↔ Kawai, Shigeki) using sort-key comparison to absorb typographic variation |
| 🛡️ 1st/2nd Author Strict Guard | Prevents misidentification of external authors at positions #1 and #2 by requiring a verified match in the local personnel master |
| 🌐 Real-time ROR API Integration | Automatically fetches and validates official institution names using the Parent ROR ID |
| 🔒 Privacy-First Architecture | 100% Vanilla JavaScript, no frameworks, no server communication. Your HR data never leaves the browser |
| 📥 Bulk CSV Export | Review generated correction proposals (From → To) and export a ready-to-submit database correction request CSV |
1. Configure → Enter your parent institution's ROR ID to confirm the name
2. Synchronize → Upload your Personnel Master CSV and Child-ROR Master CSV
3. Analyze → Input a DOI and click "Execute Analysis"
4. Export → Review the generated corrections and download the CSV for metadata submission
OMUS requires no installation. Simply open the HTML file in a modern browser.
git clone https://github.com/your-org/open-metadata-update-service.git
cd open-metadata-update-service
# Open index.html in your browser
open index.htmlThe CSV should follow this strict column order (1st row is header):
Local_Name, English_Name, Dept1_Local, Dept1_En, Dept2_Local, Dept2_En, Dept3_Local, Dept3_En
| Column | Description |
|---|---|
Local_Name |
Author name in local language |
English_Name |
Author name in English |
Dept1_Local / Dept1_En |
Faculty or Center (Tier 1) |
Dept2_Local / Dept2_En |
Division or Field (Tier 2) |
Dept3_Local / Dept3_En |
Lab or Group (Tier 3) |
A CSV containing at least one column with a 9-digit ROR ID and other columns with corresponding department names, keywords, and abbreviations (both local language and English).
- Zero Server-Side Storage: This application is a standalone HTML client
- Local Processing: Confidential personnel data stays in your browser's memory and is cleared upon page refresh
- API calls to ROR / Crossref / OpenAlex contain only ROR IDs and DOIs — never personal information
- Runtime: Browser (Chrome / Firefox / Safari / Edge — latest versions)
- Dependencies: None (Vanilla JS + Tailwind CSS via CDN)
- External APIs: ROR API (
https://api.ror.org/), Crossref API, OpenAlex API — for metadata retrieval only - Version: v48.90
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/your-feature) - Commit your changes (
git commit -m 'Add some feature') - Push to the branch (
git push origin feature/your-feature) - Open a Pull Request
Open Metadata Update Service (OMUS) は、研究機関が自機関の論文メタデータ(OpenAlex 等)を正確に管理・補正するための、プライバシー重視型支援ツールです。ローカルの人事名簿(3階層構造)と DOI データを照合し、不完全な所属情報を正確なフルパスへと自動補正します。
フレームワークに依存しない Vanilla JavaScript で構築されており、大量の著者を含む論文でもフリーズせず高速に動作します。すべての処理はブラウザ上で完結し、名簿データや CSV の内容が外部サーバーに送信されることは一切ありません。
| 機能 | 説明 |
|---|---|
| 🏗️ 3階層所属名寄せ | 人事名簿に基づき「拠点・分野・グループ」の正確な所属階層を自動的に再構築 |
| 🏛️ 階層型 ROR マッピング | 部局名キーワードから最適な(最も詳細な)ROR ID を自動特定・割り当て |
| 🔤 名寄せエンジン | S. Kawai ↔ Kawai, Shigeki のような表記揺れをソートキー比較で吸収して照合 |
| 🛡️ 第1・第2著者ガード | 筆頭・第2著者には名簿一致を必須とすることで、他機関共著者の誤検知を徹底排除 |
| 🌐 リアルタイム ROR 連携 | 親機関の ROR ID を入力するだけで API から正式名称を即座に取得・反映 |
| 🔒 プライバシーファースト | 100% Vanilla JavaScript、フレームワーク不使用、サーバー通信なし。HR データはブラウザ外に出ない |
| 📥 CSV 一括書き出し | 補正案(From → To)を確認後、データベース修正依頼用 CSV をダウンロード |
1. 設定 → 親機関の ROR ID を入力し、機関名を確定させます
2. 同期 → 「人事名簿 CSV」と「部局別 ROR マスタ CSV」を読み込ませます
3. 解析 → DOI を入力して「解析実行」をクリックします
4. 出力 → 生成された補正案を確認し、「CSV 出力」ボタンで修正依頼用データを保存します
インストール不要です。HTML ファイルをブラウザで開くだけで動作します。
git clone https://github.com/your-org/open-metadata-update-service.git
cd open-metadata-update-service
# index.html をブラウザで開く
open index.html以下の列順の CSV を準備してください(1行目はヘッダー):
氏名(和), 氏名(英), 拠点(和), 拠点(英), 分野(和), 分野(英), グループ(和), グループ(英)
| カラム | 説明 |
|---|---|
氏名(和) / 氏名(英) |
著者氏名(和文・英文) |
拠点(和) / 拠点(英) |
第1階層:学部・センター等 |
分野(和) / 分野(英) |
第2階層:分野・部門等 |
グループ(和) / グループ(英) |
第3階層:グループ・研究室等 |
任意の列に 9桁の ROR ID を含み、他の列に該当する部局名(和文・英文・略称など)を記載した CSV。
- ゼロサーバーストレージ: 本アプリケーションはスタンドアロンの HTML クライアントです
- ローカル処理: 機密性の高い人事名簿データはブラウザのメモリ上にのみ保持され、ページ更新時にクリアされます
- ROR / Crossref / OpenAlex への API 呼び出しには ROR ID と DOI のみが含まれます(個人情報は含みません)
- 実行環境: ブラウザ(Chrome / Firefox / Safari / Edge 最新版)
- 依存関係: なし(Vanilla JS + Tailwind CSS CDN)
- 外部 API 通信: ROR API・Crossref API・OpenAlex API(メタデータ取得のみ。個人情報は一切送信しない)
- バージョン: v48.90
プルリクエスト歓迎です。大きな変更を加える場合は、先に Issue を開いてご相談ください。
- リポジトリをフォーク
- フィーチャーブランチを作成 (
git checkout -b feature/your-feature) - 変更をコミット (
git commit -m 'Add some feature') - ブランチをプッシュ (
git push origin feature/your-feature) - プルリクエストを作成
MIT © 2026 Your Institution Name