# Telecom & Mobile Store Management System

Production Laravel 10 application for managing telecom companies, mobile lines (physical SIM and eSIM), plans, billing, invoices, payments, cash drawer operations, and system updates.

- PHP 8.2
- Laravel 10.x
- MySQL 8.x
- Blade + Bootstrap 5
- Arabic (default) and English
- Installer at `/install`
- Safe updates with migrations (never `migrate:fresh`)

Current version: **1.0.0** (see `VERSION` and `release/version.json`).

## Documentation

- [INSTALL.md](INSTALL.md)
- [UPDATE.md](UPDATE.md)
- [DEPLOYMENT.md](DEPLOYMENT.md)
- [CHANGELOG.md](CHANGELOG.md)
- [docs/ADMIN.md](docs/ADMIN.md)
- [دليل التشغيل الكامل بالعربية](docs/دليل-التشغيل-الكامل.md)

## Quick start (development)

1. Use PHP 8.2.
2. Copy `.env.example` to `.env` or run the web installer.
3. Create a MySQL database.
4. Open `/install` and complete the wizard.
5. Sign in with the administrator account.

```bash
php artisan test
```
