COSYONE - DANH SACH CHUC NANG
1) STORE FRONT (KHACH HANG)
- Trang chu: slider, san pham noi bat/giam gia, thuong hieu, danh gia, tin tuc moi.
- Cua hang: loc theo danh muc/thuong hieu/giam gia, sap xep, tim kiem, phan trang.
- Chi tiet san pham va san pham lien quan.
- Gio hang (session), wishlist (can dang nhap), ap ma giam gia khi checkout.
- Blog + binh luan, portfolio, gioi thieu, lien he, newsletter.
2) TAI KHOAN VA DON HANG
- Dang ky, dang nhap, thong tin ca nhan.
- Theo doi don hang cua tai khoan.
3) THANH TOAN
- COD (thanh toan khi nhan hang).
- PayOS: tao link thanh toan + webhook xac nhan.
- VNPay: URL thanh toan + return/IPN.
- Cho phep bat/tat tinh nang thanh toan qua bien moi truong.
4) CHAT AI
- Widget chat tren cac trang.
- Tra loi dua tren du lieu san pham trong he thong.
- Ho tro da nha cung cap AI:
+ Anthropic (Claude)
+ OpenAI (ChatGPT)
+ Google (Gemini)
- Cau hinh provider/model/prompt/max tokens trong trang Admin.
5) MARKETING / CRM
- Coupon nham muc tieu: tat ca / theo khach / nhom / san pham / danh muc / mua.
- Chien dich email den tat ca / nhom / khach cu the.
- Nhac don chua thanh toan theo moc 1h/24h/48h, tu huy sau 72h.
- Gui email qua SMTP/MailHog va luu email log.
6) TRANG QUAN TRI (ADMIN)
- Dashboard KPI + bieu do thong ke (doanh thu, don hang, thanh toan, top ban chay, chat).
- Quan ly san pham, danh muc, don hang, khach hang, coupon, chien dich, bai viet.
- Quan ly cau hinh AI, hoi thoai, lien he, newsletter, email log, audit log.
7) HE THONG VA KI THUAT
- Flyway migration va du lieu mau.
- Ho tro profile local (H2) va moi truong MySQL.
- Co san Docker Compose cho app + mysql + adminer + mailhog.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
HUONG DAN CHAY DU AN COSYONE
A. CHAY BANG DOCKER (NHANH NHAT - CHI 1 LENH)
Yeu cau:
- Da cai Docker Desktop
Thuc hien:
1) Mo terminal tai thu muc du an (noi co file docker-compose.yml).
2) Chay 1 lenh:
docker compose up -d --build
Truy cap:
- Ung dung: http://localhost:8080
- Adminer (quan tri DB): http://localhost:8081
- MailHog (xem email test): http://localhost:8025
Tai khoan demo:
- Admin: admin@cosyone.vn / admin123
- Khach: khach@cosyone.vn / khach123
Dung he thong:
- docker compose down
B. CHAY KHONG DUNG DOCKER (LOCAL PROFILE - H2)
Yeu cau:
- JDK 21
Thuc hien:
1) Mo terminal tai thu muc du an.
2) Chay:
mvnw.cmd spring-boot:run
(Neu dung PowerShell/CMD tren Windows, lenh tren la du)
Truy cap:
- Ung dung: http://localhost:8080
- H2 Console: http://localhost:8080/h2-console
+ JDBC URL: jdbc:h2:mem:cosyone
+ User: sa
+ Password: de trong
Ghi chu:
- Profile mac dinh la local, du lieu mau duoc nap qua Flyway.
- Neu da co app dang chay cong 8080, can tat truoc khi chay lai.
C. CHAY KHONG DOCKER VOI MYSQL (TU CHUAN BI DB)
Yeu cau:
- JDK 21
- MySQL 8 dang chay
Can dat cac bien moi truong toi thieu:
- SPRING_PROFILES_ACTIVE=default
- SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/cosyone?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Ho_Chi_Minh
- SPRING_DATASOURCE_USERNAME=<user_mysql>
- SPRING_DATASOURCE_PASSWORD=<password_mysql>
Sau do chay:
- mvnw.cmd spring-boot:run
D. BUILD JAR VA CHAY
1) Build:
mvnw.cmd clean package
2) Chay:
java -jar target/cosyone-0.0.1-SNAPSHOT.jar
E. CAC BIEN MOI TRUONG THUONG DUNG
- AI:
+ ANTHROPIC_API_KEY
+ OPENAI_API_KEY
+ GOOGLE_API_KEY
- Thanh toan:
+ PAYOS_ENABLED, PAYOS_CLIENT_ID, PAYOS_API_KEY, PAYOS_CHECKSUM_KEY
+ VNPAY_ENABLED, VNP_TMN_CODE, VNP_HASH_SECRET, VNP_RETURN_URL
- Email:
+ MAIL_HOST, MAIL_PORT
Nguồn: Topcode.vn
