Guide de Contribution Merci de votre intérêt pour contribuer à CSWeb Community Platform !

## Description
Description claire du problème
 
## Steps to Reproduce
1. Étape 1
2. Étape 2
3. Résultat observé
 
## Expected Behavior
Résultat attendu
 
## Environment
- OS: Ubuntu 20.04
- Docker: 20.10.21
- CSWeb Version: 2.0.0
 
## Logs

# Fork sur GitHub
# Puis clone
git clone https://github.com/VOTRE_USERNAME/csweb-community.git
cd csweb-community
 
# Ajouter upstream
git remote add upstream https://github.com/BOUNADRAME/csweb-community.git

# Sync avec upstream
git checkout master
git pull upstream master
 
# Créer branche
git checkout -b feature/ma-fonctionnalite
# ou
git checkout -b fix/mon-bug

# Format
<type>(<scope>): <description>
 
# Exemples
feat(breakout): Add parallel processing with threads
fix(oauth): Correct token refresh timing
docs(readme): Update installation instructions
refactor(api): Simplify error handling
test(cli): Add tests for process-cases command

# Tests unitaires (local)
composer test
# ou directement
vendor/bin/phpunit --testsuite unit
 
# Tests unitaires avec couverture
composer test:coverage
 
# Analyse statique (PHPStan niveau 1)
composer phpstan
# ou directement
vendor/bin/phpstan analyse --no-progress
 
# Vérifier le formatage (PHP-CS-Fixer, dry-run)
composer cs-check
# ou directement
vendor/bin/php-cs-fixer fix --dry-run --diff
 
# Corriger automatiquement le formatage
composer cs-fix
 
# Via Docker
docker compose exec csweb composer test
docker compose exec csweb composer phpstan
docker compose exec csweb composer cs-check

tests/
  bootstrap.php          # Bootstrap custom (stub PdoHelper pour PHP 8.4)
  Unit/                  # Tests unitaires (sans dépendance BDD)
    CSPro/
      VectorClockTest.php
      CSProResponseTest.php
      CSProMySQLFormatterTest.php
      FileManagerTest.php
      Data/
        BreakoutSchedulerTest.php
    Service/
      DatabaseDriverDetectorTest.php
      BreakoutDatabaseConfigTest.php
      HttpHelperErrorResponseTest.php
  Integration/           # Tests d'intégration (avec BDD)

# Commit changements
git add .
git commit -m "feat(breakout): Add parallel processing"
 
# Push vers votre fork
git push origin feature/ma-fonctionnalite

## Description
Description claire des changements
 
## Type de Changement
- [ ] Bug fix
- [ ] Nouvelle fonctionnalité
- [ ] Breaking change
- [ ] Documentation
 
## Tests
- [ ] Tests unitaires ajoutés
- [ ] Tests d'intégration ajoutés
- [ ] Tests manuels effectués
 
## Checklist
- [ ] Code suit les conventions
- [ ] Documentation mise à jour
- [ ] Aucun warning PHPStan
- [ ] Tests passent

<?php namespace App\Service;
 
use App\Entity\Dictionary;
 
class BreakoutService
{
 private DatabaseService $database;
 
 public function __construct(DatabaseService $database)
 {
 $this->database = $database;
 }
 
 /**
 * Process cases for specific dictionary
 */
 public function processCases(Dictionary $dictionary, int $threads = 1): void
 {
 // Implementation
 }
}

# Page Title 
 
Brief introduction.
 
## Section 1
 
Content...
 
## Section 2
 
Content...
 
---
 
**Footer**

<?php
 
namespace Tests\Unit\Service;
 
use AppBundle\Service\BreakoutDatabaseConfig;
use PHPUnit\Framework\TestCase;
use Psr\Log\LoggerInterface;
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface;
 
class BreakoutDatabaseConfigTest extends TestCase
{
    public function testDefaultDatabaseTypeIsPostgresql(): void
    {
        $params = $this->createMock(ParameterBagInterface::class);
        $logger = $this->createMock(LoggerInterface::class);
        $config = new BreakoutDatabaseConfig($params, $logger);
 
        $this->assertSame('postgresql', $config->getDefaultDatabaseType());
    }
}