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,62 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Hr;
+
+use App\Http\Controllers\Controller;
+use App\Models\Hr\AttendanceRecord;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AttendanceRecordController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = AttendanceRecord::query()->with('user');
+        $query->when($request->user_id, fn($q, $v) => $q->where('user_id', $v));
+        $query->when($request->start_date, fn($q, $v) => $q->where('attendance_date', '>=', $v));
+        $query->when($request->end_date, fn($q, $v) => $q->where('attendance_date', '<=', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->latest('attendance_date')->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'user_id' => 'required|exists:users,id',
+            'attendance_date' => 'required|date',
+            'clock_in' => 'nullable|date_format:H:i',
+            'clock_out' => 'nullable|date_format:H:i',
+            'status' => 'nullable|integer|in:1,2,3,4,5',
+            'overtime_hours' => 'nullable|numeric|min:0',
+            'remark' => 'nullable|string|max:255',
+        ]);
+
+        return $this->success(AttendanceRecord::create($v));
+    }
+
+    public function clockIn(): JsonResponse
+    {
+        $record = AttendanceRecord::firstOrCreate(
+            ['user_id' => auth()->id(), 'attendance_date' => now()->toDateString()],
+            ['status' => 1]
+        );
+        $record->update(['clock_in' => now()->format('H:i:s')]);
+
+        return $this->success($record);
+    }
+
+    public function clockOut(): JsonResponse
+    {
+        $record = AttendanceRecord::where('user_id', auth()->id())
+            ->where('attendance_date', now()->toDateString())
+            ->first();
+
+        if (!$record) {
+            return $this->error('今日未打卡上班', 40001);
+        }
+        $record->update(['clock_out' => now()->format('H:i:s')]);
+
+        return $this->success($record);
+    }
+}
@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Hr;
+
+use App\Http\Controllers\Controller;
+use App\Models\Hr\EmployeeProfile;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class EmployeeProfileController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = EmployeeProfile::query()->with('user');
+        $query->when($request->user_id, fn($q, $v) => $q->where('user_id', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'user_id' => 'required|exists:users,id',
+            'employee_no' => 'nullable|string|max:30',
+            'hire_date' => 'nullable|date',
+            'birth_date' => 'nullable|date',
+            'gender' => 'nullable|integer|in:0,1,2',
+            'id_card' => 'nullable|string|max:20',
+            'education' => 'nullable|string|max:30',
+            'emergency_contact' => 'nullable|string|max:50',
+            'emergency_phone' => 'nullable|string|max:20',
+            'base_salary' => 'nullable|numeric|min:0',
+            'position_salary' => 'nullable|numeric|min:0',
+            'status' => 'nullable|integer|in:1,2,3',
+        ]);
+
+        return $this->success(EmployeeProfile::create($v));
+    }
+
+    public function show(EmployeeProfile $employeeProfile): JsonResponse
+    {
+        return $this->success($employeeProfile->load('user'));
+    }
+
+    public function update(Request $request, EmployeeProfile $employeeProfile): JsonResponse
+    {
+        $v = $request->validate([
+            'employee_no' => 'nullable|string|max:30',
+            'hire_date' => 'nullable|date',
+            'birth_date' => 'nullable|date',
+            'gender' => 'nullable|integer|in:0,1,2',
+            'id_card' => 'nullable|string|max:20',
+            'education' => 'nullable|string|max:30',
+            'emergency_contact' => 'nullable|string|max:50',
+            'emergency_phone' => 'nullable|string|max:20',
+            'base_salary' => 'nullable|numeric|min:0',
+            'position_salary' => 'nullable|numeric|min:0',
+            'status' => 'nullable|integer|in:1,2,3',
+            'left_date' => 'nullable|date',
+        ]);
+        $employeeProfile->update($v);
+
+        return $this->success($employeeProfile);
+    }
+
+    public function destroy(EmployeeProfile $employeeProfile): JsonResponse
+    {
+        $employeeProfile->delete();
+        return $this->success(null);
+    }
+}
@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Hr;
+
+use App\Http\Controllers\Controller;
+use App\Models\Hr\LeaveRequest;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class LeaveRequestController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = LeaveRequest::query()->with('user');
+        $query->when($request->user_id, fn($q, $v) => $q->where('user_id', $v));
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'user_id' => 'required|exists:users,id',
+            'type' => 'required|integer|in:1,2,3,4,5,6',
+            'start_date' => 'required|date',
+            'end_date' => 'required|date|after_or_equal:start_date',
+            'days' => 'required|numeric|min:0.5',
+            'reason' => 'nullable|string',
+        ]);
+        $v['status'] = 0;
+
+        return $this->success(LeaveRequest::create($v));
+    }
+
+    public function show(LeaveRequest $leaveRequest): JsonResponse
+    {
+        return $this->success($leaveRequest->load(['user', 'auditor']));
+    }
+
+    public function update(Request $request, LeaveRequest $leaveRequest): JsonResponse
+    {
+        if ($leaveRequest->status !== 0) {
+            return $this->error('已审批的申请不可修改', 40001);
+        }
+        $v = $request->validate([
+            'type' => 'sometimes|integer|in:1,2,3,4,5,6',
+            'start_date' => 'sometimes|date',
+            'end_date' => 'sometimes|date|after_or_equal:start_date',
+            'days' => 'sometimes|numeric|min:0.5',
+            'reason' => 'nullable|string',
+        ]);
+        $leaveRequest->update($v);
+
+        return $this->success($leaveRequest);
+    }
+
+    public function destroy(LeaveRequest $leaveRequest): JsonResponse
+    {
+        if ($leaveRequest->status !== 0) {
+            return $this->error('已审批的申请不可删除', 40001);
+        }
+        $leaveRequest->delete();
+
+        return $this->success(null);
+    }
+
+    public function audit(Request $request, LeaveRequest $leaveRequest): JsonResponse
+    {
+        if ($leaveRequest->status !== 0) {
+            return $this->error('该申请已审批', 40001);
+        }
+        $v = $request->validate([
+            'status' => 'required|integer|in:1,2',
+        ]);
+        $leaveRequest->update([
+            'status' => $v['status'],
+            'audit_user_id' => auth()->id(),
+            'audit_at' => now(),
+        ]);
+
+        return $this->success($leaveRequest);
+    }
+}
@@ -0,0 +1,106 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Hr;
+
+use App\Http\Controllers\Controller;
+use App\Models\Hr\SalaryRecord;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class SalaryRecordController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = SalaryRecord::query()->with('user');
+        $query->when($request->user_id, fn($q, $v) => $q->where('user_id', $v));
+        $query->when($request->year_month, fn($q, $v) => $q->where('year_month', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'user_id' => 'required|exists:users,id',
+            'year_month' => 'required|string|max:7',
+            'base_salary' => 'nullable|numeric|min:0',
+            'position_salary' => 'nullable|numeric|min:0',
+            'performance' => 'nullable|numeric|min:0',
+            'overtime_pay' => 'nullable|numeric|min:0',
+            'subsidy' => 'nullable|numeric|min:0',
+            'social_insurance' => 'nullable|numeric|min:0',
+            'housing_fund' => 'nullable|numeric|min:0',
+            'tax' => 'nullable|numeric|min:0',
+            'absence_deduction' => 'nullable|numeric|min:0',
+            'other_deduction' => 'nullable|numeric|min:0',
+            'actual_amount' => 'nullable|numeric|min:0',
+        ]);
+
+        return $this->success(SalaryRecord::create($v));
+    }
+
+    public function show(SalaryRecord $salaryRecord): JsonResponse
+    {
+        return $this->success($salaryRecord->load('user'));
+    }
+
+    public function update(Request $request, SalaryRecord $salaryRecord): JsonResponse
+    {
+        if ($salaryRecord->status >= 2) {
+            return $this->error('已发放的工资记录不可修改', 40001);
+        }
+        $v = $request->validate([
+            'base_salary' => 'nullable|numeric|min:0',
+            'position_salary' => 'nullable|numeric|min:0',
+            'performance' => 'nullable|numeric|min:0',
+            'overtime_pay' => 'nullable|numeric|min:0',
+            'subsidy' => 'nullable|numeric|min:0',
+            'social_insurance' => 'nullable|numeric|min:0',
+            'housing_fund' => 'nullable|numeric|min:0',
+            'tax' => 'nullable|numeric|min:0',
+            'absence_deduction' => 'nullable|numeric|min:0',
+            'other_deduction' => 'nullable|numeric|min:0',
+            'actual_amount' => 'nullable|numeric|min:0',
+        ]);
+        $salaryRecord->update($v);
+
+        return $this->success($salaryRecord);
+    }
+
+    public function destroy(SalaryRecord $salaryRecord): JsonResponse
+    {
+        if ($salaryRecord->status >= 1) {
+            return $this->error('已确认的工资记录不可删除', 40001);
+        }
+        $salaryRecord->delete();
+
+        return $this->success(null);
+    }
+
+    public function confirm(SalaryRecord $salaryRecord): JsonResponse
+    {
+        if ($salaryRecord->status !== 0) {
+            return $this->error('仅待确认状态可确认', 40001);
+        }
+        $salaryRecord->update([
+            'status' => 1,
+            'confirmed_at' => now(),
+        ]);
+
+        return $this->success($salaryRecord);
+    }
+
+    public function pay(SalaryRecord $salaryRecord): JsonResponse
+    {
+        if ($salaryRecord->status !== 1) {
+            return $this->error('仅已确认状态可发放', 40001);
+        }
+        $salaryRecord->update([
+            'status' => 2,
+            'paid_at' => now(),
+        ]);
+
+        return $this->success($salaryRecord);
+    }
+}
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Hr;
+
+use App\Http\Controllers\Controller;
+use App\Models\Hr\Schedule;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ScheduleController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Schedule::query()->with('user');
+        $query->when($request->user_id, fn($q, $v) => $q->where('user_id', $v));
+        $query->when($request->start_date, fn($q, $v) => $q->where('schedule_date', '>=', $v));
+        $query->when($request->end_date, fn($q, $v) => $q->where('schedule_date', '<=', $v));
+
+        return $this->paginate($query->latest('schedule_date')->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'user_id' => 'required|exists:users,id',
+            'schedule_date' => 'required|date',
+            'shift_type' => 'required|integer|in:1,2,3,4,5',
+            'start_time' => 'nullable|date_format:H:i',
+            'end_time' => 'nullable|date_format:H:i',
+        ]);
+
+        $schedule = Schedule::updateOrCreate(
+            ['user_id' => $v['user_id'], 'schedule_date' => $v['schedule_date']],
+            $v
+        );
+
+        return $this->success($schedule);
+    }
+}