Telegram Shop Admin (Bot & SePay Auto-Delivery)

Hệ thống quản lý bán hàng tự động ứng dụng qua nền tảng Telegram Bot, kết hợp phương thức thanh toán SePay để giao các sản phẩm số tự động (tài khoản, mã giảm giá, thẻ nạp, phần mềm,...).

Kiến trúc tính năng (MVP)

1. Dashboard: Thống kê doanh thu, đơn hàng, người dùng trực quan.
2. Products & Inventory: Quản lý kho hàng số học thuật, lưu stock theo từng dòng và cấp mã duy nhất.
3. Bot API: Webhook trực tiếp giao tiếp với Telegram thông qua /api/bot.
4. SePay API: Tự động lắng nghe webhook giao dịch ngân hàng từ /api/sepay để đối soát và trả hàng.
5. Orders & Customers: Giám sát đơn và theo dõi tương tác Bot Logs.

Hướng dẫn Vận hành & Cài đặt

Bước 1: Khai báo URL Webhook cho Bot

1. Mở app Telegram, tìm @BotFather, gõ /newbot để tạo bot và lấy Bot Token.
2. Mở Web Admin, đến Module Cấu hình Bot (Bot Config).
3. Dán Bot Token vào, bấm Test rồi Set Webhook. Cấu hình sẽ tự động trỏ event của Telegram về /api/bot của bạn.

Bước 2: Thiết lập Thanh toán & Auto Delivery

1. Cần có tài khoản SePay.vn.
2. Tạo Webhook ở SePay với đường dẫn nhận là <domain-cua-ban>/api/sepay.
3. Trong giao diện SePay, cấu hình Nội dung cú pháp là mã Random (ví dụ: [MA_DON]). Hệ thống Bot sẽ gen riêng ra một mã 8 ký tự paymentReference cấp cho người mua.
4. Mở Web Admin, module Thanh toán (Payment Settings), cập nhật tên/số ngân hàng hiển thị để Bot báo khách.

Bước 3: Tạo Sản phẩm & Nạp Stock

1. Vào Web Admin, tạo Category mới.
2. Sang mục Products, bấm Add Product.
3. Khai báo giá và điền kho (mỗi line enter là 1 kho hàng độc lập).
4. Lưu ý: Bot chỉ bán các sản phẩm có trạng thái Active và có stock Available.

Bước 4: Trải nghiệm & Seed dữ liệu

1. Test luồng với lệnh /start đối với Bot của bạn ở Telegram.
2. (Tuỳ chọn) Nếu bạn muốn sinh dữ liệu mồi lập tức để Demo Dashboard: Hãy gọi POST vào đường dẫn <domain>/api/seed.

---

Cấu trúc Mã nguồn chính

• app/admin/...: Toàn bộ panel CMS quản trị của hệ thống.
• app/api/...: Vùng xử lý automation (Tele webhook & Bank webhook).
• lib/firebase.ts & lib/firebase-admin.ts: DB Connection & Roles.
• components/auth-provider.tsx: Context check Google SSO Auth Identity.

System uses Firebase Firestore as primary Database and utilizes Tailwind CSS v4 + Bold Typography theme.