💣 Minesweeper Pro

Modern Minesweeper game dengan fitur admin management dan profile system

Demo • Features • Installation • Screenshots

---

📋 Deskripsi

Minesweeper Pro adalah implementasi modern dari game klasik Minesweeper dengan tambahan fitur-fitur canggih seperti user authentication, profile management, admin dashboard, dan leaderboard system. Dibangun menggunakan Laravel 11 dengan UI yang stunning menggunakan Tailwind CSS dan glassmorphism effects.

✨ Features

🎮 Game Features

• 3 Tingkat Kesulitan: Easy (8x8), Medium (16x16), Hard (16x30)
• Real-time Timer: Track waktu bermain Anda
• Flag System: Tandai cell yang dicurigai sebagai mine
• Auto-reveal: Otomatis membuka cell kosong di sekitarnya
• Win/Lose Detection: Deteksi kemenangan dan kekalahan otomatis
• Score Recording: Semua game disimpan ke database

👤 User Features

• Authentication System: Register, Login, Forgot Password
• Email Verification: Verifikasi email untuk keamanan
• Profile Management: Update nama, email, password
• Profile Photo Upload: Upload foto profil (max 2MB, JPG/PNG)
• Personal Dashboard: Lihat statistik game Anda
• Game History: Riwayat semua game yang dimainkan
• Personal Records: Best time untuk setiap tingkat kesulitan

🏆 Leaderboard & Stats

• Global Leaderboard: Top 30 pemain terbaik
• Win Rate Tracking: Persentase kemenangan
• Best Time Records: Waktu tercepat per difficulty
• Total Games Played: Total game yang dimainkan
• Achievement System: Badge untuk pencapaian tertentu

👨‍💼 Admin Features

• User Management Dashboard: Kelola semua user
• Search & Filter: Cari user by nama/email, filter by role
• Edit User Info: Update nama, email, role user
• Toggle User Role: Ubah role user ↔ admin
• Reset Password: Reset password user lain
• Delete User: Hapus user (dengan proteksi admin)
• Security Controls: Admin tidak bisa delete admin lain

🎨 UI/UX Features

• Modern Design: Purple-pink gradient theme
• Glassmorphism Effects: Transparent glass-like components
• Smooth Animations: Micro-interactions dan transitions
• Responsive Design: Mobile-friendly layout
• Dark Theme: Eye-friendly dark mode
• Loading States: Skeleton screens dan spinners
• Toast Notifications: Success/error messages

🛠️ Tech Stack

• Backend: Laravel 11.x
• Frontend: Blade Templates, Alpine.js
• Styling: Tailwind CSS
• Database: MySQL
• Authentication: Laravel Breeze
• File Storage: Laravel Storage (Public Disk)
• Build Tool: Vite

📦 Installation

Prerequisites

• PHP >= 8.2
• Composer
• Node.js & NPM
• MySQL

Setup Steps

1. Clone Repository

git clone https://github.com/AndikaFitra/Minesweeper.git
cd Minesweeper

2. Install Dependencies

composer install
npm install

3. Environment Setup

cp .env.example .env
php artisan key:generate

4. Database Configuration

Edit .env file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=minesweeper
DB_USERNAME=root
DB_PASSWORD=

5. Run Migrations & Seeders

php artisan migrate --seed

6. Create Storage Link

php artisan storage:link

7. Build Assets

npm run build

8. Run Development Server

php artisan serve

Visit: http://localhost:8000

🔐 Default Credentials

Admin Account

Email: admin@minesweeper.com
Password: admin123

Test User Accounts

Email: user@minesweeper.com
Password: user123

Email: john@example.com
Password: password

Email: jane@example.com
Password: password

🎯 How to Play

1. Pilih Tingkat Kesulitan: Easy, Medium, atau Hard
2. Klik Cell: Klik kiri untuk membuka cell
3. Flag Mine: Klik kanan untuk menandai mine
4. Angka: Menunjukkan jumlah mine di sekitar cell
5. Menang: Buka semua cell yang bukan mine
6. Kalah: Klik cell yang berisi mine

📁 Project Structure

minesweeper/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── AdminController.php
│   │   │   ├── GameController.php
│   │   │   └── ProfileController.php
│   │   └── Middleware/
│   │       └── IsAdmin.php
│   └── Models/
│       ├── User.php
│       ├── GameSession.php
│       └── ScoreRecord.php
├── database/
│   ├── migrations/
│   └── seeders/
│       └── AdminUserSeeder.php
├── resources/
│   ├── views/
│   │   ├── admin/
│   │   ├── auth/
│   │   ├── minesweeper/
│   │   └── profile/
│   └── css/
│       └── app.css
└── routes/
    └── web.php

🔒 Security Features

• ✅ CSRF Protection
• ✅ SQL Injection Prevention
• ✅ XSS Protection
• ✅ Password Hashing (bcrypt)
• ✅ Email Verification
• ✅ Role-Based Access Control
• ✅ File Upload Validation
• ✅ Admin Action Protections

🚀 Deployment

Production Setup

1. Set Environment to Production

APP_ENV=production
APP_DEBUG=false

2. Optimize Application

php artisan config:cache
php artisan route:cache
php artisan view:cache

3. Build Production Assets

npm run build

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Andika Fitra

• GitHub: @AndikaFitra
• Email: andika.namikaze02@gmail.com

🙏 Acknowledgments

• Laravel Framework
• Tailwind CSS
• Alpine.js
• Heroicons

📞 Support

Jika ada pertanyaan atau issue, silakan buka GitHub Issues.

---

Made with ❤️ by Andika Fitra

⭐ Star this repo if you like it!