add controllers, servoices

2026-03-09 02:52:13 -04:00
parent c8de5f7edc
commit d76c871cb7
501 changed files with 34439 additions and 21843 deletions
@@ -0,0 +1,81 @@
+<?php
+
+namespace App\Http\Controllers\Api\Finance;
+
+use App\Http\Controllers\Api\BaseApiController;
+use App\Http\Requests\Payments\PaymentManualEditRequest;
+use App\Http\Requests\Payments\PaymentManualSearchRequest;
+use App\Http\Requests\Payments\PaymentManualSuggestRequest;
+use App\Http\Requests\Payments\PaymentManualUpdateRequest;
+use App\Services\Payments\PaymentManualService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PaymentManualController extends BaseApiController
+{
+    public function __construct(private PaymentManualService $service)
+    {
+        parent::__construct();
+    }
+
+    public function search(PaymentManualSearchRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+        $data = $this->service->search(
+            (string) ($payload['search_term'] ?? ''),
+            $payload['school_year'] ?? null
+        );
+
+        return response()->json(['ok' => true] + $data);
+    }
+
+    public function suggest(PaymentManualSuggestRequest $request): JsonResponse
+    {
+        $payload = $request->validated();
+        $items = $this->service->suggest((string) ($payload['q'] ?? ''));
+
+        return response()->json(['ok' => true, 'items' => $items]);
+    }
+
+    public function record(PaymentManualUpdateRequest $request, int $invoiceId): JsonResponse
+    {
+        $payload = $request->validated();
+
+        $result = $this->service->recordPayment(
+            $invoiceId,
+            (float) $payload['amount'],
+            (string) $payload['payment_method'],
+            $payload['payment_date'] ?? null,
+            $payload['check_number'] ?? null,
+            $payload['payment_type'] ?? null,
+            $request->file('payment_file'),
+            $payload['school_year'] ?? null,
+            $payload['semester'] ?? null,
+            (int) (auth()->id() ?? 0)
+        );
+
+        return response()->json(['ok' => true] + $result);
+    }
+
+    public function edit(PaymentManualEditRequest $request, int $paymentId): JsonResponse
+    {
+        $payload = $request->validated();
+
+        $this->service->editPayment(
+            $paymentId,
+            (float) $payload['paid_amount'],
+            (string) $payload['payment_method'],
+            $payload['check_number'] ?? null,
+            $request->file('payment_file'),
+            (int) (auth()->id() ?? 0)
+        );
+
+        return response()->json(['ok' => true]);
+    }
+
+    public function file(Request $request, string $filename)
+    {
+        $mode = (string) ($request->query('mode') ?? 'download');
+        return $this->service->serveCheckFile($filename, $mode);
+    }
+}