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,21 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\AccountTransaction;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AccountTransactionController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = AccountTransaction::query()->with(['account', 'customer']);
+        $query->when($request->customer_account_id, fn($q, $v) => $q->where('customer_account_id', $v));
+        $query->when($request->customer_id, fn($q, $v) => $q->where('customer_id', $v));
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+}
@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\AccountTransaction;
+use App\Models\Finance\CustomerAccount;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class CustomerAccountController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = CustomerAccount::query()->with(['customer']);
+        $query->when($request->customer_id, fn($q, $v) => $q->where('customer_id', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function show(CustomerAccount $customerAccount): JsonResponse
+    {
+        return $this->success($customerAccount->load(['customer', 'transactions']));
+    }
+
+    public function recharge(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'customer_id' => 'required|exists:customers,id',
+            'amount' => 'required|numeric|min:0.01',
+            'pay_method' => 'nullable|integer|in:1,2,3,4',
+            'description' => 'nullable|string|max:255',
+        ]);
+
+        return DB::transaction(function () use ($validated) {
+            $account = CustomerAccount::firstOrCreate(
+                ['customer_id' => $validated['customer_id'], 'store_id' => auth()->user()->store_id ?? 0],
+                ['cash_balance' => 0, 'card_balance' => 0, 'points' => 0]
+            );
+
+            $account->increment('cash_balance', $validated['amount']);
+            $account->refresh();
+
+            AccountTransaction::create([
+                'store_id' => $account->store_id,
+                'customer_account_id' => $account->id,
+                'customer_id' => $validated['customer_id'],
+                'type' => 1,
+                'amount' => $validated['amount'],
+                'balance_after' => $account->cash_balance,
+                'description' => $validated['description'] ?? '账户充值',
+                'operator_id' => auth()->id(),
+            ]);
+
+            return $this->success($account);
+        });
+    }
+}
@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\FinanceCategory;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class FinanceCategoryController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = FinanceCategory::query();
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        $categories = $query->orderBy('sort')->get();
+
+        // 构建树形结构
+        $tree = $categories->where('parent_id', 0)->values()->map(function ($item) use ($categories) {
+            $item->children = $categories->where('parent_id', $item->id)->values();
+            return $item;
+        });
+
+        return $this->success($tree);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:50',
+            'type' => 'required|integer|in:1,2',
+            'parent_id' => 'sometimes|integer',
+            'sort' => 'sometimes|integer',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+
+        if (!empty($validated['parent_id'])) {
+            $parent = FinanceCategory::find($validated['parent_id']);
+            $validated['level'] = $parent ? $parent->level + 1 : 1;
+        }
+
+        return $this->success(FinanceCategory::create($validated));
+    }
+
+    public function show(FinanceCategory $financeCategory): JsonResponse
+    {
+        return $this->success($financeCategory->load('children'));
+    }
+
+    public function update(Request $request, FinanceCategory $financeCategory): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:50',
+            'type' => 'sometimes|integer|in:1,2',
+            'parent_id' => 'sometimes|integer',
+            'sort' => 'sometimes|integer',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+
+        $financeCategory->update($validated);
+
+        return $this->success($financeCategory);
+    }
+
+    public function destroy(FinanceCategory $financeCategory): JsonResponse
+    {
+        if ($financeCategory->children()->count() > 0) {
+            return $this->error('存在子分类，无法删除', 40001);
+        }
+
+        $financeCategory->delete();
+
+        return $this->success(null);
+    }
+}
@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\FinanceRecord;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class FinanceRecordController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = FinanceRecord::query()->with(['category']);
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->category_id, fn($q, $v) => $q->where('category_id', $v));
+        $query->when($request->has('audit_status'), fn($q) => $q->where('audit_status', $request->audit_status));
+        $query->when($request->start_date, fn($q, $v) => $q->where('record_date', '>=', $v));
+        $query->when($request->end_date, fn($q, $v) => $q->where('record_date', '<=', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'record_no' => 'required|string|max:50|unique:finance_records',
+            'category_id' => 'nullable|exists:finance_categories,id',
+            'type' => 'required|integer|in:1,2',
+            'amount' => 'required|numeric|min:0.01',
+            'pay_method' => 'nullable|integer|in:1,2,3,4',
+            'description' => 'nullable|string|max:255',
+            'record_date' => 'required|date',
+        ]);
+
+        $validated['operator_id'] = auth()->id();
+        $validated['audit_status'] = 0;
+
+        return $this->success(FinanceRecord::create($validated));
+    }
+
+    public function show(FinanceRecord $financeRecord): JsonResponse
+    {
+        return $this->success($financeRecord->load(['category', 'auditor', 'operator']));
+    }
+
+    public function update(Request $request, FinanceRecord $financeRecord): JsonResponse
+    {
+        if ($financeRecord->audit_status !== 0) {
+            return $this->error('只能修改待审核的记录', 40001);
+        }
+
+        $validated = $request->validate([
+            'category_id' => 'nullable|exists:finance_categories,id',
+            'type' => 'sometimes|integer|in:1,2',
+            'amount' => 'sometimes|numeric|min:0.01',
+            'pay_method' => 'nullable|integer|in:1,2,3,4',
+            'description' => 'nullable|string|max:255',
+            'record_date' => 'sometimes|date',
+        ]);
+
+        $financeRecord->update($validated);
+
+        return $this->success($financeRecord);
+    }
+
+    public function destroy(FinanceRecord $financeRecord): JsonResponse
+    {
+        if ($financeRecord->audit_status !== 0) {
+            return $this->error('只能删除待审核的记录', 40001);
+        }
+
+        $financeRecord->delete();
+
+        return $this->success(null);
+    }
+
+    public function audit(Request $request, FinanceRecord $financeRecord): JsonResponse
+    {
+        if ($financeRecord->audit_status !== 0) {
+            return $this->error('该记录已审核', 40001);
+        }
+
+        $validated = $request->validate([
+            'status' => 'required|integer|in:1,2',
+        ]);
+
+        $financeRecord->update([
+            'audit_status' => $validated['status'],
+            'audit_user_id' => auth()->id(),
+            'audit_at' => now(),
+        ]);
+
+        return $this->success($financeRecord);
+    }
+}
@@ -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);
+    }
+}
@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Finance;
+
+use App\Http\Controllers\Controller;
+use App\Models\Finance\PrepaidCard;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PrepaidCardController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = PrepaidCard::query();
+        $query->when($request->name, fn($q, $v) => $q->where('name', 'like', "%{$v}%"));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->orderBy('sort')->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:100',
+            'face_value' => 'required|numeric|min:0',
+            'sell_price' => 'required|numeric|min:0',
+            'discount_rate' => 'sometimes|numeric|min:0|max:1',
+            'validity_days' => 'sometimes|integer|min:1',
+            'status' => 'sometimes|integer|in:0,1',
+            'sort' => 'sometimes|integer',
+        ]);
+
+        return $this->success(PrepaidCard::create($validated));
+    }
+
+    public function show(PrepaidCard $prepaidCard): JsonResponse
+    {
+        return $this->success($prepaidCard);
+    }
+
+    public function update(Request $request, PrepaidCard $prepaidCard): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:100',
+            'face_value' => 'sometimes|numeric|min:0',
+            'sell_price' => 'sometimes|numeric|min:0',
+            'discount_rate' => 'sometimes|numeric|min:0|max:1',
+            'validity_days' => 'sometimes|integer|min:1',
+            'status' => 'sometimes|integer|in:0,1',
+            'sort' => 'sometimes|integer',
+        ]);
+
+        $prepaidCard->update($validated);
+
+        return $this->success($prepaidCard);
+    }
+
+    public function destroy(PrepaidCard $prepaidCard): JsonResponse
+    {
+        $prepaidCard->delete();
+
+        return $this->success(null);
+    }
+}