GIỚI THIỆU
StreamBunny là mã nguồn website quản lý thư viện phim và nội dung giải trí, xây dựng trên Laravel 13, PHP 8.3+, Blade, MySQL và Vite. Gói mã nguồn phù hợp để nghiên cứu, triển khai website catalog phim hoặc phát triển thành sản phẩm riêng sau khi người mua tự cấu hình dữ liệu, nguồn phát và các dịch vụ cần thiết.
CHỨC NĂNG WEBSITE
• Trang chủ có slider phim nổi bật, trailer và các khu vực khám phá nội dung.
• Danh sách phim, tìm kiếm gợi ý, lọc theo danh mục/thể loại/quốc gia, trang chi tiết và trang xem phim theo tập/server.
• Trình phát ArtPlayer hỗ trợ các luồng tương thích như HLS/M3U8 khi máy chủ nguồn cho phép truy cập và đáp ứng yêu cầu CORS.
• Khu vực truyền hình có nhóm kênh, cấu hình luồng, lịch chương trình và lựa chọn xem lại khi nguồn dữ liệu/cấu hình tương ứng sẵn sàng.
• Tài khoản thành viên có xác minh email, tùy chọn đăng nhập Google, hồ sơ, lịch sử xem, yêu thích, danh sách xem sau, đánh giá và bình luận.
• Gợi ý nội dung theo sở thích và lịch sử xem khi người dùng bật/chấp thuận lưu dữ liệu cá nhân hóa.
• Donate qua PayOS, lịch sử và bảng vàng; hỗ trợ thông báo Slack theo cấu hình.
CHỨC NĂNG CMS
• Quản lý phim, thể loại, quốc gia, menu, mega menu và nội dung nổi bật trên trang chủ.
• Quản lý người dùng, bình luận, khiếu nại, nhóm/kênh truyền hình và cấu hình website.
• Đồng bộ catalog qua hàng đợi, theo dõi tiến độ, xử lý song song, retry lỗi và xem log API.
• Báo cáo hệ thống, cấu hình SEO/Analytics, đăng nhập Google, AI, PayOS, Slack, CDN/Gateway và các thiết lập liên quan.
• Sao lưu/khôi phục dữ liệu ứng dụng và tải log vận hành theo quyền quản trị.
CÔNG NGHỆ
• Laravel 13, PHP 8.3+, Laravel Socialite.
• Blade, Vite, Tailwind CSS 4, JavaScript.
• MySQL 8, Laravel Queue và Scheduler.
• ArtPlayer 5, hls.js.
• Docker Compose, Supervisor, Nginx.
YÊU CẦU VÀ TÍCH HỢP
Máy chủ cần PHP 8.3+, Composer, Node.js 20+ và MySQL 8+, hoặc Docker Engine cùng Docker Compose. Đăng nhập Google, PayOS, Slack, AI, Google Analytics, CDN/Gateway, API catalog và nguồn video cần tài khoản, khóa, quyền truy cập và cấu hình riêng. Các thông tin này không nằm trong gói bàn giao.
Ứng dụng lưu thông tin mô tả phim, server/tập và URL cấu hình; không đóng gói hay lưu trữ sẵn thư viện phim. Chất lượng phát phụ thuộc URL nguồn, CORS, mạng, thiết bị và quyền sử dụng nội dung. Người mua tự chịu trách nhiệm kiểm tra quyền đối với dữ liệu, hình ảnh và nguồn phát trước khi đưa website lên Internet.
PHẠM VI BÀN GIAO
Mô tả này áp dụng cho mã nguồn và tài liệu được liệt kê trong gói tải. Dữ liệu production, tài khoản quản trị đang hoạt động, chi phí dịch vụ, cài đặt lên máy chủ, tùy biến giao diện/chức năng và bảo trì không được xem là bao gồm trừ khi được ghi rõ trong thỏa thuận bán hàng.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
YÊU CẦU
PHP 8.3 trở lên với các extension Laravel cần thiết; Composer; Node.js 20 trở lên và npm; MySQL 8 trở lên. Hoặc sử dụng Docker Engine và Docker Compose.
CÀI ĐẶT THỦ CÔNG
1. Giải nén mã nguồn và mở terminal tại thư mục dự án.
2. Cài dependency PHP:
composer install
3. Tạo cấu hình môi trường:
cp .env.example .env
4. Cập nhật APP_URL và DB_* trong .env để trỏ tới domain/database của bạn. Không sử dụng thông tin production của bên bán.
5. Tạo application key:
php artisan key:generate
6. Cài dependency frontend và build tài nguyên:
npm install
npm run build
7. Tạo schema cơ sở dữ liệu:
php artisan migrate --force
8. Khai báo ADMIN_NAME, ADMIN_EMAIL và ADMIN_PASSWORD trong môi trường triển khai. Mật khẩu quản trị phải có ít nhất 12 ký tự. Sau đó tạo tài khoản:
php artisan admin:create
9. Chạy web server theo môi trường của bạn. Mở /admin/login và đăng nhập bằng tài khoản vừa tạo.
10. Chạy queue worker và scheduler để xử lý đồng bộ/tác vụ nền:
php artisan queue:work --tries=11 --timeout=180
php artisan schedule:work
CÀI ĐẶT BẰNG DOCKER COMPOSE
1. Tạo .env từ .env.example và đặt các biến Docker DB_* / DOCKER_* với mật khẩu riêng.
2. Đặt APP_URL/DOCKER_APP_URL phù hợp với URL truy cập và cấu hình HTTPS/reverse proxy nếu triển khai production.
3. Khởi động các container:
docker compose up -d --build
4. Kiểm tra tình trạng dịch vụ:
docker compose ps
5. Tạo tài khoản quản trị nếu chưa có:
docker compose exec app php artisan admin:create
6. Xem log worker khi cần:
docker compose logs -f worker
7. Mở cổng đã cấu hình (mặc định 8080) hoặc cấu hình reverse proxy đến web container.
CẤU HÌNH SAU CÀI ĐẶT
• Thiết lập mail để gửi thư xác minh tài khoản.
• Cấu hình API/nguồn metadata và chạy worker trước khi xếp tác vụ đồng bộ catalog.
• Thêm URL video/server mà bạn có quyền sử dụng; kiểm tra CORS và khả năng phát trên thiết bị mục tiêu.
• Chỉ bật Google, PayOS, Slack, AI, Analytics, CDN/Gateway hoặc tích hợp truyền hình sau khi nhập thông tin xác thực hợp lệ trong CMS.
• Bật HTTPS, sao lưu định kỳ, giới hạn quyền truy cập admin và không chia sẻ file .env.
Lưu ý: quy trình cài đặt có thể cần điều chỉnh theo phiên bản hệ điều hành, PHP extension, database và dịch vụ hosting. Xem README.md trong gói để biết cấu hình hiện hành.
Nguồn: Topcode.vn
