Skip to content

About

Upload Organization member list with Department info until 3 layer and ROR list with Department information, And you can upload DOI, and Change ROR and Child_ROR via OpenAlex.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Open Metadata Update Service (OMUS)

Privacy-first, browser-based metadata correction tool for research institutions 研究機関向けプライバシー重視型・ブラウザ完結型メタデータ補正ツール

Version License Language Privacy


English | 日本語


🌍 Overview (English)

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.


🌟 Key Features

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

🚀 Quick Start

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

💾 Getting Started

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.html

📋 CSV Format Requirements

A. Personnel Master

The 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)

B. Child-ROR Master

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).


🔒 Security & Privacy

  • 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

🛠️ Technical Specifications

  • 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

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'Add some feature')
  4. Push to the branch (git push origin feature/your-feature)
  5. 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 フォーマット

A. 人事名簿 (Personnel Master)

以下の列順の CSV を準備してください(1行目はヘッダー):

氏名(和), 氏名(英), 拠点(和), 拠点(英), 分野(和), 分野(英), グループ(和), グループ(英)
カラム 説明
氏名(和) / 氏名(英) 著者氏名(和文・英文)
拠点(和) / 拠点(英) 第1階層:学部・センター等
分野(和) / 分野(英) 第2階層:分野・部門等
グループ(和) / グループ(英) 第3階層:グループ・研究室等

B. 部局別 ROR マスタ (Child-ROR Master)

任意の列に 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 を開いてご相談ください。

  1. リポジトリをフォーク
  2. フィーチャーブランチを作成 (git checkout -b feature/your-feature)
  3. 変更をコミット (git commit -m 'Add some feature')
  4. ブランチをプッシュ (git push origin feature/your-feature)
  5. プルリクエストを作成

⚖️ License / ライセンス

MIT © 2026 Your Institution Name

About

Upload Organization member list with Department info until 3 layer and ROR list with Department information, And you can upload DOI, and Change ROR and Child_ROR via OpenAlex.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages