公司統編抬頭比對工具 - README

簡介

此工具是一個基於網頁的應用程式，用於比對公司統一編號（統編）與抬頭名稱，是否政府登記資料相符。您可以上傳包含公司統編與抬頭的原始資料和需要比對的資料，工具將自動進行比對並生成結果，方便核對和匯出。

功能

1. 支援檔案上傳： 支援 CSV 格式的檔案上傳。
2. 即時比對： 比對原始資料與需要比對的資料中的統編和抬頭是否一致。
3. 結果展示： 即時顯示比對結果，並提供核對詳細情況。
4. CSV 下載： 可將比對結果以 CSV 檔案格式下載。

使用方式

步驟 1：下載原始資料

請先至 台灣公司資料 網站，下載 index.csv.gz 資料包，並解壓縮。原始資料檔案需包含以下欄位：

• id：統編
• name：公司名稱

步驟 2：準備比對資料

準備需要比對的資料檔案，格式需為 CSV，檔案至少包含以下欄位：

• 第一列：id（統編）
• 第二列：name（抬頭名稱）

步驟 3：使用工具

1. 打開工具的網頁。
2. 上傳原始資料檔案（CSV 格式）。
3. 上傳需要比對的資料檔案（CSV 格式）。
4. 點擊「開始比對」按鈕，工具會自動執行比對。

步驟 4：檢視與下載結果

比對完成後，結果會顯示在網頁中：

• ok：比對一致。
• 不一致：提供原始資料中的抬頭名稱。
• 統編不存在：比對資料的統編在原始資料中找不到。

點擊「下載比對結果」按鈕即可將結果儲存為 CSV 檔案。

系統需求

• 瀏覽器支援：建議使用最新版的 Chrome、Firefox 或 Edge。
• 上傳檔案格式：CSV。

技術說明

HTML & CSS

• 使用簡潔的設計，提供直觀的操作界面。
• 採用響應式布局，支援桌面和行動裝置。

JavaScript

• 使用 Papa Parse 處理 CSV 檔案的解析。
• 使用 JavaScript 比對資料並生成結果。

關鍵功能

• 比對邏輯： 將原始資料轉換為字典結構（id -> name），比對輸入資料中的每一行，確認名稱是否一致。
• 動態生成表格： 根據比對結果動態生成 HTML 表格顯示結果。
• CSV 匯出： 將結果轉換為 CSV 格式並提供下載功能。

注意事項

1. 欄位名稱須符合要求： 原始資料與比對資料的表頭需包含 id 和 name 欄位。
2. 資料格式： 請確保上傳的 CSV 檔案格式正確，避免空行或不規範的內容。

範例

以下為需要比對資料範例（CSV 格式）：

id,name
12345678,公司A
87654321,公司B