Your First Contribution

git checkout dev
git pull origin dev
git checkout -b feature/customer-notes

Where's the model?       → packages/customer/src/Models/Customer.php
Where's the controller?  → packages/customer/src/Http/Controllers/
Where's the validation?  → packages/customer/src/Http/Requests/
Where's the response?    → packages/customer/src/Http/Resources/
Where's the migration?   → packages/customer/database/migrations/
Where are the routes?    → packages/customer/src/Http/routes.php

php artisan make:migration add_notes_to_customers_table --path=packages/customer/database/migrations

public function up(): void
{
    Schema::table('customers', function (Blueprint $table) {
        $table->text('notes')->nullable()->after('country');
    });
}

public function down(): void
{
    Schema::table('customers', function (Blueprint $table) {
        $table->dropColumn('notes');
    });
}

php artisan migrate

protected $fillable = [
    'name',
    'email',
    'phone_number',
    'address',
    'city',
    'country',
    'notes',       // ← Add this
    'company_id',
];

public function rules(): array
{
    return [
        // ... existing rules
        'notes' => 'nullable|string|max:5000',
    ];
}

public function toArray($request): array
{
    return [
        // ... existing fields
        'notes' => $this->notes,
    ];
}

# Run tests
docker compose exec app php -d memory_limit=1G artisan test --parallel --processes=4 --recreate-databases

# Test manually via curl
curl -X POST http://localhost:8000/v1/customer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Test", "phone_number": "+229123", "notes": "VIP customer"}'

./vendor/bin/pint

git add .
git commit -m "feat: add notes field to customer model"
git push -u origin feature/customer-notes

1. Migration   → Add/modify the database schema
2. Model       → Update $fillable, relationships, casts
3. Request     → Add validation rules
4. Service     → Add business logic (if complex)
5. Controller  → Wire request → service → response (if needed)
6. Resource    → Update the API response
7. Policy      → Add permission check (if new action)
8. Test        → Write feature test