add: helpdesk system beta

- multilingual needed - events need to be completed - creating ticket categories from staff dashboard needs to be done
2026-04-24 03:59:08 -05:00 · 2021-02-28 18:39:51 -05:00
parent e6fac5b9d3
commit 85b31e81e4
55 changed files with 2996 additions and 45 deletions
@@ -0,0 +1,252 @@
+<?php
+/**
+ * NOTICE OF LICENSE.
+ *
+ * UNIT3D Community Edition is open-sourced software licensed under the GNU Affero General Public License v3.0
+ * The details is bundled with this project in the file LICENSE.txt.
+ *
+ * @project    UNIT3D Community Edition
+ *
+ * @author     HDVinnie <hdinnovations@protonmail.com>
+ * @license    https://www.gnu.org/licenses/agpl-3.0.en.html/ GNU Affero General Public License v3.0
+ */
+
+namespace App\Http\Controllers;
+
+use App\Models\Comment;
+use App\Events\TicketAssigned;
+use App\Events\TicketClosed;
+use App\Events\TicketCreated;
+use App\Models\Ticket;
+use App\Models\TicketCategory;
+use App\Models\TicketPriority;
+use Illuminate\Http\Request;
+use App\Models\TicketAttachment;
+
+class TicketController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\View\View
+     */
+    final public function index(Request $request): \Illuminate\Contracts\View\Factory|\Illuminate\View\View|\Illuminate\Contracts\Foundation\Application
+    {
+        return \view('ticket.index');
+    }
+
+    /**
+     * Show the form for creating a new resource.
+     *
+     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\View\View
+     */
+    final public function create(): \Illuminate\Contracts\View\Factory|\Illuminate\View\View|\Illuminate\Contracts\Foundation\Application
+    {
+        $categories = TicketCategory::all()->sortBy('position');
+        $priorities = TicketPriority::all()->sortBy('position');
+
+        return view('ticket.create', [
+            'categories' => $categories,
+            'priorities' => $priorities
+        ]);
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function store(Request $request): \Illuminate\Http\RedirectResponse
+    {
+        $user = $request->user();
+
+        $ticket = new Ticket();
+        $ticket->user_id = $user->id;
+        $ticket->category_id = $request->input('category');
+        $ticket->priority_id = $request->input('priority');
+        $ticket->subject = $request->input('subject');
+        $ticket->body = $request->input('body');
+
+        $v = \validator($ticket->toArray(), [
+            'user_id'     => 'required|exists:users,id',
+            'category_id' => 'required|exists:ticket_categories,id',
+            'priority_id' => 'required|exists:ticket_priorities,id',
+            'subject'     => 'required',
+            'body'        => 'required',
+        ]);
+
+        if ($v->fails()) {
+            return \redirect()->route('tickets.create')
+                ->withInput()
+                ->withErrors($v->errors());
+        }
+
+        $ticket->save();
+
+        return \redirect()->route('tickets.show', ['id' => $ticket->id])
+            ->withSuccess('Your Helpdesk Ticket Was Created Successfully!');
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @param int                      $id
+     *
+     * @return \Illuminate\Contracts\Foundation\Application|\Illuminate\Contracts\View\Factory|\Illuminate\View\View
+     */
+    final public function show(Request $request, int $id): \Illuminate\Contracts\View\Factory|\Illuminate\View\View|\Illuminate\Contracts\Foundation\Application
+    {
+        $user = $request->user();
+        $ticket = Ticket::with(['comments'])->findOrFail($id);
+
+        return view('ticket.show', [
+            'user'   => $user,
+            'ticket' => $ticket,
+        ]);
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     *
+     * @param  int  $id
+     *
+     * @return \Illuminate\Http\Response
+     */
+    final public function edit(int $id): \Illuminate\Http\Response
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @param  int $id
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function update(Request $request, int $id): \Illuminate\Http\RedirectResponse
+    {
+        $ticket = Ticket::findOrFail($id);
+        $user = $request->user();
+        \abort_unless($user->group->is_modo || $user->id == $ticket->user_id, 403);
+
+        $ticket->category_id = $request->input('category');
+        $ticket->priority_id = $request->input('priority');
+        $ticket->subject = $request->input('subject');
+        $ticket->body = $request->input('body');
+
+        $v = \validator($ticket->toArray(), [
+            'user_id'     => 'required|exists:users,id',
+            'category_id' => 'required|exists:ticket_categories,id',
+            'priority_id' => 'required|exists:ticket_priorities,id',
+            'subject'     => 'required',
+            'body'        => 'required',
+        ]);
+
+        if ($v->fails()) {
+            return \redirect()->route('tickets.create')
+                ->withInput()
+                ->withErrors($v->errors());
+        }
+
+        $ticket->save();
+
+        return \redirect()->route('tickets.show', ['id' => $ticket->id])
+            ->withSuccess('Your Helpdesk Ticket Was Updated Successfully!');
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param \Illuminate\Http\Request $request
+     * @param int                      $id
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function destroy(Request $request, int $id): \Illuminate\Http\RedirectResponse
+    {
+        $ticket = Ticket::findOrFail($id);
+        $user = $request->user();
+        \abort_unless($user->group->is_modo || $user->id == $ticket->user_id, 403);
+
+        Comment::where('ticket_id', '=', $id)->delete();
+        TicketAttachment::where('ticket_id', '=', $id)->delete();
+        $ticket->delete();
+
+        return \redirect()->route('tickets.index')
+            ->withSuccess('Your Helpdesk Ticket Was Deleted Successfully!');
+    }
+
+    /**
+     * @param \Illuminate\Http\Request $request
+     * @param int                      $id
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function assign(Request $request, int $id): \Illuminate\Http\RedirectResponse
+    {
+        $ticket = Ticket::findOrFail($id);
+        $user = $request->user();
+        \abort_unless($user->group->is_modo, 403);
+
+        $ticket->staff_id = $request->input('user_id');
+
+        $v = \validator($ticket->toArray(), [
+            'user_id' => 'required|exists:users,id',
+        ]);
+
+        if ($v->fails()) {
+            return \redirect()->route('tickets.show', ['id' => $ticket->id])
+                ->withErrors($v->errors());
+        }
+
+        $ticket->save();
+
+        return \redirect()->route('tickets.show', ['id' => $ticket->id])
+            ->withSuccess('Helpdesk Ticket Was Assigned Successfully!');
+    }
+
+    /**
+     * @param \Illuminate\Http\Request $request
+     * @param int                      $id
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function unassign(Request $request, int $id): \Illuminate\Http\RedirectResponse
+    {
+        $ticket = Ticket::findOrFail($id);
+        $user = $request->user();
+        \abort_unless($user->group->is_modo, 403);
+
+        $ticket->staff_id = null;
+        $ticket->save();
+
+        return \redirect()->route('tickets.show', ['id' => $ticket->id])
+            ->withSuccess('Helpdesk Ticket Was Unassigned Successfully!');
+    }
+
+    /**
+     * @param \Illuminate\Http\Request $request
+     * @param int                      $id
+     *
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    final public function close(Request $request, int $id): \Illuminate\Http\RedirectResponse
+    {
+        $ticket = Ticket::findOrFail($id);
+        $user = $request->user();
+        \abort_unless($user->group->is_modo || $user->id == $ticket->user_id, 403);
+
+        $ticket->closed_at = \now();
+        $ticket->save();
+
+        return \redirect()->route('tickets.show', ['id' => $ticket->id])
+            ->withSuccess('Helpdesk Ticket Was Closed Successfully!');
+    }
+}