@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/fr/Symfony/templates/value-object.md

@@ -0,0 +1,534 @@
+# Template: Value Object (DDD)
+
+> **Pattern DDD** - Objet immuable représentant une valeur métier
+> Référence: `.claude/rules/01-architecture-ddd.md`
+
+## Caractéristiques d'un Value Object
+
+- ✅ **Immuable** (readonly class, pas de setters)
+- ✅ **Validation dans le constructeur**
+- ✅ **Égalité par valeur** (méthode `equals()`)
+- ✅ **Pas d'identité propre** (pas d'ID)
+- ✅ **Auto-suffisant** (contient toute sa logique métier)
+
+---
+
+## Template PHP 8.2+
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\ValueObject;
+
+use InvalidArgumentException;
+
+/**
+ * Value Object: [NomValueObject]
+ *
+ * Représente: [Description métier]
+ *
+ * Exemples:
+ * - new [NomValueObject]([valeur_valide])
+ * - new [NomValueObject]([autre_valeur_valide])
+ *
+ * @see https://martinfowler.com/bliki/ValueObject.html
+ */
+final readonly class [NomValueObject]
+{
+    /**
+     * @throws InvalidArgumentException Si la valeur est invalide
+     */
+    private function __construct(
+        private [type] $value
+    ) {
+        $this->validate();
+    }
+
+    /**
+     * Factory method: création depuis [source]
+     */
+    public static function fromString(string $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Factory method: création depuis [autre source]
+     */
+    public static function from[Type]([type] $value): self
+    {
+        return new self($value);
+    }
+
+    /**
+     * Validation métier
+     *
+     * @throws InvalidArgumentException
+     */
+    private function validate(): void
+    {
+        if (/* condition invalide */) {
+            throw new InvalidArgumentException(
+                sprintf('[Message erreur]: %s', $this->value)
+            );
+        }
+    }
+
+    /**
+     * Égalité par valeur
+     */
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    /**
+     * Conversion en type primitif
+     */
+    public function toString(): string
+    {
+        return (string) $this->value;
+    }
+
+    public function toInt(): int
+    {
+        return (int) $this->value;
+    }
+
+    public function toFloat(): float
+    {
+        return (float) $this->value;
+    }
+
+    /**
+     * Représentation string (pour debug)
+     */
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+
+    /**
+     * Getter de la valeur brute
+     */
+    public function value(): [type]
+    {
+        return $this->value;
+    }
+}
+```
+
+---
+
+## Exemples concrets Atoll Tourisme
+
+### 1. Money - Montant en euros
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\ValueObject;
+
+use InvalidArgumentException;
+
+/**
+ * Value Object: Money (Montant monétaire en EUR)
+ *
+ * Représente un montant en euros avec validation métier.
+ * Évite les erreurs de manipulation d'argent (float precision).
+ *
+ * Exemples:
+ * - Money::fromEuros(1299.99) → Séjour Guadeloupe
+ * - Money::fromCents(129999) → Même montant en centimes
+ */
+final readonly class Money
+{
+    private const CURRENCY = 'EUR';
+    private const MIN_CENTS = 0;
+    private const MAX_CENTS = 99999999; // 999 999,99 EUR
+
+    /**
+     * @param int $cents Montant en centimes (pour éviter les erreurs de float)
+     */
+    private function __construct(
+        private int $cents
+    ) {
+        $this->validate();
+    }
+
+    public static function fromEuros(float $euros): self
+    {
+        $cents = (int) round($euros * 100);
+        return new self($cents);
+    }
+
+    public static function fromCents(int $cents): self
+    {
+        return new self($cents);
+    }
+
+    public static function zero(): self
+    {
+        return new self(0);
+    }
+
+    private function validate(): void
+    {
+        if ($this->cents < self::MIN_CENTS) {
+            throw new InvalidArgumentException(
+                sprintf('Le montant ne peut pas être négatif: %d centimes', $this->cents)
+            );
+        }
+
+        if ($this->cents > self::MAX_CENTS) {
+            throw new InvalidArgumentException(
+                sprintf('Le montant dépasse la limite: %d centimes', $this->cents)
+            );
+        }
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->cents === $other->cents;
+    }
+
+    public function add(self $other): self
+    {
+        return new self($this->cents + $other->cents);
+    }
+
+    public function subtract(self $other): self
+    {
+        return new self($this->cents - $other->cents);
+    }
+
+    public function multiply(float $factor): self
+    {
+        return new self((int) round($this->cents * $factor));
+    }
+
+    public function isGreaterThan(self $other): bool
+    {
+        return $this->cents > $other->cents;
+    }
+
+    public function isZero(): bool
+    {
+        return $this->cents === 0;
+    }
+
+    public function toEuros(): float
+    {
+        return $this->cents / 100;
+    }
+
+    public function toCents(): int
+    {
+        return $this->cents;
+    }
+
+    public function toString(): string
+    {
+        return number_format($this->toEuros(), 2, ',', ' ') . ' €';
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+```
+
+**Tests:**
+```php
+/** @test */
+public function it_creates_money_from_euros(): void
+{
+    $money = Money::fromEuros(1299.99);
+
+    $this->assertEquals(129999, $money->toCents());
+    $this->assertEquals(1299.99, $money->toEuros());
+    $this->assertEquals('1 299,99 €', $money->toString());
+}
+
+/** @test */
+public function it_adds_two_amounts(): void
+{
+    $sejour = Money::fromEuros(1299.99);
+    $assurance = Money::fromEuros(50.00);
+
+    $total = $sejour->add($assurance);
+
+    $this->assertEquals(1349.99, $total->toEuros());
+}
+
+/** @test */
+public function it_throws_exception_for_negative_amount(): void
+{
+    $this->expectException(InvalidArgumentException::class);
+
+    Money::fromCents(-100);
+}
+```
+
+---
+
+### 2. Email - Adresse email validée
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\ValueObject;
+
+use InvalidArgumentException;
+
+/**
+ * Value Object: Email
+ *
+ * Représente une adresse email validée.
+ * Garantit qu'un email est toujours valide dans le domaine.
+ */
+final readonly class Email
+{
+    private const PATTERN = '/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/';
+
+    private function __construct(
+        private string $value
+    ) {
+        $this->validate();
+    }
+
+    public static function fromString(string $email): self
+    {
+        return new self(trim(strtolower($email)));
+    }
+
+    private function validate(): void
+    {
+        if (!filter_var($this->value, FILTER_VALIDATE_EMAIL)) {
+            throw new InvalidArgumentException(
+                sprintf('Adresse email invalide: %s', $this->value)
+            );
+        }
+
+        if (!preg_match(self::PATTERN, $this->value)) {
+            throw new InvalidArgumentException(
+                sprintf('Format d\'email non conforme: %s', $this->value)
+            );
+        }
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->value === $other->value;
+    }
+
+    public function getDomain(): string
+    {
+        return substr($this->value, strpos($this->value, '@') + 1);
+    }
+
+    public function toString(): string
+    {
+        return $this->value;
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+```
+
+---
+
+### 3. DateRange - Période de dates
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\ValueObject;
+
+use DateTimeImmutable;
+use InvalidArgumentException;
+
+/**
+ * Value Object: DateRange (Période)
+ *
+ * Représente une période avec date début et fin.
+ * Utilisé pour les séjours, les réservations, etc.
+ *
+ * Exemple:
+ * - DateRange::fromDates($debut, $fin) → Séjour du 15/02 au 22/02
+ */
+final readonly class DateRange
+{
+    private function __construct(
+        private DateTimeImmutable $start,
+        private DateTimeImmutable $end
+    ) {
+        $this->validate();
+    }
+
+    public static function fromDates(DateTimeImmutable $start, DateTimeImmutable $end): self
+    {
+        return new self($start, $end);
+    }
+
+    public static function fromStrings(string $start, string $end): self
+    {
+        return new self(
+            new DateTimeImmutable($start),
+            new DateTimeImmutable($end)
+        );
+    }
+
+    private function validate(): void
+    {
+        if ($this->start >= $this->end) {
+            throw new InvalidArgumentException(
+                sprintf(
+                    'La date de début doit être avant la date de fin: %s >= %s',
+                    $this->start->format('Y-m-d'),
+                    $this->end->format('Y-m-d')
+                )
+            );
+        }
+    }
+
+    public function equals(self $other): bool
+    {
+        return $this->start == $other->start && $this->end == $other->end;
+    }
+
+    public function contains(DateTimeImmutable $date): bool
+    {
+        return $date >= $this->start && $date <= $this->end;
+    }
+
+    public function overlaps(self $other): bool
+    {
+        return $this->start < $other->end && $other->start < $this->end;
+    }
+
+    public function getDurationInDays(): int
+    {
+        return $this->start->diff($this->end)->days;
+    }
+
+    public function start(): DateTimeImmutable
+    {
+        return $this->start;
+    }
+
+    public function end(): DateTimeImmutable
+    {
+        return $this->end;
+    }
+
+    public function toString(): string
+    {
+        return sprintf(
+            'Du %s au %s',
+            $this->start->format('d/m/Y'),
+            $this->end->format('d/m/Y')
+        );
+    }
+
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+}
+```
+
+**Tests:**
+```php
+/** @test */
+public function it_calculates_duration_in_days(): void
+{
+    $range = DateRange::fromStrings('2025-02-15', '2025-02-22');
+
+    $this->assertEquals(7, $range->getDurationInDays());
+}
+
+/** @test */
+public function it_detects_overlapping_periods(): void
+{
+    $sejour1 = DateRange::fromStrings('2025-02-15', '2025-02-22');
+    $sejour2 = DateRange::fromStrings('2025-02-20', '2025-02-27');
+
+    $this->assertTrue($sejour1->overlaps($sejour2));
+}
+
+/** @test */
+public function it_throws_exception_when_start_after_end(): void
+{
+    $this->expectException(InvalidArgumentException::class);
+
+    DateRange::fromStrings('2025-02-22', '2025-02-15');
+}
+```
+
+---
+
+## Utilisation dans une entité Doctrine
+
+```php
+use App\Domain\ValueObject\Money;
+use App\Domain\ValueObject\Email;
+use Doctrine\ORM\Mapping as ORM;
+
+#[ORM\Entity]
+class Reservation
+{
+    #[ORM\Column(type: 'integer')]
+    private int $prixCents; // Stockage en centimes
+
+    #[ORM\Column(type: 'string')]
+    private string $emailContact;
+
+    public function getPrix(): Money
+    {
+        return Money::fromCents($this->prixCents);
+    }
+
+    public function setPrix(Money $prix): void
+    {
+        $this->prixCents = $prix->toCents();
+    }
+
+    public function getEmail(): Email
+    {
+        return Email::fromString($this->emailContact);
+    }
+
+    public function setEmail(Email $email): void
+    {
+        $this->emailContact = $email->toString();
+    }
+}
+```
+
+---
+
+## Checklist Value Object
+
+- [ ] Classe `final readonly`
+- [ ] Constructeur `private`
+- [ ] Factory methods `public static`
+- [ ] Validation dans le constructeur
+- [ ] Méthode `equals()` pour comparaison
+- [ ] Méthode `toString()` pour représentation
+- [ ] Pas de setters (immuable)
+- [ ] Tests unitaires exhaustifs (>90% coverage)
+- [ ] Documentation PHPDoc complète
+- [ ] Exemples d'utilisation en commentaire

package/Dev/i18n/messages/de.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# =============================================================================
+# Claude Craft - Deutsche Nachrichten
+# =============================================================================
+
+# Installation
+MSG_INSTALLING="Installiere..."
+MSG_INSTALL_COMPLETE="Installation abgeschlossen!"
+MSG_INSTALL_FAILED="Installation fehlgeschlagen"
+MSG_INSTALL_SUCCESS="Installation erfolgreich!"
+
+# Actions
+MSG_CREATING="Erstelle:"
+MSG_UPDATING="Aktualisiere:"
+MSG_SKIPPING="Überspringe (Datei existiert):"
+MSG_BACKUP_CREATED="Sicherung erstellt:"
+MSG_COPIED="Kopiert"
+
+# Status
+MSG_INFO="INFO"
+MSG_SUCCESS="ERFOLG"
+MSG_WARNING="WARNUNG"
+MSG_ERROR="FEHLER"
+MSG_DRY_RUN="SIMULATION"
+
+# Errors
+MSG_ERR_UNKNOWN_OPTION="Unbekannte Option:"
+MSG_ERR_UNEXPECTED_ARG="Unerwartetes Argument:"
+MSG_ERR_INVALID_DIR="Ungültiges Zielverzeichnis:"
+MSG_ERR_FILE_NOT_FOUND="Quelldatei nicht gefunden:"
+MSG_ERR_DIR_NOT_FOUND="Quellverzeichnis nicht gefunden:"
+
+# Components
+MSG_INSTALLING_AGENTS="Installiere Agenten..."
+MSG_INSTALLING_COMMANDS="Installiere Befehle..."
+MSG_INSTALLING_RULES="Installiere Regeln..."
+MSG_INSTALLING_TEMPLATES="Installiere Vorlagen..."
+MSG_INSTALLING_CHECKLISTS="Installiere Checklisten..."
+
+MSG_AGENTS_NOT_FOUND="Agenten-Verzeichnis nicht gefunden:"
+MSG_COMMANDS_NOT_FOUND="Befehle-Verzeichnis nicht gefunden:"
+MSG_RULES_NOT_FOUND="Regeln-Verzeichnis nicht gefunden:"
+MSG_TEMPLATES_NOT_FOUND="Vorlagen-Verzeichnis nicht gefunden:"
+MSG_CHECKLISTS_NOT_FOUND="Checklisten-Verzeichnis nicht gefunden:"
+
+# Summary
+MSG_SUMMARY="ZUSAMMENFASSUNG"
+MSG_MODE="Modus:"
+MSG_TARGET="Ziel:"
+MSG_FILES_CREATED="Erstellte Dateien:"
+MSG_FILES_UPDATED="Aktualisierte Dateien:"
+MSG_FILES_SKIPPED="Übersprungene Dateien:"
+MSG_ERRORS="Fehler:"
+
+# Dry run
+MSG_DRY_RUN_NOTE="Ohne --dry-run ausführen, um Änderungen anzuwenden."
+MSG_DRY_RUN_WOULD_CREATE="Würde Verzeichnis erstellen:"
+MSG_DRY_RUN_WOULD_COPY="Würde kopieren:"
+
+# Headers
+MSG_HEADER_COMMON="Installation gemeinsamer Regeln"
+MSG_HEADER_SYMFONY="Installation Symfony-Regeln"
+MSG_HEADER_FLUTTER="Installation Flutter-Regeln"
+MSG_HEADER_PYTHON="Installation Python-Regeln"
+MSG_HEADER_REACT="Installation React-Regeln"
+MSG_HEADER_REACTNATIVE="Installation React Native-Regeln"
+
+# Help
+MSG_HELP_USAGE="Verwendung:"
+MSG_HELP_OPTIONS="Optionen:"
+MSG_HELP_EXAMPLES="Beispiele:"
+MSG_HELP_INSTALL="Dateien installieren (Standard)"
+MSG_HELP_UPDATE="Nur bestehende Dateien aktualisieren"
+MSG_HELP_FORCE="Alle Dateien überschreiben"
+MSG_HELP_DRY_RUN="Simulation ohne Änderungen"
+MSG_HELP_BACKUP="Sicherung vor Änderungen erstellen"
+MSG_HELP_INTERACTIVE="Interaktiver Modus"
+MSG_HELP_LANG="Sprache (en, fr, es, de, pt)"
+
+# Next steps
+MSG_NEXT_STEPS="Nächste Schritte:"
+MSG_STEP_EDIT_CONTEXT=".claude/rules/00-project-context.md bearbeiten"
+MSG_STEP_CUSTOMIZE_CLAUDE=".claude/CLAUDE.md anpassen"
+MSG_STEP_RESTART="Claude Code neu starten, um Befehle zu laden"
+
+# Validation
+MSG_VALIDATING="Konfiguration wird validiert..."
+MSG_CONFIG_VALID="Konfiguration gültig"
+MSG_CONFIG_INVALID="Konfiguration ungültig"
+MSG_PROJECT="Projekt:"
+MSG_MODULES="Module:"

package/Dev/i18n/messages/en.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# =============================================================================
+# Claude Craft - English Messages
+# =============================================================================
+
+# Installation
+MSG_INSTALLING="Installing..."
+MSG_INSTALL_COMPLETE="Installation complete!"
+MSG_INSTALL_FAILED="Installation failed"
+MSG_INSTALL_SUCCESS="Installation successful!"
+
+# Actions
+MSG_CREATING="Creating:"
+MSG_UPDATING="Updating:"
+MSG_SKIPPING="Skipping (file exists):"
+MSG_BACKUP_CREATED="Backup created:"
+MSG_COPIED="Copied"
+
+# Status
+MSG_INFO="INFO"
+MSG_SUCCESS="SUCCESS"
+MSG_WARNING="WARNING"
+MSG_ERROR="ERROR"
+MSG_DRY_RUN="DRY-RUN"
+
+# Errors
+MSG_ERR_UNKNOWN_OPTION="Unknown option:"
+MSG_ERR_UNEXPECTED_ARG="Unexpected argument:"
+MSG_ERR_INVALID_DIR="Invalid target directory:"
+MSG_ERR_FILE_NOT_FOUND="Source file not found:"
+MSG_ERR_DIR_NOT_FOUND="Source directory not found:"
+
+# Components
+MSG_INSTALLING_AGENTS="Installing agents..."
+MSG_INSTALLING_COMMANDS="Installing commands..."
+MSG_INSTALLING_RULES="Installing rules..."
+MSG_INSTALLING_TEMPLATES="Installing templates..."
+MSG_INSTALLING_CHECKLISTS="Installing checklists..."
+
+MSG_AGENTS_NOT_FOUND="Agents directory not found:"
+MSG_COMMANDS_NOT_FOUND="Commands directory not found:"
+MSG_RULES_NOT_FOUND="Rules directory not found:"
+MSG_TEMPLATES_NOT_FOUND="Templates directory not found:"
+MSG_CHECKLISTS_NOT_FOUND="Checklists directory not found:"
+
+# Summary
+MSG_SUMMARY="SUMMARY"
+MSG_MODE="Mode:"
+MSG_TARGET="Target:"
+MSG_FILES_CREATED="Files created:"
+MSG_FILES_UPDATED="Files updated:"
+MSG_FILES_SKIPPED="Files skipped:"
+MSG_ERRORS="Errors:"
+
+# Dry run
+MSG_DRY_RUN_NOTE="Run without --dry-run to apply changes."
+MSG_DRY_RUN_WOULD_CREATE="Would create directory:"
+MSG_DRY_RUN_WOULD_COPY="Would copy:"
+
+# Headers
+MSG_HEADER_COMMON="Install Common Rules"
+MSG_HEADER_SYMFONY="Install Symfony Rules"
+MSG_HEADER_FLUTTER="Install Flutter Rules"
+MSG_HEADER_PYTHON="Install Python Rules"
+MSG_HEADER_REACT="Install React Rules"
+MSG_HEADER_REACTNATIVE="Install React Native Rules"
+
+# Help
+MSG_HELP_USAGE="Usage:"
+MSG_HELP_OPTIONS="Options:"
+MSG_HELP_EXAMPLES="Examples:"
+MSG_HELP_INSTALL="Install files (default)"
+MSG_HELP_UPDATE="Update existing files only"
+MSG_HELP_FORCE="Overwrite all files"
+MSG_HELP_DRY_RUN="Simulate without changes"
+MSG_HELP_BACKUP="Create backup before changes"
+MSG_HELP_INTERACTIVE="Interactive mode"
+MSG_HELP_LANG="Language (en, fr, es, de, pt)"
+
+# Next steps
+MSG_NEXT_STEPS="Next steps:"
+MSG_STEP_EDIT_CONTEXT="Edit .claude/rules/00-project-context.md"
+MSG_STEP_CUSTOMIZE_CLAUDE="Customize .claude/CLAUDE.md"
+MSG_STEP_RESTART="Restart Claude Code to load commands"
+
+# Validation
+MSG_VALIDATING="Validating configuration..."
+MSG_CONFIG_VALID="Configuration valid"
+MSG_CONFIG_INVALID="Configuration invalid"
+MSG_PROJECT="Project:"
+MSG_MODULES="Modules:"