Bagian 6: Security dan Testing

<?php

declare(strict_types=1);

/**
 * Bootstrap PHPUnit untuk suite isolasi aplikasi SaaS multi-tenant.
 *
 * Tugas berkas ini satu: memuat seluruh class proyek SEKALI sebelum
 * test pertama berjalan, lewat path relatif antar folder bagian.
 *
 * Pada proyek nyata, class hidup dalam satu folder src/ dengan
 * namespace dan autoloader Composer, sehingga berkas semacam ini cukup
 * memanggil require 'vendor/autoload.php'. Pada bundle kursus ini,
 * class justru tersebar di folder src/ milik masing-masing bagian agar
 * setiap halaman bagian mandiri - folder bagian bersaudara di bawah
 * aplikasi-saas-multi-tenant/, maka dari tests/ kita naik dua tingkat
 * ('/../..') lalu masuk ke bagian tujuan. require_once menjaga berkas
 * yang sama tidak dimuat dua kali bila suite diperluas dengan test
 * file lain.
 */

// Bagian 2: identitas tenant aktif + resolusi tenant.
require_once __DIR__ . '/../../bagian-2-tenant-isolation/src/TenantContext.php';
require_once __DIR__ . '/../../bagian-2-tenant-isolation/src/TenantRepository.php';

// Bagian 3: keanggotaan dan matriks izin.
require_once __DIR__ . '/../../bagian-3-membership-dan-permissions/src/MembershipRepository.php';
require_once __DIR__ . '/../../bagian-3-membership-dan-permissions/src/AccessControl.php';

// Bagian 4: katalog plan dan siklus langganan.
require_once __DIR__ . '/../../bagian-4-billing-dan-subscriptions/src/PlanRepository.php';
require_once __DIR__ . '/../../bagian-4-billing-dan-subscriptions/src/SubscriptionService.php';

// Bagian 5: audit trail dan job queue.
require_once __DIR__ . '/../../bagian-5-audit-dan-background-jobs/src/AuditLogger.php';
require_once __DIR__ . '/../../bagian-5-audit-dan-background-jobs/src/JobQueue.php';

/**
 * Path absolut ke berkas struktur database. setUp() tiap test
 * mengeksekusi ketiganya berurutan pada koneksi :memory: yang baru:
 * schema dasar dulu (tenants/users/memberships/projects), lalu dua
 * migrasi - urutan ini wajib karena foreign key kedua migrasi
 * menunjuk tabel pada schema dasar.
 */
const SCHEMA_SAAS = __DIR__ . '/../../bagian-1-tenant-dan-domain-model/schema.sql';
const MIGRASI_BILLING = __DIR__ . '/../../bagian-4-billing-dan-subscriptions/migrasi-billing.sql';
const MIGRASI_AUDIT_JOBS = __DIR__ . '/../../bagian-5-audit-dan-background-jobs/migrasi-audit-jobs.sql';

<?php

declare(strict_types=1);

use PHPUnit\Framework\TestCase;

/**
 * Suite untuk invarian keamanan aplikasi SaaS multi-tenant.
 *
 * Isolasi data ADALAH properti keamanan proyek ini: satu database
 * bersama banyak pelanggan, dan satu-satunya penjaga batas adalah
 * penyaringan tenant_id pada setiap query. Suite ini memanggil
 * setiap operasi dengan id milik tenant lain dan menuntut hasil
 * kosong/ditolak - janji yang diucapkan pada Bagian 2 sampai 5
 * kini diperiksa mesin, bukan mata.
 *
 * Fixture seed yang dipakai seluruh test (schema.sql Bagian 1):
 * tenant #1 toko-bunga-melati, #2 studio-foto-cendrawasih; user #1
 * budi (owner t1), #2 siti (owner t2), #3 dewi (member t1 SEKALIGUS
 * admin t2 - user global), #4 rudi (tanpa keanggotaan); proyek
 * #1,#2 milik t1 dan #3,#4,#5 milik t2.
 *
 * Class dimuat oleh tests/bootstrap.php, bukan oleh berkas ini;
 * jalankan dari folder bagian ini dengan:
 *   php phpunit.phar --no-progress tests/TenantIsolationTest.php --bootstrap tests/bootstrap.php
 */
final class TenantIsolationTest extends TestCase
{
    private PDO $pdo;

    private MembershipRepository $memberships;

    private AccessControl $access;

    private SubscriptionService $subscriptions;

    private AuditLogger $audit;

    private JobQueue $queue;

    protected function setUp(): void
    {
        // Database :memory: baru untuk setiap test, dengan seluruh
        // struktur dimuat berurutan: schema dasar lalu dua migrasi.
        // Fixture selalu identik (2 tenant, 4 user, 5 proyek, 2 plan).
        $this->pdo = new PDO('sqlite::memory:');
        $this->pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        $this->pdo->exec('PRAGMA foreign_keys = ON');
        $this->pdo->exec((string) file_get_contents(SCHEMA_SAAS));
        $this->pdo->exec((string) file_get_contents(MIGRASI_BILLING));
        $this->pdo->exec((string) file_get_contents(MIGRASI_AUDIT_JOBS));

        $this->memberships = new MembershipRepository($this->pdo);
        $this->access = new AccessControl($this->memberships);
        $this->subscriptions = new SubscriptionService($this->pdo, new PlanRepository($this->pdo));
        $this->audit = new AuditLogger($this->pdo);
        $this->queue = new JobQueue($this->pdo);
    }

    protected function tearDown(): void
    {
        // TenantContext menyimpan state statis yang HIDUP menembus
        // batas method. Tanpa clear(), context dari test sebelumnya
        // bocor ke test berikutnya dan membuat
        // testContextDimulaiKosongDiTestBerikutnya gagal.

        TenantContext::clear();
    }

    public function testSandiDemoTerverifikasiTerhadapHashBeku(): void
    {
        $hash = $this->hashUser(1);

        $this->assertTrue(password_verify('sandi-budi-2026', $hash));
        $this->assertFalse(password_verify('sandi-salah-2026', $hash));
    }

    public function testContextUserGlobalBisaDuaTenantRoleBerbeda(): void
    {
        $sebagaiToko = TenantContext::fromUser($this->pdo, 3, 'toko-bunga-melati');
        $this->assertNotNull($sebagaiToko);
        $this->assertSame(1, $sebagaiToko->tenantId);
        $this->assertSame('member', $sebagaiToko->role);

        $sebagaiStudio = TenantContext::fromUser($this->pdo, 3, 'studio-foto-cendrawasih');
        $this->assertNotNull($sebagaiStudio);
        $this->assertSame(2, $sebagaiStudio->tenantId);
        $this->assertSame('admin', $sebagaiStudio->role);
    }

    public function testContextLintasTenantDitolakUntukNonAnggota(): void
    {
        // Budi owner tenant #1, bukan anggota tenant #2 - tidak
        // ada context untuknya di sana, berapa pun kali mencoba.
        $this->assertNull(TenantContext::fromUser($this->pdo, 1, 'studio-foto-cendrawasih'));
        $this->assertNull(TenantContext::fromUser($this->pdo, 2, 'toko-bunga-melati'));

        // Rudi terdaftar sebagai user global tetapi tanpa keanggotaan
        // apa pun: tidak ada context di tenant mana pun.
        $this->assertNull(TenantContext::fromUser($this->pdo, 4, 'toko-bunga-melati'));
        $this->assertNull(TenantContext::fromUser($this->pdo, 4, 'studio-foto-cendrawasih'));
    }

    public function testProyekTenantSatuTidakTerlihatDariKonteksTenantDua(): void
    {
        // Dewi berangkat sebagai member tenant #1.
        TenantContext::set(TenantContext::fromUser($this->pdo, 3, 'toko-bunga-melati'));
        $dariToko = $this->namaProyekDiContext();

        // Lalu pindah context ke tenant #2 sebagai admin.
        TenantContext::clear();
        TenantContext::set(TenantContext::fromUser($this->pdo, 3, 'studio-foto-cendrawasih'));
        $dariStudio = $this->namaProyekDiContext();

        $this->assertSame(['Website Baru', 'Kampanye Valentine'], $dariToko);
        $this->assertSame(
            ['Fotografi Produk Sabun', 'Branding Ulang 2026', 'Katalog Musim Hujan'],
            $dariStudio
        );
        $this->assertSame([], array_intersect($dariToko, $dariStudio));
    }

    public function testPengambilanProyekLintasTenantMengembalikanNull(): void
    {
        // Syarat ganda id + tenant_id: proyek #3 milik tenant #2
        // tidak bisa diambil dengan konteks tenant #1, dan sebaliknya.
        $this->assertNull($this->proyekUntukTenant(3, 1));
        $this->assertNull($this->proyekUntukTenant(1, 2));
        $this->assertNull($this->proyekUntukTenant(99, 1));

        $milikStudio = $this->proyekUntukTenant(3, 2);
        $this->assertNotNull($milikStudio);
        $this->assertSame('Fotografi Produk Sabun', $milikStudio['nama']);
    }

    public function testKeanggotaanLintasTenantTidakDitemukan(): void
    {
        $this->assertNull($this->memberships->findByUserAndTenant(1, 2));
        $this->assertNull($this->memberships->findByUserAndTenant(2, 1));
        $this->assertNull($this->memberships->findByUserAndTenant(4, 1));

        $this->assertSame('member', $this->memberships->findByUserAndTenant(3, 1)['role']);
        $this->assertSame('admin', $this->memberships->findByUserAndTenant(3, 2)['role']);
    }

    public function testAccessControlMenolakAksiLintasTenant(): void
    {
        // Pemilik tenant #1 kehilangan seluruh kekuasaannya di
        // tenant #2; rudi ditolak di mana-mana; di dalam tenant
        // sendiri izin tetap berjalan normal.
        $this->assertFalse($this->access->can(1, 'project.view', 2));
        $this->assertFalse($this->access->can(2, 'project.view', 1));
        $this->assertFalse($this->access->can(4, 'project.view', 1));
        $this->assertFalse($this->access->can(4, 'project.view', 2));

        $this->assertTrue($this->access->can(1, 'project.view', 1));
        $this->assertTrue($this->access->can(3, 'member.remove', 2));
    }

    public function testAksiTakDikenalDitolakUntukSemuaRole(): void
    {
        // Deny by default: aksi di luar matriks 8 aksi Bagian 3
        // ditolak bahkan untuk owner sekalipun.
        $this->assertFalse($this->access->can(1, 'project.rename', 1));
        $this->assertFalse($this->access->can(3, 'project.rename', 2));
    }

    public function testRiwayatAuditTerbagiPerTenant(): void
    {
        // Dua tenant merekam peristiwa pada entitas bernomor sama -
        // id 6 belum terpakai pada seed, jadi tidak perlu insert
        // proyek sungguhan untuk menguji pembacaannya.
        $this->audit->record(1, 1, 'project.create', 'project', 6,
            '{"nama":"Landing Page Lebaran"}', $this->z('2026-02-02 09:05:00'));
        $this->audit->record(2, 2, 'project.create', 'project', 6,
            '{"nama":"Kampanye Promo Studio"}', $this->z('2026-02-02 10:00:00'));

        $riwayatToko = $this->audit->riwayat(1, 'project', 6);
        $riwayatStudio = $this->audit->riwayat(2, 'project', 6);

        $this->assertCount(1, $riwayatToko);
        $this->assertCount(1, $riwayatStudio);
        $this->assertSame('{"nama":"Landing Page Lebaran"}', $riwayatToko[0]['detail']);
        $this->assertSame('{"nama":"Kampanye Promo Studio"}', $riwayatStudio[0]['detail']);
    }

    public function testAuditLogMenolakTulisUlang(): void
    {
        $this->audit->record(1, 1, 'project.create', 'project', 1,
            '{"nama":"Website Baru"}', $this->z('2026-02-02 09:00:00'));

        try {
            $this->pdo->exec('UPDATE audit_log SET aksi = \'project.rename\' WHERE id = 1');
            $this->fail('UPDATE pada audit_log seharusnya ditolak trigger append-only.');
        } catch (PDOException $e) {
            $this->assertStringContainsString('append-only', $e->getMessage());
        }

        $this->expectException(PDOException::class);
        $this->pdo->exec('DELETE FROM audit_log WHERE id = 1');
    }

    public function testBatasLanggananBerlakuPerTenant(): void
    {
        $now = $this->z('2026-02-01 09:00:00');

        // Tenant #1 memegang 2 proyek: masih bisa membuat yang ketiga.
        $this->assertTrue($this->subscriptions->bolehBuatProyek(1, $now));
        $this->tambahProyek(1, 'Landing Page Lebaran');

        $this->assertFalse($this->subscriptions->bolehBuatProyek(1, $now));
        $this->assertSame(
            'Batas plan Gratis: 3 proyek (saat ini 3).',
            $this->subscriptions->alasanBlokir(1, $now)
        );

        // Tenant #2 memegang 3 proyek sejak seed: penuh sejak awal.
        $this->assertFalse($this->subscriptions->bolehBuatProyek(2, $now));

        // Budi meng-upgrade tenant #1 ke plan Pro: batas naik ke 25
        // untuk tenant #1 saja - tenant #2 tidak ikut terangkat.
        $this->subscriptions->subscribe(1, 'pro', $now);
        $this->assertSame(25, $this->subscriptions->batasProyekEfektif(1, $now));
        $this->assertTrue($this->subscriptions->bolehBuatProyek(1, $now));
        $this->assertSame(3, $this->subscriptions->batasProyekEfektif(2, $now));
        $this->assertSame('tidak-berlangganan', $this->subscriptions->status(2, $now));
    }

    public function testTenggangHanyaMengunciTenantYangBerlangganan(): void
    {
        // Tenant #1 berlangganan Pro 2026-02-01, berakhir 2026-03-03.
        $this->subscriptions->subscribe(1, 'pro', $this->z('2026-02-01 09:00:00'));

        // Dua hari setelah masa berlaku habis: tenant #1 tenggang,
        // tenant #2 sama sekali tidak tersentuh status itu.
        $tenggang = $this->z('2026-03-05 09:00:00');
        $this->assertSame('tenggang', $this->subscriptions->status(1, $tenggang));
        $this->assertFalse($this->subscriptions->bolehBuatProyek(1, $tenggang));
        $this->assertStringContainsString('Masa tenggang', $this->subscriptions->alasanBlokir(1, $tenggang));

        $this->assertSame('tidak-berlangganan', $this->subscriptions->status(2, $tenggang));
        $this->assertSame(
            'Batas plan Gratis: 3 proyek (saat ini 3).',
            $this->subscriptions->alasanBlokir(2, $tenggang)
        );
    }

    public function testJobMembawaKonteksTenantSepanjangSiklus(): void
    {
        $now = $this->z('2026-02-02 08:00:00');
        $this->queue->enqueue(1, 'email.laporan-mingguan',
            '{"tenant_id":1,"email":"[email protected]"}', $now);
        $this->queue->enqueue(2, 'subscription.sweep',
            '{"tenant_id":2,"cek_pada":"2026-02-02 08:00:00"}', $now);

        $jobPertama = $this->queue->claim($now);
        $this->assertNotNull($jobPertama);
        $this->assertSame(1, (int) $jobPertama['tenant_id']);
        $this->assertSame(1, json_decode((string) $jobPertama['payload'], true)['tenant_id']);
        $this->queue->complete((int) $jobPertama['id']);

        $jobKedua = $this->queue->claim($now);
        $this->assertNotNull($jobKedua);
        $this->assertSame(2, (int) $jobKedua['tenant_id']);
        $this->assertSame(2, json_decode((string) $jobKedua['payload'], true)['tenant_id']);
        $this->queue->complete((int) $jobKedua['id']);

        $this->assertSame([], $this->queue->deadLetters());
    }

    public function testJobGagalTigaKaliMenjadiDeadLetterDenganTenant(): void
    {
        $now = $this->z('2026-02-02 08:00:00');
        $job = $this->queue->enqueue(2, 'email.laporan-mingguan',
            '{"tenant_id":2,"email":"[email protected]"}', $now);
        $id = (int) $job['id'];

        // Tiga kali claim-then-fail: claim menaikkan attempts dan
        // mengubah status menjadi diproses, fail menjadwalkan ulang
        // dengan backoff 2 lalu 4 menit, dan percobaan ketiga
        // (attempts = MAX_ATTEMPTS) membuat job mati permanen.
        $this->assertNotNull($this->queue->claim($now));
        $this->assertSame('menunggu', $this->queue->fail($id, 'SMTP mati', $now));

        $this->assertNotNull($this->queue->claim($this->z('2026-02-02 08:02:00')));
        $this->assertSame('menunggu', $this->queue->fail($id, 'SMTP mati', $this->z('2026-02-02 08:02:00')));

        $jobKetiga = $this->queue->claim($this->z('2026-02-02 08:06:00'));
        $this->assertNotNull($jobKetiga);
        $this->assertSame(3, (int) $jobKetiga['attempts']);
        $this->assertSame('gagal', $this->queue->fail($id, 'SMTP mati', $this->z('2026-02-02 08:06:00')));

        $dead = $this->queue->deadLetters();
        $this->assertCount(1, $dead);
        $this->assertSame($id, (int) $dead[0]['id']);
        $this->assertSame(2, (int) $dead[0]['tenant_id']);
        $this->assertSame(3, (int) $dead[0]['attempts']);
        $this->assertSame('SMTP mati', $dead[0]['error']);
    }

    /**
     * Test ini diletakkan SETELAH test-test yang memasang context,
     * dan bergantung pada urutan deklarasi (default PHPUnit): bila
     * tearDown() lupa memanggil clear(), context test sebelumnya
     * masih terpasang dan get() tidak melempar - test ini gagal.
     */
    public function testContextDimulaiKosongDiTestBerikutnya(): void
    {
        $this->expectException(RuntimeException::class);

        TenantContext::get();
    }

    /**
     * Jam beku WIB - pola yang sama dengan SubscriptionService.
     */
    private function z(string $waktu): DateTimeImmutable
    {
        return new DateTimeImmutable($waktu, new DateTimeZone('Asia/Jakarta'));
    }

    private function hashUser(int $userId): string
    {
        $stmt = $this->pdo->prepare('SELECT password_hash FROM users WHERE id = :id');
        $stmt->execute(['id' => $userId]);

        return (string) $stmt->fetchColumn();
    }

    /**
     * Daftar nama proyek yang terbaca dari context aktif.
     *
     * Query mengikuti pola repository Bagian 2: tenant_id selalu
     * berasal dari TenantContext, bukan dari parameter request.
     *
     * @return list<string>
     */
    private function namaProyekDiContext(): array
    {
        $stmt = $this->pdo->prepare(
            'SELECT nama FROM projects WHERE tenant_id = :tenant_id ORDER BY id'
        );
        $stmt->execute(['tenant_id' => TenantContext::get()->tenantId]);

        return array_map(
            fn (array $baris): string => (string) $baris['nama'],
            $stmt->fetchAll(PDO::FETCH_ASSOC),
        );
    }

    /**
     * Ambil satu proyek dengan syarat ganda id + tenant_id -
     * pola findForTenant() Bagian 2 yang menolak IDOR lintas tenant.
     *
     * @return array<string, mixed>|null
     */
    private function proyekUntukTenant(int $projectId, int $tenantId): ?array
    {
        $stmt = $this->pdo->prepare(
            'SELECT id, tenant_id, nama FROM projects
              WHERE id = :id AND tenant_id = :tenant_id'
        );
        $stmt->execute(['id' => $projectId, 'tenant_id' => $tenantId]);
        $baris = $stmt->fetch(PDO::FETCH_ASSOC);

        return $baris === false ? null : $baris;
    }

    private function tambahProyek(int $tenantId, string $nama): void
    {
        $stmt = $this->pdo->prepare(
            'INSERT INTO projects (tenant_id, nama) VALUES (:tenant_id, :nama)'
        );
        $stmt->execute(['tenant_id' => $tenantId, 'nama' => $nama]);
    }
}