Sites
=====

Django admin
------------

Staff-facing Django AdminSite instances (not the Agency desktop SPA).

+----------------+----------------------------+------------------------------------------+
| URL            | Site                       | Role                                     |
+================+============================+==========================================+
| ``/admin/``    | Django default admin       | Full staff admin (incl. User preferences)|
+----------------+----------------------------+------------------------------------------+
| ``/system/``   | ``AgencyAdminSite``        | Agency / corpus / miner management       |
+----------------+----------------------------+------------------------------------------+
| ``/custom/``   | custom AdminSite           | Application-specific registrations       |
+----------------+----------------------------+------------------------------------------+

Product SPA (Agency desktop) for operators: ``/`` after ``/login/`` — see :doc:`index`.
The desktop is an installable PWA (``/manifest.webmanifest``, service worker
``/sw.js``, ``/offline.html``). A public ``/health/`` payload lets the SPA
detect a Django restart and reload, Home Assistant-style. Mission Control
(Agents / Missions / Executions) lives on that desktop.

REST API
--------

DRF landing and OpenAPI schema UIs.

+----------------------+----------------------------+------------------------------------------+
| URL                  | Site                       | Role                                     |
+======================+============================+==========================================+
| ``/api/``            | DRF portada                | API index for the product                |
+----------------------+----------------------------+------------------------------------------+
| ``/api/swagger-ui/`` | Swagger UI                 | Interactive OpenAPI                      |
+----------------------+----------------------------+------------------------------------------+
| ``/api/redoc/``      | ReDoc                      | Readable OpenAPI                         |
+----------------------+----------------------------+------------------------------------------+

Docs
----

+---------------------------+----------------------------+------------------------------------------+
| URL                       | Site                       | Role                                     |
+===========================+============================+==========================================+
| ``/static/documentation/``| Sphinx HTML                | This documentation tree                  |
+---------------------------+----------------------------+------------------------------------------+

Developer
---------

Useful ops / debug entry points.

.. list-table::
   :header-rows: 1
   :widths: 28 28 44

   * - URL
     - Site
     - Role
   * - ``/logs/``
     - Log stream
     - SSE logs outside the SPA
   * - ``http://localhost:5555/``
     - Flower
     - Celery monitor (Compose publishes port 5555)
   * - ``/health/``
     - Liveness
     - Public ``boot_id`` / ``ui_build`` (PWA restart detect)
   * - ``/health/redis/``
     - Redis health
     - Broker / Channels health check
   * - ``/offline.html``
     - Offline wait screen
     - Cached fallback while Django is down
   * - ``/manifest.webmanifest``
     - Web app manifest
     - PWA install (standalone desktop)
   * - ``/sw.js``
     - Service worker
     - Scope ``/``; caches hashed ``/static/agency/ui/assets/`` only