Skills Medusajs

Các tiện ích mở rộng giao diện người dùng tùy chỉnh cho bảng điều khiển quản trị Medusa sử dụng Admin SDK và các thành phần giao diện Medusa. Tải kỹ năng này TRƯỚC TIÊN cho bất kỳ công việc giao diện quản trị nào (lập kế hoạch, triển khai, khám phá); máy chủ MCP chỉ cung cấp tham chiếu API, không phải mẫu thiết kế hoặc chiến lược tải dữ liệu. QUAN TRỌNG: Luôn sử dụng Medusa JS SDK cho tất cả các yêu cầu API (không bao giờ dùng fetch thông thường); tách biệt truy vấn hiển thị khỏi truy vấn modal và vô hiệu hóa dữ liệu

Tự động tải khi lập kế hoạch, nghiên cứu hoặc triển khai giao diện bảng điều khiển quản trị Medusa (widget, trang tùy chỉnh, biểu mẫu, bảng, tải dữ liệu, điều hướng).…

Tích hợp frontend theo SDK cho các storefront Medusa với các mẫu React Query và quy tắc gọi API quan trọng. Luôn sử dụng Medusa JS SDK cho mọi yêu cầu API—không bao giờ dùng fetch() thông thường, vì nó thiếu các header cần thiết (khóa API có thể xuất bản cho các route store, xác thực cho các route admin). Truyền các đối tượng JavaScript thuần cho các phương thức SDK; không bao giờ dùng JSON.stringify() trên các tham số body, vì SDK tự động xử lý tuần tự hóa. Sử dụng useQuery cho các yêu cầu GET và useMutation cho các yêu cầu POST/DELETE,...

Tự động tải khi lập kế hoạch, nghiên cứu hoặc triển khai các tính năng storefront của Medusa (gọi các route API tùy chỉnh, tích hợp SDK, các mẫu React Query,…)

Hướng dẫn toàn diện về kiến trúc backend Medusa, quy trình làm việc và các quy tắc triển khai quan trọng. Bao gồm sáu loại quy tắc (kiến trúc, an toàn kiểu dữ liệu, vị trí logic nghiệp vụ, import, truy cập dữ liệu, tổ chức tệp) với các phản mẫu cụ thể và kiểm tra thực thi. Áp dụng phân tách lớp nghiêm ngặt: Module → Workflow → API Route → Frontend, yêu cầu workflow cho mọi thao tác thay đổi dữ liệu và chỉ cho phép các phương thức HTTP GET/POST/DELETE. Bao gồm các quy tắc xử lý dữ liệu quan trọng: giá được lưu trữ nguyên trạng...

Tự động tải khi lập kế hoạch, nghiên cứu hoặc triển khai BẤT KỲ tính năng backend Medusa nào (module tùy chỉnh, route API, quy trình làm việc, mô hình dữ liệu, liên kết module,…)

Tạo migrations cơ sở dữ liệu cho các module Medusa chỉ với một lệnh duy nhất. Bao bọc lệnh CLI npx medusa db:generate để tạo các tệp migration cho các module Medusa được chỉ định. Chấp nhận tên module làm đối số và báo cáo vị trí tệp migration, lỗi và các bước tiếp theo. Tự động đề xuất chạy npx medusa db:migrate sau khi tạo để áp dụng migrations.

Tạo migrations cơ sở dữ liệu cho một module Medusa

Thực thi các migration cơ sở dữ liệu Medusa đang chờ và báo cáo kết quả. Chạy npx medusa db:migrate qua Bash để áp dụng tất cả migration đang chờ vào cơ sở dữ liệu Medusa của bạn. Báo cáo kết quả migration bao gồm số lượng migration đã áp dụng, bất kỳ lỗi nào gặp phải và xác nhận thành công. Được thiết kế cho các dự án Medusa với thiết lập npm/npx tiêu chuẩn.

Chạy di chuyển cơ sở dữ liệu trong Medusa

Khóa học phát triển Medusa tương tác từng bước, nơi bạn xây dựng tính năng thương hiệu trong khi học các mẫu kiến trúc. Ba bài học tiến dần (tổng cộng 2–3 giờ) bao gồm modules, workflows, API routes, module links, workflow hooks và tùy chỉnh giao diện quản trị. Kiểm tra xác nhận sau mỗi thành phần chính để đánh giá hiểu biết khái niệm, chất lượng mã và chức năng trước khi tiếp tục. Coi lỗi là cơ hội giảng dạy; gỡ lỗi cùng nhau với các câu hỏi chẩn đoán và nguyên nhân gốc rễ...

Tự động tải khi người dùng yêu cầu học phát triển Medusa (ví dụ: "dạy tôi cách xây dựng với medusa", "hướng dẫn tôi qua medusa", "tôi muốn học medusa").…

Thực thi các lệnh mcloud deployments để liệt kê các bản triển khai, lấy thông tin chi tiết bản triển khai và tải nhật ký bản dựng. Sử dụng khi liệt kê các bản triển khai, kiểm tra bản triển khai…

Thực thi các lệnh mcloud environments để liệt kê, lấy, tạo, xóa, triển khai lại hoặc kích hoạt bản dựng cho các môi trường Cloud. Sử dụng khi quản lý vòng đời môi trường,…

Thực thi mcloud logs để lấy và phát trực tiếp nhật ký thời gian chạy cho các môi trường Cloud. Sử dụng khi đọc nhật ký backend hoặc storefront, lọc theo khoảng thời gian, tìm kiếm…

Thực thi các lệnh tổ chức mcloud để liệt kê hoặc lấy các tổ chức Cloud. Sử dụng khi khám phá tổ chức, tra cứu ID tổ chức theo tên, hoặc truy xuất…

Thực thi các lệnh dự án mcloud để liệt kê, lấy hoặc xóa các dự án Cloud. Sử dụng khi khám phá dự án, giải quyết các handle dự án theo tên, hoặc truy xuất…

Thực thi các lệnh biến mcloud để liệt kê và lấy các biến môi trường cho một môi trường Cloud. Sử dụng khi kiểm tra, đọc hoặc xuất môi trường…

Tạo người dùng quản trị mới trong Medusa với email và mật khẩu. Chấp nhận email và mật khẩu làm đối số lệnh để thiết lập thông tin quản trị. Thực thi lệnh npx medusa user qua Bash với cờ -e và -p. Báo cáo thành công tạo, email người dùng, lỗi và các bước tiếp theo để đăng nhập vào bảng điều khiển quản trị.

Tạo người dùng quản trị trong Medusa

LUÔN sử dụng kỹ năng này khi làm việc với các cửa hàng thương mại điện tử, cửa hàng trực tuyến, trang web mua sắm. Sử dụng cho BẤT KỲ thành phần cửa hàng nào bao gồm trang thanh toán, giỏ hàng,…

Hướng dẫn toàn diện để xây dựng storefront thương mại điện tử hiện đại với các mẫu thiết kế, kiến trúc thành phần và tích hợp backend. Bao gồm tất cả các thành phần storefront: điều hướng, trang sản phẩm, giỏ hàng, thanh toán và trang tài khoản trên mọi framework (Next.js, SvelteKit, React, Vue). Bao gồm các mẫu hỗ trợ tiếp cận quan trọng (aria-live cho cập nhật giỏ hàng), tối ưu hóa di động (safe-area-inset, mục tiêu chạm 44px) và yêu cầu SEO (Product schema, Core Web Vitals). Cung cấp SDK backend bắt buộc...

Quản lý tài nguyên Medusa Cloud thông qua Cloud CLI (mcloud). Sử dụng khi triển khai, gỡ lỗi các bản triển khai, quản lý môi trường, biến môi trường hoặc bất kỳ…

Quản lý tài nguyên Medusa Cloud thông qua Cloud CLI (mcloud). Sử dụng khi triển khai, gỡ lỗi các bản triển khai, quản lý môi trường, biến môi trường hoặc bất kỳ…