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,59 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\Channel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ChannelController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Channel::query();
+        $query->when($request->name, fn($q, $v) => $q->where('name', 'like', "%{$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
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:50',
+            'type' => 'required|integer|in:1,2,3',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+
+        $channel = Channel::create($validated);
+
+        return $this->success($channel);
+    }
+
+    public function show(Channel $channel): JsonResponse
+    {
+        return $this->success($channel->load('leads'));
+    }
+
+    public function update(Request $request, Channel $channel): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:50',
+            'type' => 'sometimes|integer|in:1,2,3',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+
+        $channel->update($validated);
+
+        return $this->success($channel);
+    }
+
+    public function destroy(Channel $channel): JsonResponse
+    {
+        $channel->delete();
+
+        return $this->success(null);
+    }
+}
@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\Complaint;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ComplaintController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Complaint::query()->with(['customer', 'handler']);
+        $query->when($request->customer_id, fn($q, $v) => $q->where('customer_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
+    {
+        $validated = $request->validate([
+            'customer_id' => 'required|exists:customers,id',
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'content' => 'required|string',
+            'images' => 'nullable|array',
+        ]);
+        $validated['status'] = 0;
+
+        return $this->success(Complaint::create($validated));
+    }
+
+    public function show(Complaint $complaint): JsonResponse
+    {
+        return $this->success($complaint->load(['customer', 'handler']));
+    }
+
+    public function update(Request $request, Complaint $complaint): JsonResponse
+    {
+        $validated = $request->validate([
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'content' => 'sometimes|string',
+            'images' => 'nullable|array',
+        ]);
+        $complaint->update($validated);
+        return $this->success($complaint);
+    }
+
+    public function destroy(Complaint $complaint): JsonResponse
+    {
+        $complaint->delete();
+        return $this->success(null);
+    }
+
+    public function handle(Request $request, Complaint $complaint): JsonResponse
+    {
+        if ($complaint->status >= 2) {
+            return $this->error('该投诉已处理', 40001);
+        }
+        $validated = $request->validate([
+            'handle_result' => 'required|string',
+            'status' => 'required|integer|in:2,3',
+        ]);
+        $complaint->update([
+            'handle_result' => $validated['handle_result'],
+            'status' => $validated['status'],
+            'handler_id' => auth()->id(),
+            'handle_at' => now(),
+        ]);
+        return $this->success($complaint);
+    }
+}
@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\Contract;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ContractController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Contract::query()->with(['customer', 'auditor']);
+        $query->when($request->contract_no, fn($q, $v) => $q->where('contract_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));
+
+        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_no' => 'required|string|max:50|unique:contracts',
+            'package_name' => 'nullable|string|max:100',
+            'total_amount' => 'required|numeric|min:0',
+            'discount_amount' => 'sometimes|numeric|min:0',
+            'actual_amount' => 'required|numeric|min:0',
+            'days' => 'nullable|integer|min:1',
+            'check_in_date' => 'nullable|date',
+            'check_out_date' => 'nullable|date|after_or_equal:check_in_date',
+            'remark' => 'nullable|string',
+        ]);
+        $validated['created_by'] = auth()->id();
+        $validated['status'] = 0;
+
+        return $this->success(Contract::create($validated));
+    }
+
+    public function show(Contract $contract): JsonResponse
+    {
+        return $this->success($contract->load(['customer', 'auditor', 'creator']));
+    }
+
+    public function update(Request $request, Contract $contract): JsonResponse
+    {
+        if ($contract->status !== 0) {
+            return $this->error('只能修改待审核的合同', 40001);
+        }
+        $validated = $request->validate([
+            'package_name' => 'nullable|string|max:100',
+            'total_amount' => 'sometimes|numeric|min:0',
+            'discount_amount' => 'sometimes|numeric|min:0',
+            'actual_amount' => 'sometimes|numeric|min:0',
+            'days' => 'nullable|integer|min:1',
+            'check_in_date' => 'nullable|date',
+            'check_out_date' => 'nullable|date|after_or_equal:check_in_date',
+            'remark' => 'nullable|string',
+        ]);
+        $contract->update($validated);
+        return $this->success($contract);
+    }
+
+    public function destroy(Contract $contract): JsonResponse
+    {
+        if ($contract->status !== 0) {
+            return $this->error('只能删除待审核的合同', 40001);
+        }
+        $contract->delete();
+        return $this->success(null);
+    }
+
+    public function audit(Request $request, Contract $contract): JsonResponse
+    {
+        if ($contract->status !== 0) {
+            return $this->error('该合同已审核', 40001);
+        }
+        $validated = $request->validate([
+            'status' => 'required|integer|in:1,2',
+            'audit_remark' => 'nullable|string|max:255',
+        ]);
+        $contract->update([
+            'status' => $validated['status'],
+            'audit_user_id' => auth()->id(),
+            'audit_at' => now(),
+            'audit_remark' => $validated['audit_remark'] ?? null,
+        ]);
+
+        if ($validated['status'] === 1) {
+            $contract->customer->update(['status' => 2]);
+        }
+
+        return $this->success($contract);
+    }
+}
@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\Customer;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CustomerController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Customer::query()->with(['owner']);
+        $query->when($request->name, fn($q, $v) => $q->where('name', 'like', "%{$v}%"));
+        $query->when($request->phone, fn($q, $v) => $q->where('phone', 'like', "%{$v}%"));
+        $query->when($request->status, fn($q, $v) => $q->where('status', $v));
+        $query->when($request->owner_id, fn($q, $v) => $q->where('owner_id', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'lead_id' => 'nullable|exists:leads,id',
+            'name' => 'required|string|max:50',
+            'phone' => 'required|string|max:20',
+            'id_card' => 'nullable|string|max:20',
+            'wechat' => 'nullable|string|max:50',
+            'birthday' => 'nullable|date',
+            'expected_date' => 'nullable|date',
+            'actual_date' => 'nullable|date',
+            'baby_count' => 'sometimes|integer|min:1',
+            'tags' => 'nullable|array',
+            'remark' => 'nullable|string',
+            'families' => 'nullable|array',
+            'families.*.name' => 'nullable|string|max:50',
+            'families.*.phone' => 'nullable|string|max:20',
+            'families.*.relation' => 'nullable|string|max:20',
+            'families.*.is_emergency' => 'nullable|boolean',
+        ]);
+
+        $families = $validated['families'] ?? [];
+        unset($validated['families']);
+        $validated['status'] = 1;
+
+        $customer = Customer::create($validated);
+        if ($families) {
+            $customer->families()->createMany($families);
+        }
+
+        return $this->success($customer->load('families'));
+    }
+
+    public function show(Customer $customer): JsonResponse
+    {
+        return $this->success($customer->load(['owner', 'families', 'contracts', 'complaints']));
+    }
+
+    public function update(Request $request, Customer $customer): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:50',
+            'phone' => 'sometimes|string|max:20',
+            'id_card' => 'nullable|string|max:20',
+            'wechat' => 'nullable|string|max:50',
+            'birthday' => 'nullable|date',
+            'expected_date' => 'nullable|date',
+            'actual_date' => 'nullable|date',
+            'baby_count' => 'sometimes|integer|min:1',
+            'tags' => 'nullable|array',
+            'status' => 'sometimes|integer|in:1,2,3,4,5',
+            'owner_id' => 'nullable|exists:users,id',
+            'remark' => 'nullable|string',
+        ]);
+        $customer->update($validated);
+        return $this->success($customer);
+    }
+
+    public function destroy(Customer $customer): JsonResponse
+    {
+        $customer->delete();
+        return $this->success(null);
+    }
+}
@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\Lead;
+use App\Models\Crm\LeadFollow;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class LeadController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Lead::query()->with(['channel', 'owner']);
+        $query->when($request->name, fn($q, $v) => $q->where('name', 'like', "%{$v}%"));
+        $query->when($request->phone, fn($q, $v) => $q->where('phone', 'like', "%{$v}%"));
+        $query->when($request->status, fn($q, $v) => $q->where('status', $v));
+        $query->when($request->channel_id, fn($q, $v) => $q->where('channel_id', $v));
+        $query->when($request->owner_id, fn($q, $v) => $q->where('owner_id', $v));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'channel_id' => 'nullable|exists:channels,id',
+            'name' => 'required|string|max:50',
+            'phone' => 'required|string|max:20',
+            'wechat' => 'nullable|string|max:50',
+            'expected_date' => 'nullable|date',
+            'source' => 'nullable|string|max:50',
+            'remark' => 'nullable|string',
+        ]);
+        $validated['created_by'] = auth()->id();
+        $validated['status'] = 1;
+
+        return $this->success(Lead::create($validated));
+    }
+
+    public function show(Lead $lead): JsonResponse
+    {
+        return $this->success($lead->load(['channel', 'owner', 'follows.user']));
+    }
+
+    public function update(Request $request, Lead $lead): JsonResponse
+    {
+        $validated = $request->validate([
+            'channel_id' => 'nullable|exists:channels,id',
+            'name' => 'sometimes|string|max:50',
+            'phone' => 'sometimes|string|max:20',
+            'wechat' => 'nullable|string|max:50',
+            'expected_date' => 'nullable|date',
+            'source' => 'nullable|string|max:50',
+            'status' => 'sometimes|integer|in:1,2,3,4',
+            'remark' => 'nullable|string',
+        ]);
+        $lead->update($validated);
+        return $this->success($lead);
+    }
+
+    public function destroy(Lead $lead): JsonResponse
+    {
+        $lead->delete();
+        return $this->success(null);
+    }
+
+    public function follow(Request $request, Lead $lead): JsonResponse
+    {
+        $validated = $request->validate([
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'content' => 'nullable|string',
+            'next_follow_at' => 'nullable|date',
+        ]);
+        $validated['lead_id'] = $lead->id;
+        $validated['user_id'] = auth()->id();
+
+        $follow = LeadFollow::create($validated);
+        $lead->update(['status' => 2]);
+
+        return $this->success($follow);
+    }
+
+    public function assign(Request $request, Lead $lead): JsonResponse
+    {
+        $validated = $request->validate([
+            'owner_id' => 'required|exists:users,id',
+        ]);
+        $lead->update($validated);
+        return $this->success($lead);
+    }
+}
@@ -0,0 +1,80 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Crm;
+
+use App\Http\Controllers\Controller;
+use App\Models\Crm\QuestionnaireAnswer;
+use App\Models\Crm\QuestionnaireTemplate;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class QuestionnaireController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = QuestionnaireTemplate::query();
+        $query->when($request->title, fn($q, $v) => $q->where('title', 'like', "%{$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
+    {
+        $validated = $request->validate([
+            'title' => 'required|string|max:100',
+            'description' => 'nullable|string',
+            'questions' => 'nullable|array',
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+        return $this->success(QuestionnaireTemplate::create($validated));
+    }
+
+    public function show(QuestionnaireTemplate $questionnaire): JsonResponse
+    {
+        return $this->success($questionnaire->load('answers.customer'));
+    }
+
+    public function update(Request $request, QuestionnaireTemplate $questionnaire): JsonResponse
+    {
+        $validated = $request->validate([
+            'title' => 'sometimes|string|max:100',
+            'description' => 'nullable|string',
+            'questions' => 'nullable|array',
+            'type' => 'nullable|integer|in:1,2,3,4',
+            'status' => 'sometimes|integer|in:0,1',
+        ]);
+        $questionnaire->update($validated);
+        return $this->success($questionnaire);
+    }
+
+    public function destroy(QuestionnaireTemplate $questionnaire): JsonResponse
+    {
+        $questionnaire->delete();
+        return $this->success(null);
+    }
+
+    public function submitAnswer(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'questionnaire_template_id' => 'required|exists:questionnaire_templates,id',
+            'customer_id' => 'required|exists:customers,id',
+            'answers' => 'nullable|array',
+            'score' => 'nullable|numeric|min:0|max:100',
+        ]);
+        $validated['status'] = 1;
+
+        return $this->success(QuestionnaireAnswer::create($validated));
+    }
+
+    public function answers(Request $request): JsonResponse
+    {
+        $query = QuestionnaireAnswer::query()->with(['template', 'customer']);
+        $query->when($request->questionnaire_template_id, fn($q, $v) => $q->where('questionnaire_template_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)));
+    }
+}