feat: 第四阶段财务与人事薪资模块

- 新增2个migration(11张表): finance(6表)/hr(5表) - 新增11个Model + 11个Controller - 新增50条API路由(总计262条) - 新增2个前端API模块 + 10个管理页面 - 迁移运行通过, vite build验证通过
2026-03-13 20:35:19 +08:00
parent e7d4d9b414
commit fb5e0daf1a
37 changed files with 3157 additions and 0 deletions
@@ -0,0 +1,94 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\Invoice;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class InvoiceController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Invoice::query()->with(['customer']);
+        $query->when($request->invoice_no, fn($q, $v) => $q->where('invoice_no', 'like', "%{$v}%"));
+        $query->when($request->customer_id, fn($q, $v) => $q->where('customer_id', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'invoice_no' => 'required|string|max:50|unique:invoices',
+            'customer_id' => 'nullable|exists:customers,id',
+            'type' => 'sometimes|integer|in:1,2',
+            'amount' => 'required|numeric|min:0',
+            'tax_amount' => 'sometimes|numeric|min:0',
+            'title' => 'nullable|string|max:255',
+            'tax_no' => 'nullable|string|max:50',
+            'related_type' => 'nullable|string|max:50',
+            'related_id' => 'nullable|integer',
+        ]);
+
+        $validated['operator_id'] = auth()->id();
+        $validated['status'] = 0;
+
+        return $this->success(Invoice::create($validated));
+    }
+
+    public function show(Invoice $invoice): JsonResponse
+    {
+        return $this->success($invoice->load(['customer', 'operator']));
+    }
+
+    public function update(Request $request, Invoice $invoice): JsonResponse
+    {
+        if ($invoice->status !== 0) {
+            return $this->error('只能修改待开票的发票', 40001);
+        }
+
+        $validated = $request->validate([
+            'customer_id' => 'nullable|exists:customers,id',
+            'type' => 'sometimes|integer|in:1,2',
+            'amount' => 'sometimes|numeric|min:0',
+            'tax_amount' => 'sometimes|numeric|min:0',
+            'title' => 'nullable|string|max:255',
+            'tax_no' => 'nullable|string|max:50',
+            'related_type' => 'nullable|string|max:50',
+            'related_id' => 'nullable|integer',
+        ]);
+
+        $invoice->update($validated);
+
+        return $this->success($invoice);
+    }
+
+    public function destroy(Invoice $invoice): JsonResponse
+    {
+        if ($invoice->status !== 0) {
+            return $this->error('只能删除待开票的发票', 40001);
+        }
+
+        $invoice->delete();
+
+        return $this->success(null);
+    }
+
+    public function issue(Invoice $invoice): JsonResponse
+    {
+        if ($invoice->status !== 0) {
+            return $this->error('该发票已开具或已红冲', 40001);
+        }
+
+        $invoice->update([
+            'status' => 1,
+            'issued_at' => now(),
+        ]);
+
+        return $this->success($invoice);
+    }
+}