Add membership fee system with disability discount and fix document permissions

Features: - Implement two fee types: entrance fee and annual fee (both NT$1,000) - Add 50% discount for disability certificate holders - Add disability certificate upload in member profile - Integrate disability verification into cashier approval workflow - Add membership fee settings in system admin Document permissions: - Fix hard-coded role logic in Document model - Use permission-based authorization instead of role checks Additional features: - Add announcements, general ledger, and trial balance modules - Add income management and accounting entries - Add comprehensive test suite with factories - Update UI translations to Traditional Chinese 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 09:56:01 +08:00
parent 83ce1f7fc8
commit 642b879dd4
207 changed files with 19487 additions and 3048 deletions
--- a/tests/Traits/CreatesMemberData.php
+++ b/tests/Traits/CreatesMemberData.php
@@ -0,0 +1,145 @@
+<?php
+
+namespace Tests\Traits;
+
+use App\Models\Member;
+use App\Models\MembershipPayment;
+use App\Models\User;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+
+trait CreatesMemberData
+{
+    /**
+     * Create a member with associated user
+     */
+    protected function createMember(array $memberAttributes = [], array $userAttributes = []): Member
+    {
+        $user = User::factory()->create($userAttributes);
+        return Member::factory()->create(array_merge(
+            ['user_id' => $user->id],
+            $memberAttributes
+        ));
+    }
+
+    /**
+     * Create a pending member (awaiting payment)
+     */
+    protected function createPendingMember(array $attributes = []): Member
+    {
+        return $this->createMember(array_merge([
+            'membership_status' => Member::STATUS_PENDING,
+            'membership_started_at' => null,
+            'membership_expires_at' => null,
+        ], $attributes));
+    }
+
+    /**
+     * Create an active member with valid membership
+     */
+    protected function createActiveMember(array $attributes = []): Member
+    {
+        return $this->createMember(array_merge([
+            'membership_status' => Member::STATUS_ACTIVE,
+            'membership_started_at' => now()->subMonth(),
+            'membership_expires_at' => now()->addYear(),
+        ], $attributes));
+    }
+
+    /**
+     * Create an expired member
+     */
+    protected function createExpiredMember(array $attributes = []): Member
+    {
+        return $this->createMember(array_merge([
+            'membership_status' => Member::STATUS_EXPIRED,
+            'membership_started_at' => now()->subYear()->subMonth(),
+            'membership_expires_at' => now()->subMonth(),
+        ], $attributes));
+    }
+
+    /**
+     * Create a suspended member
+     */
+    protected function createSuspendedMember(array $attributes = []): Member
+    {
+        return $this->createMember(array_merge([
+            'membership_status' => Member::STATUS_SUSPENDED,
+        ], $attributes));
+    }
+
+    /**
+     * Create a member with a pending payment
+     */
+    protected function createMemberWithPendingPayment(array $memberAttributes = [], array $paymentAttributes = []): array
+    {
+        Storage::fake('private');
+
+        $member = $this->createPendingMember($memberAttributes);
+
+        $payment = MembershipPayment::factory()->create(array_merge([
+            'member_id' => $member->id,
+            'status' => MembershipPayment::STATUS_PENDING,
+            'amount' => 1000,
+            'payment_method' => MembershipPayment::METHOD_BANK_TRANSFER,
+        ], $paymentAttributes));
+
+        return ['member' => $member, 'payment' => $payment];
+    }
+
+    /**
+     * Create a member with payment at specific approval stage
+     */
+    protected function createMemberWithPaymentAtStage(string $stage, array $memberAttributes = []): array
+    {
+        Storage::fake('private');
+
+        $member = $this->createPendingMember($memberAttributes);
+
+        $statusMap = [
+            'pending' => MembershipPayment::STATUS_PENDING,
+            'cashier_approved' => MembershipPayment::STATUS_APPROVED_CASHIER,
+            'accountant_approved' => MembershipPayment::STATUS_APPROVED_ACCOUNTANT,
+            'fully_approved' => MembershipPayment::STATUS_APPROVED_CHAIR,
+        ];
+
+        $payment = MembershipPayment::factory()->create([
+            'member_id' => $member->id,
+            'status' => $statusMap[$stage] ?? MembershipPayment::STATUS_PENDING,
+        ]);
+
+        return ['member' => $member, 'payment' => $payment];
+    }
+
+    /**
+     * Create a fake receipt file for testing
+     */
+    protected function createFakeReceipt(string $name = 'receipt.jpg'): UploadedFile
+    {
+        return UploadedFile::fake()->image($name, 800, 600);
+    }
+
+    /**
+     * Get valid member registration data
+     */
+    protected function getValidMemberRegistrationData(array $overrides = []): array
+    {
+        $uniqueEmail = 'test'.uniqid().'@example.com';
+
+        return array_merge([
+            'full_name' => 'Test User',
+            'email' => $uniqueEmail,
+            'password' => 'Password123!',
+            'password_confirmation' => 'Password123!',
+            'phone' => '0912345678',
+            'national_id' => 'A123456789',
+            'address_line_1' => '123 Test Street',
+            'address_line_2' => '',
+            'city' => 'Taipei',
+            'postal_code' => '100',
+            'emergency_contact_name' => 'Emergency Contact',
+            'emergency_contact_phone' => '0987654321',
+            'terms_accepted' => true,
+        ], $overrides);
+    }
+}