Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sethsandaru/laravel-caro
Chơi cờ Caro Online Realtime được viết bằng PHP, Laravel 11 & Reverb
https://github.com/sethsandaru/laravel-caro
caro laravel laravel-learning php real-time reverb websocket
Last synced: 7 days ago
JSON representation
Chơi cờ Caro Online Realtime được viết bằng PHP, Laravel 11 & Reverb
- Host: GitHub
- URL: https://github.com/sethsandaru/laravel-caro
- Owner: sethsandaru
- Created: 2024-03-17T15:11:18.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-03-30T06:46:01.000Z (7 months ago)
- Last Synced: 2024-03-30T08:26:23.407Z (7 months ago)
- Topics: caro, laravel, laravel-learning, php, real-time, reverb, websocket
- Language: PHP
- Homepage:
- Size: 500 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Laravel Caro x Seth Phat
[](https://github.com/sethsandaru/laravel-caro/actions/workflows/build.yml)
[](https://codecov.io/gh/sethsandaru/laravel-caro)
Laravel Caro là một ứng dụng game Caro Online realtime đơn giản. Viết bởi [@sethsandaru](https://github.com/sethsandaru)
Đây là một trong những dự án mà mình mong muốn implement từ lâu 🥰, dự định từ thời sinh viên nhưng đến nay mới
rảnh rỗi để viết.
Với việc ra mắt Laravel Reverb khi Laravel 11 ra mắt, việc implement realtime nay lại dễ dàng hơn 🔥
## Tech Stuff
- PHP 8.2+
- Laravel 11
- Laravel Reverb (WebSocket)
- MySQL
- Node 18+
- Vue 3 x TypeScript
- TailwindCSS FTW
## Cài đặt và chạy thử
Làm theo các bước sau đây: [Setup](./SETUP.md)
## Để chơi được
- Tạo tài khoản (thông qua đăng nhập Google)
- Tạo phòng
- Đợi người chơi thứ 2 vào phòng (thông qua URL hoặc rooms list)
- Đợi người chơi thứ 2 chuyển sang trạng thái "Sẵn Sàng"
- Chơi
- Kết quả sẽ được tính trên Backend
## Features có thể làm
- Chatbox giữa 2 người chơi
- Chặn 2 đầu thì ko dc thắng
- Kick người chơi
- Bảng xếp hạng (ngày, tuần, tháng, năm)
- Lịch sử thi đấu
- Lịch sử từng nước đi
- Time limit (nếu sau **x** seconds mà ko đi thì mặc định thua)
## Improvement có thể thêm
- Tạo ra các reusable components (button, avatar,...)
## Learning notes
Dành cho các bạn quan tâm học hỏi để tiếp thu thêm kiến thức + kinh nghiệm thực chiến với Laravel.
### Tests
Tests là phần không thể thiếu trong các backend apps hiện nay. Project này cũng vậy.
Để học cách viết tests, hãy tham khảo thư mục `tests`
Project này bao gồm: Unit Tests và Feature Tests.
**Note**: cái quan trọng nhất là Logic Caro, dc test covered 100% 😎
### Continuous Integration / CI
Project này sử dụng GitHub Actions để chạy Continuous Integration (CI) process. Tham khảo thư mục `.github/workflows` để tìm hiểu thêm.
Workflow cơ bản:
- Pull project
- Setup dependencies
- Setup ENV
- Chạy tests
- Hoàn tất
### Login with Google
Thay vì sử dụng Socialite của Laravel, mình viết 1 cái service đơn giản để login với Google.
Về cơ bản thì nó đơn giản, 2 external APIs call và hết. Không cần phải cài thêm package cho mệt.
### Auth Token stored in HTTPOnly Cookie
Đúng vậy, khi ta stores Auth Token ở HTTPOnly Cookie, có thể ensure 100% là client không lấy + chỉnh sửa được.
Điều này khiến app của bạn dc secured hơn, mấy cái browser's extensions cũng ko thể lấy dc token
- Nếu bạn lưu trong localStorage/sessionStorage thì có thể.
Tất nhiên là cái gì cũng có trade-offs nhưng mình cảm thấy approach này phù hợp cho Laravel Caro app.
## Lưu ý
Đây là một sản phẩn Open Source để chia sẻ kiến thức theo MIT License.
## Powered by
Seth Phat 2024