ComicVerse – Hệ thống đọc truyện tranh & truyện chữ hoàn chỉnh: App Android + Backend + Web Admin
Một lệnh cài đặt là có ngay nền tảng đọc truyện chạy thật: app Android cho độc giả, REST API Spring Boot, trang quản trị React, thanh toán gói VIP qua PayOS. Toàn bộ chạy bằng Docker trên Windows và Linux, từ máy cá nhân đến VPS có tên miền và HTTPS tự động.
Code viết sạch theo kiến trúc chuẩn (MVVM + Clean Architecture trên Android, phân tầng rõ ràng trên backend), có tài liệu tiếng Việt đầy đủ, phù hợp để kinh doanh thật, làm đồ án tốt nghiệp hoặc học kiến trúc dự án lớn.
🔥 Điểm nổi bật
-
Cài đặt 1 lệnh:
./install.sh (Linux) hoặc install.ps1 (Windows) tự sinh mật khẩu, khóa bảo mật, tài khoản admin, build và chạy toàn bộ hệ thống.
-
Hỗ trợ cả truyện tranh và truyện chữ trong cùng một hệ thống.
-
Kiếm tiền ngay: gói VIP mở chương VIP, thanh toán QR ngân hàng qua PayOS, thống kê doanh thu.
-
Công cụ nạp truyện hàng loạt: nạp cả kho truyện bằng một lệnh Python, tự tạo tác giả, thể loại, chương và tự duyệt; bị ngắt giữa chừng chạy lại sẽ tiếp tục đúng chỗ.
-
HTTPS tự động khi gắn tên miền (Caddy + Let's Encrypt); chạy được cả qua Cloudflare Tunnel khi không có IP tĩnh.
-
Lưu ảnh linh hoạt: lưu trên máy chủ hoặc chuyển sang Cloudflare R2 / AWS S3 chỉ bằng sửa file cấu hình.
-
App tự cập nhật khi phát hành APK ngoài Google Play (kiểm tra SHA-256 trước khi cài).
📱 Ứng dụng Android (Java)
-
Trang chủ, truyện đề xuất, truyện cùng thể loại, từ khóa hot.
-
Tìm kiếm theo tên, lọc theo quốc gia / thể loại / trạng thái.
-
Đọc truyện tranh cuộn dọc, phóng to, tự cuộn.
-
Đọc truyện chữ: chỉnh cỡ chữ, nền Sáng / Vàng / Tối.
-
Đọc không cần tài khoản (lưu lịch sử, yêu thích trên máy); đăng nhập thì tự đồng bộ lên server.
-
Đăng nhập email hoặc Google; quên mật khẩu bằng mã OTP qua email; hồ sơ cá nhân.
-
Bình luận, đánh giá truyện 1–5 sao, báo lỗi chương, thông báo.
-
Mua gói VIP ngay trong app.
-
Đổi tên app, màu thương hiệu, icon, mã ứng dụng dễ dàng để đưa lên Google Play.
🖥️ Trang quản trị Web (React)
-
Admin: dashboard thống kê, quản lý truyện (xóa mềm / khôi phục), duyệt chương, người dùng, thể loại, tác giả, gói VIP, gửi thông báo, doanh thu, giao dịch, xử lý báo lỗi.
-
Uploader: tạo truyện, upload chương ảnh hàng loạt bằng kéo thả thư mục (mỗi thư mục = 1 chương, tự sắp xếp trang), nhập truyện chữ từ file EPUB.
-
Quy trình kiểm duyệt: chương mới chờ Admin duyệt mới hiện với độc giả.
⚙️ Backend (Spring Boot)
-
REST API bảo mật JWT (access + refresh token), phân quyền User / Uploader / Admin.
-
Chương VIP chỉ trả nội dung cho tài khoản còn hạn VIP.
-
Đếm lượt xem qua Redis, ghi xuống MySQL định kỳ, chịu tải tốt.
-
Database tự nâng cấp khi cập nhật phiên bản (Flyway migration).
-
Tài liệu API tự sinh (Swagger UI).
🧰 Công nghệ sử dụng
-
Android: Java, MVVM + Clean Architecture, Hilt, Retrofit + RxJava 3, Room, Paging 3, Glide, Navigation Component. minSdk 24 (Android 7.0), targetSdk 35.
-
Backend: Java 17, Spring Boot 3, Spring Security + JWT, MySQL 8.4, Redis 7, Flyway.
-
Web Admin: React 19, Vite, Tailwind CSS.
-
Triển khai: Docker Compose, Caddy (HTTPS tự động), GitHub Actions build APK tự động.
📦 Bạn nhận được
-
Toàn bộ mã nguồn 3 phần: Android, Backend, Web Admin.
-
Script cài đặt cho Windows và Linux.
-
Công cụ nạp / chuyển dữ liệu truyện giữa các server, kèm gói dữ liệu mẫu để chạy thử.
-
Tài liệu tiếng Việt: cài đặt, cấu hình, triển khai VPS + tên miền, sao lưu / khôi phục, build app, xử lý sự cố.
💻 Yêu cầu
-
Máy chủ: Windows 10/11 64-bit hoặc Ubuntu 22.04/24.04, Debian 12; RAM trống từ 2 GB (khuyến nghị 4 GB).
-
Phần mềm: Docker (Windows dùng Docker Desktop). Không cần cài Java hay Node để chạy.
-
Build app: Android Studio.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
Code kèm tài liệu tiếng Việt chi tiết. Dưới đây là các bước tóm tắt, mất khoảng 15–30 phút.
Bước 1. Cài Docker
Bước 2. Giải nén code
Giải nén vào thư mục không dấu, không dấu cách, ví dụ D:\comicverse (Windows) hoặc ~/comicverse (Linux).
Bước 3. Chạy cài đặt
Script tự tạo cấu hình, sinh mật khẩu, build và khởi động. Khi xong sẽ in ra địa chỉ web admin, email và mật khẩu admin. Hãy ghi lại mật khẩu.
Bước 4. Đăng nhập trang quản trị
Mở địa chỉ được in ra (vd. http://192.168.1.5) và đăng nhập bằng tài khoản admin.
Bước 5. Nạp dữ liệu truyện mẫu
Cần Python 3.9+. Trong thư mục gói dữ liệu comicverse-data:
pip install requests
python import.py --api http://localhost/api --email <email admin> --password <mật khẩu admin>
Script tự tạo truyện, chương, tác giả, thể loại. Bị ngắt thì chạy lại đúng lệnh cũ để tiếp tục.
Bước 6. Build app Android
-
Mở thư mục
android-app bằng Android Studio.
-
Thêm vào
local.properties: api.baseUrl.debug=http://<IP máy chủ>/api/
-
Bấm Run để cài lên điện thoại, hoặc Build → Generate Signed APK để xuất file APK.
Chạy thật với tên miền
Sửa file .env: SITE_ADDRESS=tenmien.com, STORAGE_PUBLIC_URL=https://tenmien.com, rồi chạy lại script. HTTPS được cấp tự động.
Tài liệu kèm theo có hướng dẫn chi tiết: cấu hình PayOS, email OTP, đăng nhập Google, lưu ảnh lên Cloudflare R2/S3, sao lưu – khôi phục, cập nhật phiên bản, đổi thương hiệu app và bảng xử lý sự cố.
Nguồn: Topcode.vn
