<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>

<p align="center">
<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
</p>


# naneasy

Socle Laravel SSR pour une application SaaS, conçu pour rester déployable sur un hébergement PHP/MySQL classique.

## Stack

PHP 8.3+, Laravel 13, Blade, Livewire 4, Alpine.js, Tailwind CSS 4, Vite, PHPUnit 12, MySQL 8.4, Laravel Pint et Larastan/PHPStan.

## Installation Docker

Prérequis: Docker Desktop avec Compose.

```bash
cp .env.example .env
make up
make migrate
```

L'application est disponible sur [http://localhost](http://localhost) et phpMyAdmin sur [http://localhost:8080](http://localhost:8080). Les identifiants de développement sont `naneasy` / `naneasy`; ils sont réservés au local.

Le service `node` lance Vite sur le port `5173`. Pour compiler les assets: `make build`.

## Commandes usuelles

```bash
make up
make down
make bash
make migrate
make test
make lint
make fix
make analyse
make fresh
```

Les scripts Composer équivalents sont `composer test`, `composer lint`, `composer fix` et `composer analyse`.

## Authentification

Laravel Breeze fournit l'authentification sessionnelle Blade: connexion, inscription, reset du mot de passe et vérification d'email. Aucun JWT, OAuth ou service externe n'est requis.

## Hébergement mutualisé

La production ne dépend pas de Docker, Redis ou d'un service système complexe. Configurer PHP 8.3+, MySQL 8+, le document root sur `public/`, puis exécuter `composer install --no-dev --optimize-autoloader` et `php artisan migrate --force`.

Voir [ARCHITECTURE.md](ARCHITECTURE.md) et [TESTING.md](TESTING.md) pour les conventions.

## Learning Laravel

Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.

In addition, [Laracasts](https://laracasts.com) contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.

You can also watch bite-sized lessons with real-world projects on [Laravel Learn](https://laravel.com/learn), where you will be guided through building a Laravel application from scratch while learning PHP fundamentals.

## Agentic Development

Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install [Laravel Boost](https://laravel.com/docs/ai) to supercharge your AI workflow:

```bash
composer require laravel/boost --dev

php artisan boost:install
```

Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.

## Contributing

Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).

## Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).

## Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.

## License

The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
