@isofh/chuyen-doi-dia-chi-2-cap 1.0.3 → 1.0.5

package/README.md

@@ -63,12 +63,13 @@ console.log(splitResult);
 
 - chuỗi địa chỉ hành chính, ví dụ `"Xuân Thành, Xuân Lộc, Đồng Nai"`
 - hoặc mảng các phần tử địa chỉ, ví dụ `['Xuân Thành', 'Xuân Lộc', 'Đồng Nai']`
+- ngoài ra hàm cũng cố gắng tự bóc đuôi hành chính nếu input có kèm `số nhà, tên đường, quốc gia...`
 
 ## Lưu ý quan trọng
 
-Hàm này chỉ xử lý phần địa chỉ hành chính.
+Hàm này ưu tiên xử lý phần địa chỉ hành chính.
 
-Nếu input gốc có cả số nhà, tên đường, khu phố..., caller nên tách phần hành chính trước khi gọi hàm này.
+Nếu input gốc có cả số nhà, tên đường, khu phố..., hàm sẽ cố gắng nhận diện đuôi hành chính hợp lệ để convert. Dù vậy, trong các case nhập liệu quá nhiễu hoặc thiếu tỉnh/xã rõ ràng, caller vẫn nên tách phần hành chính trước khi gọi để đảm bảo độ chính xác cao nhất.
 
 Ví dụ:
 

package/dataXa.json

@@ -3054,7 +3054,11 @@
         "ten": "Hồng Bàng",
         "timKiem": "hongbang",
         "satNhapTu": [
-          { "ten": "Hoàng Văn Thụ", "timKiem": "hoangvanthu" },
+          {
+            "ten": "Hoàng Văn Thụ",
+            "timKiem": "hoangvanthu",
+            "huyen": "hongbang"
+          },
           { "ten": "Minh Khai", "timKiem": "minhkhai" },
           { "ten": "Phan Bội Châu", "timKiem": "phanboichau" },
           { "ten": "Thượng Lý", "timKiem": "thuongly" },
@@ -24410,10 +24414,14 @@
         "ten": "Thủ Dầu Một",
         "timKiem": "thudaumot",
         "satNhapTu": [
-          { "ten": "Phú Cường", "timKiem": "phucuong" },
-          { "ten": "Phú Thọ", "timKiem": "phutho" },
-          { "ten": "Chánh Nghĩa", "timKiem": "chanhnghia" },
-          { "ten": "Hiệp Thành", "timKiem": "hiepthanh" },
+          { "ten": "Phú Cường", "timKiem": "phucuong", "huyen": "thudaumot" },
+          { "ten": "Phú Thọ", "timKiem": "phutho", "huyen": "thudaumot" },
+          {
+            "ten": "Chánh Nghĩa",
+            "timKiem": "chanhnghia",
+            "huyen": "thudaumot"
+          },
+          { "ten": "Hiệp Thành", "timKiem": "hiepthanh", "huyen": "thudaumot" },
           { "ten": "Chánh Mỹ", "timKiem": "chanhmy" }
         ]
       },
@@ -24865,7 +24873,7 @@
         "ten": "Tân Thới Hiệp",
         "timKiem": "tanthoihiep",
         "satNhapTu": [
-          { "ten": "Hiệp Thành", "timKiem": "hiepthanh" },
+          { "ten": "Hiệp Thành", "timKiem": "hiepthanh", "huyen": "12" },
           { "ten": "Tân Thới Hiệp", "timKiem": "tanthoihiep" }
         ]
       },
@@ -24946,7 +24954,7 @@
         "satNhapTu": [
           { "ten": "12", "timKiem": "12", "huyen": "binhthanh" },
           { "ten": "14", "timKiem": "14", "huyen": "binhthanh" },
-          { "ten": "26", "timKiem": "26" }
+          { "ten": "26", "timKiem": "26", "huyen": "binhthanh" }
         ]
       },
       {
@@ -24962,17 +24970,17 @@
         "ten": "Thạnh Mỹ Tây",
         "timKiem": "thanhmytay",
         "satNhapTu": [
-          { "ten": "19", "timKiem": "19" },
-          { "ten": "22", "timKiem": "22" },
-          { "ten": "25", "timKiem": "25" }
+          { "ten": "19", "timKiem": "19", "huyen": "binhthanh" },
+          { "ten": "22", "timKiem": "22", "huyen": "binhthanh" },
+          { "ten": "25", "timKiem": "25", "huyen": "binhthanh" }
         ]
       },
       {
         "ten": "Bình Quới",
         "timKiem": "binhquoi",
         "satNhapTu": [
-          { "ten": "27", "timKiem": "27" },
-          { "ten": "28", "timKiem": "28" }
+          { "ten": "27", "timKiem": "27", "huyen": "binhthanh" },
+          { "ten": "28", "timKiem": "28", "huyen": "binhthanh" }
         ]
       },
       {
@@ -25288,11 +25296,11 @@
         "ten": "Tân Nhựt",
         "timKiem": "tannhut",
         "satNhapTu": [
-          { "ten": "Tân Túc", "timKiem": "tantuc" },
-          { "ten": "Tân Nhựt", "timKiem": "tannhut" },
-          { "ten": "Tân Tạo A", "timKiem": "tantaoa" },
-          { "ten": "Tân Kiên", "timKiem": "tankien" },
-          { "ten": "16", "timKiem": "16" }
+          { "ten": "Tân Túc", "timKiem": "tantuc", "huyen": "binhchanh" },
+          { "ten": "Tân Nhựt", "timKiem": "tannhut", "huyen": "binhchanh" },
+          { "ten": "Tân Tạo A", "timKiem": "tantaoa", "huyen": "binhtan" },
+          { "ten": "Tân Kiên", "timKiem": "tankien", "huyen": "binhchanh" },
+          { "ten": "16", "timKiem": "16", "huyen": "8" }
         ]
       },
       {
@@ -25318,9 +25326,9 @@
         "ten": "Bình Hưng",
         "timKiem": "binhhung",
         "satNhapTu": [
-          { "ten": "Phong Phú", "timKiem": "phongphu" },
-          { "ten": "Bình Hưng", "timKiem": "binhhung" },
-          { "ten": "7", "timKiem": "7" }
+          { "ten": "Phong Phú", "timKiem": "phongphu", "huyen": "binhchanh" },
+          { "ten": "Bình Hưng", "timKiem": "binhhung", "huyen": "binhchanh" },
+          { "ten": "7", "timKiem": "7", "huyen": "8" }
         ]
       },
       {
@@ -25708,84 +25716,90 @@
       {
         "ten": "Đặc khu Côn Đảo",
         "timKiem": "dackhucondao",
-        "satNhapTu": [{ "ten": "Huyện Côn Đảo", "timKiem": "huyencondao" }]
+        "satNhapTu": [
+          { "ten": "Huyện Côn Đảo", "timKiem": "huyencondao" },
+          { "ten": "Côn Đảo", "timKiem": "condao" }
+        ]
       },
       {
         "ten": "Bàn Cờ",
         "timKiem": "banco",
         "satNhapTu": [
-          { "ten": "1", "timKiem": "1" },
-          { "ten": "2", "timKiem": "2" },
-          { "ten": "3", "timKiem": "3" },
-          { "ten": "5", "timKiem": "5" },
-          { "ten": "4", "timKiem": "4" }
+          { "ten": "1", "timKiem": "1", "huyen": "3" },
+          { "ten": "2", "timKiem": "2", "huyen": "3" },
+          { "ten": "3", "timKiem": "3", "huyen": "3" },
+          { "ten": "5", "timKiem": "5", "huyen": "3" },
+          { "ten": "4", "timKiem": "4", "huyen": "3" }
         ]
       },
       {
         "ten": "Xuân Hòa",
         "timKiem": "xuanhoa",
         "satNhapTu": [
-          { "ten": "Võ Thị Sáu", "timKiem": "vothisau" },
-          { "ten": "4", "timKiem": "4" }
+          { "ten": "Võ Thị Sáu", "timKiem": "vothisau", "huyen": "3" },
+          { "ten": "4", "timKiem": "4", "huyen": "3" },
+          { "ten": "6", "timKiem": "6", "huyen": "3" },
+          { "ten": "7", "timKiem": "7", "huyen": "3" },
+          { "ten": "8", "timKiem": "8", "huyen": "3" }
         ]
       },
       {
         "ten": "Nhiêu Lộc",
         "timKiem": "nhieuloc",
         "satNhapTu": [
-          { "ten": "9", "timKiem": "9" },
-          { "ten": "11", "timKiem": "11" },
+          { "ten": "9", "timKiem": "9", "huyen": "3" },
+          { "ten": "11", "timKiem": "11", "huyen": "3" },
           { "ten": "12", "timKiem": "12", "huyen": "3" },
-          { "ten": "14", "timKiem": "14" }
+          { "ten": "14", "timKiem": "14", "huyen": "3" }
         ]
       },
       {
         "ten": "Xóm Chiếu",
         "timKiem": "xomchieu",
         "satNhapTu": [
-          { "ten": "13", "timKiem": "13" },
-          { "ten": "16", "timKiem": "16" },
-          { "ten": "18", "timKiem": "18" },
-          { "ten": "15", "timKiem": "15" }
+          { "ten": "13", "timKiem": "13", "huyen": "4" },
+          { "ten": "16", "timKiem": "16", "huyen": "4" },
+          { "ten": "18", "timKiem": "18", "huyen": "4" },
+          { "ten": "15", "timKiem": "15", "huyen": "4" }
         ]
       },
       {
         "ten": "Khánh Hội",
         "timKiem": "khanhhoi",
         "satNhapTu": [
-          { "ten": "8", "timKiem": "8" },
-          { "ten": "9", "timKiem": "9" },
-          { "ten": "2", "timKiem": "2" },
-          { "ten": "4", "timKiem": "4" },
-          { "ten": "15", "timKiem": "15" }
+          { "ten": "8", "timKiem": "8", "huyen": "4" },
+          { "ten": "9", "timKiem": "9", "huyen": "4" },
+          { "ten": "2", "timKiem": "2", "huyen": "4" },
+          { "ten": "4", "timKiem": "4", "huyen": "4" },
+          { "ten": "15", "timKiem": "15", "huyen": "4" }
         ]
       },
       {
         "ten": "Vĩnh Hội",
         "timKiem": "vinhhoi",
         "satNhapTu": [
-          { "ten": "1", "timKiem": "1" },
-          { "ten": "3", "timKiem": "3" },
-          { "ten": "2", "timKiem": "2" },
-          { "ten": "4", "timKiem": "4" }
+          { "ten": "1", "timKiem": "1", "huyen": "4" },
+          { "ten": "3", "timKiem": "3", "huyen": "4" },
+          { "ten": "2", "timKiem": "2", "huyen": "4" },
+          { "ten": "4", "timKiem": "4", "huyen": "4" }
         ]
       },
       {
         "ten": "Chợ Quán",
         "timKiem": "choquan",
         "satNhapTu": [
-          { "ten": "1", "timKiem": "1" },
-          { "ten": "2", "timKiem": "2" },
-          { "ten": "4", "timKiem": "4" }
+          { "ten": "1", "timKiem": "1", "huyen": "5" },
+          { "ten": "2", "timKiem": "2", "huyen": "5" },
+          { "ten": "4", "timKiem": "4", "huyen": "5" }
         ]
       },
       {
         "ten": "An Đông",
         "timKiem": "andong",
         "satNhapTu": [
-          { "ten": "Phường 5", "timKiem": "5" },
-          { "ten": "7", "timKiem": "7" },
-          { "ten": "9", "timKiem": "9" }
+          { "ten": "5", "timKiem": "5", "huyen": "5" },
+          { "ten": "7", "timKiem": "7", "huyen": "5" },
+          { "ten": "9", "timKiem": "9", "huyen": "5" }
         ]
       }
     ]

package/index.js

@@ -146,6 +146,9 @@ const getVerifyOptions = (tinhOrOptions, maybeOptions) => {
   };
 };
 
+// Chuẩn hóa tên huyện/quận để so khớp với metadata `huyen` trong dataset khi cần phân biệt xã với số nhà.
+const normalizeDistrictCode = (value = "") => normalizeAdministrativeCode(value);
+
 // Tạo tập khóa tìm kiếm của tỉnh từ cả tên gốc lẫn tên đã bỏ prefix.
 const getProvinceSearchKeys = (value = "") => {
   const keys = [createUniqueText(value), normalizeAdministrativeCode(value)].filter(Boolean);
@@ -176,6 +179,75 @@ const getProvinceCandidates = (tinh, sourceDataXa) => {
   });
 };
 
+// Tìm tỉnh/thành phù hợp nhất trong một vế địa chỉ bất kỳ.
+const findProvinceByText = (value = "", sourceDataXa = []) => {
+  const normalizedValue = createUniqueText(value);
+
+  if (!normalizedValue) {
+    return null;
+  }
+
+  return (
+    sourceDataXa.find(
+      (item) =>
+        normalizedValue.indexOf(item.timKiem) !== -1 ||
+        item.dsTinh?.some((item2) => normalizedValue.indexOf(item2.timKiem) !== -1)
+    ) || null
+  );
+};
+
+// Với địa chỉ đầy đủ có số nhà/đường/quốc gia, cố gắng bóc ra đuôi hành chính để reuse thuật toán convert gốc.
+const extractAdministrativeParts = (input, sourceDataXa) => {
+  const parts = splitAddressParts(input);
+
+  if (parts.length < 3) {
+    return parts;
+  }
+
+  for (let provinceIndex = parts.length - 1; provinceIndex >= 0; provinceIndex -= 1) {
+    const province = findProvinceByText(parts[provinceIndex], sourceDataXa);
+
+    if (!province) {
+      continue;
+    }
+
+    const provinceName = province.ten;
+
+    if (provinceIndex >= 2) {
+      const threeLevelXa = verifyXaName(parts[provinceIndex - 2], provinceName, {
+        dataXa: sourceDataXa,
+        huyen: parts[provinceIndex - 1],
+      });
+
+      if (threeLevelXa.isValid) {
+        return parts.slice(provinceIndex - 2, provinceIndex + 1);
+      }
+    }
+
+    if (provinceIndex >= 1) {
+      const twoLevelXa = verifyXaName(parts[provinceIndex - 1], provinceName, {
+        dataXa: sourceDataXa,
+      });
+
+      if (twoLevelXa.isValid) {
+        return parts.slice(provinceIndex - 1, provinceIndex + 1);
+      }
+    }
+
+    const splitResult = splitAddressByValidXa(parts.slice(0, provinceIndex + 1), provinceName, {
+      dataXa: sourceDataXa,
+    });
+
+    if (splitResult.matchedXaIndex >= 0) {
+      return splitAddressParts(splitResult.diaChi);
+    }
+
+    return parts.slice(Math.max(0, provinceIndex - 2), provinceIndex + 1);
+  }
+
+  return parts;
+};
+
 // Loại bỏ kết quả trùng và ưu tiên match theo tên xã hiện tại trước `satNhapTu`.
 const dedupeMatches = (matches = []) => {
   const uniqueMatches = matches.filter((item, index, arr) => {
@@ -207,6 +279,7 @@ const verifyXaName = (tenXa, tinhOrOptions, maybeOptions) => {
   const sourceDataXa = options.dataXa || getDataXaSync();
   const normalizedXa = normalizeAdministrativeCode(tenXa);
   const normalizedTinh = normalizeAdministrativeCode(tinh);
+  const normalizedHuyen = normalizeDistrictCode(options.huyen);
   const matchedProvinces = getProvinceCandidates(tinh, sourceDataXa);
 
   if (!normalizedXa) {
@@ -222,23 +295,36 @@ const verifyXaName = (tenXa, tinhOrOptions, maybeOptions) => {
 
   const matches = [];
 
+  const isDistrictCompatible = (districtValue = "") => {
+    if (!normalizedHuyen || !districtValue) {
+      return true;
+    }
+
+    return normalizeDistrictCode(districtValue) === normalizedHuyen;
+  };
+
   matchedProvinces.forEach((province) => {
     province.dsXa.forEach((xa) => {
-      if (xa.timKiem === normalizedXa) {
+      if (xa.timKiem === normalizedXa && isDistrictCompatible(xa.huyen)) {
         matches.push({
           matchType: "current",
           tenXa: xa.ten,
           tenTinh: province.ten,
+          huyen: xa.huyen || "",
         });
       }
 
       xa.satNhapTu?.forEach((satNhapItem) => {
-        if (satNhapItem.timKiem === normalizedXa) {
+        if (
+          satNhapItem.timKiem === normalizedXa &&
+          isDistrictCompatible(satNhapItem.huyen || xa.huyen)
+        ) {
           matches.push({
             matchType: "satNhapTu",
             tenXa: xa.ten,
             tenTinh: province.ten,
             tenXaCu: satNhapItem.ten,
+            huyen: satNhapItem.huyen || xa.huyen || "",
           });
         }
       });
@@ -252,6 +338,7 @@ const verifyXaName = (tenXa, tinhOrOptions, maybeOptions) => {
     provinceInput: tinh || "",
     normalizedInput: normalizedXa,
     normalizedProvince: normalizedTinh,
+    normalizedDistrict: normalizedHuyen,
     isValid: uniqueMatches.length > 0,
     matches: uniqueMatches,
   };
@@ -404,7 +491,7 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
   }
 
   let diaChi = [];
-  const arr = splitAddressParts(diaChi2CapCu);
+  const arr = extractAdministrativeParts(diaChi2CapCu, sourceDataXa);
 
   if (arr.length === 2) diaChi = [arr[0], arr[1]];
   if (arr.length === 3) diaChi = [arr[0], arr[2]];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isofh/chuyen-doi-dia-chi-2-cap",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Chuan hoa dia chi hanh chinh cu sang format 2 cap moi",
   "main": "index.js",
   "files": [