feat: debut d'un front vue.js + ajout de cursorrules
This commit is contained in:
parent
ca9a74fe69
commit
bee8572dc5
147
.cursor/rules/commands.mdc
Normal file
147
.cursor/rules/commands.mdc
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
description:
|
||||
globs:
|
||||
alwaysApply: true
|
||||
---
|
||||
# Commandes Makefile de Mangarr
|
||||
|
||||
Toujours chercher si une commande est disponible dans [Makefile](mdc:Makefile).
|
||||
|
||||
## Structure Générale
|
||||
Le Makefile est organisé en plusieurs sections distinctes :
|
||||
- Docker 🐳
|
||||
- Composer 🧙
|
||||
- Symfony 🎵
|
||||
- Webpack Encore 📦
|
||||
|
||||
## Variables Principales
|
||||
```makefile
|
||||
# Exécutables Docker
|
||||
DOCKER_COMP = docker compose
|
||||
DOCKER_COMP_EXEC = $(DOCKER_COMP) exec
|
||||
|
||||
# Conteneurs
|
||||
PHP_CONT = $(DOCKER_COMP_EXEC) php
|
||||
NODE_CONT = $(DOCKER_COMP_EXEC) node
|
||||
|
||||
# Exécutables dans les conteneurs
|
||||
PHP = $(PHP_CONT) php
|
||||
COMPOSER = $(PHP_CONT) composer
|
||||
SYMFONY = $(PHP) bin/console
|
||||
SF_MEMORY = $(PHP) -d memory_limit=256M bin/console
|
||||
```
|
||||
|
||||
## Bonnes Pratiques
|
||||
|
||||
### 1. Organisation des Commandes
|
||||
- Regrouper les commandes par catégorie avec des commentaires clairs
|
||||
- Utiliser des variables pour les commandes répétitives
|
||||
- Documenter chaque commande avec `##` pour l'aide automatique
|
||||
- Préfixer les commandes internes avec `_` (exemple: `_check-deps`)
|
||||
|
||||
### 2. Paramètres et Options
|
||||
- Utiliser la syntaxe `make command p=value` pour les paramètres
|
||||
- Documenter les paramètres possibles dans les commentaires
|
||||
- Utiliser `?=` pour les valeurs par défaut modifiables
|
||||
|
||||
### 3. Dépendances
|
||||
- Définir clairement les dépendances entre les commandes
|
||||
- Utiliser des commandes composées pour les tâches complexes
|
||||
- Éviter les dépendances circulaires
|
||||
|
||||
### 4. Documentation
|
||||
- Chaque commande doit avoir une description avec `##`
|
||||
- Inclure des exemples d'utilisation pour les commandes complexes
|
||||
- Utiliser la commande `help` pour afficher la documentation
|
||||
|
||||
## Commandes Disponibles
|
||||
|
||||
### Docker 🐳
|
||||
```makefile
|
||||
build: ## Construit les images Docker
|
||||
up: ## Démarre les conteneurs
|
||||
start: ## Démarre les conteneurs en mode détaché
|
||||
down: ## Arrête et supprime les conteneurs
|
||||
logs: ## Affiche les logs en temps réel
|
||||
sh: ## Se connecte au conteneur PHP
|
||||
```
|
||||
|
||||
### Composer 🧙
|
||||
```makefile
|
||||
composer: ## Exécute une commande composer (c=command)
|
||||
vendor: ## Installe les dépendances
|
||||
```
|
||||
|
||||
### Symfony 🎵
|
||||
```makefile
|
||||
sf: ## Liste/exécute les commandes Symfony (c=command)
|
||||
cc: ## Vide le cache
|
||||
migration: ## Crée une nouvelle migration
|
||||
fixtures: ## Charge les fixtures
|
||||
consume: ## Consomme les messages de la queue
|
||||
```
|
||||
|
||||
### Webpack Encore 📦
|
||||
```makefile
|
||||
npm-install: ## Installe les dépendances npm
|
||||
npm-run: ## Lance le serveur de développement
|
||||
npm-watch: ## Surveille les changements
|
||||
```
|
||||
|
||||
## Exemples d'Utilisation
|
||||
|
||||
### 1. Installation du Projet
|
||||
```bash
|
||||
make install # Construit et démarre les conteneurs, installe les dépendances
|
||||
```
|
||||
|
||||
### 2. Développement Quotidien
|
||||
```bash
|
||||
make start # Démarre les conteneurs
|
||||
make npm-watch # Lance la compilation des assets
|
||||
make consume # Démarre les workers
|
||||
```
|
||||
|
||||
### 3. Commandes avec Paramètres
|
||||
```bash
|
||||
make composer c="require symfony/orm-pack" # Ajoute une dépendance
|
||||
make sf c="make:entity" # Crée une entité
|
||||
make test f="ScrapeChapterHandlerTest" # Lance un test spécifique
|
||||
```
|
||||
|
||||
## Ajout de Nouvelles Commandes
|
||||
|
||||
### 1. Structure de Base
|
||||
```makefile
|
||||
command-name: ## Description de la commande
|
||||
@$(DOCKER_COMP) ... # Commande à exécuter
|
||||
```
|
||||
|
||||
### 2. Avec Paramètres
|
||||
```makefile
|
||||
command-with-param: ## Description (p=value)
|
||||
@$(eval p ?=)
|
||||
@$(DOCKER_COMP) ... $(p)
|
||||
```
|
||||
|
||||
### 3. Commande Composée
|
||||
```makefile
|
||||
full-install: build start vendor npm-install ## Description complète
|
||||
```
|
||||
|
||||
## Maintenance
|
||||
|
||||
### 1. Nettoyage
|
||||
- Supprimer les commandes obsolètes
|
||||
- Mettre à jour les descriptions
|
||||
- Vérifier les dépendances
|
||||
|
||||
### 2. Documentation
|
||||
- Maintenir la section d'aide à jour
|
||||
- Ajouter des exemples pour les nouvelles commandes
|
||||
- Documenter les changements importants
|
||||
|
||||
### 3. Tests
|
||||
- Tester les nouvelles commandes
|
||||
- Vérifier les dépendances
|
||||
- Valider les paramètres
|
||||
Reference in New Issue
Block a user