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

=======================
Abuse Violation Reports
=======================

:Author: Zhenyu Yang <yangzhenyu@sust.edu.cn>
:Last updated: Apr 24, 2026

Corresponding API docs: `Abuse Report API <../../api/abuse.rst>`__

``abuse`` Code Entry
--------------------

-  ``backend/apps/abuse/models/__init__.py``
-  ``backend/apps/abuse/views/__init__.py``

``abuse`` Core Data
-------------------

``AbuseReport``
~~~~~~~~~~~~~~~

Key fields:

-  ``reporter``
-  ``classroom``
-  ``description``
-  ``images``
-  ``status``
-  ``remark``

Status enum:

-  ``open``
-  ``processing``
-  ``resolved``

``abuse`` Permission Boundaries
-------------------------------

-  All endpoints require authentication.
-  List / detail:

   -  ``superadmin`` can see all reports.
   -  Other users can only see their own submitted reports.

-  Update:

   -  ``superadmin`` only.

Implementation Notes
--------------------

-  This is a very thin module with no complex approval flow.
-  The view layer does not write operation logs. If auditing is needed
   in the future, it should follow the same pattern used in ``repairs``
   and ``borrowings``.