2. TỔNG QUAN DỰ ÁN & SỨ MỆNH (EXECUTIVE SUMMARY)

NodeX Studio Marketplace được xây dựng nhằm giải quyết bài toán tự động hóa hoàn toàn quy trình bán hàng số:

• Tự động hóa 100%: Khách nạp tiền → Hệ thống Cronjob ngân hàng đối soát → Cộng tiền & khuyến mãi → Khách đặt hàng → Hệ thống tự động kích hoạt / gửi link download / cấp License Key.
• Không tốn nhân sự vận hành: Bot Telegram tự động báo tin nhắn về máy tính / điện thoại Admin theo thời gian thực (Real-time).
• Tốc độ vượt trội: Thời gian phản hồi trang dưới 150ms, giao diện Metronic 8 mượt mà, hỗ trợ full responsive từ Mobile tới Widescreen 4K.

3. CÔNG NGHỆ & LÕI KỸ THUẬT (TECH STACK)

4. KIẾN TRÚC BẢO MẬT ĐỘC QUYỀN (SECURITY ARCHITECTURE)

NodeX Studio loại bỏ hoàn toàn các lớp bảo mật mặc định kém an toàn, thay thế bằng các tiêu chuẩn bảo mật Enterprise:

• NodeX-Token (Thay thế hoàn toàn CSRF gốc): Loại bỏ hoàn toàn @csrf và csrf_token(). Sinh token AES-256 tự động từ View::composer trong AppServiceProvider. Kiểm tra IP, Session ID, TTL 5 phút. Khi phát hiện request giả mạo/hack, Middleware trả về HTTP 404 để ẩn hoàn toàn endpoint.
• Rate Limiting & Anti-Brute Force: Phân tầng Request Throttle: /api/login (10 req/phút), /api/admin/* (30 req/phút). Middleware BlockBadBots, SqlInjectionProtection, XssProtection, SecurityHeaders.
• Strict Types & Thin Controller: 100% file PHP bắt buộc có declare(strict_types=1);. Controller chỉ đóng vai trò điều hướng, toàn bộ Business Logic được encapsulation trong các lớp Action độc lập (App\Modules\*).

5. MA TRẬN TÍNH NĂNG CHI TIẾT (DETAILED FEATURE MATRIX)

A. Dành Cho Khách Hàng (Client Portal)

• Trang chủ Dashboard: Slider banner cao cấp, thống kê sản phẩm hot, dịch vụ mới nhất, bài viết kiến thức.
• Kho Mã Nguồn (Source Code Marketplace): Xem demo trực tiếp, bộ lọc danh mục thông minh, xem thông số chi tiết (Phiên bản, PHP required, lượt xem, lượt mua).
• Tự động giao dịch: Mua mã nguồn → Hệ thống trừ số dư → Cấp link Google Drive / Mega / License Key trong phần Lịch sử đơn hàng.
• Hệ Thống Dịch Vụ Cho Thuê (Service Rental System): Cho thuê Web, Tool, API tự động. Khách nhập domain/thông số → Chọn gói thời hạn (1 tháng, 3 tháng, 1 năm) → Hệ thống tự tính giá và tạo đơn xử lý.
• Nạp Tiền Tự Động (Auto Deposit): Tích hợp cổng nạp Ngân Hàng (MBBank, Vietcombank,...), Momo, VNPay. Sinh mã giao dịch QR Code động chuẩn VietQR. Cronjob ngân hàng quét đối soát tự động cộng tiền trong 5 - 30 giây. Hỗ trợ chương trình Khuyến Mãi Nạp Tiền (ví dụ: Nạp từ 500k +10%, nạp ngày vàng +20%).
• Trang Cá Nhân & Nhật Ký: Quản lý Hồ sơ, đổi mật khẩu, xem Biến động số dư và Nhật ký hoạt động IP/Thiết bị.

B. Dành Cho Quản Trị Viên (Admin Control Panel)

• Tổng Quan (Admin Dashboard): Biểu đồ doanh thu 30 ngày, thống kê tổng thành viên, tổng lợi nhuận, tổng số dư người dùng.
• Quản Lý Mã Nguồn: Thêm/sửa/xóa mã nguồn, tải ảnh banner, gallery ảnh demo, link tải file, giá bán, giá khuyến mãi.
• Quản Lý Dịch Vụ: Tạo dịch vụ cho thuê, tùy chỉnh các trường dữ liệu khách cần nhập, duyệt đơn dịch vụ.
• Quản Lý Đơn Hàng: Quản lý toàn bộ lịch sử giao dịch mã nguồn và dịch vụ, cập nhật trạng thái, ghi chú xử lý.
• Quản Lý Thành Viên: Cộng/trừ tiền thành viên thủ công, đổi mật khẩu, khóa/mở khóa tài khoản (Banned).
• Cấu Hình Nạp Tiền & Ngân Hàng: Thêm tài khoản ngân hàng nhận tiền, cài đặt % khuyến mãi nạp tiền, lấy link Cronjob đối soát.
• Cấu Hình Hệ Thống (System Settings):
  • SEO Basic & Social: Tùy chỉnh Meta Title, Description, Keywords, OG:Image, Twitter Cards.
  • Thương hiệu: Thay đổi Logo Header/Footer, Favicon, Banner.
  • Custom Scripts: Trình chỉnh sửa Monaco Editor nhúng script Header, Body, Footer (Google Analytics, Facebook Pixel, Chat Widget).
• Telegram Bot Admin: Cài đặt Bot Token, Admin Chat ID, bật/tắt gửi thông báo cho từng sự kiện (Đăng ký, Đăng nhập, Mua mã nguồn, Đặt đơn dịch vụ, Nạp tiền).

C. Bot Telegram Thông Minh (Real-time Telegram Bot)

Tích hợp sẵn thông báo gửi về nhóm/kênh Telegram của Admin khi có phát sinh:

• Có thành viên mới đăng ký tài khoản.
• Có người dùng đăng nhập hệ thống.
• Có đơn đặt mua Mã nguồn mới.
• Có đơn đặt hàng Dịch vụ mới.
• Có giao dịch Nạp tiền thành công từ ngân hàng.

6. CẤU TRÚC CODEBASE CHUẨN MODULAR MONOLITH

Codebase được tổ chức cực kỳ gọn gàng, tách biệt theo các Module chức năng chính trong app/Modules/:

nodexstudio.click/
├── app/
│   ├── Http/
│   │   ├── Controllers/        # API & Web Controller thin
│   │   ├── Middleware/         # Security, Auth, CheckAdmin, XssProtection
│   │   └── Requests/           # FormRequest Validation riêng biệt
│   ├── Modules/
│   │   ├── Core/               # Module Lõi (Settings, Dashboard, User)
│   │   ├── SourceCode/         # Module Bán Mã Nguồn
│   │   ├── Service/            # Module Dịch Vụ Cho Thuê
│   │   ├── Deposit/            # Module Nạp Tiền & Cronjob Ngân Hàng
│   │   ├── Post/               # Module Bài Viết & Tin Tức
│   │   └── Order/              # Module Quản Lý Đơn Hàng
│   └── Services/
│       ├── Security/           # RequestSignature, Security Encryption
│       └── Telegram/           # TelegramNotificationService
├── packages/
│   └── NodeX/
│       └── Security/           # NodeX-Token Engine Package
├── public/
│   └── frontend/assets/        # CSS, JS, Images tách theo từng Component/Trang
├── resources/
│   └── views/
│       ├── layouts/            # Master Layout (Admin & Client)
│       ├── core/               # Blade views Core
│       ├── source_code/        # Blade views Source Code
│       ├── service/            # Blade views Service
│       └── deposit/            # Blade views Deposit
└── routes/
    ├── web.php                 # GET Routes Client
    ├── admin.php               # GET Routes Admin
    ├── api.php                 # POST/PUT/DELETE Routes API
    └── cronjobs.php            # Cronjob Reconciliation Routes

7. TRẢI NGHIỆM GIAO DIỆN (UI/UX AESTHETICS)

• Chuẩn Thiết Kế Premium: Sử dụng tông màu Modern Dark/Light Mode, bo góc viền mềm mại, hiệu ứng Glassmorphism mờ kính sang trọng.
• Thư Viện Icon Tối Ưu: Sử dụng Iconify load vector icon siêu nhẹ, hỗ trợ hàng ngàn icon Solar & FontAwesome.
• Tối Ưu Hiển Thị Logo: Logo Header & Footer được căn chỉnh tỷ lệ tự động (object-fit: contain), không bao giờ bị vỡ hay bóp méo hình.
• Responsive 100%: Hiển thị mượt mà trên iPhone, Android, Tablet, Laptop và Màn hình PC Ultra-wide.