feat: 第二阶段核心业务模块(CRM/房务/护理/月子餐)

后端: - 4个迁移文件新增23张业务表 - 23个Eloquent Model(含关联/类型转换/门店隔离) - 20个Controller(含CRUD+业务操作: 合同审核/入住退房/护理异常处理等) - 110+条API路由(crm/room/care/meal四大前缀) 前端: - 4个API模块(crm.js/room.js/care.js/meal.js) - 13个业务页面(线索/客户/合同/渠道/投诉/房型/房间/预定/护理档案/护理计划/护理记录/菜品/排餐)
2026-03-13 20:18:29 +08:00
parent 11c177a432
commit 16bcd9bcf0
65 changed files with 4660 additions and 0 deletions
@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Room;
+
+use App\Http\Controllers\Controller;
+use App\Models\Room\CallRecord;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CallRecordController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = CallRecord::query()->with(['room', 'customer', 'handler']);
+        $query->when($request->room_id, fn($q, $v) => $q->where('room_id', $v));
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->status, fn($q, $v) => $q->where('status', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'room_id' => 'required|exists:rooms,id',
+            'customer_id' => 'nullable|exists:customers,id',
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'remark' => 'nullable|string|max:255',
+        ]);
+        $validated['status'] = 0;
+
+        return $this->success(CallRecord::create($validated));
+    }
+
+    public function handle(Request $request, CallRecord $callRecord): JsonResponse
+    {
+        if ($callRecord->status === 2) {
+            return $this->error('该呼叫已完成', 40001);
+        }
+        $callRecord->update([
+            'status' => 2,
+            'handler_id' => auth()->id(),
+            'handle_at' => now(),
+            'remark' => $request->input('remark', $callRecord->remark),
+        ]);
+        return $this->success($callRecord);
+    }
+}
@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Room;
+
+use App\Http\Controllers\Controller;
+use App\Models\Room\CustomerOuting;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CustomerOutingController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = CustomerOuting::query()->with(['reservation.room', 'customer']);
+        $query->when($request->reservation_id, fn($q, $v) => $q->where('reservation_id', $v));
+        $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 store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'reservation_id' => 'required|exists:reservations,id',
+            'customer_id' => 'required|exists:customers,id',
+            'out_at' => 'required|date',
+            'expected_back_at' => 'nullable|date|after:out_at',
+            'reason' => 'nullable|string',
+            'risk_note' => 'nullable|string',
+        ]);
+        $validated['created_by'] = auth()->id();
+
+        return $this->success(CustomerOuting::create($validated));
+    }
+
+    public function show(CustomerOuting $customerOuting): JsonResponse
+    {
+        return $this->success($customerOuting->load(['reservation.room', 'customer']));
+    }
+
+    public function recordBack(Request $request, CustomerOuting $customerOuting): JsonResponse
+    {
+        if ($customerOuting->actual_back_at) {
+            return $this->error('已记录返回时间', 40001);
+        }
+        $customerOuting->update(['actual_back_at' => $request->input('actual_back_at', now())]);
+        return $this->success($customerOuting);
+    }
+}
@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Room;
+
+use App\Http\Controllers\Controller;
+use App\Models\Room\Reservation;
+use App\Models\Room\Room;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ReservationController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Reservation::query()->with(['customer', 'room.roomType']);
+        $query->when($request->customer_id, fn($q, $v) => $q->where('customer_id', $v));
+        $query->when($request->room_id, fn($q, $v) => $q->where('room_id', $v));
+        $query->when($request->status, fn($q, $v) => $q->where('status', $v));
+        $query->when($request->check_in_date, fn($q, $v) => $q->whereDate('check_in_date', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'customer_id' => 'required|exists:customers,id',
+            'contract_id' => 'nullable|exists:contracts,id',
+            'room_id' => 'required|exists:rooms,id',
+            'check_in_date' => 'required|date',
+            'check_out_date' => 'required|date|after_or_equal:check_in_date',
+            'remark' => 'nullable|string',
+        ]);
+        $validated['created_by'] = auth()->id();
+        $validated['status'] = 0;
+
+        $reservation = Reservation::create($validated);
+        Room::find($validated['room_id'])->update(['status' => 2]);
+
+        return $this->success($reservation);
+    }
+
+    public function show(Reservation $reservation): JsonResponse
+    {
+        return $this->success($reservation->load(['customer', 'room.roomType', 'contract', 'outings']));
+    }
+
+    public function update(Request $request, Reservation $reservation): JsonResponse
+    {
+        if ($reservation->status >= 2) {
+            return $this->error('已退房或已取消的预定不可修改', 40001);
+        }
+        $validated = $request->validate([
+            'room_id' => 'sometimes|exists:rooms,id',
+            'check_in_date' => 'sometimes|date',
+            'check_out_date' => 'sometimes|date|after_or_equal:check_in_date',
+            'remark' => 'nullable|string',
+        ]);
+        $reservation->update($validated);
+        return $this->success($reservation);
+    }
+
+    public function destroy(Reservation $reservation): JsonResponse
+    {
+        if ($reservation->status === 1) {
+            return $this->error('已入住的预定不可删除', 40001);
+        }
+        $reservation->room->update(['status' => 1]);
+        $reservation->delete();
+        return $this->success(null);
+    }
+
+    public function checkIn(Reservation $reservation): JsonResponse
+    {
+        if ($reservation->status !== 0) {
+            return $this->error('只有预定状态可以办理入住', 40001);
+        }
+        $reservation->update([
+            'status' => 1,
+            'actual_check_in' => now(),
+        ]);
+        $reservation->room->update(['status' => 3]);
+        $reservation->customer->update(['status' => 3]);
+
+        return $this->success($reservation);
+    }
+
+    public function checkOut(Reservation $reservation): JsonResponse
+    {
+        if ($reservation->status !== 1) {
+            return $this->error('只有入住状态可以办理退房', 40001);
+        }
+        $reservation->update([
+            'status' => 2,
+            'actual_check_out' => now(),
+        ]);
+        $reservation->room->update(['status' => 5]);
+        $reservation->customer->update(['status' => 4]);
+
+        return $this->success($reservation);
+    }
+
+    public function cancel(Request $request, Reservation $reservation): JsonResponse
+    {
+        if ($reservation->status >= 2) {
+            return $this->error('已退房或已取消的预定不可取消', 40001);
+        }
+        $reservation->update(['status' => 3, 'remark' => $request->input('remark', $reservation->remark)]);
+        $reservation->room->update(['status' => 1]);
+
+        return $this->success($reservation);
+    }
+}
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Room;
+
+use App\Http\Controllers\Controller;
+use App\Models\Room\Room;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class RoomController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Room::query()->with('roomType');
+        $query->when($request->room_type_id, fn($q, $v) => $q->where('room_type_id', $v));
+        $query->when($request->floor, fn($q, $v) => $q->where('floor', $v));
+        $query->when($request->status, fn($q, $v) => $q->where('status', $v));
+        $query->when($request->number, fn($q, $v) => $q->where('number', 'like', "%{$v}%"));
+
+        return $this->paginate($query->orderBy('sort')->paginate($request->input('per_page', 50)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'room_type_id' => 'required|exists:room_types,id',
+            'floor' => 'nullable|string|max:10',
+            'number' => 'required|string|max:20',
+            'status' => 'sometimes|integer|in:1,2,3,4,5',
+            'sort' => 'sometimes|integer',
+        ]);
+        return $this->success(Room::create($validated));
+    }
+
+    public function show(Room $room): JsonResponse
+    {
+        return $this->success($room->load(['roomType', 'reservations.customer']));
+    }
+
+    public function update(Request $request, Room $room): JsonResponse
+    {
+        $validated = $request->validate([
+            'room_type_id' => 'sometimes|exists:room_types,id',
+            'floor' => 'nullable|string|max:10',
+            'number' => 'sometimes|string|max:20',
+            'sort' => 'sometimes|integer',
+        ]);
+        $room->update($validated);
+        return $this->success($room);
+    }
+
+    public function destroy(Room $room): JsonResponse
+    {
+        if ($room->status === 3) {
+            return $this->error('入住中的房间无法删除', 40001);
+        }
+        $room->delete();
+        return $this->success(null);
+    }
+
+    public function updateStatus(Request $request, Room $room): JsonResponse
+    {
+        $validated = $request->validate([
+            'status' => 'required|integer|in:1,2,3,4,5',
+        ]);
+        $room->update($validated);
+        return $this->success($room);
+    }
+}
@@ -0,0 +1,63 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Room;
+
+use App\Http\Controllers\Controller;
+use App\Models\Room\RoomType;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class RoomTypeController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = RoomType::query()->withCount('rooms');
+        $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:50',
+            'price' => 'nullable|numeric|min:0',
+            'description' => 'nullable|string',
+            'images' => 'nullable|array',
+            'facilities' => 'nullable|array',
+            'sort' => 'sometimes|integer',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+        return $this->success(RoomType::create($validated));
+    }
+
+    public function show(RoomType $roomType): JsonResponse
+    {
+        return $this->success($roomType->load('rooms'));
+    }
+
+    public function update(Request $request, RoomType $roomType): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:50',
+            'price' => 'nullable|numeric|min:0',
+            'description' => 'nullable|string',
+            'images' => 'nullable|array',
+            'facilities' => 'nullable|array',
+            'sort' => 'sometimes|integer',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+        $roomType->update($validated);
+        return $this->success($roomType);
+    }
+
+    public function destroy(RoomType $roomType): JsonResponse
+    {
+        if ($roomType->rooms()->exists()) {
+            return $this->error('该房型下有房间，无法删除', 40001);
+        }
+        $roomType->delete();
+        return $this->success(null);
+    }
+}