Bỏ qua, tới nội dung

Nhà phát triển

Mã nguồn mở, xây trên Spree Commerce 6

ParkViet bám sát cách tổ chức của Spree để nhận cải tiến và bản vá từ upstream, rồi thêm POS, VietQR và các phần cho cửa hàng Việt Nam. Đọc được, sửa được, chạy được trên máy của bạn.

Tải về Xem trên GitHub

Trong repo có gì

Một monorepo: API Rails và các ứng dụng giao diện, chạy cùng nhau bằng Docker.

  • API thương mại

    server/

    Spree 6 · Ruby on Rails · PostgreSQL · Redis

    Spree, ParkViet tuỳ biến

  • POS bán tại quầy

    apps/pos

    React · Vite · TanStack Router, Query

    ParkViet

  • Bảng quản trị

    apps/dashboard

    React · Vite · @spree/dashboard

    Spree, tuỳ biến bằng plugin

  • Website bán hàng

    apps/storefront

    Next.js · React · Tailwind · @spree/sdk

    Spree

  • Bảng người bán (sàn)

    apps/seller-dashboard

    React · Vite · @spree/seller-dashboard

    Spree

  • Gem VietQR

    server/vendor/gems/spree_vietqr

    Ruby gem cho Spree 6 · webhook SePay, PayOS

    ParkViet

Nền tảng

Xây trên Spree Commerce, lõi thương mại mã nguồn mở

Thay vì viết lại mọi thứ từ đầu, ParkViet dùng Spree Commerce (giấy phép BSD-3-Clause), nền tảng đã được nhiều doanh nghiệp trên thế giới sử dụng. Spree lo phần lõi: sản phẩm, đơn hàng, kho, khuyến mãi. ParkViet làm phần hợp với cách bán hàng của người Việt.

ParkViet là dự án độc lập, không phải sản phẩm của Spree. Chúng tôi theo sát các bản cập nhật của Spree để nhận cải tiến và bản vá bảo mật.

  1. Ứng dụngParkViet + Spree
    • POS bán tại quầy
    • Bảng quản trị
    • Bảng người bán
    • Cửa hàng online
  2. Phần cho Việt NamParkViet
    • VietQR tự đối soát
    • Hồ sơ ngành
    • Serial, lô, hạn dùng
    • Ca và sổ quỹ
    • Bán chịu
  3. Lõi thương mạiSpree Commerce 6
    • Sản phẩm, biến thể
    • Đơn hàng
    • Nhiều kho
    • Khuyến mãi
    • Thuế
    • Đa ngôn ngữ
    • API, webhook
  4. Hạ tầngMã nguồn mở
    • Ruby on Rails
    • PostgreSQL
    • Redis
    • Docker

Mở rộng theo cách của Spree

Phần lớn cơ chế mở rộng đến từ Spree, nên tài liệu của Spree áp dụng được cho ParkViet. Tài liệu riêng của ParkViet đang được soạn.

  • API REST và OpenAPI

    Store API cho website, ứng dụng di động; Admin API cho hệ thống nội bộ.

  • Webhook

    Nhận sự kiện khi đơn hàng, thanh toán, tồn kho thay đổi.

  • Plugin bảng quản trị

    Thêm trang riêng, chỉnh bảng dữ liệu với tải lại trực tiếp.

  • Cổng thanh toán mới

    Viết theo cơ chế payment method của Spree, như cách gem VietQR làm.

  • Dòng lệnh pnpm spree

    Chạy service, seed dữ liệu, tạo khoá API, sinh mã, gọi Admin API.

  • MCP cho AI agent

    Spree có máy chủ MCP để AI agent đọc và thao tác dữ liệu cửa hàng.

Cộng đồng

Mã nguồn công khai, ai cũng góp được

Báo lỗi, đề xuất tính năng hay gửi pull request đều trên GitHub. Mỗi đóng góp đều giúp phần mềm bán hàng tốt hơn cho người Việt.

Xem mã nguồnBáo lỗi, góp ý
Fork
22
Người đóng góp
2