Personal Database

Application personnelle pour archiver mes lectures et visionnages, construite avec Laravel, Livewire et Flux UI.

Prérequis

• Docker Desktop ou Docker Engine

Installation (premier lancement)

1. Cloner le dépôt

git clone <url>
cd personal-database

2. Installer les dépendances PHP via Docker

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php84-composer:latest \
    composer install --ignore-platform-reqs

3. Configurer l'environnement

cp .env.example .env

4. Construire et démarrer les conteneurs

./vendor/bin/sail up -d

La première exécution peut prendre quelques minutes (construction de l'image Docker).

5. Initialiser l'application

./vendor/bin/sail composer run setup

L'application est disponible sur http://localhost.

---

Utilisation quotidienne

Démarrer les conteneurs :

./vendor/bin/sail up -d

Lancer le serveur de développement (Vite + queue worker + logs) :

./vendor/bin/sail composer run dev

Arrêter les conteneurs :

./vendor/bin/sail down

Commandes Artisan :

./vendor/bin/sail artisan <commande>

Peupler la base avec des données de test :

./vendor/bin/sail artisan db:seed

Vider la base et recommencer le seed :

./vendor/bin/sail artisan migrate:fresh --seed

Tests :

./vendor/bin/sail artisan test --compact

Alias pratique (à ajouter dans ~/.zshrc ou ~/.bashrc) :

alias sail='./vendor/bin/sail'

Ensuite toutes les commandes peuvent s'écrire sail up -d, sail artisan migrate, etc.