ifnex/04_Laravel/tests/Feature/Database/Seeders/CurrencySeederTest.php
Kazem Alghasi f1d5667fe8 feat(deploy): preflight + smoke-test + UAT checklist (phases 3.9.1–3.11)
Prepare the project for production deployment and final client
acceptance testing. Adds preflight fail-fast command, hardened FX rate
importer, currency seeder, deploy scripts, E2E smoke test, and the
43-item UAT checklist document with sign-off form.

Key changes:

- Phase 3.9.1 — hotfix (AddressBookEntry):
  - Add $attributes defaults (use_count=0, is_default=false) so
    instance values are populated right after create() without
    refresh(). Resolves the red test
    `it_increments_use_count_and_sets_last_used_at`.

- Phase 3.10 — deploy infrastructure (Laravel):
  - Add `ifnex:preflight` command: fail-fast audit of production
    environment (APP_ENV, APP_DEBUG, APP_KEY, IFNEX_API_KEY,
    IFNEX_BRIDGE_API_KEY, ZARINPAL_SANDBOX, DB_CONNECTION, CORS,
    currencies seeded, PHP extensions, storage writable). Exits 1
    if any check fails; supports --skip-db for pre-migrate runs.
  - Add `ifnex:import-fx-rates` command: replacement for
    `ifnex:update-rates`. Fetches USD/AED from Exir.io + EUR/CNY
    from FreeCurrencyAPI. Supports --auto-approve (cron use) and
    --threshold (max change % for auto-approve). Logs critical on
    HTTP failure. URL configurable via EXIR_API_URL env.
  - Add `CurrencySeeder`: creates 5 base currencies (USD/AED/EUR/
    CNY/IRR) with rate=0 (IRR=1). Idempotent — does not overwrite
    real rates already set by admin or cron.
  - Update `DatabaseSeeder`: skip super_admin with password
    'password' in production (still created in local/testing).
  - Fix `bootstrap/app.php`: remove dead `use ApiKeyAuth` import
    (actual class is ApiKeyMiddleware). Latent fatal if api_key
    alias was used.
  - Add `config/ifnex.php` exir block + preflight config.
  - Harden `.env.example`: MySQL default, EXIR_API_URL,
    SANCTUM_STATEFUL_DOMAINS, APP_TIMEZONE, LOG_DAILY_DAYS, fix
    duplicate CURRENCY_API_KEY.

- Phase 3.10 — deploy scripts (Linux):
  - Add `scripts/deploy.sh`: idempotent 13-step deploy (composer
    install → key:generate → preflight → migrate → seed → FX import
    → cache → chown). Fail-fast with set -e.
  - Add `scripts/cron-exir-rates.sh`: daily cron wrapper for
    `ifnex:import-fx-rates --source=all --auto-approve`.

- Phase 3.10.1 — preflight hotfix:
  - Make expected DB connection configurable
    (ifnex.preflight.expected_db_connection) instead of hardcoded
    'mysql'. Prevents cascade test failure when tests would have to
    mutate database.default to mysql in a sqlite test environment
    (Unknown database ':memory:' → broken connection pool → 22
    previously-green tests fail with "There is already an active
    transaction").
  - Rewrite IfnexPreflightTest to use config() rather than mutating
    database.default.

- Phase 3.11 — UAT:
  - Add `ifnex:smoke-test` command: E2E post-deploy automated test
    (25+ checks: DB connection, core tables, currencies with
    non-zero rates, countries count, roles, admin user, system
    settings, storage writable, config/route cache, 4 API
    endpoints: /up, /countries, /track/{invalid}, /customer/profile
    without token).
  - Add 9 feature tests for smoke-test (PASS + 6 FAIL + custom URL
    + 422/500 handling + auth bypass detection).
  - Add `UAT-3.11.md`: 43-item Persian checklist for client
    acceptance testing across 15 feature areas. Includes sign-off
    form for both parties (client + VernaSoft).
  - Update `CLIENT_DELIVERY.md` to record phases 3.10 and 3.11.

Tests:
- Total: 51 → 82 tests, 150 → 220+ assertions, all green.
- New: IfnexPreflightTest (9), IfnexImportFxRatesTest (9),
  CurrencySeederTest (4), IfnexSmokeTestTest (9) = 31 new tests.

Documentation:
- DEPLOYMENT_HANDOFF.md §2.4: add CurrencySeeder + import-fx-rates.
- DEPLOYMENT_HANDOFF.md §2.8: update cron to use cron-exir-rates.sh.
- UAT-3.11.md: new 43-item client acceptance checklist + sign-off.
- CLIENT_DELIVERY.md: record phases 3.10 and 3.11 completion.
2026-10-31 22:18:15 +03:30

79 lines
2.6 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace Tests\Feature\Database\Seeders;
use App\Models\Currency;
use Database\Seeders\CurrencySeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;
/**
* تست‌های CurrencySeeder (فاز ۳.۱۰)
*
* مطمئن می‌شود که seeder:
* - ۵ ارز پایه (USD/AED/EUR/CNY/IRR) را ایجاد می‌کند
* - ایمن برای اجرای چندباره است (idempotent)
* - نرخ واقعی موجود را overwrite نمی‌کند
* - نرخ ریال را روی ۱ تنظیم می‌کند (چون مبنای سیستم است)
*/
class CurrencySeederTest extends TestCase
{
use RefreshDatabase;
#[Test]
public function it_creates_five_base_currencies()
{
$this->seed(CurrencySeeder::class);
$this->assertDatabaseCount('currencies', 5);
foreach (['USD', 'AED', 'EUR', 'CNY', 'IRR'] as $code) {
$this->assertDatabaseHas('currencies', [
'code' => $code,
'is_active' => true,
]);
}
}
#[Test]
public function it_sets_irr_rate_to_one()
{
$this->seed(CurrencySeeder::class);
$irr = Currency::where('code', 'IRR')->first();
$this->assertSame('1.0000', $irr->rate_to_rial);
}
#[Test]
public function it_is_idempotent_and_does_not_overwrite_real_rates()
{
// اجرای اول با نرخ صفر
$this->seed(CurrencySeeder::class);
// شبیه‌سازی نرخ واقعی که مدیر یا cron وارد کرده
Currency::where('code', 'USD')->update(['rate_to_rial' => 60000]);
Currency::where('code', 'EUR')->update(['rate_to_rial' => 65000]);
// اجرای دوباره seeder — نباید نرخ‌های واقعی را overwrite کند
$this->seed(CurrencySeeder::class);
$this->assertSame('60000.0000', Currency::where('code', 'USD')->value('rate_to_rial'));
$this->assertSame('65000.0000', Currency::where('code', 'EUR')->value('rate_to_rial'));
// ولی هنوز همه ۵ ارز موجود هستند
$this->assertDatabaseCount('currencies', 5);
}
#[Test]
public function it_sets_other_currencies_rate_to_zero_until_imported()
{
$this->seed(CurrencySeeder::class);
// ارزهای غیر IRR باید نرخ صفر داشته باشند تا cron یا مدیر آنها را پر کند
foreach (['USD', 'AED', 'EUR', 'CNY'] as $code) {
$this->assertSame('0.0000', Currency::where('code', $code)->value('rate_to_rial'));
}
}
}