Nếu osCommerce được chọn làm Nền tảng đích, công tác chuẩn bị phải bắt đầu từ dòng phiên bản của Cửa hàng nguồn vì osCommerce v4 hiện tại và các bản cài đặt legacy đã vận hành lâu năm có thể dùng cấu trúc danh mục, phần mở rộng, nội dung và cơ sở dữ liệu khác nhau đáng kể. Một cửa hàng được gọi chung là osCommerce có thể là v4 hiện tại, bản 2.x cũ, một fork hoặc codebase đã được chỉnh sửa sâu với contribution cộng đồng và thay đổi schema trực tiếp.
Mục tiêu chuẩn bị là xác định mô hình nguồn thực tế trước khi chọn cách liên kết trường. Mỗi khu vực cần nêu rõ hành động, người chịu trách nhiệm, tài liệu cần giữ và điều kiện được xem là sẵn sàng. Các quan hệ của v4 như kênh bán hàng, nhóm Customers, attributes, properties và bản ghi CMS không được mặc định tồn tại dưới cùng hình thức trong nguồn legacy. Ngược lại, bảng của extension legacy cũng không được coi là dữ liệu native của v4 chỉ vì tính năng hiện đại có tên tương tự.
Xác định dòng phiên bản nguồn, quyền truy cập và trách nhiệm kỹ thuật
Ghi nhận tên Nền tảng nguồn, phiên bản, branch hoặc fork, prefix cơ sở dữ liệu, môi trường hosting, front ends/storefronts đang hoạt động, ngôn ngữ, tiền tệ, extensions, tệp đã chỉnh sửa, bảng tùy chỉnh và các luồng đồng bộ với hệ thống ngoài. Nếu cửa hàng cũ đã trải qua nhiều lần nâng cấp, cần giữ ghi chú của đội phát triển hoặc thông tin schema cho biết bảng nào vẫn điều khiển cách cửa hàng hiện tại hoạt động.
Chuẩn bị quyền truy cập nguồn cần thiết cho lộ trình chuyển đổi đã chọn. Người phụ trách kỹ thuật cần xác nhận kết nối truy cập đúng cơ sở dữ liệu và cây tệp của cửa hàng, đồng thời bản sao lưu có sẵn phải thuộc cùng một trạng thái dữ liệu.
| Hành động | Người phụ trách | Tài liệu cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Xác định thế hệ nguồn và dòng code | Người phụ trách kỹ thuật | Thông tin phiên bản, repository/gói cài đặt, lịch sử fork | Nguồn được phân loại rõ là v4 hiện tại, osCommerce legacy, fork hoặc bản phát triển tùy chỉnh. |
| Xác nhận quyền truy cập cơ sở dữ liệu và tệp | Người phụ trách hosting/cơ sở dữ liệu | Tên/prefix cơ sở dữ liệu, trạng thái kết nối, ghi chú document root | Kết nối nguồn cần thiết truy cập đúng bản cài đặt dự kiến. |
| Lập danh mục extensions và thay đổi ở core | Developer hoặc agency | Danh sách extension, tệp đã chỉnh sửa, danh sách bảng tùy chỉnh | Có thể tách bản ghi native, bản ghi do extension sở hữu và bản ghi tùy chỉnh. |
| Ghi nhận front ends, ngôn ngữ, tiền tệ và ngữ cảnh thuế | Người phụ trách thương mại | Thông tin thiết lập và ma trận phạm vi | Ngữ cảnh toàn cửa hàng làm thay đổi ý nghĩa Products hoặc Orders đã được ghi nhận. |
| Xác định hệ thống ngoài và luồng import | Người phụ trách tích hợp | Danh sách ERP/PIM/WMS/CRM, lịch feed, trường khóa | Giá trị được duy trì bên ngoài osCommerce có nguồn có thẩm quyền rõ. |
Sau khi bộ tài liệu này được chốt, nên hạn chế các thay đổi cấu trúc không được ghi nhận. Hoạt động kinh doanh thường ngày vẫn có thể tiếp tục, nhưng extension mới, chỉnh sửa schema, thay đổi mô hình Products hoặc viết lại routes phải được đưa vào change log của dự án.
Chuẩn bị Products, Categories, brands, suppliers và phạm vi front end
osCommerce v4 có thể liên kết Products với Categories, brands, suppliers, kênh bán hàng/front ends, nhóm Customers, mô tả đa ngôn ngữ, chế độ tồn kho, hình ảnh, identifiers, giá, trường SEO và quan hệ merchandising. Cửa hàng legacy có thể dùng bảng lõi đơn giản hơn và dựa vào extensions để bổ sung nhiều chức năng trong số này.
Tạo bảng kiểm kê Products gồm ID nguồn, SKU/model, identifier khác, trạng thái, giá cơ bản, Tax class, cách quản lý tồn kho, trọng lượng, trạng thái virtual/downloadable, quan hệ Categories, brand/manufacturer, supplier, hình ảnh, giá trị theo ngôn ngữ, phạm vi kênh bán hàng, phạm vi nhóm Customers và quan hệ khuyến mãi hoặc giá theo số lượng đang hoạt động.
| Mẫu ở nguồn | Hành động chuẩn bị | Tài liệu cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Products được gán cho nhiều Categories | Ghi lại toàn bộ quan hệ Categories và bối cảnh merchandising chính | Dữ liệu quan hệ Products-Categories | Vị trí dùng chung được nhìn thấy rõ mà không nhân bản Products. |
| Products chỉ xuất hiện trên một số front ends | Ghi nhận quan hệ gán và giới hạn theo kênh/front end | Ma trận phạm vi theo Products/Categories | Khả năng có mặt theo kênh đã rõ. |
| Quan hệ brand hoặc supplier | Tách thương hiệu hiển thị công khai khỏi quyền sở hữu mua hàng | Liên kết brand, supplier và Products | Các nhãn giống nhau không bị gộp vào một trường không cùng ý nghĩa. |
| Trạng thái tồn kho thực, không giới hạn, ẩn hoặc preorder | Ghi số lượng, chế độ tồn kho và cách xử lý khi hết hàng | Thiết lập của các bản ghi Products đại diện | Ý nghĩa khả dụng không bị rút gọn thành một con số tồn kho. |
| Products virtual/downloadable | Ghi tệp, thời hạn, giới hạn tải, ý nghĩa vận chuyển và đường dẫn nguồn | Manifest Products/tệp | Quan hệ giao hàng số và tệp gốc đầy đủ. |
| Giá theo nhóm hoặc số lượng | Ghi Products, nhóm Customers, ngưỡng, tiền tệ và số tiền | Danh mục quan hệ giá | Giá có điều kiện không bị thay bằng giá cơ bản. |
Với cửa hàng legacy, cần ghi rõ giá trị nào đến từ bảng Products lõi và giá trị nào đến từ cột/bảng của extension. Người phụ trách nghiệp vụ phải phê duyệt mọi hoạt động dọn dữ liệu làm thay đổi định danh Products hoặc phạm vi kênh.
Tách attributes, properties và quan hệ Products có thể cấu hình
osCommerce v4 phân biệt attributes với properties. Attributes có thể đại diện cho lựa chọn của người mua, template dùng lại, tác động đến giá/trọng lượng, tệp virtual và quan hệ tồn kho. Properties mô tả đặc tính có cấu trúc phục vụ hiển thị, lọc, tìm kiếm, so sánh, ranges, icons hoặc nhóm Products. Attributes legacy có thể gộp nhiều ý nghĩa trong một cấu trúc.
Chuẩn bị thông tin cho phép phân loại từng giá trị nguồn theo chức năng thay vì chỉ dựa trên tên.
| Ý nghĩa kinh doanh | Hành động chuẩn bị | Tài liệu cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Lựa chọn của người mua | Ghi attribute, values, template, Products được gán và tác động đến giá/trọng lượng | Dữ liệu attribute và quan hệ gán | Lựa chọn mua hàng và tác động thương mại đã rõ. |
| Tổ hợp có SKU hoặc tồn kho độc lập | Xác định bản ghi configurable hoặc tổ hợp do extension sở hữu | Bảng tổ hợp và khóa Products | Định danh mặt hàng có thể bán độc lập được giữ trong mô hình nguồn. |
| Thông số kỹ thuật | Ghi nhóm property, property, kiểu dữ liệu, đơn vị, values và liên kết Products | Danh mục properties | Dữ liệu mô tả được tách khỏi lựa chọn mua hàng. |
| Giá trị dùng để lọc hoặc so sánh | Ghi cách hiển thị/lọc/tìm kiếm và hệ thống phân loại | Bảng theo dõi trường dùng cho khám phá Products | Những giá trị cần cho việc tìm kiếm Products đã được xác định. |
| Text input hoặc cá nhân hóa | Xác định chủ sở hữu trường và chi tiết mặt hàng của Orders đại diện | Ví dụ Products và Orders | Giá trị nhập riêng cho giao dịch không bị coi là metadata dùng lại. |
| Attribute downloadable | Ghi tệp, giới hạn, Products và quan hệ attribute | Manifest tệp và attribute | Tệp và thông tin chứng minh quyền tải đã đầy đủ. |
Không nên tự động chuyển mọi attribute legacy thành attribute hiện tại của v4. Một số phù hợp hơn với properties, quan hệ Products có thể cấu hình, trường tùy chỉnh hoặc cấu trúc do extension sở hữu.
Ghi rõ nhóm Customers, tài khoản, địa chỉ và ngữ cảnh thương mại
Nhóm Customers trong v4 có thể điều khiển khả năng hiển thị Products/Categories, cách áp dụng thuế, giảm giá cộng dồn và thiết lập mặc định cho khách vãng lai hoặc Customers mới đăng ký. Extensions có thể bổ sung quan hệ wholesale, B2B, tín dụng, loyalty hoặc phê duyệt. Cửa hàng legacy có thể biểu diễn các quan hệ này theo cách khác.
Chuẩn bị thông tin Customers theo từng nhóm: định danh, bản ghi trong sổ địa chỉ, trạng thái khách vãng lai, quan hệ nhóm Customers, trạng thái thuế/trade, Reviews, identifier hệ thống ngoài và số dư/quyền do extension sở hữu.
| Nhóm thông tin | Người phụ trách | Tài liệu cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Định danh Customers | Hỗ trợ Customers hoặc CRM | Danh sách bản ghi trùng và ngoại lệ | Mỗi tài khoản giữ lại có quyết định định danh rõ. |
| Nhóm Customers | Người phụ trách thương mại | Ma trận nhóm với khả năng hiển thị, thuế và giảm giá | Ý nghĩa nhóm được ghi nhận vượt ra ngoài tên nhãn. |
| Địa chỉ | Người phụ trách dữ liệu Customers | Địa chỉ dùng lại và ví dụ địa chỉ tại thời điểm Orders | Tài khoản hiện tại và ảnh chụp lịch sử được tách biệt. |
| Extension wholesale/B2B | Người phụ trách nghiệp vụ và developer | Bản ghi công ty, vai trò, phê duyệt, giá hoặc tín dụng | Quan hệ thương mại do extension sở hữu có quyết định về đích đến. |
| Reviews và hoạt động Customers | Người phụ trách nội dung/thương mại | Quan hệ Customers-Products đại diện | Bản ghi do Customers tạo vẫn gắn đúng chủ sở hữu. |
| Khóa Customers hệ thống ngoài | Người phụ trách tích hợp | Bảng đối chiếu identifier CRM/ERP | Hệ thống tiếp tục vận hành có thể tìm đúng tài khoản. |
Khả năng dùng lại mật khẩu phải được ghi như đặc tính của Cửa hàng nguồn, không được suy luận từ việc có địa chỉ email. Cần ghi cơ chế xác thực nguồn và mức độ phụ thuộc đối với quyền truy cập tài khoản mà không biến checklist này thành kế hoạch truyền thông với khách hàng.
Chuẩn bị Orders và thông tin lịch sử thương mại
Phần chuẩn bị Orders cần giúp giao dịch trước đây tiếp tục được hiểu. Orders v4 có thể chứa ngữ cảnh kênh bán hàng, ảnh chụp Products/attributes, địa chỉ, các khoản tổng, trạng thái, ghi chú, nhãn thanh toán/vận chuyển, tracking, refunds, returns, invoices và tham chiếu hệ thống ngoài. Module legacy có thể bổ sung bảng tổng Orders hoặc bảng giao dịch riêng.
Chọn các Orders phản ánh đúng độ phức tạp thực tế và xác định bản ghi hoặc extension nào sở hữu từng giá trị lịch sử.
| Thông tin Orders | Hành động chuẩn bị | Điều kiện sẵn sàng |
|---|---|---|
| Products và attributes đã mua | Ghi tên/SKU tại thời điểm mua, giá trị lựa chọn, số lượng và giá | Mặt hàng đã mua vẫn được hiểu độc lập với danh mục hiện tại. |
| Địa chỉ thanh toán/giao hàng | Giữ ảnh chụp tại thời điểm Orders tách khỏi địa chỉ Customers hiện tại | Địa chỉ lịch sử của giao dịch đầy đủ. |
| Thuế, vận chuyển, giảm giá, phí và tín dụng | Kiểm kê từng dòng tổng quan trọng và module sở hữu | Có thể giải thích tổng cuối cùng mà không cần tái tạo code đã ngừng dùng. |
| Tham chiếu thanh toán/vận chuyển | Ghi nhãn, transaction IDs, tracking và module sở hữu | Tham chiếu lịch sử có sẵn nhưng không bị coi là cấu hình hiện tại. |
| Trạng thái và ghi chú | Ghi ý nghĩa trạng thái, thứ tự, thời gian và mức độ hiển thị | Nhân viên có thể đọc đúng quy trình lịch sử. |
| Refunds, returns và ID hệ thống ngoài | Ghi các đối tượng liên quan và khóa đối chiếu | Quan hệ hậu mãi và hệ thống ngoài vẫn truy vết được. |
Không được tính lại Orders cũ từ Products, nhóm Customers, thuế hoặc thiết lập vận chuyển hiện tại. Bộ tài liệu phải giữ giao dịch đúng như đã được ghi nhận tại thời điểm phát sinh.
Lập danh mục Apps, extension legacy, bảng tùy chỉnh và tích hợp
Apps v4 hiện tại và extensions legacy có thể sở hữu trường danh mục, nhóm Customers, tổng Orders, dữ liệu SEO, tham chiếu thanh toán, offer Marketplace, báo cáo hoặc mapping với hệ thống ngoài. Chỉ có danh sách tên extension là chưa đủ; cần xác định các bản ghi mà từng thành phần tạo hoặc thay đổi.
| Mô hình phụ thuộc | Tài liệu cần chuẩn bị | Điều kiện sẵn sàng |
|---|---|---|
| v4 App đang dùng | Tên App, phiên bản, dữ liệu bị ảnh hưởng, trường/bảng và ID đại diện | Dữ liệu App còn hoạt động có chủ sở hữu rõ. |
| Extension legacy | Tên package, tệp core đã chỉnh sửa, thay đổi SQL và bản ghi liên quan | Có thể tách dữ liệu extension khỏi bản ghi lõi osCommerce. |
| Bảng hoặc trường tùy chỉnh | Schema, ý nghĩa kinh doanh, khóa cha và hệ thống sử dụng | Mỗi giá trị tùy chỉnh còn sử dụng có quyết định xử lý. |
| Kết nối Marketplace/kênh bán hàng | Listing, offer, kênh và ID hệ thống ngoài | Định danh Products gốc được tách khỏi cách Products xuất hiện trên kênh. |
| Tích hợp ERP/PIM/WMS/CRM | Nguồn có thẩm quyền, hướng đồng bộ và khóa ổn định | Hệ thống tiếp tục hoạt động có thể kết nối lại đúng dữ liệu trên đích. |
| Thành phần đã bỏ | Thông tin lần dùng cuối và xác nhận từ người phụ trách | Phần dư thừa kỹ thuật được đánh dấu lưu trữ riêng hoặc loại bỏ. |
Chuẩn bị nội dung CMS, media, SEO và routes
osCommerce v4 có thể quản lý nội dung CMS, themes, front ends, mô tả Products/Categories, media và thiết lập SEO. Cửa hàng legacy có thể dùng extension trang thông tin, tệp tĩnh, template box, tệp ngôn ngữ hoặc module SEO. Cần chuẩn bị nội dung theo chủ sở hữu thay vì coi mọi trang hiển thị là một bản ghi CMS cùng loại.
Lập danh mục route cho Products, Categories, brands, CMS Pages, trang thông tin, nội dung riêng theo front end và endpoint của extension có giá trị cao. Ghi đường dẫn nguồn, đối tượng sở hữu, ngôn ngữ, front end, metadata, canonical khi có, mức độ quan trọng kinh doanh và quyết định xử lý trên đích.
Sao lưu hình ảnh, downloads, tài liệu, tài nguyên theme và tệp nội dung gốc. Ghi quan hệ attachment và URL ngoài. Bản dump cơ sở dữ liệu có thể giữ tên tệp nhưng không chứa tệp vật lý thực tế.
Tạo gói backup và kiểm tra mức độ sẵn sàng của dữ liệu đầu vào
Tạo một gói có thể khôi phục, gắn với một trạng thái nguồn cụ thể.
| Thành phần gói | Người phụ trách | Tài liệu cần giữ | Điều kiện sẵn sàng |
|---|---|---|---|
| Backup cơ sở dữ liệu | Quản trị cơ sở dữ liệu | Dump có timestamp, prefix và ghi chú thế hệ nguồn | Toàn bộ schema dự kiến đã được đưa vào. |
| Tệp và media | Người phụ trách hosting/kỹ thuật | File archive hoặc cây nguồn có thể truy cập | Media, downloads, extensions và code tùy chỉnh gốc còn sẵn. |
| Hồ sơ dòng phiên bản | Người phụ trách kỹ thuật | Lịch sử phiên bản/fork và ghi chú nâng cấp | Có thể diễn giải đúng cấu trúc legacy và hiện tại. |
| Danh sách quyền truy cập | Người phụ trách dự án | Chủ sở hữu quyền truy cập và trạng thái kết nối | Quyền truy cập cần thiết sẵn sàng mà không công khai credentials. |
| Change log | Quản trị cửa hàng | Các thay đổi cấu trúc sau thời điểm chốt thông tin | Thay đổi muộn có thể được đưa vào dự án có chủ đích. |
Chọn các bản ghi đại diện để kiểm thử di chuyển dữ liệu
Chuẩn bị manifest các bản ghi mẫu với ID nguồn, người phụ trách, lý do kinh doanh, tệp liên quan và quan hệ kỳ vọng từ nguồn. Bộ mẫu nên làm lộ cả cấu trúc v4 hiện tại và cấu trúc legacy nếu cả hai cùng tồn tại. Manifest được xem là sẵn sàng khi mọi kỳ vọng ở nguồn, phụ thuộc theo dòng phiên bản, tệp liên kết và identifier đều đầy đủ và có người rà soát.
Tối thiểu nên gồm:
- một bản ghi Products đơn giản và một bản ghi Products có nhiều quan hệ Categories hoặc front end;
- Products có attributes, properties, tổ hợp configurable, downloads, suppliers và giá theo nhóm;
- Customers thuộc các nhóm có ý nghĩa, giao dịch của khách vãng lai và tài khoản wholesale/do extension sở hữu;
- Orders có attributes, nhiều khoản tổng, refunds, tracking, ghi chú và tham chiếu hệ thống ngoài;
- các route ưu tiên thuộc CMS, Products, Categories, brand và extension;
- một bản ghi từ App hiện tại hoặc extension legacy có chứa dữ liệu kinh doanh;
- một bản ghi có ý nghĩa khác nhau giữa thế hệ nguồn và v4 hiện tại.
Kiểm tra điều kiện sẵn sàng cuối cùng trước khi chuyển đổi sang osCommerce
| Câu hỏi về mức độ sẵn sàng | Kết quả cần đạt |
|---|---|
| Dòng phiên bản nguồn đã được xác nhận chưa? | Phiên bản, branch/fork, cơ sở dữ liệu, front ends, extensions và phần tùy chỉnh đều được ghi nhận. |
| Phạm vi danh mục đã đầy đủ chưa? | Products, Categories, brands, suppliers, kênh, tồn kho, giá và media có chủ sở hữu rõ. |
| Attributes và properties đã được phân loại chưa? | Quan hệ lựa chọn, mô tả, configurable và tùy chỉnh được tách biệt. |
| Customers và Orders có thể được diễn giải đầy đủ chưa? | Nhóm, địa chỉ, tổng tiền, trạng thái và tham chiếu hệ thống ngoài đã được ghi nhận. |
| Apps và dữ liệu tùy chỉnh đã được phân loại chưa? | Bản ghi còn hoạt động do extension sở hữu có quyết định đích đến rõ. |
| Nội dung và routes đã được kiểm kê chưa? | CMS, nội dung legacy, media và URL quan trọng gắn với đúng đối tượng sở hữu. |
| Backup, quyền truy cập và mẫu kiểm thử đã sẵn sàng chưa? | Gói nguồn có thể khôi phục và danh sách ID đại diện đầy đủ. |
Công tác chuẩn bị chưa thể đóng nếu một bảng legacy quan trọng, quan hệ gán theo kênh, quy tắc nhóm Customers, module tổng Orders hoặc identifier hệ thống ngoài vẫn chưa có chủ sở hữu và quyết định xử lý.
Kết luận
Chuẩn bị chuyển đổi sang osCommerce vừa là quá trình xác định dòng phiên bản vừa là quá trình kiểm kê dữ liệu. Products, front ends, nhóm Customers, attributes, properties, nội dung CMS và Apps của v4 cần được tách khỏi bảng legacy, contribution cộng đồng và code đã chỉnh sửa.
Một gói dữ liệu nguồn được kiểm soát tốt sẽ làm rõ các ranh giới này và cung cấp đủ bản ghi đại diện để cấu hình di chuyển dữ liệu.
Câu hỏi thường gặp
Vì sao cần xác nhận phiên bản hoặc fork của osCommerce nguồn trước tiên?
osCommerce v4 và các bản cài đặt legacy có thể lưu và diễn giải danh mục, Customers, Orders, nội dung và dữ liệu extension theo cách khác nhau. Dòng phiên bản quyết định bảng và quan hệ nào thực sự sở hữu dữ liệu nguồn.
Khi chuẩn bị di chuyển dữ liệu, attributes và properties khác nhau như thế nào?
Attributes thường đại diện cho giá trị Products có thể lựa chọn hoặc cấu hình và có thể ảnh hưởng đến giá, trọng lượng, tồn kho hoặc downloads. Properties mô tả đặc tính có cấu trúc dùng cho hiển thị, lọc, tìm kiếm hoặc so sánh.
Nên ghi nhận việc gán theo kênh bán hàng/front end như thế nào?
Cần ghi Products, Categories, nội dung, ngôn ngữ và URL nào thuộc từng front end. Bản ghi dùng chung và bản ghi riêng theo kênh phải được thể hiện rõ trong ma trận phạm vi.
Có nên sao chép bảng extension legacy vào các trường osCommerce v4 hiện tại không?
Không nên mặc định sao chép. Trước tiên cần xác định extension, ý nghĩa kinh doanh, bản ghi cha và hệ thống còn tiếp tục sử dụng dữ liệu. Tính năng hiện đại có tên tương tự chưa chắc dùng cùng schema hoặc có cùng cách hoạt động.
Những Orders nào nên được đưa vào bộ mẫu osCommerce?
Nên có Orders của khách vãng lai và Customers đã đăng ký, nhiều trạng thái, lựa chọn attributes, giảm giá, thuế, vận chuyển, tham chiếu thanh toán, refunds, ghi chú, tracking và khoản tổng do extension tạo hoặc ID hệ thống ngoài.
Backup cơ sở dữ liệu có chứa hình ảnh, downloads và tệp extension của osCommerce không?
Backup cơ sở dữ liệu không chứa đầy đủ các tệp đó. Cần chuẩn bị cây tệp liên quan cùng cơ sở dữ liệu để media, tệp downloadable, themes, Apps, extensions legacy và code tùy chỉnh vẫn có sẵn.