.. SPDX-License-Identifier: GPL-3.0-or-later

================
Abuse report API
================

1. Submit a report (all authenticated users)
============================================

.. code:: bash

   POST /api/v1/abuse

Body:

.. code:: json

   {
     "classroom_id": 121,
     "description": "The classroom appears to be occupied by unauthorized people.",
     "images": []
   }

Response:

.. code:: json

   {
     "code": 0,
     "message": "success",
     "data": {
       "id": 1,
       "classroom_id": 121,
       "classroom": { "id": 121, "building": "5A", "room_number": "203" },
       "description": "The classroom appears to be occupied by unauthorized people.",
       "images": [],
       "status": "open",
       "remark": "",
       "created_at": "2026-04-05T10:00:00+08:00"
     }
   }

2. Report List
==============

.. code:: bash

   GET /api/v1/abuse

Permissions:

-  ``superadmin``: view all reports.
-  Other users: view only reports they submitted.

3. Handle a Report (superadmin Only)
====================================

.. code:: bash

   PUT /api/v1/abuse/{id}

Body:

.. code:: json

   {
     "status": "resolved",
     "remark": "Resolved"
   }