# 🚀 Quick Start Guide

A condensed guide to get started with the School Management System quickly.

---

## ⚡ Get Started in 5 Minutes

### Prerequisites
- ✅ PHP 8.2+
- ✅ Composer
- ✅ Node.js & NPM
- ✅ MySQL

### Installation Steps

```bash
# 1. Clone the project
git clone <repository-url>
cd school_system

# 2. Install dependencies
composer install
npm install

# 3. Setup environment
cp .env.example .env
php artisan key:generate

# 4. Create database
mysql -u root -p -e "CREATE DATABASE school_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 5. Update .env
# Edit DB_DATABASE, DB_USERNAME, DB_PASSWORD

# 6. Run migrations
php artisan migrate

# 7. (Optional) Seed database
php artisan db:seed

# 8. Run the project
php artisan serve

# 9. Start the queue worker (for background jobs)
php artisan queue:work
```

In another terminal window:
```bash
npm run dev
```

Open browser: **http://localhost:8000**

---

## 📚 Full Documentation

| File | Description |
|------|-------------|
| [README.md](README.md) | Complete project information |
| [DATABASE_SETUP.md](DATABASE_SETUP.md) | Database setup guide |
| [CONTRIBUTING.md](CONTRIBUTING.md) | Contribution guidelines |
| [ARCHITECTURE.md](ARCHITECTURE.md) | Project architecture |
| [FAQ.md](FAQ.md) | Frequently asked questions |
| [CHANGELOG.md](CHANGELOG.md) | Version history |

---

## 🎯 Key Features

- ✅ Student and teacher management
- ✅ Attendance tracking
- ✅ Grade and exam management
- ✅ Fee and payment system
- ✅ School library
- ✅ Permission system (Admin, Teacher, Student, Parent)

---

## 🔑 Default Admin Account

After running `php artisan db:seed`:

```
Email: admin@school.com
Password: password123
```

⚠️ **Important**: Change the password in production!

---

## 🆘 Common Issues

### Database connection error
```bash
# Ensure MySQL is running
# Then check .env file
```

### "Class not found" error
```bash
composer dump-autoload
php artisan optimize:clear
```

### Styles don't appear
```bash
npm run build
```

---

## 📞 Support

- 📖 [Full Documentation](README.md)
- ❓ [FAQ](FAQ.md)
- 🐛 [Report an Issue](../../issues)

---

<p align="center">
  <strong>🎉 Congratulations! You're ready to start</strong>
</p>